NeuroLag

插件

· 作者 Duong2012G

一个智能、资源感知的优化插件,可根据服务器的 TPS 和内存使用情况动态调整生物 AI,确保 SMP 体验无卡顿

0 本站下载 0 关注 更新于 1 周前

最新 1.9.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

NeuroLag

面向 Paper 26.1+ 的智能 TPS 感知生物 AI 优化器

在卡顿发生前保护你的 TPS —— 并在服务器恢复后悄然撤销所有操作。

? 下载 • ? 报告错误 • ? 更新日志


? 目录

  • ✨ 功能特性
  • ? 工作原理
  • ? 前置要求
  • ? 安装指南
  • ⌨️ 命令与权限
  • ? 配置说明
  • ? Web 仪表盘
  • ? 多服同步
  • ?️ 受保护区域
  • ?️ 配置文件集
  • ? 备份系统
  • ? 开发者 API
  • ? 故障排除
  • ❓ 常见问题
  • ? 致谢

? 1.9.0 版本更新内容

  • Minecraft 26.x:支持 Paper 26.1+、Java 25、世界键(minecraft:the_nether)、SpawnCategory、原版 /tick 命令支持,以及无生成区块感知功能。
  • 崩溃安全的生物状态:原始 AI 和跟随范围存储在生物的玩家定制数据(PDC)中,并在区块加载时恢复——在卡顿事件或崩溃后没有任何生物会保持冻结状态,且 NPC/无 AI 生物永远不会被唤醒。
  • 所有生物均被优化:不再仅限于每个世界的第一个 80 个生物;坐骑/骑乘者/拴绳/持久性生物不会被剔除。
  • 恢复功能在任何玩家数量下均可工作(此前在约 38 名玩家时会卡在 MEDIUM 状态)。
  • 重载真正生效;/nlag toggle 确实能暂停服务。
  • 更安全的 Web 仪表盘与同步(默认回环地址,无通配符 CORS,优先 TLS 的 MySQL,唯一服务器 ID)。

完整列表请参阅 CHANGELOG.md。


✨ 功能特性

? 智能 TPS 状态机

NeuroLag 持续采样 TPS、CPU 负载、堆内存使用率、玩家数量及预测趋势数据,以决定在每个世界中应用以下三种状态之一:

状态 默认触发条件 效果
NORMAL TPS ≥ 18.0 无限制;完全恢复 AI
MEDIUM TPS < 18.0 缩放跟随范围,限制寻路,启用刻节流
CRITICAL TPS < 15.0 完全禁用 AI,抑制生成,智能剔除

所有阈值均可按世界单独配置,并可通过配置文件集覆盖。迟滞缓冲(默认 0.5 TPS)可防止在边界处出现震荡。


⚡ 31 项优化功能

F1 — CPU 节流惩罚

监控 JVM CPU 使用率。当使用率超过配置的阈值(默认 80%)时,对有效 TPS 计算施加 1.5 的惩罚值,从而在服务器线程饱和之前触发更严格的生物优化。

F2 — 基于区域的寻路截止

将每个世界划分为可配置的区域。超出寻路距离阈值(disable-pathfinding-distance-chunks: 8)的生物,其 FOLLOW_RANGE 属性将被清零,从而消除那些玩家永远看不到的生物的昂贵 A* 寻路计算。

F3 — 基于区块的 AI 切换

在 CRITICAL 状态下,距离任何玩家超出可配置区块半径(distance-chunks: 4)的生物将完全禁用 AI。范围内的生物无论服务器状态如何,始终保留完整的 AI。

F4 — 速度冻结

处于 AI 禁用状态的远距离生物,其速度将被清零以防止被动漂移。可配置最小冻结区块距离(freeze-distance-chunks: 6)。

F5 — 生成抑制

在 MEDIUM 和 CRITICAL 状态下,怪物和动物的生成上限会降低(monster-limit: 30,animal-limit: 10),以便在服务器已承受负载时减缓生物种群的增长。

F6 — 智能剔除

当每世界实体数量在 CRITICAL 状态下超过 max-entities-per-world 时,将移除优先级最低的生物。支持三种剔除策略:

策略 行为
FAR_FROM_PLAYER 首先移除距离任何玩家最远的生物
GROUP 移除实例数量最多的生物类型
RANDOM 随机排序并移除

