From 0fc4f78e42726ffb3b5ac407f7bd2d5009e3ab2f Mon Sep 17 00:00:00 2001
From: xingluo <xingluo01@liulikeji.cn>
Date: Mon, 28 Apr 2025 01:03:01 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e581aa8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,54 @@
+# 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变更
+
+---
+
+### ⚠️ 注意事项
+- 操作前请务必备份服务器数据  
+- 建议在服务器离线状态下执行  
+- 确保对数据文件有读写权限  
+
+---
+
+> 无需复杂操作，三步完成玩家数据无缝迁移，保障服务器平稳过渡！  
\ No newline at end of file