先给结论
基岩版世界以目录形式存储,服务端通过 level-name 定位要加载的世界。迁移的本质是把一份结构正确的世界目录放到服务端能找到的位置,并让配置指向它。理解这一点,单机转服务器、换主机、跨设备搬迁都是同一套流程,差别只在导出方式与平台限制。
一、迁移前必须先拿到一致的数据
迁移失败最隐蔽的原因是源端数据本身不一致:客户端还在世界里就复制了存档,或者复制时服务端正在写入。得到的结果是一个看似完整、实际内部状态错乱的世界。
因此第一步永远是让源端干净退出并确认已保存。单机世界要退出到世界列表,服务端要正常停止进程。宁可多花几分钟做一次干净退出,也不要省这一步去修一个半损坏的存档。
判断是否真的干净退出,可以看进程是否结束、文件是否还能被重命名。如果源文件被占用、重命名失败,说明还有程序在写入,此时复制必然有风险。
二、目录层级是最常见的坑
从设备导出的世界包往往是压缩形式,解压后可能多出一层同名目录。服务端要求世界目录内部直接包含世界数据文件,多套一层就会找不到关键文件,然后在旁边新建一个空白世界,让人误以为导入失败。
判断方法很直接:进入准备放入 worlds 的那个目录,确认里面直接就是世界数据而不是又一个文件夹。确认无误后再启动,启动后看日志明确显示了加载目标世界。
如果发现多了一层,正确做法是把内层目录整体移到 worlds 下,而不是移动外层壳目录。移动完成后重新核对目录名,因为有些平台在导出时会自动加上日期或设备后缀。
三、level-name 与目录名必须严格一致
level-name 决定加载哪个目录,匹配是严格的:大小写、空格、特殊符号都算差异。目录叫 Survival 而配置写 survival,结果就是加载失败并新建世界。
更麻烦的情况是新建的世界与旧世界同名不同内容,玩家进去发现是空地图,却以为存档丢了。所以导入后第一件事是进服核对出生点、已探索区域和建筑是否还在,而不是只看服务端有没有报错。
建议把目录名改成简短、全小写、无空格的形式,例如 survival 或 season2,再同步修改 level-name。这样能同时避开大小写问题、路径空格问题以及不同系统间的字符差异。
四、跨设备搬迁的额外注意项
不同设备的基岩版世界导出方式不同,主机平台往往需要借助官方提供的转移方式,不能直接拷文件。搬迁前先确认目标平台支持哪种导入路径,避免中途发现无法落地。
跨主机搬迁服务端时,除了世界目录,还要一并迁移 server.properties、allowlist.json、permissions.json 以及行为包和资源包目录。只搬世界会得到一模一样的地图配上完全不同的一套权限和玩法配置。
还要注意版本一致性:新环境服务端版本低于世界结构版本时,可能无法读取或读取后降级失败。搬迁前记录源端的服务端版本,并尽量在新环境使用相同或更高版本。
五、迁移后要做核对清单
核对顺序建议按玩家最在意的顺序来:出生点位置是否正确、已探索地图是否完整、建筑与容器内容是否还在、玩家背包与进度是否保留、权限与白名单是否生效。
每一项都要实际进游戏看一眼,而不是看目录大小相近就认定成功。核对完成后再开放给其他玩家,避免所有人一起进入一个可能还有问题的世界。
最后保留源端原始数据一段时间。迁移成功不等于立刻安全,新环境可能在前几天才暴露问题,此时源端副本就是唯一的退路。
执行步骤
- 让源端世界或服务端干净退出,确认文件不再被占用。
- 取得世界数据并确认解压后目录内部直接包含世界数据。
- 将内层世界目录放入服务端 worlds 下,记录准确目录名。
- 把 server.properties 的 level-name 改为与该目录名完全一致。
- 启动服务端,从日志确认加载的是目标世界而非新建世界。
- 进服核对出生点、地图、建筑、容器与玩家数据。
- 一并迁移配置文件、权限文件与内容包目录。
- 核对无误后再对全体玩家开放,并暂留源端副本。
验收标准
- 服务端日志明确加载了导入的世界。
- 进入后能找到原有建筑与已探索区域。
- 玩家背包、进度与权限表现与迁移前一致。
- 源端保留一份未被修改的原始副本。
- 配置文件与内容包同步迁移,玩法未发生变化。
- 迁移后外部玩家连接表现正常。
常见误区
- 解压后多套一层目录,服务端找不到世界数据。
- level-name 大小写不一致,服务端新建空白世界。
- 客户端仍在游玩时就复制存档,得到不一致数据。
- 只迁移世界目录,忘记权限与配置文件。
- 目标服务端版本低于世界结构版本,读取失败。
- 看目录体积相近就认定迁移成功,未进服核对。
世界迁移是一次数据搬运,不是一次冒险。把「干净退出、目录结构、名字一致、进服核对」四步做实,跨平台与跨主机的差异就只是操作路径不同而已。