DynamicMobLimiter

插件

· 作者 crqzycat

根据服务器的 TPS 动态限制自然生成的怪物数量——在服务器负载较高时保持流畅运行,而在 TPS 正常时无任何影响。

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

最新 1.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

DynamicMobLimiter

自动、基于 TPS 感知的生物生成节流,适用于 Paper 服务器。

DynamicMobLimiter 实时监控服务器的性能,并在 TPS 开始下降时动态降低自然生物生成速率——一旦性能恢复,它会自动恢复正常生成速率。无需手动干预,无需永久性的生成上限,不浪费任何潜力。

✨ 特性

  • 实时 TPS 监控 — 使用 Paper 内置的 1 分钟平均 TPS,按可配置的间隔进行检查。
  • 阶梯式节流 — 定义多个 TPS 阈值,每个阈值对应各自的允许生成百分比(例如 75%、50%、20%、0%)。
  • 自动恢复 — 只要 TPS 回升到阈值以上,生成速率就会自动恢复到 100%。
  • 选择性生成原因 — 精确选择受影响的生成原因(NATURAL、CHUNK_GEN、BREEDING、EGG 等)。
  • 生物白名单 — 豁免特定实体(例如 WITHER、ENDER_DRAGON),确保 Boss 战斗和重要生成不会被阻止。
  • 为性能而生 — 生成处理程序运行时间为 O(1):两次集合查找、一次易失性读取,最多一次随机判定。无 Bukkit API 调用,无内存分配,热路径中无异步跳跃。
  • 管理员命令 — /dml status 显示当前 TPS 和当前生成速率;/dml reload 在不重启的情况下重新加载配置。

⚙️ 工作原理

  1. 每隔 check-interval-seconds 秒,插件读取服务器的 1 分钟平均 TPS。
  2. 如果 TPS 高于 min-tps-threshold,生成以 100% 运行——插件不做任何操作。
  3. 如果 TPS 低于 阈值,插件会查找你配置的节流步骤并应用匹配的生成百分比。
  4. 每个具有已配置生成原因的 CreatureSpawnEvent 都有机会(等于该百分比)继续执行——否则将在生物生成前被取消。

?️ 配置

settings:
  check-interval-seconds: 5
  min-tps-threshold: 18.0

tps-throttling-steps:
  19.0: 1.0   # 100% 生成(正常)
  18.0: 0.75  # 允许 75%
  17.0: 0.50  # 允许 50%
  16.0: 0.20  # 允许 20%
  15.0: 0.00  # 停止生成

affected-spawn-reasons:
  - NATURAL
  - CHUNK_GEN
  - BREEDING
  - EGG

whitelist-mobs:
  - WITHER
  - ENDER_DRAGON

? 命令与权限

命令 权限 描述
/dml status dynamicmoblimiter.status 显示当前 TPS、活动生成速率和配置的步骤
/dml reload dynamicmoblimiter.reload 在不重启的情况下重新加载 config.yml

两者默认均为:op

? 要求

  • Paper(或 Paper-fork)1.20+
  • Java 21+

? 问题与建议

发现错误或有新功能想法?在 GitHub 仓库 上提交 Issue。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源