Distant Ticking

插件

· 作者 drizmans

模拟模拟距离之外的区块。高级区块加载器。

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

最新 1.0 · 1.21.6 · Paper

一键开服(送7天)

? 概览

DistantTicking 是一款强大的 PaperMC 插件,旨在提升服务器性能的同时,确保您的红石装置和自动化农场在玩家远离时也能持续运行。告别挂机农场和不合时宜的区块卸载!

传统上,Minecraft 仅在玩家的 simulation-distance(模拟距离)范围内“tick”区块。这意味着当玩家移动得太远或登出时,复杂的机器和农场的运作就会停止。DistantTicking 通过追踪精确位置来智能检测并永久加载包含玩家放置的“可 tick 方块”的区块,从而解决了这一问题。

适用对象

这不适用于大型服务器。它面向的是注重沉浸感、追求最大模拟距离的小型私人高端服务器。此插件允许您降低模拟距离。

例如,在我的服务器上,模拟距离为 16 时,每位玩家需要模拟大约 1089 个区块。 使用此插件后,仅有约 60 个区块处于加载状态。 由于模拟距离的重要性不再那么突出,我们将模拟距离降低到了 10。 这意味着每位玩家减少了约 648 个区块的模拟量 同时,由于作物、熔炉、带有箱子的区块等仍然处于加载状态,就体验而言,模拟距离实际上变得无限了。

这本质上是一个隐蔽的区块加载器。

✨ 功能

  • 智能区块加载: 通过追踪玩家放置方块的具体位置(如熔炉、漏斗、红石、活塞、铁轨),自动检测并强制加载区块。
  • 区块休眠: 在超过预设时间且没有在线玩家时,自动使区块进入休眠状态。
  • 持久 Tick: 确保您的机器、农场和红石装置全天候(24/7)持续工作,即使附近没有玩家或不在同一维度。
  • 性能优化: 允许服务器管理员在 server.properties 中降低全局 simulation-distance(例如降至 4-8),以获得更好的整体 TPS 并减少服务器负载,同时由 DistantTicking 管理关键的 tick 区域。
  • 可配置的 Tick 方块: 直接在 config.yml 中轻松自定义哪些方块材料会触发区块加载。
  • 自我修复数据: 使用中央索引与每个区块的持久化数据容器(PDC)相结合的混合方法实现稳健的数据持久性。能够从意外删除数据文件或服务器崩溃中优雅恢复。
  • 定期一致性检查: 如果方块被移除而未通过插件正确通知(例如使用世界编辑工具、服务器崩溃),则自动清理过期的强制加载条目。
  • 管理命令: 提供直观的命令用于监控插件状态、列出强制加载的区块、刷新区块数据以及调试。
  • 旧数据清理工具: 一个特定命令,用于移除来自以前插件版本的 PDC 中存储的旧版 tick 方块数据。
  • 调试日志: 特定的调试模式,可提供详细的插件日志,而不会淹没整个服务器控制台。

⚙️ 工作原理

DistantTicking 采用混合数据存储模型:

  1. 区块数据 (PDC): 当玩家放置一个可配置的“可 tick 方块”时,插件会使用 Minecraft 内置的持久化数据容器(PDCs)标记该区块的数据。现在它不仅仅存储计数,而是存储该区块内每个可 tick 方块的具体 X, Y, Z 坐标。这些数据被序列化为 JSON 字符串并直接存储在区块文件中,即使主插件数据文件丢失,数据也会保留。
  2. 集中式索引 (active_chunks.json): 一个轻量级的 JSON 文件维护着当前跨所有世界由插件强制加载的所有区块列表。该文件在服务器启动时加载,以立即启动所有相关区块的强制加载。
  3. 同步机制:
    • 当玩家放置一个可 tick 方块时,其所在的区块会被添加到集中式索引并强制加载 (如果是该区块中的第一个可 tick 方块)。
    • 当玩家破坏(或方块被摧毁)一个可 tick 方块时,其位置会从该区块的 PDC 中移除。如果在移除后 该区块的 PDC 中不再有任何可 tick 方块,则将其从集中式索引中移除并取消强制加载。
    • 定期的后台任务会验证集中式索引中的区块在其 PDC 中是否仍有对应的可 tick 方块。如果区块的 PDC 显示没有存储的方块位置,则该条目将从集中式索引中移除,确保从数据不一致中“自我修复”。

这种方法提供了精确的追踪、可靠的持久性以及高效的资源管理。

已知问题

  • 如果您追踪作物,当您踩踏它们时,插件可能无法检测到它们被破坏。但是,一致性检查最终会发现这一点。

