🥺 迁移前须知

在将本地单机存档迁移至服务器前,请先了解以下注意事项:

  1. 模组数据风险:将模组整合包的单机存档迁移至服务器存在一定兼容性风险,个别模组特有的方块或物品在迁移后可能会消失。
  2. 需修改存档配置:直接将单机存档文件夹原封不动上传至面板是无法被服务端直接识别使用的,必须先按本教程修改 level.dat。
  3. 模组环境一致:待迁移的本地存档应尽量与服务端安装的模组版本保持一致。
  4. 存档损坏风险:操作不当可能导致存档无法加载或进服报错。

重要提醒:开始任何修改操作前,请务必先在本地完整复制备份一份原存档,以防操作失误导致存档无法恢复!

✅ 一、修改并上传地图存档

  1. 在本地电脑找到客户端的存档目录:

    • 未开启版本隔离:通常位于 .minecraft\saves
    • 开启了版本隔离:通常位于 .minecraft\versions\<游戏版本>\saves

    未开启版本隔离的目录示例:

    未开启版本隔离的存档目录

    开启版本隔离的目录示例:

    开启版本隔离的存档目录
  2. 打开 saves 文件夹,里面的每一个子文件夹即代表一个独立存档(此处以“新的世界”为例)。开始修改前,请先下载并解压 NBT 编辑工具:NBTExplorer(提取码:4nm2)。

    saves 文件夹
  3. 进入需要迁移的存档文件夹,找到 level.dat 文件。

    level.dat
  4. 使用 NBTExplorer 打开 level.dat,点击箭头所指的 + 号展开 Data 节点。

    展开配置信息
  5. 在展开的列表中找到 LevelName 项,双击打开编辑窗口(部分模组存档包含更多条目,不影响此处修改)。

    找到 LevelName
  6. 将数值修改为 world,点击 OK 确认。

    改为 world
  7. 在列表中找到上方的 Player 节点,选中后点击顶部工具栏的红色叉号将其删除。

    删除 Player 数据
  8. 点击左上角的磁盘图标保存修改,随后关闭编辑器,并将该存档文件夹本身也重命名为 world。

    保存

至此,地图存档主体已修改完毕。若您无需保留原有的玩家背包数据,或此前全程使用正版账号游玩,现在即可直接参照 上传文件到面板 与 地图存档相关操作 将存档打包上传至服务器。


🔃 二、同步玩家存档数据(离线账号必看)

在 Minecraft 的存档结构中,玩家的个人数据分别保存在存档目录的以下文件夹内:

  • playerdata:存放玩家背包物品、位置坐标、经验等级等核心数据;
  • advancements:存放玩家已达成的进度数据;
  • stats:存放玩家的统计信息;
  • 其他模组专属目录:部分模组会在存档内建立独立文件夹存放玩家数据。

如下图所示,这些 .dat 或 .json 文件均以玩家的 UUID 命名:

以 UUID 命名的玩家数据
  • 正版玩家:拥有全网唯一且固定的正版 UUID(即使修改正版游戏名,UUID 也不会改变),因此迁移存档后直接进服即可自动继承原有背包与进度。
  • 离线(非正版)玩家:未经过微软正版验证,其 UUID 由本地客户端或服务端各自生成并记录在 usercache.json 中。同一个离线玩家名在单机客户端与服务器上生成的 UUID 往往不一致,直接进服会被视为新玩家,导致原有背包数据丢失。

若您或朋友此前使用离线账号游玩该存档,请按以下对应情况同步 usercache.json:

1. 纯单人游玩的存档

若该存档仅您一人单机游玩过,只需在本地客户端根目录下找到 usercache.json 文件,将其直接上传并覆盖到面板服务端根目录下即可(注意:请放在服务端根目录,切勿放进 world 存档文件夹内)。

客户端的 usercache.json

2. 多人局域网联机过的存档

若该存档曾通过内网穿透或局域网与朋友联机,存档内便包含多位玩家的数据。此时需要将所有联机玩家原本的 UUID 映射关系合并至服务端的 usercache.json 中(以下以双人联机为例,多人同理):

  1. 获取朋友的 UUID 记录:请联机朋友打开其本地客户端根目录下的 usercache.json 文件(如下图所示,a2877b20-598d-4e2e-a5f3-bbef9798a2cf 即为该玩家的 UUID)。

    朋友的 usercache.json
  2. 请朋友将方括号 [ ] 内属于他自己的那一段 { ... } 记录完整复制发给您,格式如下:

    {"name":"vat","uuid":"a2877b20-598d-4e2e-a5f3-bbef9798a2cf","expiresOn":"2025-09-03 17:48:12 +0800"}
  3. 在面板“文件”页面打开服务端根目录下的 usercache.json(若服务器尚无玩家进入过,默认仅有一对空方括号 [])。

    服务端的 usercache.json
  4. 将收集到的玩家记录粘贴至 [ ] 内部,即可完成单个玩家 UUID 的绑定。

    粘贴一个玩家的信息
  5. 若有多位玩家,请在每段记录的 } 后方添加一个英文逗号 ,,再依次粘贴下一位玩家的记录(如下图所示)。

    多个玩家
  6. 保存文件并启动服务器,各位玩家使用原游戏名进服,即可正常继承原有的背包与进度数据。

作者:Azitate  创建时间:2025-08-10 16:55
最后编辑:admin  更新时间:2026-11-14 18:58