受保护区域的生物以及命名/驯服的生物(如果在白名单中)绝不会被剔除。

F7 — 刻节流

在 MEDIUM 状态下,非优先生物仅在每 N 个游戏刻(ticks-per-ai-tick: 4)中执行一次 AI 逻辑,而不是每刻都执行。这在不完全禁用生物的情况下,将 AI 成本减半或减至四分之一。

F8 — 生物权重系统

每种实体类型都被分配一个权重分数。剔除时优先考虑重量最大的实体。完全可配置(features.yml 中的 zombies.yml 风格块)。

实体 默认权重
Bat (蝙蝠) 0.3
Bee (蜜蜂) 0.5
Zombie (僵尸) 1.0
Skeleton (骷髅) 1.2
Creeper (苦力怕) 1.5
Enderman (末影人) 2.0
Wither (凋灵) 3.0
Ender Dragon (末影龙) 4.0

F9 — AI 难度缩放

根据世界难度调整有效 TPS,以便在简单难度(玩家不太在意)下更早触发优化,而在困难难度(玩家希望获得完整的生物行为)下稍后触发。阈值始终会被钳制,以确保健康的服务器可以返回 NORMAL 状态。

难度 TPS 偏移量
Peaceful (和平) +3.0 (永不优化)
Easy (简单) −1.0 (更早优化)
Normal (普通) 0.0
Hard (困难) +1.0 (推迟优化)

F10 — 内存压力惩罚

监控 JVM 堆内存使用比率。当已用堆内存超过配置的阈值(默认 80%)时,将添加可配置的 TPS 惩罚值,在 GC 暂停发生前提前触发优化。

F11 — 预测调度器

跟踪滑动窗口内的历史 TPS 以及一组可配置的峰值时段。如果检测到早期向下的 TPS 趋势(在阈值被突破之前),将应用 earlyOffset 惩罚值以主动触发优化。

可配置的峰值时段示例:

peak-hours: "17:00-19:00,19:00-22:00"

F12 — 受保护区域

位于定义好的长方体区域(或 WorldGuard 区域)内的生物永远不会被限流、清除或修改属性。当检测到生物位于受保护区域时,跟随范围将始终恢复为默认值。

F13 — 智能群体清除

不是随机清除生物,而是按类型对实体进行分组,仅针对数量超过 min-type-before-cull 阈值的类型进行清除,在降低最高密度种群数量的同时保持生态多样性。

F14 — 玩家动作栏通知

靠近受影响生物的玩家在中度/危急状态下会收到动作栏警告。可配置半径(radius-blocks: 64)。

F15 — 警报系统

在状态转换时通过动作栏向管理员广播。支持可选的 Discord Webhook 和游戏内声音警报。 声音名称、粒子类型、粒子数量以及是否显示动作栏警报均可在 monitors.yml 下的 alerts.* 中配置。包含针对每位玩家的冷却机制,以防止在多世界服务器上造成感官混乱。

F16 — 玩家数量缩放

随着更多玩家加入,TPS 阈值会动态收紧。配置 min-players、max-players 和 max-threshold-offset,以便在玩家数量高峰期更积极地优化插件。

F17 — 动画冻结

在危急状态下,冻结超出 freeze-distance-chunks 距离的生物的速度,无需 NMS 或数据包级访问即可防止物理漂移。

F18 — 配置文件自动备份

按照可配置的频率自动创建所有 NeuroLag YAML 文件(包括 lang/ 目录)的时间戳 ZIP 包,并保留最近的 N 个副本。每个备份都附带一个 .sha256 校验和文件,在恢复之前会进行验证。通过限制单个条目(10 MB)和总恢复大小(50 MB)来防范 zip-bomb 攻击。

F19 — 危急状态的安全模式

如果在危急 TPS 层配置中启用,安全模式仅禁用危险的 AI 组件,同时保留必要的游戏机制。防止过度优化导致村民交易、生物逃离水域以及其他关键行为失效。

F20 — 生物重要性评分系统

根据类型、命名、驯服状态、装备和拴绳状态为所有生物分配重要性分数。命名的生物(10倍)、驯服的生物(20倍)和装备了物品的生物(1.5倍)获得更高的优先级。系统在清除操作中保护重要生物。

F21 — 生物行为组

