Optimizator

插件

· 作者 SerjTv

一个能安全优化你服务器的 Minecraft 插件

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

最新 1.0.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

Optimizator

适用于 Minecraft 1.16.5 至 1.21.11 的 Paper / Folia 服务器的轻量级优化插件。

单个 .jar 文件即可覆盖整个版本范围:该插件基于最旧的 API(1.16.5)编译,因此得益于 Bukkit API 向后兼容性,它也能在更高版本中加载。无需外部库依赖。

功能特性

  • 实体 (Entities) — 当设定半径内没有玩家时取消生物生成;移除区块溢出;每个被移除实体的区块限制;可选移除远处生物;受保护的类型列表。
  • 物品 (Items) — 移除陈旧掉落的物品(伴有玩家警告)并合并附近相同的物品堆叠。
  • 爆炸 (Explosions) — 可配置是否取消苦力怕、TNT 和凋灵的爆炸;设置允许爆炸的世界白名单。
  • 区块 (Chunks) — 定期追踪已加载的区块。
  • TPS 监控 — 监控 TPS 和内存,并在性能下降时发出警告。
  • 世界黑名单 — 完全禁用选定世界中的优化功能。
  • Folia — 安全的调度器:通过 GlobalRegionScheduler 执行全局任务,在玩家所在区域 (RegionScheduler) 处理区块工作,绝不触碰其他区域。
  • 全版本通用 JAR — 从 1.16.5 到 1.21.11 无需重新构建。
  • 统计与命令 — 提供计数器及支持 Tab 补全的 /optimizator 命令。
  • 热重载 — 使用 /optimizator reload 无需重启服务器即可应用更改。

游戏安全性

该插件设计为对玩家不可见:

  • 仅移除废弃的敌对生物。 移除操作仅应用于会自动消失的生物实体 (getRemoveWhenFarAway() == true)。动物、刷怪笼生成的生物以及持久性生物绝不会受到干扰。
  • 重要实体受保护。 以下实体永远不会被移除:玩家、驯服的宠物、命名过的生物、Boss(末影龙、凋灵)、列入 protected-types 的生物,以及正在承载他人或被骑乘的实体(包括由玩家骑乘)。
  • 安全半径。 在玩家周围 entity.safety-radius(默认 32 格)范围内,不会移除任何内容 — 战斗、农场和宠物均不受影响。
  • 生成取消不可察觉。 仅切断自然 (NATURAL) 生成,且仅在远离所有玩家的地方 — 即无人目睹的区域。
  • 物品不会丢失。 仅移除超过 item-lifetime 时长的物品(默认 600 秒;原版在 300 秒后移除)。拥有名称、描述或附魔的物品受保护 (protect-valuable)。物品合并不会删除任何东西 — 它仅合并相同的物品堆叠。
  • 爆炸默认不被取消 — 每个 cancel-* 选项均为 false。
  • 所有功能均可单独关闭。 任何部分都可以禁用,并且可以将世界添加到 disabled-worlds 中。

兼容性

服务器 版本 任务调度器
Paper / Spigot 1.16.5 – 1.21.11 BukkitScheduler
Folia 1.19.4 – 1.21.11 GlobalRegionScheduler / RegionScheduler

Folia 在 1.19.4 版本之前不存在,因此在 1.16.5 上插件以正常的 Paper/Spigot 模式运行,而在 Folia 上运行时区域模式会自动启用。


要求

  • 服务器: 支持版本的 Paper、Folia 或 Spigot。
  • Java: 构建需要 JDK 16+;运行时需要与您服务器匹配的 Java 版本(1.16.5 对应 Java 16,1.21+ 对应 Java 21)。

安装

  1. 构建插件(参见 构建)或直接获取现成的 Optimizator-1.0.0.jar。
  2. 将 Optimizator-1.0.0.jar 放入服务器的 plugins/ 文件夹。
  3. 启动服务器 — 将会创建 plugins/Optimizator/config.yml 文件。
  4. 根据您的需要编辑 config.yml。
  5. 使用 /optimizator reload 应用更改。

命令与权限

命令 描述
/optimizator reload 重新加载 config.yml 并重启任务
/optimizator stats 总体统计信息(MC 版本、TPS、内存、计数器)
/optimizator entity 实体统计信息
/optimizator items 物品统计信息
/optimizator chunk 区块统计信息
/optimizator explosion 爆炸统计信息
/optimizator tps 当前 TPS 和内存使用情况
/optimizator folia 检查服务器是否运行在 Folia 上
/optimizator reset 重置所有统计信息

