# 迁移
如果您原来在使用 Authme 之类的游戏内登录插件,并且现在想要切换到本项目的话,您可能需要注意一下 UUID 的问题。
# 概述
现在的 Minecraft(1.7.6+)都是使用 UUID 来唯一性地标识玩家的。当您在使用 Mojang 官方的正版登录时,一个玩家的 UUID 是从 Mojang 的认证服务器那边拿到的;同样地,当您在使用本方案时,玩家的 UUID 是从皮肤站那边拿到的。
而在离线模式中(online-mode=false
,也就是盗版服),玩家的 UUID 一般是基于玩家名称生成的。
那么当您在一个原本是离线模式的服务器使用本外置登录方案时,由于设定了 online-mode=true
,服务器会从皮肤站的 Yggdrasil API 插件那边获取玩家的 UUID。显然,服务器从皮肤站那边拿到的 UUID 和之前使用离线模式时生成的 UUID 肯定是不同的,这就造成这样的情况:
- 玩家位置、出生点被重置
- 玩家物品栏、末影箱被清空
- 所有根据 UUID 认人的 Mod 都不认得您了
诸如此类。
# 修改皮肤站的 UUID 生成算法
为了最大限度与离线模式兼容,皮肤站提供了修改 UUID 生成算法的选项。
选择 Version 3
即可让皮肤站使用离线模式下的 UUID 生成算法。这样的好处是您可以随时将您的服务器切换回离线模式,弃用 authlib-injector 外置登录方案不会对您的服务器造成太大影响。
同时,如果您使用 BungeeCord 同时提供「外置登录」与「盗版 + 插件登录」两种进服方式的话,也请使用 Version 3
以防止出现各子服务器中玩家 UUID 不一致的情况。
如果您原来的服务器是处于离线模式(online-mode=false
,也就是盗版服)的话,那么到这里您就已经完成迁移工作了。
一般情况下,您并不需要继续往下阅读。下面两种导入 UUID 的方法,仅在以下情况下可能有用:
- 您的服务器原先是正版服
- 您的服务器原先使用的是其他的 Yggdrasil 认证服务器,并且原 Yggdrasil 认证服务器使用的 UUID 生成算法与离线模式下的不同(比如早期的「统一通行证」,或是其他使用随机生成 UUID 的 BS 实例)
- 您就是不想使用离线模式的那一套 UUID 生成算法
注意:导入错误的 UUID 可能造成无法预知的问题,请谨慎操作。
# 参考链接(英语)
- https://www.reddit.com/r/feedthebeast/comments/6jvjzt/how_do_you_transfer_an_offline_server_to_online/
- https://www.minecraftforum.net/forums/support/server-support/2254587-player-data-migration-between-offline-and-online
← 错误排查