将生物分类为行为组以进行针对性优化:

  • PASSIVE(低优先级):牛、猪、羊、鸡
  • AGGRESSIVE(高优先级):僵尸、骷髅、苦力怕
  • NEUTRAL(中等优先级):末影人、铁傀儡
  • SPECIAL(保留):村民、Boss、命名生物
  • AQUATIC(水生):海豚、守卫者、鱿鱼

F22 — 动态区域大小

根据玩家数量自动调整区域大小以实现最佳性能:

  • 0-5 名玩家:16 区块(大区域)
  • 6-20 名玩家:8 区块(中等区域)
  • 21-50 名玩家:4 区块(小区域)
  • 50+ 名玩家:2 区块(非常小的区域)

F23 — 热点区域衰减

在最后一位玩家离开附近后,区域保持“热”状态 30 秒,然后冷却。这避免了玩家在传送或离开时生物立即冻结,同时也不会让区域无限期保持“热”状态。

F24 — EWMA 预测算法

指数加权移动平均线(EWMA)通过对近期样本赋予更高权重来提供更准确的短期 TPS 预测。平滑因子 Alpha 设为 0.3 以获得最佳响应速度。

F25 — 线性回归趋势分析

使用线性检测向下 TPS 趋势,从而在滞后发生前进行预测。 结合简单平均值和 EWMA 以实现稳健的预测准确性。

F26 — 基于注解的配置验证

@ConfigValidation 注解允许对配置值进行字段级验证规则。验证数值范围、必填字段和边界警告,并提供清晰的错误消息。

F27 — 配置迁移系统

自动检查版本并对配置文件进行逐步迁移。在迁移前创建备份并支持回滚。迁移 config.yml、features.yml、monitors.yml 和 systems.yml 的同时保留用户设置。

F28 — 事件驱动架构

EventBus 模式将优化逻辑与主引擎解耦。组件可以注册为 OptimizationListener 以响应优化状态的变化,从而使插件/附加组件能够扩展功能。

F29 — 重构后的优化器类

遵循单一职责原则,将优化逻辑提取到专用类中:

  • MobCuller - 带有重要性评分的实体清除
  • AIThrottler - AI 限流和刻管理
  • SpawnSuppressor - 生成率调整逻辑

F30 — 综合配置指南

CONFIG-GUIDE.md 提供了所有配置选项的详细解释,包括使用示例、推荐值以及按功能领域组织的故障排除提示。

F31 — 增强的配置注释

所有 YAML 配置文件(config.yml、features.yml、monitors.yml、systems.yml) 均包含详细的内联注释、章节标题和安全说明,以便于更好地理解和配置管理。


? 监控与报告

功能 描述
BossBar 仪表盘 为管理员提供实时的 TPS、状态、CPU 和堆内存显示
Web 仪表盘 嵌入式 HTTP 服务器,端口可配置,提供 JSON API
ASCII 图表 /nlag graph — 聊天中的 TPS 历史图表
HTML 审计报告 按需或自动生成报告,涵盖服务器规格、插件列表、区块统计和生物分析。为避免主线程峰值,每个世界的实体收集上限为 5,000 个。完整的 HTML 转义可防止 XSS 攻击。
滞后报告 当事件持续时间超过最小持续时间时记录
指标 API 用于第三方集成的插件消息通道(neurolag.api)

? 多服务器同步

实时跨网络传播 TPS 状态。支持:

  • Redis(推荐)— 通过 Pub/Sub 实现低于 100 毫秒的延迟
  • MySQL — 基于轮询,适用于任何共享数据库

当对等服务器进入 CRITICAL(严重)状态时,级联警告会通知本地管理员。


?️ 配置预设 (Config Profiles)

在运行时切换命名的配置预设:

/nlag profile survival
/nlag profile event
/nlag profile clear

预设配置文件会覆盖 critical-tps、medium-tps 和 max-entities,而无需修改基础配置文件。


? 开发者 API

NeuroLagAPI api = NeuroLagAPI.getInstance();

api.getCurrentTps();
api.getWorldState("world");           // "NORMAL" | "MEDIUM" | "CRITICAL"
api.isManualOverride();
api.getCriticalActivationCount();
api.getMediumActivationCount();

? 工作原理

