LagXpert Free

插件

· 作者 KoyereDev

适用于所有服务器的模块化延迟管理方案。

0 本站下载 0 关注 更新于 2 个月前

最新 2.7 · 26.2 · Bukkit / Folia

一键开服(送7天)

LagXpert Free v2.7 — 自主优化器与卡顿诊断

LagXpert 是一款支持多平台(Folia/Paper/Spigot/Bukkit)并兼容基岩版的 Minecraft 服务器性能插件。它主要做两件事:随着负载变化自动进行优化,并告诉你服务器卡顿的原因和位置。


v2.7 更新内容

卡顿诊断

大多数性能插件只会告诉你 TPS。更难的问题是哪个区块正在拖我后腿。/lagxpert diagnose 命令可以回答这个问题。

  • 根据相对限制对区块进行排名,而非原始计数。 一个拥有 40 只生物但上限为 200 的区块是正常的。一个拥有 12 个漏斗但上限为 8 的区块才是问题所在。按原始计数排名会选出错误的区块。
  • 使用当前实际生效的限制,因此报告内容与玩家此刻的体验相符。
  • 统计干预历史。 如果一个区块在过去一小时内被插件清理过二十次,它的排名会高于那些仅仅只是“满”了的区块。
  • 用通俗语言解释原因。 无论是负载集中在少数区块还是遍布各处、哪种违规类型占主导、内存压力是否是真正的罪魁祸首、哪个世界承载了负载——以及当原因超出 LagXpert 的处理范围时,让你停止在错误的地方寻找。
  • 诊断卡顿不会造成卡顿。 区块快照在所属线程上获取;所有评分过程都在异步进行。结果会短暂缓存,以便同时执行的命令和 GUI 共享一次扫描。

交互式 GUI 提供五个屏幕:概览、分页的热点列表、带有传送按钮的单区块详细分析、纠正操作审计追踪以及历史趋势图。

优先适配基岩版的 GUI 渲染

此处的基岩版支持是结构性的,而非装饰性的。屏幕尺寸来自配置的安全尺寸,每个槽位的位置都基于该实际尺寸计算,因此不会放置任何基岩版客户端无法渲染的内容。Geyser 翻译效果不佳的材质会自动替换,lore(描述文本)会被截断,如果某个物品栏完全无法打开,完整报告将以聊天文本形式发送。

紧急控制器

一个具有迟滞效应以防止状态抖动的四级状态机(NORMAL → WARNING → CRITICAL → EMERGENCY)。每个状态应用分级且可配置的响应措施:生物上限降低、自然生成阻止、强制物品清理、激进区块卸载、AI 距离缩减、红石时钟关闭、全服 AI 冻结,以及可选的自定义命令。

在 v2.7 中,EMERGENCY 层级变得可达,且最后四项响应措施变为功能可用——此前它们虽然可配置和显示,但从未执行。

自适应阈值

每个区块的限制都会根据服务器健康状况进行缩放。结合了两个输入指标:来自 TPS 和内存的连续健康数据,以及离散的紧急状态。两者中更严格的那个胜出;它们永远不会相乘,否则会导致数值叠加到无法游玩的程度。限制只会向下缩放——你配置的值始终是上限——并设有一个可配置的下限。通过 lagxpert.limits.* 权限授予的玩家专属限制会原样保留。

优化配置文件

四种预设配置文件(relaxed, balanced, aggressive, performance),通过 /lagxpert profile <name> 应用。应用配置文件时会快照它所替代的值,因此 revert(恢复)命令能还原你的配置,而不是假设的默认值。auto-revert-minutes 用于防止在处理故障时应用了激进配置文件却忘记撤销的情况。


功能特性

自主优化

  • 具有分级状态响应的紧急控制器
  • 针对生物、存储、实体和红石的自适应限制
  • 智能调度器,根据状态和优先级调整任务间隔:低优先级任务在 WARNING 状态下暂停,紧急优先级任务运行速度最高提升 4 倍
  • 闭环机制:检测 → 行动 → 记录
  • 所有纠正操作的完整审计追踪,可在游戏内查询

诊断与监控

  • 带有通俗语言结论的排名区块热点分析
  • 带有传送至热点功能的交互式诊断 GUI
  • 1/5/15 分钟窗口内的 TPS、刻时间、卡顿尖峰检测
  • 性能历史记录,支持可配置的时间间隔和保留策略,持久化至磁盘
  • 每日最差时段检测、峰值玩家追踪、实体增长趋势

