101 lines
2.6 KiB
Markdown
101 lines
2.6 KiB
Markdown
# Minecraft 服务器UUID迁移助手
|
||
|
||
**专为整合包服务器设计的玩家数据迁移工具**
|
||
轻松解决玩家UUID变更导致的数据丢失问题，完美支持主流FTB模组数据迁移。
|
||
|
||
---
|
||
|
||
### 🎯 核心功能
|
||
- **玩家档案迁移**
|
||
更新`usercache.json`和`usernamecache.json`中的UUID映射，保持玩家身份一致性
|
||
|
||
- **FTB模组支持**
|
||
自动处理以下模组数据文件：
|
||
- **FTB Teams**
|
||
- 战队成员数据 (`/world/ftbteams/party`)
|
||
- 玩家个人档案 (`/world/ftbteams/player`)
|
||
- **FTB Chunks**
|
||
- 领地权限数据 (`/world/ftbchunks`)
|
||
- **FTB Quests**
|
||
- 任务进度存档 (`/world/ftbquests`)
|
||
|
||
- **智能文件处理**
|
||
自动识别并更新涉及UUID的：
|
||
- 配置文件内容
|
||
- 文件名与目录名
|
||
- 嵌套数据结构
|
||
|
||
---
|
||
|
||
### 🚀 使用场景
|
||
- 玩家账户系统升级时保持数据连贯
|
||
- 切换正版/离线模式时的数据迁移
|
||
- 玩家身份信息异常后的数据修复
|
||
- 服务器合并时的玩家数据整合
|
||
|
||
---
|
||
|
||
### 📦 使用方式
|
||
1. **单次迁移模式**
|
||
跟随引导输入服务器路径、新旧UUID即可
|
||
|
||
### 2. 批量处理模式
|
||
|
||
**适用场景**
|
||
同时处理多个玩家的UUID变更需求，适合大规模数据迁移
|
||
|
||
**操作流程**
|
||
1. **创建配置文件**
|
||
新建`migration.json`文件，内容示例：
|
||
```json
|
||
{
|
||
"path": "C:/你的服务器路径",
|
||
"mappings": {
|
||
"原UUID1": "新UUID1",
|
||
"原UUID2": "新UUID2"
|
||
}
|
||
}
|
||
```
|
||
|
||
2. **填写配置信息**
|
||
- `path`: 填写你的服务器根目录绝对路径
|
||
- `mappings`: 按`"旧UUID": "新UUID"`格式添加需要变更的对应关系
|
||
|
||
3. **执行迁移命令**
|
||
```bash
|
||
python uuid_migrator.py --config migration.json
|
||
```
|
||
|
||
**配置示例**
|
||
处理两位玩家的数据迁移：
|
||
```json
|
||
{
|
||
"path": "C:/mc_server",
|
||
"mappings": {
|
||
"850c1551-a4af-4d56-88b5-2a041232be56": "1f06a2e9-fdc1-3392-80a2-b72ea9cd12f8",
|
||
"79f25117-0128-4329-86f7-618a8d983c82": "dda6094c-bc6b-3d53-b379-af7535d95c5d"
|
||
}
|
||
}
|
||
```
|
||
|
||
**效果说明**
|
||
程序将自动完成：
|
||
- 所有配置文件的UUID更新
|
||
- 涉及模组数据的内容替换
|
||
- 相关文件/目录的重命名操作
|
||
|
||
⚠️ **注意事项**
|
||
- 请使用纯文本编辑器创建配置文件
|
||
- 路径请使用正斜杠`/`（兼容Windows/Linux）
|
||
- 确保所有UUID格式正确
|
||
|
||
---
|
||
|
||
### ⚠️ 注意事项
|
||
- 操作前请务必备份服务器数据
|
||
- 建议在服务器离线状态下执行
|
||
- 确保对数据文件有读写权限
|
||
|
||
---
|
||
|
||
> 无需复杂操作，三步完成玩家数据无缝迁移，保障服务器平稳过渡！ |