每隔 check-interval 秒执行一次检查(默认值:10):

  原始 TPS
    │
    ├─ 内存压力惩罚  (如果堆内存 > 阈值)
    ├─ CPU 节流惩罚     (如果 CPU > 阈值)
    ├─ 预测偏移量        (如果检测到下降趋势)
    └─ 难度缩放         (按世界调整)
            │
            ▼
       有效 TPS
            │
   ┌────────┴─────────┐
   │  迟滞有限状态机  │   NORMAL ↔ MEDIUM ↔ CRITICAL
   └────────┬─────────┘
            │
   ┌────────┴────────────────────────────────┐
   │  按世界优化处理流程                     │
   │  • 收集目标(缓存 4 个刻)              │
   │  • 生成抑制                           │
   │  • 智能剔除(仅在 CRITICAL 状态下)     │
   │  • 批量 AI/范围更新(每批 ≤ 50)        │
   │  • 管理员与玩家通知                   │
   └─────────────────────────────────────────┘

恢复至 NORMAL 状态时:
  → restoreWorld() — 对所有生物恢复完整的 AI + 默认的 FOLLOW_RANGE

? 依赖要求

组件 版本 备注
Java 25+ 必需(Minecraft 26.x 运行于 Java 25)
Paper 26.1+ 必需;不支持 Spigot 和 Folia。Minecraft 1.21.x → 请使用 NeuroLag 1.8.x
WorldGuard 7.0.17+ 可选 — 启用 WG 区域集成(旧版 WorldGuard 不支持 26.x)
Redis 任意近期版本 可选 — 用于多服务器同步
MySQL 8.x / 9.x 可选 — 替代同步后端

? 安装步骤

  1. 从 Modrinth 下载 NeuroLag-1.9.0.jar。

  2. 将其放入 plugins/ 文件夹。

  3. 启动服务器一次以生成所有配置文件。

  4. 编辑 plugins/NeuroLag/ 中的文件:

    文件 用途
    config.yml TPS 阈值、目标规则、按世界覆盖设置
    features.yml 切换和调整各项优化功能
    monitors.yml 仪表板、Web API、警报、Discord、审计日志
    systems.yml 同步、区域、预设、备份、验证器
  5. 运行 /nlag validate 以捕获配置错误。

  6. 运行 /nlag status 确认一切正常运行。

⚠️ 请勿使用 /reload。始终进行完整的服务器重启,或使用 /nlag reload 来应用 NeuroLag 相关的更改。


⌨️ 命令

命令 描述 权限
/nlag status 显示 TPS、CPU、堆内存、各世界状态及激活计数 neurolag.admin
/nlag graph ASCII TPS 历史图表(最近 60 个样本) neurolag.admin
/nlag toggle 暂停/恢复监控和生物优化 neurolag.admin
/nlag simulate <tps|clear> 强制设置 TPS 值以进行测试(0–20) neurolag.admin
/nlag dashboard [off] 显示/隐藏 BossBar 仪表板 neurolag.dashboard
/nlag audit 生成 HTML 审计报告 neurolag.audit
/nlag zone 显示已加载的保护区域 neurolag.zone
/nlag profile [name|clear] 切换或清除配置预设 neurolag.profile
/nlag validate 验证所有配置值并报告错误 neurolag.validate
/nlag backup 立即创建手动备份 ZIP 包 neurolag.backup
/nlag backup list 列出可用备份 neurolag.backup
/nlag backup restore [file] 从最新或指定名称的备份中恢复 neurolag.backup
/nlag stresstest [count] [min] 生成测试生物以进行负载测试 neurolag.stresstest
/nlag sync 显示多服务器对等节点的 TPS 状态 neurolag.admin
/nlag reload 热重载所有 NeuroLag 配置文件 neurolag.admin

别名:/neurolag, /nl, /neuromob


? 权限

权限 描述 默认值
neurolag.admin 完全控制;授予所有子命令权限 OP
neurolag.dashboard 使用 /nlag dashboard OP
neurolag.audit 使用 /nlag audit OP
neurolag.zone 使用 /nlag zone OP
neurolag.profile 使用 /nlag profile OP
neurolag.validate 使用 /nlag validate OP
neurolag.backup 使用 /nlag backup OP
neurolag.stresstest 使用 /nlag stresstest OP
neurolag.web Web 仪表板访问控制(Bukkit 外部) OP
neurolag.api 通过 NeuroLagAPI 读取插件指标 true

? 配置

NeuroLag 采用分离式配置布局。所有文件均位于 plugins/NeuroLag/ 目录下。