限制与清理

  • 针对生物、漏斗、箱子、熔炉、 barrels(木桶)、发射器、投掷器、潜影盒、TNT、活塞和观察者的单区块限制
  • 带有泛洪填充断路器的红石电路追踪
  • 带有警告和深渊回收系统的物品清理器
  • 实体清理:无效、重复、废弃、越界以及超过实体上限的区块中的实体
  • 智能移除生物,保护命名、驯服、拴绳、骑乘和装备了物品的实体
  • 生物 AI 优化器(基于距离和按类型)
  • 爆炸半径控制与连锁反应预防
  • 载具限制与废弃载具清理
  • 鞘翅速度限制与引雷冷却
  • 线程安全的控制台日志过滤器

管理

  • 交互式 GUI 配置(/lagxpertgui)
  • 按世界覆盖的配置
  • 覆盖所有子系统的热重载
  • bStats 指标集成

模块与配置文件

模块 配置文件 说明
General config.yml 模块开关、自适应阈值、操作日志、性能历史
Mobs mobs.yml 生物上限、AI 优化器、智能移除
Storage storage.yml 每个区块的方块上限
Redstone redstone.yml 电路追踪、泛洪填充破坏器
Alerts alerts.yml 通知开关、冷却时间、速率限制
Task Scanner task.yml 自动区块扫描间隔
Item Cleaner itemcleaner.yml 地面物品清理 + Abyss 恢复
Entity Cleanup entitycleanup.yml 实体移除目标、每区块实体上限
Monitoring monitoring.yml TPS、内存、区块、卡顿峰值阈值
Chunks chunks.yml 区块加载/卸载、预加载
Emergency Controller emergency-controller.yml 状态阈值、分级响应
Vehicles vehicles.yml 载具上限、废弃清理
Abilities abilities.yml 鞘翅速度、激流冷却
Explosions explosions.yml 爆炸半径、连锁反应预防
Console Filter console-filter.yml 控制台日志正则过滤器
Profiles profiles.yml 优化预设
Messages messages.yml 所有插件消息(i18n)

命令

命令 说明 权限
/lagxpert 主命令和帮助 lagxpert.use
/lagxpert diagnose [chat|refresh] 查找导致卡顿的原因及其位置 lagxpert.admin.diagnostics
/lagxpert status 性能仪表板 lagxpert.admin.status
/lagxpert optimize 完整优化流程,包含优化前后对比 lagxpert.admin.optimize
/lagxpert emergency [status|force-normal] 紧急状态控制 lagxpert.admin.emergency
/lagxpert profile [list|<name>|revert] 应用优化配置 lagxpert.admin.profile
/lagxpert reload 热重载所有配置和子系统 lagxpert.admin
/lagxpert inspect <x> <z> [world] 检查特定区块 lagxpert.admin
/lagxpertgui [open|diagnostics] 交互式图形界面 lagxpert.gui
/chunkstatus 当前区块使用信息 lagxpert.chunkstatus
/tps 服务器性能指标 lagxpert.tps
/abyss 恢复最近被清除的物品 lagxpert.abyss
/clearitems [all|world] 手动清理物品 lagxpert.clearitems

权限

lagxpert.admin 包含所有 lagxpert.admin.* 节点。更细粒度的节点允许为受限管理员授予单一能力,而不赋予其他权限——例如,仅拥有只读诊断功能,而无法重写配置文件或移除实体。

权限 默认值 说明
lagxpert.use true 基本命令访问权限
lagxpert.admin op 所有管理命令
lagxpert.admin.status op 只读性能仪表板
lagxpert.admin.diagnostics op 只读卡顿分析和诊断 GUI
lagxpert.admin.diagnostics.teleport op 从 GUI 传送至问题区块
lagxpert.admin.optimize op 运行优化(移除实体、卸载区块)
lagxpert.admin.emergency op 紧急控制,包括强制恢复正常
lagxpert.admin.profile op 应用配置(重写配置文件)
lagxpert.gui op GUI 访问权限
lagxpert.chunkstatus true 区块状态命令
lagxpert.tps true TPS 命令
lagxpert.abyss true 物品恢复
lagxpert.clearitems op 手动清理
lagxpert.emergency.notify op 接收紧急状态广播
lagxpert.monitoring.alerts op 接收性能警报
lagxpert.alerts.receive op 接收所有限制警报
lagxpert.bypass.mobs false 绕过生物上限和紧急生成阻止
lagxpert.bypass.redstone false 绕过红石控制
lagxpert.bypass.abilities false 绕过能力限制
lagxpert.bypass.* false 绕过所有限制
lagxpert.limits.mobs.<N> false 玩家或等级的自定义生物上限
lagxpert.limits.hoppers.<N> false 玩家或等级的自定义漏斗上限
lagxpert.notifications.mob-removal false 接收附近生物移除通知
lagxpert.console.view-filtered false 在聊天中接收被屏蔽的控制台消息