? 安装

  1. 下载最新的 DistantTicking-X.Y.Z.jar。
  2. 将 DistantTicking-X.Y.Z.jar 文件放入服务器的 plugins/ 文件夹中。
  3. 重启您的 PaperMC 服务器。
  4. 将在您的 plugins/ 目录中创建一个 DistantTicking 文件夹,其中包含 config.yml 和 active_chunks.json。
  5. 重要!如果您将此插件添加到现有世界,您需要运行 /dt refresh <chunk radius> <vertical-up> <vertical-down> 来为现有方块填充基于新位置跟踪的数据。我建议以精准的方式执行此操作,使用较低的区块半径和适当的垂直限制,因为扫描大量区块或大垂直范围可能会很慢。

    更新后您可能需要运行 /dt cleanup,以防我更改了任何内容。

?️ 配置 (config.yml)

config.yml 文件会在首次运行时自动生成。您可以在此自定义插件的行为。

# DistantTicking Plugin Configuration

settings:
  # 自动将强制加载的区块数据保存到 active_chunks.json 的时间间隔。
  # 单位为分钟。(20 ticks = 1 second)
  auto-save-interval-minutes: 5 # 默认值: 5

# 周期性一致性检查的时间间隔。
# 此检查用于验证标记为强制加载的区块在其 PDC(持久数据组件)中是否仍包含需要刻更新的方块。
# 单位为小时。
consistency-check-interval-hours: 6 # 默认值:6

# 启用调试模式以输出更详细的控制台日志。
# 设置为 'true' 可查看插件的详细活动(例如,各个区块的加载/卸载情况)。
# 这些日志*仅*针对 DistantTicking,不会让其他插件的调试消息淹没你的控制台。
debug-mode: false # 默认值:false

# 服务器休眠功能的设置。
# 当服务器为空时,插件可以卸载所有区块以节省资源。
hibernation:
  # 设置为 true 以启用此功能。
  enabled: true
  # 服务器必须保持空载状态多长时间后才会卸载区块。
  # 单位为分钟。
  unload-delay-minutes: 60
  # 当玩家加入空服务器时,每次重新加载多少个区块。
  # 数值越高,重新加载速度越快,但可能导致更多的卡顿。
  reload-chunks-per-batch: 5
  # 每隔多少刻处理一批区块进行重新加载。20 刻 = 1 秒。
  # 值为 5 表示每 5 刻重新加载一批区块。
  reload-stagger-ticks: 5

# 列出当玩家放置时应使其所在区块变为“需要刻更新”并强制加载的材料。
# 确保材料名称是有效的 Minecraft Material 枚举值(插件内不区分大小写,但建议使用大写以提高清晰度)。
#
# 重要提示:即使是非实体方块(如红石粉、中继器、活塞)也会导致区块保持加载状态,
# 如果它们属于活跃的红石电路的一部分,则允许其持续运行。
#
tick-worthy-blocks:
  - Blocks you want to tick
# 给服务器拥有者的建议:
# 为了获得最佳性能,请考虑将 server.properties 中的 'simulation-distance'(模拟距离)
# 降低到类似 4-8 的值。这允许 DistantTicking 为你的机器管理持续的刻更新,
# 同时显著减少服务器 CPU 在没有关键机械装置区域上的负载。

? 命令

所有命令均以 /dt(或 /distantticking)开头。

命令 描述 权限
/dt help 显示插件的帮助信息。 distantticking.command.base
/dt pdcinfo 显示你当前区块中具有可计时特性的方块(来自 PDC)的数量。 distantticking.command.pdcinfo

| /dt status | 显示 DistantTicking 插件的当前状态。 | distantticking.command.status | | /dt list [page] | 列出插件当前强制加载的所有区块,支持分页。 | distantticking.command.list | | /dt removehere | 从强制加载列表中移除你当前所在的区块。 | distantticking.command.removehere | | /dt reload | 重新加载插件的 config.yml 并重启内部任务。 | distantticking.command.reload |

| /dt refresh <半径> <垂直向上> <垂直向下> | 扫描由 <radius> 参数定义的方块区域,并通过垂直向上和向下的参数进行限制,以防止检测到不需要的地图结构(例如矿洞)。 | distantticking.command.refresh |

| /dt cleanup | 清理在追踪功能按区块区分之前使用的旧 PDC 键值。 | distantticking.command.cleanup | | /dt check | 执行一致性检查并告知运行所花费的时间。此命令更适合作为性能分析工具,而非日常使用,因为这些检查会自动运行。 | distantticking.command.cleanup |

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源