config.yml — 核心设置

settings:
  language: en                # en, vi, es, fr, de, ja, zh
  check-interval: 10          # 两次 TPS 采样之间的间隔(秒)
  enable-logging: true
  hysteresis-buffer: 0.5      # 状态恢复前的 TPS 间隙缓冲

tiers:
  medium:
    tps-trigger: 18.0
    range-multiplier: 0.5     # 在 MEDIUM 状态下将生物 FOLLOW_RANGE 缩放为 50%
  critical:
    tps-trigger: 15.0

targets:
  hostile-mobs: true
  passive-mobs: false
  water-mobs: true
  whitelist-types: [WARDEN, ELDER_GUARDIAN, ENDER_DRAGON, WITHER]
  protect-named-mobs: true
  protect-tamed-mobs: true

features.yml — 优化开关

culling:
  enabled: true
  max-entities-per-world: 500
  priority: "FAR_FROM_PLAYER"   # FAR_FROM_PLAYER | GROUP | RANDOM

chunk-ai:
  enabled: true
  distance-chunks: 4

tick-throttle:
  enabled: true
  ticks-per-ai-tick: 4

spawn-suppression:
  enabled: true
  monster-limit: 30
  animal-limit: 10

cpu-throttling: enabled: true cpu-threshold: 80 mode: THROTTLE_TASKS

memory-pressure: enabled: true percent: 0.80 # 堆内存使用率达 80% = 施加惩罚 offset: 0.5

smart-culling: enabled: true cull-in-groups: true min-type-before-cull: 2 removal-particle: POOF


### `monitors.yml` — 仪表盘与警报