安装

  1. 将 LagXpert-2.7.jar 放入 plugins/ 目录
  2. 启动服务器以生成配置文件
  3. 运行 /lagxpert diagnose 查看服务器当前状态
  4. 根据需要调整 .yml 文件
  5. 执行 /lagxpert reload 无需重启即可应用更改

从 v2.6.x 升级

  1. 停止服务器并替换 jar 文件
  2. 重启服务器以生成 emergency-controller.yml 和 profiles.yml
  3. 现有配置保持兼容;新键使用安全默认值
  4. lagshield.yml 已不再使用,可以删除

要求

  • Java 11+
  • Minecraft 1.16+ (Spigot / Paper / Purpur / Folia)
  • 无必需依赖项。Geyser 和 Floodgate 是用于基岩版玩家检测的可选软依赖项。

开发者 API

// 响应区块过载
@EventHandler
public void onChunkOverload(ChunkOverloadEvent event) {
    event.getChunk();
    event.getCause();
}
// 统计区块内容
LagXpertAPI.countLivingEntitiesInChunk(chunk);
LagXpertAPI.countTileEntitiesInChunk(chunk, Material.HOPPER);
LagXpertAPI.countAllShulkerBoxesInChunk(chunk);

// 读取配置的限值
LagXpertAPI.getMobLimit();
LagXpertAPI.getHopperLimit();
LagXpertAPI.getLimitForMaterial(Material.HOPPER);   // 如果未管理则返回 -1

由于 v2.7 中的限值是动态的,LagXpertAPI 返回的是配置值。如需获取当前正在执行的限值,请通过自适应引擎:

AdaptiveThresholdEngine adaptive = AdaptiveThresholdEngine.getInstance();

```java
// 当前生效的限制,在生命值和紧急缩放之后
adaptive.getEffectiveMobLimit(world);
adaptive.getEffectiveLimit(LimitCategory.STORAGE, ConfigManager.getMaxHoppersPerChunk(world));
adaptive.isCurrentlyThrottling();
// 服务器状态、审计跟踪和历史记录
EmergencyController.getInstance().getCurrentState();
ActionLogger.getInstance().getRecent(50);
PerformanceHistory.getInstance().getEntityTrend(6);

// 诊断报告(回调在主线程上运行)
LagDiagnosticsEngine.getInstance().requestReport(false, report -> {
    if (report == null) return;              // 扫描已在运行中
    report.getTopChunks(10);
    report.getObservations();
});

按世界覆盖配置

将以其世界名称命名的文件放入 plugins/LagXpert/config/worlds/ 目录,以仅针对该世界覆盖全局设置。需要在 config.yml 中启用 per-world-settings.enabled: true。

支持的路径:

limits:
  mobs-per-chunk, hoppers-per-chunk, chests-per-chunk, furnaces-per-chunk,
  blast_furnaces-per-chunk, smokers-per-chunk, barrels-per-chunk,
  droppers-per-chunk, dispensers-per-chunk, shulker_boxes-per-chunk,
  tnt-per-chunk, pistons-per-chunk, observers-per-chunk

entity-cleanup:
  advanced:
    max-entities-per-chunk      # 该世界的实体总数上限

chunk-management:
  auto-unload:
    inactivity-threshold-minutes
  preload:
    enabled

monitoring:
  tps:
    alert-thresholds:
      warning, critical

任何未指定的值将回退到全局值。按世界设置的值在负载下仍会由自适应引擎进行缩放调整。

限制值为 0 表示“无限制”,而非“禁止”。 使用 1 可实现最严格的限制。


Folia 支持

Folia 将服务器划分为独立刻更新的区域,实体只能被拥有其所在区块的线程访问。LagXpert 尊重这一机制:所有读取或移除实体的操作都通过区域调度器按区块分发执行。这涵盖了物品清理器、实体清理、载具清理、按区块实体修剪、紧急 AI 冻结、诊断扫描以及快照和优化报告中的实体计数等功能。

在 Spigot 和 Paper 上,相同的分发机制会在多个刻中将区块分批处理,从而将一次长时间卡顿的刻拆分为多次短暂的刻。这一点至关重要,因为这些清理操作恰好是在服务器已经承受压力时运行的。

一个后果是,清理总数仅在清理扫描完成时才会返回,因此 /clearitems 和 /lagxpert optimize 会在命令完成时报告结果。


已知限制

  • 没有自动化测试套件;验证是针对构建产物手动执行的。
  • /lagxpert optimize 报告的 TPS 为滚动平均值,而非命令前后的差值,因为在该命令的执行期间平均值无法发生显著变化。

支持

Discord: bStats 插件 ID: 25746

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源