该命令支持子命令的 Tab 补全(Tab)。

权限 描述 默认值
optimizator.admin 访问所有插件命令 op

配置

plugins/Optimizator/config.yml 文件:

# 控制台调试消息。
debug: false

# 完全禁用优化的世界(按世界名称)。
disabled-worlds: []

entity:
  optimization-enabled: true
  cancel-spawns: true        # 在远离玩家的地方取消自然生成
  mob-spawn-range: 48        # 玩家周围的生物生成半径(格)
  max-entities-per-chunk: 50 # 每个区块最多移除的生物数量
  max-living-per-chunk: 30   # 每个区块最多移除的生命体数量(0 = 关闭)
  remove-far-mobs: false     # 移除远离玩家的生物
  safety-radius: 32          # 距离玩家更近的任何东西都不会被移除
  protected-types:           # 永远不会被移除的类型
    - PLAYER
    - VILLAGER
    - WANDERING_TRADER
    - IRON_GOLEM
    - SNOWMAN
    - WOLF
    - CAT
    - PARROT
    - HORSE
    - DONKEY
    - MULE
    - LLAMA
    - TRADER_LLAMA
    - AXOLOTL
    - ALLAY

爆炸优化:
  启用优化: true
  取消苦力怕爆炸: false      # 取消苦力怕爆炸
  取消TNT爆炸: false          # 取消TNT爆炸
  取消凋灵爆炸: false       # 取消凋灵爆炸
  允许的世界: []         # 始终允许发生爆炸的世界

物品:
  清理已启用: true      # 移除旧的掉落物
  物品生命周期: 600         # 物品保留时间(秒)
  清理间隔: 60       # 检查间隔(秒)
  清理前警告: true  # 移除前向玩家发出警告
  警告延迟: 5              # 警告与移除之间的延迟(秒)
  保护贵重物品: true     # 不移除拥有名称/描述/附魔的物品
  合并物品: true          # 合并附近相同的物品
  合并半径: 1.5          # 合并半径(方块)

区块:
  启用优化: true
  自动保存间隔: 1200   # 区块追踪间隔(刻,1200 = 60 秒)
  保存非活跃区块: true

每秒刻数(TPS):
  监控已启用: true      # 追踪 TPS
  警告阈值: 15.0       # TPS 警告阈值
  检查间隔: 60         # 检查间隔(秒)

设置参考

设置项 类型 默认值 描述
debug 布尔 false 打印调试信息
disabled-worlds 列表 [] 完全禁用优化的世界
entity.optimization-enabled 布尔 true 实体优化
entity.cancel-spawns 布尔 true 在远离玩家的地方取消自然生成
entity.mob-spawn-range 整数 48 玩家周围的生物生成半径(方块)
entity.max-entities-per-chunk 整数 50 每个区块移除的生物上限
entity.max-living-per-chunk 整数 30 可移除的活体实体上限(0 = 关闭)
entity.remove-far-mobs 布尔 false 移除远离玩家的生物
entity.safety-radius 整数 32 永远不会移除距离玩家过近的实体(方块)
entity.protected-types 列表 见上文 永远不会被移除的类型
explosion.optimization-enabled 布尔 true 爆炸优化
explosion.cancel-creeper 布尔 false 取消苦力怕爆炸
explosion.cancel-tnt 布尔 false 取消 TNT 爆炸
explosion.cancel-wither 布尔 false 取消凋灵爆炸
explosion.allowed-worlds 列表 [] 始终允许发生爆炸的世界
items.cleanup-enabled 布尔 true 移除旧物品
items.item-lifetime 整数 600 物品保留时间(秒)
items.cleanup-interval 整数 60 检查间隔(秒)
items.warn-before-cleanup 布尔 true 移除前发出警告
items.warn-delay 整数 5 移除前的延迟(秒)
items.protect-valuable 布尔 true 不移除拥有名称/描述/附魔的物品
items.merge-items 布尔 true 合并附近物品
items.merge-radius 双精度浮点数 1.5 合并半径(方块)
chunk.optimization-enabled 布尔 true 区块追踪
chunk.auto-save-interval 整数 1200 区块追踪间隔(刻)
chunk.save-inactive-chunks 布尔 true 追踪非活跃区块
tps.monitor-enabled 布尔 true TPS 和内存监控
tps.warn-threshold 双精度浮点数 15.0 TPS 警告阈值
tps.check-interval 整数 60 TPS 检查间隔(秒)