```yaml
dashboard:
  enabled: true
  type: BOSSBAR
  update-interval: 2
  bossbar:
    name: "Server Health"
    color: BLUE

web-dashboard:
  enabled: true
  port: 8080
  auth:
    token: "change-this-token-now"
    require-auth: true
    allow-query-token: false    # 出于安全考虑请保持为 false

discord:
  enabled: false
  webhook-url: ""
  notify-on-critical: true
  notify-on-recovery: true

audit-reports:
  enabled: true
  generate-on: CRITICAL_EVENT
  output-format: HTML

systems.yml — 维护与同步

stress-test:
  enabled: false
  max-mob-count: 2000
  cooldown-seconds: 300
  max-mobs-per-chunk: 80          # 1.5.2 新增 —— 崩溃预防密度上限
  entity-types:
    - ZOMBIE
    - SKELETON
    - CREEPER

multi-server:
  enabled: false
  backend: REDIS              # REDIS 或 MYSQL

zone-protection:
  enabled: false
  integrate-worldguard: false
  zones:
    - "world 0 60 0 100 200 100"

config-profiles:
  enabled: true
  profiles:
    survival:
      critical-tps: 15.0
      medium-tps: 18.0
      max-entities: 500

auto-backup:
  enabled: true
  backup-interval-minutes: 60
  keep-backups: 10

? 安全性

自 1.9.0 版本起,仪表盘默认绑定到本地回环地址(loopback),使用恒定时间令牌比较,不再支持通配符 CORS,且在重载时不再泄露线程信息——详见更新日志。

Web 仪表盘加固 (v1.5.2)

NeuroLag 1.5.2 为 Web 仪表盘带来了三项安全改进:

功能 默认值 配置键
自动生成安全令牌 启用(每次调用 start() 时替换占位符,即使仪表盘已禁用) monitors.yml 中的 web-dashboard.auth.token
按 IP 限流 60 次请求/分钟 monitors.yml 中的 web-dashboard.rate-limit
IP 白名单 禁用 monitors.yml 中的 web-dashboard.ip-whitelist

在首次启动时,如果令牌仍然是 "change-this-token-now",NeuroLag 会自动生成一个密码学安全的随机令牌,将其保存到 monitors.yml(如果需要则创建该文件),并将其打印到控制台。请将其用作你的 Authorization: Bearer <token> 头部。

1.5.2 修复: 令牌生成现在在 enabled 检查之前运行,因此即使你设置了 web-dashboard.enabled: false,占位符也会被替换。以前,如果在初始设置后开启仪表盘,直到下次重启前默认令牌仍可能暴露。


? Web 仪表盘

内置的 HTTP 服务器提供了一个实时仪表盘和 JSON API。

路由:

路由 方法 描述
/ GET HTML 实时仪表盘(自动刷新)
/api/status GET JSON 指标快照
/api/cmd POST 受限的命令桥接

通过 /api/cmd 允许的指令: reload, status, graph, validate

网络: 服务器默认绑定到 127.0.0.1 (web-dashboard.bind-address)。如需远程访问,请在前面放置反向代理,或者明知风险地设置为 0.0.0.0。除非设置了 cors-allowed-origin,否则 CORS 处于关闭状态。

认证:

在浏览器中打开 http://host:8080/#token=<token> —— URL 片段永远不会发送给服务器或被记录。对于 API 调用,请始终使用 Authorization: Bearer <token> 请求头。?token=... 查询字符串回退方式默认禁用 (allow-query-token: false),因为 URL 中的令牌会出现在服务器访问日志和浏览器历史记录中。

# 正确做法
curl -H "Authorization: Bearer my-secret-token" http://localhost:8080/api/status

# 可行但不安全 —— 仅在 allow-query-token: true 时有效
curl "http://localhost:8080/api/status?token=my-secret-token"

⚠️ 请务必更改默认令牌,并且切勿在没有反向代理或防火墙规则的情况下将 Web 仪表盘端口公开暴露。


? 多服务器同步

在网络间共享 TPS 状态,使操作员可以从一个地方查看每个节点的健康状况。

Redis (推荐)

multi-server:
  enabled: true
  backend: REDIS
  cascade-warnings: true
  redis:
    host: localhost
    port: 6379
    password: ""

MySQL

multi-server:
  enabled: true
  backend: MYSQL
  mysql:
    host: localhost
    port: 3306
    database: neurolag
    user: root
    password: ""

使用 /nlag sync 查看实时对等体状态:

[NeuroLag] This server: MyServer_25565
  - LobbyServer_25565  →  19.8 TPS  [NORMAL]
  - SurvivalNode_25566 →  16.2 TPS  [MEDIUM]

v1.5.1: Redis 订阅者在重载时现在可以干净退出。MySQL 重连使用指数退避算法,以避免在数据库中断期间产生大量日志垃圾。


?️ 受保护区域

定义方块区域,在这些区域内生物永不被优化、限速或清除。

zone-protection:
  enabled: true
  integrate-worldguard: false   # 设置为 true 以同时保护 WorldGuard 区域
  zones:
    - "world 0 60 0 100 200 100"       # world minX minY minZ maxX maxY maxZ
    - "world_nether -50 0 -50 50 128 50"

受保护的生物始终拥有:

  • AI 启用
  • FOLLOW_RANGE 恢复至 Minecraft 默认值
  • 速度未冻结
  • 免疫智能清除

v1.5.1: FOLLOW_RANGE 现在会在每次优化传递时无条件地为受保护生物恢复,而不仅仅是当生物恰好重新进入区域时。


?️ 配置配置文件

在不编辑文件的情况下,在运行时切换命名预设。

config-profiles:
  enabled: true
  profiles:
    survival:
      critical-tps: 15.0
      medium-tps: 18.0
      max-entities: 500
    event:
      critical-tps: 14.0
      medium-tps: 17.0
      max-entities: 900
    minigame:
      critical-tps: 12.0
      medium-tps: 16.0
      max-entities: 1000
/nlag profile event     — 切换到事件配置
/nlag profile clear     — 返回基础配置
/nlag profile           — 显示所有配置 + 当前激活的配置

? 备份系统

自动备份会将所有 NeuroLag .yml 文件(包括 lang/ 目录)保存为带时间戳的 ZIP 压缩包。

auto-backup:
  enabled: true
  backup-interval-minutes: 60
  keep-backups: 10

备份存储在 plugins/NeuroLag/backups/ 中。

/nlag backup                                          — 立即创建
/nlag backup list                                     — 列出所有备份
/nlag backup restore                                  — 恢复最新的备份
/nlag backup restore config-bundle-2026-04-18_12-00-00.zip

v1.6.0 安全改进:

  • 每个备份 ZIP 都附带一个 .sha256 校验和文件。
  • 恢复时会先校验校验和,如果不匹配则中止并记录 SEVERE 日志。
  • Zip-bomb 保护:单个条目上限 10 MB,总恢复上限 50 MB。
  • 备份列表缓存于内存中;purgeOld() 使用基于文件名的排序——无需文件系统 stat 调用。

v1.5.1: lang/ 子目录已包含在所有备份包中,以便在恢复时不会丢失自定义语言文件。


? 开发者 API

// 获取 API 实例
NeuroLagAPI api = NeuroLagAPI.getInstance();

// 读取当前 TPS 和世界状态
double tps       = api.getCurrentTps();
String state     = api.getWorldState("world");     // "NORMAL" | "MEDIUM" | "CRITICAL"
boolean override = api.isManualOverride();

// 读取生命周期计数器
int critCount    = api.getCriticalActivationCount();
int medCount     = api.getMediumActivationCount();

通过插件消息通道 neurolag.api 订阅状态变更(需要目标玩家拥有设置为 true 的 neurolag.api 权限)。


? 故障排除

在出生点生成大量生物时压力测试导致服务器崩溃

已在 1.5.2 中修复。压力测试现在会在生成前检查出生点周围 7×7 区块网格内的每区块生物密度(默认 stress-test.max-mobs-per-chunk 为 80)。如果超出限制,数量会自动减少。请更新至 1.5.2。

启用 Web 仪表板后,Token 仍保持为默认占位符

已在 1.5.2 中修复。Token 生成现在在 enabled 检查之前运行,因此无论仪表板是否启动,占位符都会被替换。请更新至 1.5.2。

MySQL 日志刷屏:数据库中断期间,“连接丢失 — 正在重连”的消息充斥控制台

已在 1.5.2 中修复。重连日志消息现在使用与 SQL 错误相同的 2 的幂次间隔过滤器进行抑制(在第 1、2、4、8、16… 次间隔时记录)。请更新至 1.5.2。

当区域保护激活时,实体数量始终高于 maxEntities

已在 1.5.2 中修复。清除阶段现在在计算移除数量前先过滤受保护的生物,因此数学计算正确,即使部分生物受到区域保护,引擎也能收敛到目标实体数量。请更新至 1.5.2。

/nlag toggle 或 /nlag reload 后生物被冻结

已在 1.5.1 中修复。飞行中的批处理任务在 restoreAll() 运行后会重新应用 AI 限制。请更新至 1.5.1,问题即可解决。如果你运行的是 1.4.0,请触发完整的服务器重启作为临时解决方案。

即使在 NeuroLag 激活的情况下,高生物密度的服务器上 TPS 仍不断飙升

确保 collectTargets 缓存处于激活状态(1.5.1+)。在旧版本中,实体扫描会在每个刻运行。此外,请在 features.yml 中降低 check-interval 并减少 max-entities-per-world。

服务器恢复正常至 NORMAL 后,FOLLOW_RANGE 仍保持降低状态

已在 1.5.1 中修复。受保护区域的生物以及从非 NORMAL 状态恢复到 NORMAL 的世界中的生物,现在都会通过新的 restoreWorld() 调用将 FOLLOW_RANGE 重置为 Minecraft 默认值。

重载时 Redis/MySQL 异常充斥日志

已在 1.5.1 中修复。Redis 订阅者现在在池关闭前加入。MySQL 重连使用指数退避算法,因此错误仅在第 1、2、4、8、16… 次间隔时记录。

Web 仪表板 Token 出现在服务器访问日志中

设置 allow-query-token: false(1.5.1 中的默认值),并使用 Authorization: Bearer <token> 标头代替。

自定义语言文件在备份恢复后丢失

已在 1.5.1 中修复。备份包现在包含 lang/ 子目录。从 1.5.1 的备份中恢复以找回语言文件。

受保护区域内的生物被智能清除机制移除

已在 1.5.1 中修复。cull() 方法现在在移除任何生物之前会检查 zoneManager.isProtected()。请更新至 1.5.1。

完全没有进行任何优化
  1. 运行 /nlag validate — 查找配置错误。
  2. 运行 /nlag status — 检查 Override 是否显示为 OFF。
  3. 检查 config.yml 中的 ignored-worlds — 你的世界可能被排除在外。
  4. 使用 /nlag simulate 10 强制进入 CRITICAL 状态并验证生物是否有响应。
  5. 检查 config.yml 中的 targets — hostile-mobs 和 water-mobs 必须设为 true。
即使使用正确的 Token,Web 仪表板也返回 401 错误

确保你将 Token 发送在 Authorization 标头中,而不是查询字符串中(allow-query-token 默认为 false)。示例:

curl -H "Authorization: Bearer your-token-here" http://localhost:8080/api/status
/reload 破坏了插件

请使用 /nlag reload 而不是服务器级别的 /reload 命令。 服务器的 /reload 可能会在任何插件中留下悬空任务和损坏的事件注册。


❓ 常见问题

NeuroLag 会影响玩家行为吗?

不会。它仅修改非玩家生物(mob)的 AI 和行为属性值(FOLLOW_RANGE)。玩家、他们的物品以及能力均不受影响。

生物会永久冻结吗?

不会。当服务器返回 NORMAL 状态、插件被禁用,或使用 /nlag toggle 暂停监控时,NeuroLag 总会恢复完整的 AI 和默认属性。

是否支持多世界?

支持。每个世界都有独立的状态机进行跟踪。可以在 config.yml 下的 world-settings 中配置每个世界的 TPS 阈值。

是否支持 Folia?

不支持。NeuroLag 使用 Bukkit 调度器 API,这与 Folia 的区域级线程模型不兼容。未来版本计划支持 Folia。

可以与其他优化插件一起使用吗?

可以,但请确保剔除(culling)和禁用 AI 的设置之间没有冲突。NeuroLag 旨在与 Spark、ClearLag 和 Chunky 等插件共存。

如何确认它正在工作?

运行 /nlag status —— 你将看到当前的 TPS、CPU、堆内存、各世界状态以及累计激活次数。运行 /nlag simulate 10 强制进入 CRITICAL 状态,并实时观察生物的响应。

配置验证器是必须的吗?

不是必须的,但强烈建议启用。每次手动编辑配置后,请运行 /nlag validate,以便在引发运行时错误之前捕获类型不匹配、超出范围的值以及缺失字段。

执行 /nlag reload 后生物会发生什么?

从 1.5.1 版本开始:所有待处理的批处理任务将被取消,restoreAll() 将会运行(生物恢复完整 AI),然后所有服务将使用新配置重新启动。不会有生物停留在受限状态。


? 致谢

作者: Duong2012G 许可证: Apache 2.0 Modrinth:

开源 — 欢迎贡献。


? 更新日志

请参阅 CHANGELOG.md 获取完整的版本历史记录。

近期亮点:

  • 1.8.0 — 代码审计版本:修复了 7 个漏洞,完成了 2 项未完成的重构,移除了死代码。关键修复包括:RegionOptimizer 的热查找在动态扩容后失效(导致玩家旁边的生物冻结)、长时间运行的服务器上 pendingBatchTasks 的内存泄漏、AIThrottler 的单一职责原则(SRP)重构已完全集成、applyHotRegionDecay 并发修改问题、EventBus 错误记录到 System.err
  • 1.7.1 — 5 项针对性漏洞修复:安全模式下的 FOLLOW_RANGE 在每个 tick 中被静默覆盖、Slime/Bat 实体类型在 SafeModeOptimizer 中抛出 NullPointerException、restoreAI() 使用了硬编码的 FOLLOW_RANGE 表而忽略了自定义属性、HARD/EASY 难度缩放逻辑颠倒、Web 仪表板因扫描 IP 导致的速率限制映射内存泄漏
  • 1.7.0 — 重大架构重构:提取 MobCuller/AIThrottler/SpawnSuppressor 的单一职责原则(SRP)、引入 EventBus 模式、MobImportanceScorer、MobBehaviorGroups、动态区域大小调整、EWMA+LR 预测、基于注解的配置验证、配置迁移系统
  • 1.5.2 — 5 项针对性漏洞修复:plugin.yml 中的 api-version 错误、禁用时未生成 web token、受保护区域下剔除计数错误、AI 更新调度器饱和、密集刷怪区压力测试崩溃、MySQL 重连日志泛滥
  • 1.5.1 — 4 项严重 + 5 项高危漏洞修复:任务泄漏、生物冻结、实体扫描缓存、FOLLOW_RANGE 恢复、查询令牌安全性、Redis/MySQL 稳定性、区域剔除、语言包备份
  • 1.4.0 — 生命周期重构、区域保护、备份捆绑包、Web 身份验证改进
  • 1.3.0 — 预测调度器、区域管理器、Web 仪表板、多服务器同步、配置配置文件、备份系统、开发者 API

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源