GlymeraChunkLoader

GlymeraChunkLoader – 保持区块活跃！

永久保持区块加载和运转，即使周围没有玩家。支持服务器重启后持久化。

---

什么是 GlymeraChunkLoader？

GlymeraChunkLoader 让服务器管理员可以强制加载特定区块，使它们在无玩家时依然保持活跃。加载的区块会持续运转——作物生长、红石触发、实体移动，所有行为都仿佛有玩家站在那里。

所有已配置的区块都会在服务器重启后保留，通过一个简单的 JSON 配置文件实现，该文件也可以手动编辑。

---

区块加载器方块（v4）

想让你的玩家自己保持区块加载——而无需给他们命令权限？放置区块加载器方块：一个石头底座上的小钟表，顶部带有状态指示灯。

• 点击一次 = 激活：指示灯变为绿色，该方块所在的区块保持加载并运转。再次点击：指示灯变为红色，区块恢复正常卸载。
• 故意不提供合成配方——使用 /cl give <玩家> 分发，或在你的服务器商店/经济插件中出售（物品 ID：Glymera_Chunk_Loader）。
• 所有者保护：只有放置者（或管理员）可以切换或破坏它。破坏它总会返还物品。
• 每个玩家限制：配置文件中的 maxLoadersPerPlayer（默认为 3，-1 = 无限制）。
• 重启安全：放置的加载器及其开/关状态在重启后保留。
• 外形匹配：碰撞箱和瞄准轮廓与实际钟表模型一致（半个方块宽，约 3/4 个方块高）——周围没有不可见的完整方块框。

---

命令

所有命令仅限管理员（普通玩家只使用方块）。

加载 & 卸载

/cl load [半径]  - 强制加载你当前所在的区块（半径 0-16，默认为 0）
/cl unload         - 释放你当前所在的区块

半径示例： /cl load 3 强制加载以你为中心的一个 7x7 区域（49 个区块）。

管理

/cl list           - 列出所有强制加载的区块（按世界分组）
/cl status         - 验证哪些区块当前实际已加载并正在运转
/cl reload         - 手动编辑后从磁盘重新加载配置

嘀嗒测试钟

/cl test           - 将附近的箱子标记为嘀嗒测试钟
/cl test off       - 停止嘀嗒测试

站在一个箱子旁边，运行 /cl test。插件将每 60 秒向箱子中添加 1 个岩石。走开，稍后再回来，数一数石头数——那就是在你离开期间该区块积极运转的总分钟数。

• 箱子满了？ 自动暂停，腾出空间后恢复。
• 箱子被破坏？ 测试自动停止。

---

配置文件

位置：plugins/GlymeraChunkLoader/config.json。可以手动编辑——使用 /cl reload 应用更改。

{
  "chunks": [
    {
      "world": "default",
      "x": -56,
      "z": 47
    },
    {
      "world": "plains_1",
      "x": 10,
      "z": -3
    }
  ]
}

每个条目指定世界名称和区块坐标（不是方块坐标）。完全支持来自不同世界的区块。

---

工作原理

• 使用 Hytale 原生的 WorldChunk.addKeepLoaded() API（引用计数，防止卸载）
• 维护任务每 5 秒运行一次，确保所有配置的区块保持加载并运转
• 设置 TICKING 标志并重置 keepAlive / activeTimer，以防止卸载系统驱逐区块
• 首次激活时通过 getChunkReferenceAsync() 异步加载区块
• 所有区块操作都在世界线程上运行，以确保线程安全
• 没有假玩家，没有网络开销——对性能的影响极小

---

安装

将 GlymeraChunkLoader-1.0.0.jar 放入服务器的 mods/ 文件夹并重启。无需资源包。

---

要求

• Hytale 服务器（任何版本）
• 使用命令需要管理员权限