工作原理

  • OptimizatorPlugin — 入口点:读取配置文件,连接管理器、命令,启动任务,并支持完整重载。
  • FoliaOptimizer — 中央调度器。检测 Folia 并通过 Folia 调度器或 BukkitScheduler 分发任务。返回 TaskHandle 以便在重载时干净地取消任务。
  • EntityOptimizer — 每 10 秒遍历区块,仅移除超出限制的“无人看管”敌对生物:它绝不会触碰宠物、命名生物、Boss、持久化生物或处于玩家 safety-radius 范围内的任何实体。在 Folia 上,它仅遍历玩家区域。
  • OptimizatorListener — 监听 CreatureSpawnEvent 并取消在远离玩家处的自然生物生成。
  • ExplosionOptimizer — 监听 ExplosionPrimeEvent 并取消选定的爆炸,尊重世界白名单。
  • ItemOptimizer — 清理旧物品(带有警告)并合并附近相同的物品堆。
  • ChunkOptimizer — 定期追踪加载的区块。
  • TPSMonitor — 测量 TPS(通过 Paper 的 getTPS() 或其自身的采样)和内存,当性能下降时记录警告。
  • ConfigManager — 加载、保存和重载设置。
  • ServerVersion — 检测和比较 Minecraft 版本。

所有重型处理均按计时器运行,且从不阻塞主线程刻。


Folia 支持

Folia 是一个独立的构建(Paper 的一个分支),具有区域多线程功能,自 1.19.4 起可用。

插件通过 io.papermc.paper.threadedregions.RegionizedServer 类来检测 Folia —— 该类仅存在于 Folia 中。通过 RegionScheduler 进行检测并不可靠:自 Paper 1.20 以来,该类也作为主线程包装器存在于常规 Paper 中,这将导致误判。

  • 全局任务(计时器)—— 通过 GlobalRegionScheduler。
  • 区块和实体工作 —— 在玩家所在区域通过 RegionScheduler 执行。
  • 跳过外部区域(Bukkit.isOwnedByCurrentRegion),因此实体访问始终是线程安全的。
  • 在常规 Paper/Spigot 上,所有内容均通过 BukkitScheduler 运行。

故障排除

插件未加载;日志显示 Unsupported class file major version。 服务器运行在较旧的 Java 版本上。对于 1.20.5+ 请使用 Java 21,对于 1.16.5–1.17 请使用 Java 16/17。插件兼容所有这些版本;关键在于服务器自身的 Java 版本。

任务未运行。 启用 debug: true,检查控制台,并确保相关部分(entity / items / chunk / tps)已启用,且该世界未列在 disabled-worlds 中。

附近持续生成生物。 仅当最近玩家距离超过 mob-spawn-range 时,才会取消 NATURAL(自然)原因的生成。降低该值可增强效果。

必要的物品/实体正在被移除。 增加 item-lifetime 的值,或从 entity.protected-types 中移除相应类型。对于物品,请禁用 items.cleanup-enabled。

物品移除消息刷屏。 禁用 items.warn-before-cleanup 或增加 items.cleanup-interval。

我想应用更改。 编辑 config.yml 后,运行 /optimizator reload —— 任务将重新启动。


更新日志

1.0.0

  • 适用于 Minecraft 1.16.5 – 1.21.11 的单个 JAR 文件。
  • 兼容 Folia 的计划任务系统:支持全局任务、区域任务以及无需重启服务器即可取消任务。
  • 玩法安全:仅移除废弃的敌对生物;保护宠物、命名生物、Boss 和持久化生物;围绕玩家设置安全半径 (entity.safety-radius)。
  • 物品优化:清理旧物品并合并邻近堆叠;保护贵重物品 (items.protect-valuable)。
  • TPS 与内存监控及警告功能。
  • 世界黑名单及用于爆炸的世界白名单。
  • 受保护的实体类型列表。
  • 每个区块被移除实体的数量限制。
  • 命令补全功能,包含 items、tps、reset 子命令。
  • 通过 /optimizator reload 完全重载配置。

许可证

本项目根据 MIT 许可证分发。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源