XPMerge

插件

· 作者 MooshFR

这是一个兼容 Folia 的 Minecraft 插件,通过将附近的经验球合并为一个来减少延迟。

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

最新 1.0.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

✨ XpMerge

更少的经验球。更高的帧率。相同的经验值。
自动将附近分散的经验球合并为一个——静默、安全,且绝不会导致掉落物复制。


? 概述

XpMerge 是一款轻量级的原生 Folia 经验球合并插件,专为注重性能的服务端设计。在每一个配置的时间间隔内,它会扫描所有已加载的区块,查找紧密聚集的经验球簇,并将它们坍缩为单个经验球——不丢失任何经验值,没有漏洞,也没有麻烦。

大型怪物农场、经验磨坊和附魔装置可以在几秒钟内生成数百个经验球。XpMerge 通过减少实体数量从根源上消除这种卡顿,而不会触碰收集逻辑。玩家永远不会察觉它的运行——他们只会觉得服务器变得更流畅了。


✨ 特性

  • ? 基于时间间隔的扫描 — 合并操作按照可配置的刻数计划执行,而非每一帧都触发
  • ? 基于半径的聚类 — 设定方块半径内的经验球会坍缩为一个,同时保留总经验值
  • ? Folia 原生线程支持 — 使用 RegionScheduler 处理每个 8×8 区块区域,意味着所有的实体读取和写入都在正确的区域线程上进行,零不安全跨区域访问
  • ? 防复制设计 — 在移除前立即重新验证经验球,以处理扫描过程中因收集事件导致的竞态条件
  • ? 多世界支持 — 同时扫描所有已加载的世界
  • ?️ 热重载 — 通过 /xpmerge reload 在不重启服务器的情况下更新配置
  • ? 状态命令 — 一目了然地检查当前设置和终身合并计数
  • ? 调试模式 — 可选的每次合并控制台日志记录用于诊断,默认关闭

? 防复制安全性与瓶装经验兼容性

XpMerge 针对那些能够装瓶、提取或以其他方式操纵经验球实体的插件进行了严格测试——这类插件在与经验球合并结合使用时特别容易受到复制漏洞的影响。

关键的安全措施是:XpMerge 在移除之前会立即重新验证每一个经验球。 如果在扫描期间到合并执行之间,玩家或插件已经收集了某个经验球,则该经验球将被完全跳过。经验值不会被重复计算或发放两次。

已与以下插件测试并确认无复制漏洞:

插件 仓库
Experience Manager (XPM) by FruitLoopin github.com/jwkerr/XPManager
BottleEXP by Mooshlol304 github.com/Mooshlol304/BottleEXP-1.21.5
XP Bottling by HoneyBerries github.com/HoneyBerries/XPBottling

经验值在内部作为 long 类型累积,然后再写回为 int 类型,从而防止在大经验球簇情况下出现溢出边缘情况。最终值被钳制在 Integer.MAX_VALUE 作为硬性上限。


?️ 兼容性

平台 支持版本
Paper 1.21.10 — 1.21.11 (广泛支持 1.21.x)
Folia 1.21.10 — 1.21.11 (原生线程支持)

⚠️ 不支持 Spigot/Bukkit。必须使用 Paper 或 Folia。
Folia 支持是一等公民——扫描架构是从底层围绕 RegionScheduler 设计的,而不是事后附加的。


? 命令与权限

命令 描述 权限
/xpmerge status 显示当前间隔、半径、调试状态以及合并的经验球总数 xpmerge.admin
/xpmerge reload 热重载配置并重新启动合并任务 xpmerge.admin

xpmerge.admin 默认仅允许 OP(管理员) 使用。


⚙️ 配置

配置文件位于:

plugins/XpMerge/config.yml

以下是完整的默认配置:

# 每次合并扫描之间的刻数。20 刻 = 1 秒。
# 数值越低 = 合并越激进,CPU 占用略高。最小值:1。
merge-interval: 5

# 经验球合并在一起的方块半径。
# 在此距离内的所有经验球都会坍缩为一个。
merge-radius: 20.00

# 每次合并经验球时在控制台打印一行。生产环境请关闭。
debug: false

配置详解

  • merge-interval — 扫描触发的频率,单位为刻。5 = 每四分之一秒一次。较低的数值会以略微增加 CPU 开销为代价进行更激进的合并。硬性最小值为 1。
  • merge-radius — 用于聚类附近经验球的方块半径。20.0 覆盖范围很广,非常适合大型农场和高密度经验设置。
  • debug — 启用时,会将每次单独的合并记录到控制台,包括位置、经验球数量和总经验值。适用于测试——在生产环境中请保持关闭。

? 安装

  1. 从发布页面下载最新的 .jar 文件
  2. 将其放入你的 /plugins 文件夹
  3. 重启服务器 (不要使用 /reload)
  4. 根据需要编辑 plugins/XpMerge/config.yml
  5. 使用 /xpmerge reload 实时应用配置更改

? 许可证

XpMerge 是开源的,并根据 MIT 许可证 分发。
欢迎在项目仓库中提交贡献、问题报告和拉取请求。


专为那些不想在经验农场和良好性能之间做出选择的服务端构建。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源