如何使用 Chunky 预生成 Minecraft 世界
在 Paper 上使用 Chunky 预生成 Minecraft 世界,然后用世界边界加以限制:范围大小、进度跟踪、停止后继续、回退和故障排除。
本页内容
玩家探索新区域时,服务器必须在游戏过程中生成地形,这常常导致卡顿。Chunky 可以提前生成这些地形,之后再用世界边界阻止玩家离开已准备好的区域。
本指南是在 Paper 上安装和更新插件的延续,沿用其中的 /opt/minecraft/server 文件夹、minecraft.service 服务和 mc-console 命令。
完成本指南后,您将拥有:
- 在选定范围内完成预生成的三个维度
- 每个维度中都已设置好的世界边界
- 一套跟踪、中断和继续生成任务的方法
前提条件
- 一台带有
mc-console的 Paper 服务器,已按照 Paper 指南安装 - 已安装 Chunky。该指南的从 Hangar 安装一节正是以此插件为例
- 使用具有
sudo权限的用户进行 SSH 访问 - 足够的可用磁盘空间,用于存放生成的世界和一份备份
确认 Chunky 已加载:
sudo mc-console plugins选择范围大小
Chunky 以中心点为基准,使用以方块为单位的半径。而 worldborder 命令需要的是直径,即半径的两倍。
| 半径 | 世界边界(直径) | 需处理的区块数(约) |
|---|---|---|
| 1,000 | 2,000 | 16,000 |
| 2,500 | 5,000 | 99,000 |
| 5,000 | 10,000 | 393,000 |
| 10,000 | 20,000 | 1,565,000 |
请从小范围开始:之后可以再扩大,Chunky 会跳过已生成的区块。本指南在主世界使用 5000 的半径,在下界和末地使用 2500。请根据您的磁盘和处理器调整这些数值。
另外请在边界之外多生成 200 格的余量。贴着边界的玩家仍会加载边界另一侧渲染距离范围内的区块:view-distance=10 时相当于 160 格。
备份服务器
停止服务器,检查可用空间并创建归档:
sudo systemctl stop minecraft.service
sudo du -sh /opt/minecraft/server
df -h /opt/minecraft
sudo mkdir -p /opt/minecraft/backups
sudo tar -czf /opt/minecraft/backups/avant-chunky-$(date +%F-%H%M).tar.gz -C /opt/minecraft server
sudo ls -lh /opt/minecraft/backups
sudo systemctl start minecraft.service继续之前,请等待服务器准备就绪:
sudo journalctl -u minecraft.service -f出现 Done 这一行后,按 Ctrl+C 退出日志跟踪。
检查中心点和当前边界
查询主世界的出生点和边界状态:
sudo mc-console chunky world minecraft:overworld
sudo mc-console chunky spawn
sudo mc-console worldborder get第二条命令会显示 Center changed to X, Z。请记下这些数值:本指南写作 0 0,请替换为您自己的数值,使区域以出生点为中心。
默认的世界边界为 59999968 格。如果您的边界小于计划的区域,请出于上述原因在生成之前将其扩大。
开始预生成
如有可能,请在没有玩家在线时进行生成,并暂时停用 Dynmap 或 BlueMap 等地图插件。先降低消息频率,默认为每秒一行:
sudo mc-console chunky quiet 30
sudo mc-console chunky start minecraft:overworld square 0 0 5200参数依次为:世界、形状、中心点的 X 和 Z,以及半径。日志应显示 Task started in minecraft:overworld。
跟踪进度:
sudo journalctl -u minecraft.service -f | grep --line-buffered Chunky每一行都会显示已处理的区块数、百分比、预计剩余时间以及每秒处理的区块数。按 Ctrl+C 退出跟踪:生成会继续进行。您也可以随时查询状态:
sudo mc-console chunky progress在最初的几个百分点期间请留意磁盘,之后也要不时查看:
df -h /opt/minecraft
sudo du -sh /opt/minecraft/server/world生成下界和末地
当出现 Task finished for minecraft:overworld 这一行时,依次启动其他维度:
sudo mc-console chunky start minecraft:the_nether square 0 0 2700sudo mc-console chunky start minecraft:the_end square 0 0 2700中断和继续
| 操作 | 命令 |
|---|---|
| 暂停并保存进度 | sudo mc-console chunky pause |
| 继续 | sudo mc-console chunky continue |
| 查看进度 | sudo mc-console chunky progress |
| 永久取消 | sudo mc-console chunky cancel,然后 sudo mc-console chunky confirm |
正常停止服务器会保存进度,但任务不会自动恢复。请在重启后输入 chunky continue,或启用自动继续:
sudo -u minecraft sed -i 's/^continue-on-restart: .*/continue-on-restart: true/' /opt/minecraft/server/plugins/Chunky/config.yml
sudo mc-console chunky reload取消任务不会删除已生成的区块。
设置世界边界
所有任务完成后,设置世界边界。从控制台执行时,命令作用于主世界:
sudo mc-console worldborder center 0 0
sudo mc-console worldborder set 10000每个维度都有自己的边界,因此另外两个维度需通过 execute in 设置:
sudo mc-console execute in minecraft:the_nether run worldborder center 0 0
sudo mc-console execute in minecraft:the_nether run worldborder set 5000
sudo mc-console execute in minecraft:the_end run worldborder center 0 0
sudo mc-console execute in minecraft:the_end run worldborder set 5000如果您的世界已有边界,chunky worldborder 会直接将其中心和半径用于下一个任务。ChunkyBorder 模块则支持圆形或其他形状的边界。
验证结果
sudo mc-console chunky progress
sudo mc-console worldborder get
sudo mc-console execute in minecraft:the_nether run worldborder get
sudo mc-console execute in minecraft:the_end run worldborder get
sudo du -sh /opt/minecraft/server/world您应该看到 No tasks running,然后主世界显示 The world border is currently 10000 block(s) wide,另外两个维度显示 5000。接着登录游戏并靠近边界:地形应流畅显示而不卡顿,日志中也不应频繁出现 Can't keep up! 消息。
回退
要移除世界边界,请将其恢复为默认大小:
sudo mc-console worldborder set 59999968要将世界恢复原样,请恢复开始时创建的归档。将文件名替换为 ls 显示的名称:
sudo systemctl stop minecraft.service
sudo ls -lh /opt/minecraft/backups
sudo mv /opt/minecraft/server /opt/minecraft/server-echec
sudo tar -xzf /opt/minecraft/backups/avant-chunky-YYYY-MM-DD-HHMM.tar.gz -C /opt/minecraft
sudo systemctl start minecraft.service此操作会清除备份之后建造的所有内容。如果玩家在此期间继续游戏,您也可以改用 chunky trim minecraft:overworld square 0 0 5200,然后执行 chunky confirm,删除区域外的区块。此删除操作不可逆:请事先重新备份,并在完成后彻底重启服务器。
故障排除
sudo journalctl -u minecraft.service -n 200 --no-pager | grep -iE 'chunky|error|exception'“World minecraft:the_nether not found. Available worlds: …”
该世界未加载,或其名称不同。请使用所显示列表中的名称。如果缺少下界或末地,请检查 server.properties 中的 allow-nether 和 bukkit.yml 中的 allow-end。
“Task already started for …”
该世界中已有任务在运行。请使用 chunky progress 跟踪它;如果要更换区域,可以取消它。
“A task was already started for this world”
已保存了一个被中断的任务。输入 chunky continue 可继续该任务,输入 chunky confirm 则用新任务替换它。
“No tasks to continue.”
没有已保存的任务,之前的任务已完成或已取消。请确认所需的范围,然后重新运行 chunky start:已存在的区块会被跳过。
生成缓慢或服务器卡顿
- 大量生成期间经常出现
Can't keep up!消息。有玩家在线时请暂停生成 - 速度主要取决于处理器、磁盘和内存。Chunky 建议使用 SSD 和至少 4 GB 内存
- 请在不加载非必要插件和数据包的情况下测试:其中一些会减慢甚至阻塞生成
“OutOfMemoryError: Java heap space”
服务器内存不足。请在 /etc/systemd/system/minecraft.service 的 ExecStart 行中增大 -Xmx,但不要超过可用内存,然后应用更改并继续任务:
sudo systemctl daemon-reload
sudo systemctl restart minecraft.service等待出现 Done 这一行,然后运行 sudo mc-console chunky continue。
“No space left on device”
磁盘已满。请停止服务器并释放空间,然后在重启时检查世界。如果日志报告区块损坏,请恢复备份。
已生成的区域内没有动物
该区域是在世界边界或 max-world-size 较小时生成的。请恢复备份,或使用 chunky trim 删除这些区块,并在边界足够大的情况下重新生成。
如需进一步了解,请查阅 Chunky Wiki,特别是其中的 Commands 和 World borders 页面。