01 UUID 是身份标识，不是密码
Minecraft 玩家 UUID 用于识别采用该身份的记录，不等于显示名、登录密码或基岩平台标识。知道 UUID 不能证明自己就是持有人。先明确任务：检查白名单、查找玩家数据，还是排查迁移。
运维时优先使用玩家实际加入的服务器记录。第三方名称查询不一定匹配离线模式或转发错误的后端身份。本文提供核对流程，不冒充实时 UUID 查询工具。
02 读取已有记录，不为查询而创建高权限条目
Paper 的 Vanilla data-file reference / 原版数据文件说明 ↗ 展示 whitelist.json、ops.json 等记录的 UUID 与名称字段。以备份或只读方式检查已有相关条目；不能为了查询就授予管理员权限，实际权限变更采用支持命令。
- 让玩家从计划使用的正常入口加入。
- 记录准确账户名、时间与认证路径。
- 找到对应日志或已有管理记录。
- 比较该 UUID 与准备迁移或管理的数据。
- 映射不明确时，先不要改文件名或授权。
名字相似不足以证明身份。迁移记录应写明来源与目标环境，才能解释标识变化。
03 在线认证与代理转发影响身份上下文
server.properties reference / Paper 配置说明 ↗ 描述 online-mode 账号认证。代理后端还需正确的 Player-information forwarding / 玩家信息转发 ↗，配置错误可能让后端观察到不同身份。
不要把切换 online-mode 当作 UUID 修复捷径，也不要公开未认证后端。先确认新旧环境分别是直接认证、受保护代理还是跨平台认证组件。路径或转发错误时先修配置，否则改数据文件名只会掩盖原因。
04 迁移后验收玩家进度
身份转换前备份完整世界与相关玩家记录。在隔离目标环境验收物品、位置与权限。插件可能还有独立文件或数据库，复制原版玩家文件不代表迁移了全部插件身份数据。
只有基岩玩家异常时，检查 Geyser/Floodgate route / 跨平台认证链路，不要把 Java UUID 填进所有字段。出现异常权限则直接复核授权配置。保留原映射，回退时才能确认每份记录属于谁。