Chunkmaster - 区块预生成插件

Chunkmaster 是一款用于预生成世界出生点周围区块的插件。它只会生成那些尚未被生成的区块，帮助服务器管理员提前准备地图区域，减少玩家探索时的卡顿。

💡功能特性

• 区域预生成：围绕世界中心预生成特定区域。
• 中心点配置：可配置不同世界的生成中心。
• Dynmap 集成：与 Dynmap 插件集成，自动渲染已生成区块并在地图上显示生成区域标记。
• 区块传送：可传送至指定的区块坐标。
• 自动暂停：当服务器有玩家在线时，可自动暂停生成任务以避免卡顿。
• 高度可配置：提供丰富的配置选项。
• 跳过已生成区块：自动检测并跳过已经生成的区块，提高效率。

🎮命令

所有功能均可通过 /chunkmaster 或其别名 /chm、chunkm、cmaster 访问。

• /chm generate [world] [radius] [<square|circle>]：开始生成，直到达到指定半径（以方块为单位）或世界边界。形状可选方形（square）或圆形（circle）。
• /chm list：列出所有正在运行的生成任务。
• /chm cancel <Task id|world>：取消指定 ID 或世界的生成任务。
• /chm pause：暂停所有生成任务。
• /chm resume：恢复所有已暂停的生成任务。
• /chm reload：重新加载配置文件。
• /chm tpchunk <X> <Z>：将你传送至指定的区块坐标。
• /chm setCenter [[<world>] <chunkX> <chunkZ>]：设置世界的中心区块。
• /chm getCenter [<world>]：返回指定世界的中心区块。
• /chm completed：按世界列出已完成的生成任务。

使用示例

• 生成一个以中心为原点，100x100 方块的方形区域：

/chm generate [world] 50

• 从中心向每个方向生成 200 方块：

/chm generate [world] 200

• 生成一个以中心为圆心，直径为 1000 的圆形区域：

/chm generate [world] 500 circle

🔧配置文件

# 语言设置。
# 内置支持德语 (de)、中文普通话 (zh)、法语 (fr) 和英语 (en)。
# 可在插件文件夹下的 i18n 目录中配置其他语言。
# 文件名必须为 <language>.i18n.properties 格式，内容需符合 Java 属性文件格式。
# 未定义的翻译将使用默认（英语）版本。
language: en

# 启用/禁用 dynmap 集成。
# 设置为 'true' 时，插件会尝试在卸载区块前触发其渲染。
# 同时会在 dynmap 上添加区域标记，显示即将预生成的区域。
# 任务完成或取消后，标记会自动移除。
dynmap: true

generation:
  # 如果设置为 true，插件将忽略原版世界边界，到达时不会停止区块生成。
  ignore-worldborder: false

  # 在卸载和保存之前，最多加载的区块数量。
  # 值越高，生成速度越快，但内存占用也越大。
  max-loaded-chunks: 1000

  # 仅 Paper 端有效
  # 使用 Paper 异步区块加载方法时，最大请求的区块数量。
  # 值越高，生成越快，但内存占用和性能影响也越大。设置过高可能导致服务器崩溃。
  max-pending-chunks: 500

  # 卸载已加载区块的周期（以游戏刻 tick 为单位）。
  # 卸载操作在主线程进行，可能影响服务器性能。
  # 你可以结合 max-loaded-chunks 设置来调整：要么一次卸载大量区块，要么更频繁地卸载少量区块。
  # 如果达到最大加载区块数，生成将暂停，直到卸载任务再次运行。
  unloading-period: 50

  # 在区块生成过程中，服务器每 tick 允许的最大毫秒数 (mspt)。
  # 如果 mspt 大于此值，区块生成任务将暂停。
  mspt-pause-threshold: 500

  # 当服务器在线玩家数量大于或等于设定值时，暂停生成。
  # 请注意，在持续生成区块的服务器上游玩可能会非常卡顿并导致崩溃。
  pause-on-player-count: 1

  # 是否在服务器启动时自动开始生成。
  autostart: true

✨兼容性与翻译

服务端支持

• 插件适用于 Spigot 和 Paper 服务端。
• 在 Paper 服务端上速度显著更快（因为它受益于异步区块加载和更好的 isChunkGenerated 方法实现）。

翻译贡献

• 中文翻译由 NPBeta 提供，由 ed3d3d 验证。
• 法语翻译由 Corenb 提供，由 Fiwel00 和 Youssef Habri 验证。
• 德语和英语翻译由插件作者提供。

你可以自行翻译插件，并通过向 GitHub 仓库提交 Pull Request 来添加你的翻译：

• 在 Chunkmaster 文件夹中创建 i18n 目录 (plugins/Chunkmaster)。
• 将默认翻译文件复制到新文件夹，并重命名为 <语言代码>.i18n.properties。
• 修改文件中的值为你的翻译（可以使用 Minecraft 的 § 格式代码）。
• 在配置文件中将 language 属性设置为你的语言缩写。
• 启动服务器。

现在，插件应该会使用你的翻译来显示本地化消息。

⭐Dynmap 集成

从 Beta 0.15 版本开始，如果检测到 Dynmap 插件，Chunkmaster 将与之集成。

• 它会为已生成的区块触发地图瓦片渲染。
• 在地图上将生成区域显示为标记。

注意事项

• Dynmap 的渲染过程比区块生成慢，因此区块生成完成后地图可能不会立即完全渲染。
• 你可以使用 /dynmap stats 检查有多少瓦片仍在等待处理。
• 如果没有待处理的区块而地图仍未完全渲染，你需要使用 /dynmap fullrender <world> 强制重新渲染整个地图。

❓问题与支持

• 漏洞报告或功能请求：请在 GitHub 上提交 Issue。
• 问题咨询：可以加入作者的 Discord 服务器 或通过邮箱 support[at]trivernis[dot]net 联系。

关于数据统计

• 本插件使用 bStats 来收集插件使用情况的匿名数据，以帮助改进。
• 你可以通过全局 bStats 配置文件选择退出数据收集。