MinecartChunkLoader

插件

· 作者 UrLocalGooose

当矿车驶出已加载世界的边缘时,长铁轨线路会停滞。此插件可确保移动中的矿车周围的区块保持加载状态,使矿车自带其加载窗口。

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

最新 1.0.0 · 26.2 · Paper

一键开服(送7天)

MinecartChunkLoader

当矿车经过已加载世界的边缘时,长距离铁轨上的运行会停滞。此插件会使移动中的矿车周围的区块保持加载状态,从而让矿车自带其加载窗口。

停放的矿车不消耗资源。矿车后方的区块会自动卸载。

工作原理

每隔 scan-interval-ticks(扫描间隔刻),插件会在每个启用的世界中遍历已加载的矿车,并为每辆矿车周围的区块方块添加一个 Bukkit 插件区块票(plugin chunk ticket)。每张票都带有到期刻数,每次刷新时该刻数都会向后推移。停止刷新的票将过期,矿车后方的区块也会正常卸载。

由于持有票的区块会持续 ticking,矿车得以继续移动,进而标记下一个区块——加载窗口随矿车一同移动。

功能特性

  • 仅追踪实际在移动的矿车,并配有可配置的宽限期,以便矿车在车站或岔道暂停时不会立即导致其周围区块卸载。
  • 全局区块上限(max-loaded-chunks)。达到上限时,优先服务正在使用的矿车,然后才是各矿车附近的区块——这样即使失控的漏斗矿车农场也无法耗尽你的服务器性能。
  • 按世界启用/禁用列表。
  • 按变体过滤——可以追踪所有矿车,或仅追踪 CHEST_MINECART,或仅追踪有乘客的矿车。
  • 空服空闲——当 require-players-online 为 true 且无人在线时,跳过所有工作。
  • 所有内容均在主线程通过单个重复任务运行。不进行异步 Bukkit 访问。
  • 在 WorldUnloadEvent 时释放票证,因此插件永远不会阻塞世界卸载。
  • 无依赖项。

命令

命令 描述
/mcl status 已持有的区块、已追踪的矿车、当前设置、按世界分解统计
/mcl reload 重新读取 config.yml 并重启扫描任务

两者均需权限 minecartchunkloader.admin(默认:op)。完整命令名为 /minecartchunkloader。

配置

plugins/MinecartChunkLoader/config.yml:

键 默认值 备注
radius 2 每辆矿车的区块半径。2 = 5×5 方格 = 25 个区块。最大值为 16。
scan-interval-ticks 10 动力矿车在 10 刻内约移动 4 格,完全处于半径 2 的方格范围内。
keep-alive-ticks 100 最后一次刷新后,区块保持被票证锁定的时间长度。
require-moving true 设为 false 以永久加载所有矿车周围的区块。开销较大。
stationary-grace-ticks 60 静止的矿车仍被视为“移动”的时间长度。
movement-threshold 0.05 两次扫描之间需要移动多少格才算作发生了位移。
require-occupied false 仅追踪有乘客的矿车。
require-players-online true 在空服上跳过所有工作。
max-loaded-chunks 512 所有世界的全局上限。
minecart-types [] 空列表表示所有变体。例如 [MINECART, CHEST_MINECART]。
worlds.mode / worlds.list allow / [] allow = 仅列出中的世界;deny = 除列出中的世界外的所有世界。空列表 = 所有世界。
debug false 每次扫描时记录矿车和区块数量。

规模估算

最坏情况下的区块数为 活跃矿车数量 × (2 × radius + 1)²。使用默认值时,每辆矿车占用 25 个区块,因此 max-loaded-chunks: 512 可同时容纳约 20 辆矿车运行。如果你运行繁忙的铁轨网络,请提高上限或将 radius 降至 1(每辆矿车 9 个区块)。

安装

  1. 将 jar 文件放入服务器的 plugins/ 文件夹中。
  2. 重启服务器。默认配置文件将写入 plugins/MinecartChunkLoader/config.yml。
  3. 根据你的铁轨网络调整 radius 和 max-loaded-chunks,然后执行 /mcl reload。

兼容性

基于 Paper 26.2(paper-api:26.2.build.65-beta,Java 25)构建并测试。需要 Paper 或其分支——它使用 paper-plugin.yml 引导程序,因此不支持原版 Spigot/Bukkit。

不支持 Folia。 该插件使用单个全局重复任务,而非 Folia 的区域化调度器。

已验证行为

已在实时 Paper 26.2 服务器上测试:

  • 插件成功启用,api-version: 26.2 被接受。
  • 移动的矿车获取票证(半径 2 时一辆矿车对应 25 个区块)。
  • 矿车移动期间票证不断刷新,并在其停止后约 keep-alive-ticks 时间释放。
  • /mcl status 和 /mcl reload 在控制台和游戏内均可正常使用。
  • 安全停用,所有票证均已释放。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源