将您的世界从 Minecraft Realms 迁移到 ServerPrism
将 Realms (Java) 世界移动到您自己的 ServerPrism 服务器 — 从 Realms 客户端下载导出文件,通过 SFTP 或面板上传,并保持所有人的进度不变。
从 Minecraft Realms (Java 版) 迁移到您自己的 ServerPrism 服务器是一个直接的单向复制过程 — Realms 世界文件夹是一个标准的 Minecraft 世界文件夹,因此它可以直接放入 ServerPrism Paper 或 Vanilla 服务器。只要您保持 online-mode=true,所有人的进度(物品栏、经验、位置、进度)都会自动转移。
本指南涵盖了整个迁移过程:您可以和不能转移的内容、从 Realms 导出、订购正确的 ServerPrism 计划、上传世界、重建 Realms 不导出的权限列表,以及将您的玩家指向新地址。
开始之前:实际转移的内容
Realms 被设计为一个锁定的托管世界,因此导出文件包含所有与世界相关的内容,但不包含任何与平台相关的内容。
干净转移的内容:
- 世界文件夹本身(所有维度、区块、等级数据)
- 每个玩家的个人存档 (
playerdata/<uuid>.dat) — 物品栏、位置、经验、末影箱、生命值 - 玩家统计数据 (
stats/<uuid>.json) 和进度 (advancements/<uuid>.json) - 您在世界中安装的任何数据包
- 结构、出生点、世界种子和游戏规则
不转移的内容(您需要重建):
- Realms 成员列表 — Realms 使用 Microsoft 账户邀请,而不是标准的
ops.json/whitelist.json/banned-players.json文件 - 服务器设置 — Realms 不公开
server.properties,因此难度、PvP、出生点保护、视距等都将在您的新服务器上重新设置 - Realm 的 IP — Realms 使用临时地址;玩家将需要您的新 ServerPrism 地址
Realms 本身不存在的内容(因此无需迁移):插件、模组、服务器端捆绑的资源包,或任何 Forge/Fabric 加载器。如果您在迁移后需要这些,ServerPrism 可以运行它们。
步骤 1:选择合适的 ServerPrism 计划
Realms Java 版限制您最多 11 名玩家(所有者 + 10),且不支持插件/模组。在 ServerPrism 上,您可以摆脱这两个限制,所以现在是选择您真正想要的内容的好时机。
- 与之前相同(最多约 10 名玩家,原版风格): 2 GB 或 4 GB 计划足够了。选择 Paper 作为运行时 — 它是一个直接替换原版的版本,运行相同的世界,但性能更好,并且如果您以后需要插件,它也支持。
- 更大的社区或大型世界: 6 GB 或 8 GB 为 15 到 25 名玩家提供了舒适的余量。
- 迁移后想添加模组: 选择 Forge、NeoForge,或使用我们的 Modpack Installer 运行时。您的 Realms 世界仍然可以正常导入;之后可以添加模组。
订购后,请从面板仪表板记下您的服务器 IP:port — 您将在最后将其提供给玩家。
步骤 2:匹配 Minecraft 版本
Realms 运行 Minecraft 的最新稳定版本,不允许您选择版本。您的 ServerPrism 服务器需要与 Realms 处于相同版本或更新版本 — 世界可以升级到更新的 MC 版本,但不能降级。
在 ServerPrism 面板上,打开您的服务器,点击 Startup,并检查版本变量(Paper 的 Minecraft Version,或您在订购时选择的版本)。如果它与 Realm 的最新版本不匹配,请立即设置并重启一次,以便服务器下载正确的 jar。您可以通过检查您的 Minecraft 客户端来确认您的 Realm 运行的是哪个版本 — Realms 选项卡会在顶部显示版本。
步骤 3:从 Realms 导出您的世界
只有 Realm 所有者可以执行此操作(受邀成员无法下载)。
- 启动 Minecraft(使用您拥有 Realm 的同一账户)。
- 从主菜单中,点击 Minecraft Realms。
- 从列表中选择您的 Realm,然后点击 Configure Realm(扳手/齿轮图标)。
- 打开 Backups 选项卡。您将看到自动备份列表以及当前世界状态。
- 点击您想要的版本旁边的 Download World(通常是最新版本)。
- 出现提示时输入名称 — 这将成为下载文件的文件名。
- 等待下载完成。您将获得一个 .zip 文件,通常保存到您的 Downloads 文件夹中。
zip 文件内部会有一个以您的世界名称命名的文件夹,其中包含 level.dat、region/、playerdata/、stats/、advancements/、dimensions/,以及(如果您有)datapacks/。这就是整个世界,它是一个标准的 Minecraft 文件夹 — 没有 Realms 特定的结构。
注意双重嵌套。 某些客户端版本会生成一个文件夹内包含同名文件夹的情况。如果 zip 文件的第一层只包含一个文件夹,而实际的世界文件在该内部文件夹中,请在接下来的步骤中使用该内部文件夹。
步骤 4:准备世界文件夹
上传之前,在您的本地机器上进行两次小清理:
- 将文件夹重命名为
world(全部小写)。ServerPrism 的 Minecraft 服务器默认查找名为world的文件夹。如果您在server.properties中设置level-name=yourname,您可以使用不同的名称,但world是最不容易出错的路径。 - 如果存在,删除
session.lock。该文件是之前运行的服务器的锁定标记;保留它可能会在首次启动时导致“世界已被使用”错误。
步骤 5:将世界上传到 ServerPrism
您有两种选择将世界上传到您的服务器。两者都有效 — 选择适合您世界大小的方法。
选项 A — SFTP(适用于任何超过 100 MB 的文件)
- 在您的服务器面板仪表板上,查找 SFTP 部分(通常在侧边栏或底部)。记下那里显示的主机、端口和用户名。您的密码是您的 ServerPrism 面板密码。
- 打开一个 SFTP 客户端 — Windows 上的 FileZilla 或 WinSCP,macOS 上的 Cyberduck 或 Transmit,或 Linux 上任何支持 SFTP 的文件管理器。
- 使用面板中的凭据连接(不是端口 22 — ServerPrism SFTP 使用仪表板上显示的自定义端口)。
- 连接后,您将看到服务器的文件树。如果新安装后已经有一个
world文件夹,请先删除它(或将其重命名作为备份)。 - 将您的
world文件夹从您的机器拖到服务器根目录。大型世界可能需要 5 到 30 分钟,具体取决于您的上传速度。 - 传输完成后,关闭 SFTP 客户端。
选项 B — 文件管理器上传(适用于较小的世界,最大约 500 MB)
- 在面板中,打开您的服务器并点击 File Manager。
- 删除或重命名根目录中现有的
world文件夹。 - 点击 Upload 并拖入您的世界文件夹,或者上传原始的 .zip 文件并使用 Unarchive(右键点击文件 → Unarchive)将其原地解压。
- 如果您上传了 zip 文件,请在之后删除 zip 文件以节省磁盘空间。
步骤 6:启动服务器并验证
- 在面板上,点击 Console 选项卡上的 Start。
- 观察控制台,直到出现
Done (X.XXXs)! For help, type "help"行 — 这表示世界已加载,服务器正在接受连接。 - 如果您看到提及 DataVersion 或“世界来自较新版本”的错误,则您的服务器的 MC 版本比 Realms 运行的版本旧。在 Startup 选项卡中更新服务器的 Minecraft 版本并重启。
步骤 7:重建 ops、白名单和设置
由于 Realms 不导出这些,请现在设置它们。
- 给自己管理员权限。 在 Console 选项卡中,运行
op YourMinecraftName。您现在可以使用/gamemode、/tp和所有其他管理员命令。 - 重新添加您的玩家。 如果您想保留 Realms 曾经拥有的“只有这些人可以加入”的行为,请启用白名单:
whitelist on
whitelist add PlayerName
whitelist add AnotherPlayer
- 调整 server.properties。 打开 File Manager →
server.properties并设置motd、difficulty、pvp、view-distance和其他基本设置。有关实际重要的设置,请参阅 服务器基础:server.properties、白名单和 ops。
步骤 8:将新地址发送给您的玩家
将面板中的新连接地址发送给您的朋友。它将是 123.45.67.89:25565 或我们分配给您的子域名的格式。他们在 Minecraft 客户端的 Multiplayer → Add Server 下添加它并点击 Join — 他们在 Realm 上拥有的一切(物品栏、位置、经验、末影箱、进度)都与他们离开时完全一样,因为他们的 UUID 在在线模式服务器端匹配。
如果玩家赤身裸体地出现在出生点且没有经验,则您的服务器正在运行
online-mode=false(离线模式)。他们的离线 UUID 与他们的 Realms UUID 不匹配,因此他们的存档文件未被加载。在server.properties中设置online-mode=true并重启 — 这是正确的默认设置,也是您几乎肯定想要的设置。
常见问题
- “世界来自较新版本”: 您的服务器运行的 MC 版本比 Realm 旧。在 Startup 选项卡中更新版本并重启。
- 数据包未加载: 确认它们位于
world/datapacks/(在世界文件夹内,而不是在服务器根目录),然后在控制台中运行/datapack list以查看服务器是否识别它们。如果数据包被禁用,/datapack enable "file/mypack"将启用它。 - 下界或末地为空: 在较新的 MC 版本中,这些维度位于
world/dimensions/minecraft/the_nether/和world/dimensions/minecraft/the_end/。如果它们在您的上传中缺失,请重新检查 zip 文件 — Realms 通常会包含它们。 - “世界已被使用 — 是否有另一个实例正在运行?”: 您的世界文件夹中有一个残留的
session.lock。删除它并重启。 - 玩家仍然连接到旧的 Realm: Realms 订阅每月续订。如果您不再使用它,请在您的 Minecraft 账户设置中取消 Realm,否则您将继续向 Mojang 和 ServerPrism 付费。
一旦您在新服务器上舒适运行一两天,您就可以安全地取消您的 Realm 订阅。如果您想移回,相同的文件夹路径可以反向操作(通过 Realms 客户端上传 zip 文件),但您将失去插件以及 ServerPrism 启用而 Realms 不支持的任何自定义设置。