[MD]
## 零、我的废话
灵感来源于我以前在管理服务器时遇到过盗版切正版后导致玩家数据丢失的情况。但是需要注意的是,这个工具只能转换原版玩家数据,服务器中插件的数据的需要另寻他法。
## 一、这是什么
一个**单文件 HTML 工具**,用 Chrome / Edge 浏览器直接双击打开即可使用,**无需安装、无需服务器、无依赖**。它帮你把 Minecraft 的两种 UUID(正版 v4 / 盗版 v3)互相转换,并批量迁移整个存档的玩家数据。
- 正版 UUID(v4):Mojang 账号系统生成
- 盗版(离线)UUID(v3):由 `MD5("OfflinePlayer:" + 用户名)` 确定性生成
## 二、核心功能
**1. UUID 工具(单条快速处理)**
- 盗版 UUID 生成:用户名 → 离线 v3 UUID
- 正版 UUID 查询:用户名 → 正版 v4 UUID(多通道智能回退:PlayerDB / MineTools / vrc.lol / allorigins / Mojang / MC Services)
- 正版 UUID 反查:正版 v4 UUID → 用户名
**2. 存档转换(单玩家)**
- 选中某个玩家,正版 ↔ 盗版 UUID 一键互转
- 支持**旧结构(1.7.6 ~ 1.21.11)**、**新结构(26.1+)**、**混合结构**自动识别
- 可加载服务端 `usercache.json` 离线补全用户名 / 获取正版 UUID
- 「按 UUID 反查用户名」按钮(正版 UUID 可用)
- 「覆盖已存在文件」开关(转换前自动备份)
**3. 批量转换**
- 扫描整个存档的所有玩家
- 批量查询 UUID、批量执行转换
- 个别玩家缺用户名 / 查询失败时**只标记该玩家失败,不中断整批**
- 盗版 → 正版:只信任真正的正版 v4 UUID(避免把离线 UUID 当目标)
- 正版 → 盗版:按正版 UUID 反查用户名后生成对应盗版 UUID
## 三、使用步骤
1. 用 **Chrome 或 Edge** 打开 `Minecraft UUID 转换工具.html`(地址栏为 `file://...` 路径)
2. 选择「存档转换」→ 选择你的世界文件夹
3. 工具会列出所有玩家及其 UUID 类型
4. 选择转换方向,点击执行(建议先勾选「备份」)
> ⚠️ **操作前请务必停止服务器并备份整个存档!** 本工具会直接修改存档目录下的文件。
## 四、注意事项
- **浏览器要求**:必须 Chrome / Edge 86+(依赖 File System Access API)。在网页预览面板、微信内置浏览器等环境里会**拦截文件读写和联网请求**,请直接双击文件打开。
- **联网需求**:正版 UUID 查询 / 反查需要联网;仅做“用户名 → 盗版 UUID”生成可不联网。
---
**兼容版本**:Minecraft 1.7.6 ~ 26.1+
**开源 / 免费**:本工具为单文件 HTML,可随意分发。
[/MD]