====== 机器与资源世界 Mod 使用教程 ======

本文说明机械动力服务器使用的 ''Machine Resource Worlds'' 服务端 Mod。当前适配版本为 Minecraft ''1.21.1'' + NeoForge ''21.1.x''。

===== 功能概览 =====

该 Mod 提供两个服务器维度：

  * ''machine_resource_worlds:machine_world''：机器维度，超平坦世界。
  * ''machine_resource_worlds:resource_world''：资源世界，主世界地形生成，并按配置定时重置。

两个维度的共同规则：

  * 不自然刷怪。
  * 固定白天。
  * 不下雨、不打雷。
  * 不生成结构。

机器维度额外规则：

  * 玩家保持原游戏模式，不会切换创造模式。
  * 生存/冒险玩家可飞行。
  * 免疫掉落伤害。
  * 禁止 PVP。
  * 默认进入点会生成安全平台，避免卡进方块。

资源世界额外规则：

  * 地形按主世界样式生成。
  * 默认每天 00:00 自动热重置，不需要重启服务器。
  * 重置时会先把资源世界内玩家传回主世界，再清空资源世界区块数据。

===== 玩家命令 =====

进入机器维度：

<code text>
/mrw machine
/machineworld
</code>

进入资源世界：

<code text>
/mrw resource
/resourceworld
</code>

离开当前自定义维度，返回主世界：

<code text>
/mrw back
/mrw exit
/mrw leave
/exitworld
/leaveworld
/machineworld exit
/resourceworld exit
</code>

查看状态：

<code text>
/mrw status
</code>

===== 重置资源世界 =====

手动立即重置资源世界：

<code text>
/mrw reset now
/resourceworld reset
</code>

重置期间：

  * 资源世界里的玩家会被移动到主世界安全点。
  * 资源世界的区块、实体、POI 数据会被清空。
  * 下一次进入或加载区块时会重新生成资源世界地形。

如果更新 Mod 前资源世界已经生成过结构或怪物，旧区块内容不会自动消失。执行一次手动重置后，新生成的资源世界会按“不刷怪、白天、无结构”的规则重新生成。

===== 配置文件 =====

配置文件路径：

<code text>
config/machine-resource-worlds.properties
</code>

默认配置：

<code properties>
auto_reset_enabled=true
reset_hour=0
reset_minute=0
zone_id=system
chunks_per_tick=512
unload_wait_ticks=200
abort_if_loaded_chunks_remain=true
delete_dimension_data_storage=false
</code>

配置说明：

  * ''auto_reset_enabled''：是否启用每日自动重置。
  * ''reset_hour'' / ''reset_minute''：自动重置时间。
  * ''zone_id''：时区，''system'' 表示使用服务器系统时区。
  * ''chunks_per_tick''：每 tick 清理的区块记录数量，数值越大重置越快，但瞬时压力也越高。
  * ''unload_wait_ticks''：重置前等待资源世界区块卸载的时间。
  * ''abort_if_loaded_chunks_remain''：如果仍有区块被加载，是否中止重置。
  * ''delete_dimension_data_storage''：是否额外删除资源世界 data 目录。

重新加载配置：

<code text>
/mrw config reload
</code>

===== 安装说明 =====

将 Mod jar 放入服务器 ''mods'' 目录，然后启动服务器即可。

构建产物名称：

<code text>
machine_resource_worlds-1.0.0.jar
</code>

该 Mod 是服务端 Mod，主要逻辑都在服务器侧执行。

===== 注意事项 =====

  * 资源世界热重置会修改世界数据，正式服使用前建议备份。
  * 如果有其它 Mod 强制加载资源世界区块，自动重置可能会因为区块无法卸载而中止。
  * 第一次安装后，Mod 会记录当天日期，不会立刻补一次自动重置，会等到下一次配置的重置时间。