diff --git a/libs/external/MCPlayerTransfer b/libs/external/MCPlayerTransfer deleted file mode 160000 index fe6f473..0000000 --- a/libs/external/MCPlayerTransfer +++ /dev/null @@ -1 +0,0 @@ -Subproject commit fe6f4735bd80bf8b5ccdf8986c78c946383950c1 diff --git a/libs/external/MCPlayerTransfer/README.md b/libs/external/MCPlayerTransfer/README.md new file mode 100644 index 0000000..47848a0 --- /dev/null +++ b/libs/external/MCPlayerTransfer/README.md @@ -0,0 +1,52 @@ +# MC Player Transfer + +Minecraft 基岩版角色转移工具 - 像泰拉瑞亚一样转移角色 + +## 项目结构 + +``` +MCPlayerTransfer/ +├── main.py # 主入口 +├── requirements.txt # 依赖 +├── README.md +├── src/ +│ ├── __init__.py +│ ├── extract_player.py # 提取模块 +│ └── import_player.py # 导入模块 +├── input/ # 放入 .mcworld 文件 +└── output/ # 输出 .dat 角色文件 +``` + +## 安装 + +```bash +pip install -r requirements.txt +``` + +## 使用 + +### 提取角色 +```bash +python main.py extract "input/World.mcworld" +``` + +### 导入角色 +```bash +python main.py import "input/另一个世界.mcworld" "output/player.dat" +``` + +## 数据说明 + +提取的 `.dat` 文件包含角色全部数据: +- 背包物品 +- 末影箱物品 +- 潜影盒及内容 +- 装备栏 +- 经验等级 +- 生命/饥饿值 +- 位置坐标 + +## 注意事项 + +- 操作前备份存档 +- 关闭游戏后操作 diff --git a/libs/external/MCPlayerTransfer/docs/使用文档.md b/libs/external/MCPlayerTransfer/docs/使用文档.md new file mode 100644 index 0000000..192a5b4 --- /dev/null +++ b/libs/external/MCPlayerTransfer/docs/使用文档.md @@ -0,0 +1,243 @@ +# MC Player Transfer 使用文档 + +## 简介 + +MC Player Transfer 是一个 Minecraft 基岩版角色转移工具,可以像泰拉瑞亚一样,将角色从一个世界完整转移到另一个世界。 + +### 支持转移的数据 + +- ✅ 背包全部物品 +- ✅ 末影箱全部物品 +- ✅ 潜影盒及其内部物品 +- ✅ 装备栏(头盔、胸甲、护腿、靴子) +- ✅ 副手物品 +- ✅ 经验等级 +- ✅ 生命值 / 饥饿值 +- ✅ 玩家坐标位置 +- ✅ 游戏模式 +- ✅ 物品附魔、耐久度等 NBT 数据 + +--- + +## 环境要求 + +- Python 3.8 或更高版本 +- Windows 10/11(WSL 环境) + +--- + +## 安装步骤 + +### 1. 安装 Python 依赖 + +打开命令行,进入项目目录,执行: + +```bash +pip install -r requirements.txt +``` + +或手动安装: + +```bash +pip install amulet-core +``` + +### 2. 验证安装 + +```bash +python main.py +``` + +如果显示帮助信息,说明安装成功。 + +--- + +## 使用方法 + +### 方法一:提取角色数据 + +将 `.mcworld` 文件中的角色数据提取为独立的 `.dat` 文件。 + +**步骤:** + +1. 将你的 `.mcworld` 存档文件放入 `input/` 文件夹 + +2. 执行命令: + ```bash + python main.py extract "input/你的世界.mcworld" + ``` + +3. 提取的角色数据会保存到 `output/` 文件夹,文件名格式:`世界名_时间戳.dat` + +**示例:** + +```bash +python main.py extract "input/World (2).mcworld" +``` + +输出: +``` +正在解压: input/World (2).mcworld +找到数据库: /tmp/xxx/db + +✓ 提取成功! + 世界名称: World (2) + 数据大小: 50617 bytes + 输出文件: output/World (2)_20251216_084843.dat +``` + +--- + +### 方法二:导入角色数据 + +将 `.dat` 角色文件导入到另一个 `.mcworld` 存档中。 + +**步骤:** + +1. 准备好目标世界的 `.mcworld` 文件 + +2. 准备好之前提取的 `.dat` 角色文件 + +3. 执行命令: + ```bash + python main.py import "目标世界.mcworld" "output/角色数据.dat" + ``` + +4. 生成的新存档文件名为 `目标世界_imported.mcworld` + +**示例:** + +```bash +python main.py import "我的世界.mcworld" "output/World (2)_20251216_084843.dat" +``` + +输出: +``` +读取角色数据: 50617 bytes +正在解压: 我的世界.mcworld +✓ 角色数据已写入 +正在打包: 我的世界_imported.mcworld + +✓ 导入成功! + 输出文件: 我的世界_imported.mcworld +``` + +--- + +## 完整使用流程示例 + +### 场景:将角色从「生存世界」转移到「新世界」 + +```bash +# 第一步:提取生存世界的角色 +python main.py extract "input/生存世界.mcworld" + +# 第二步:导入到新世界 +python main.py import "input/新世界.mcworld" "output/生存世界_20251216_120000.dat" + +# 第三步:将生成的 新世界_imported.mcworld 导入游戏 +``` + +--- + +## 如何获取 .mcworld 文件 + +### 方法一:从游戏导出 + +1. 打开 Minecraft 基岩版 +2. 进入「设置」→「存储」 +3. 选择要导出的世界 +4. 点击「导出世界」 +5. 选择保存位置,得到 `.mcworld` 文件 + +### 方法二:从存档文件夹打包 + +Windows 存档位置: +``` +C:\Users\用户名\AppData\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\minecraftWorlds\ +``` + +将整个世界文件夹压缩为 `.zip`,然后改后缀为 `.mcworld`。 + +--- + +## 如何导入 .mcworld 文件到游戏 + +1. 双击 `.mcworld` 文件,游戏会自动导入 +2. 或者将文件拖入游戏窗口 +3. 或者手动解压到存档目录 + +--- + +## 项目目录结构 + +``` +MCPlayerTransfer/ +├── main.py # 主程序入口 +├── requirements.txt # Python 依赖 +├── README.md # 简要说明 +├── src/ # 源代码 +│ ├── __init__.py +│ ├── extract_player.py # 提取模块 +│ └── import_player.py # 导入模块 +├── docs/ # 文档 +│ └── 使用文档.md +├── input/ # 输入文件夹(放 .mcworld 文件) +└── output/ # 输出文件夹(生成 .dat 文件) +``` + +--- + +## 常见问题 + +### Q: 提示找不到 leveldb 模块? + +A: 执行 `pip install amulet-core`,这个包包含了所需的 leveldb 支持。 + +### Q: 提示找不到本地玩家数据? + +A: 确保 `.mcworld` 文件是有效的基岩版存档,且曾经在单人模式下游玩过。 + +### Q: 导入后角色位置不对? + +A: 角色数据包含坐标信息,导入后会保留原来的位置。如果新世界该位置是虚空,角色可能会掉落。建议先在新世界创建一个安全的出生点。 + +### Q: 可以转移多人服务器的角色吗? + +A: 本工具只支持本地玩家(`~local_player`)。服务器玩家数据存储方式不同,暂不支持。 + +### Q: 原存档会被修改吗? + +A: 不会。提取操作只读取数据,导入操作会生成新的 `_imported.mcworld` 文件,不修改原文件。 + +--- + +## 注意事项 + +⚠️ **重要提醒:** + +1. **操作前务必备份存档** +2. **关闭游戏后再进行操作** +3. **导入会完全覆盖目标存档的本地玩家数据** +4. **建议先在测试存档上验证** + +--- + +## 技术原理 + +Minecraft 基岩版使用 LevelDB 数据库存储世界数据。玩家数据存储在 key 为 `~local_player` 的条目中,格式为 NBT 二进制数据。 + +本工具的工作原理: +1. 解压 `.mcworld` 文件(本质是 ZIP 压缩包) +2. 打开 `db/` 目录中的 LevelDB 数据库 +3. 读取或写入 `~local_player` 数据 +4. 重新打包为 `.mcworld` 文件 + +--- + +## 更新日志 + +### v1.0.0 (2024-12-16) +- 初始版本 +- 支持提取和导入本地玩家数据 +- 支持 .mcworld 文件格式 diff --git a/libs/external/MCPlayerTransfer/main.py b/libs/external/MCPlayerTransfer/main.py new file mode 100644 index 0000000..59885c1 --- /dev/null +++ b/libs/external/MCPlayerTransfer/main.py @@ -0,0 +1,50 @@ +#!/usr/bin/env python3 +""" +Minecraft 基岩版角色转移工具 +""" + +import sys +import os + +sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'src')) + +from extract_player import extract_player +from import_player import import_player + + +def main(): + if len(sys.argv) < 2: + print(""" +Minecraft 基岩版角色转移工具 +============================ + +用法: + python main.py extract <.mcworld文件> + python main.py import <.mcworld文件> <.dat角色文件> + +示例: + python main.py extract "input/World.mcworld" + python main.py import "input/World.mcworld" "output/player.dat" + """) + return + + cmd = sys.argv[1].lower() + + if cmd == 'extract': + if len(sys.argv) < 3: + print("错误: 请提供 .mcworld 文件路径") + return + extract_player(sys.argv[2], "output") + + elif cmd == 'import': + if len(sys.argv) < 4: + print("错误: 请提供 .mcworld 文件和 .dat 角色文件") + return + import_player(sys.argv[2], sys.argv[3]) + + else: + print(f"未知命令: {cmd}") + + +if __name__ == '__main__': + main() diff --git a/libs/external/MCPlayerTransfer/requirements.txt b/libs/external/MCPlayerTransfer/requirements.txt new file mode 100644 index 0000000..3c4e04c --- /dev/null +++ b/libs/external/MCPlayerTransfer/requirements.txt @@ -0,0 +1 @@ +amulet-core>=1.9.0 diff --git a/libs/external/MCPlayerTransfer/src/__init__.py b/libs/external/MCPlayerTransfer/src/__init__.py new file mode 100644 index 0000000..92e12ef --- /dev/null +++ b/libs/external/MCPlayerTransfer/src/__init__.py @@ -0,0 +1 @@ +# MC Player Transfer diff --git a/libs/external/MCPlayerTransfer/src/extract_player.py b/libs/external/MCPlayerTransfer/src/extract_player.py new file mode 100644 index 0000000..ae3d8c1 --- /dev/null +++ b/libs/external/MCPlayerTransfer/src/extract_player.py @@ -0,0 +1,111 @@ +#!/usr/bin/env python3 +""" +Minecraft 基岩版角色提取工具 +输入: .mcworld 文件 +输出: 角色数据文件 (.dat) +""" + +import os +import sys +import zipfile +import tempfile +import shutil +from datetime import datetime + +def extract_player(mcworld_path, output_dir="output"): + """从 .mcworld 文件提取角色数据""" + + if not os.path.exists(mcworld_path): + print(f"错误: 文件不存在 - {mcworld_path}") + return None + + if not mcworld_path.endswith('.mcworld'): + print("错误: 请提供 .mcworld 文件") + return None + + # 创建输出目录 + os.makedirs(output_dir, exist_ok=True) + + # 获取世界名称 + world_name = os.path.splitext(os.path.basename(mcworld_path))[0] + + # 创建临时目录解压 + temp_dir = tempfile.mkdtemp() + + try: + print(f"正在解压: {mcworld_path}") + with zipfile.ZipFile(mcworld_path, 'r') as zip_ref: + zip_ref.extractall(temp_dir) + + # 查找 db 目录 + db_path = os.path.join(temp_dir, 'db') + if not os.path.exists(db_path): + # 可能在子目录里 + for root, dirs, files in os.walk(temp_dir): + if 'db' in dirs: + db_path = os.path.join(root, 'db') + break + + if not os.path.exists(db_path): + print("错误: 找不到 db 目录") + return None + + print(f"找到数据库: {db_path}") + + # 打开 LevelDB + import leveldb + db = leveldb.LevelDB(db_path) + + # 提取玩家数据 + player_data = db.get(b'~local_player') + + if not player_data: + print("错误: 找不到本地玩家数据") + return None + + # 保存到输出目录 + timestamp = datetime.now().strftime('%Y%m%d_%H%M%S') + output_file = os.path.join(output_dir, f"{world_name}_{timestamp}.dat") + + with open(output_file, 'wb') as f: + f.write(player_data) + + print(f"\n✓ 提取成功!") + print(f" 世界名称: {world_name}") + print(f" 数据大小: {len(player_data)} bytes") + print(f" 输出文件: {output_file}") + + del db + return output_file + + finally: + # 清理临时目录 + shutil.rmtree(temp_dir, ignore_errors=True) + + +def main(): + if len(sys.argv) < 2: + print(""" +Minecraft 基岩版角色提取工具 +============================ + +用法: + python extract_player.py <.mcworld文件> [输出目录] + +示例: + python extract_player.py "World.mcworld" + python extract_player.py "World.mcworld" ./output + +输出: + 角色数据文件 (.dat),可导入到其他存档 + """) + return + + mcworld_path = sys.argv[1] + output_dir = sys.argv[2] if len(sys.argv) > 2 else "output" + + extract_player(mcworld_path, output_dir) + + +if __name__ == '__main__': + main() diff --git a/libs/external/MCPlayerTransfer/src/import_player.py b/libs/external/MCPlayerTransfer/src/import_player.py new file mode 100644 index 0000000..053151f --- /dev/null +++ b/libs/external/MCPlayerTransfer/src/import_player.py @@ -0,0 +1,107 @@ +#!/usr/bin/env python3 +""" +Minecraft 基岩版角色导入工具 +输入: .mcworld 文件 + .dat 角色文件 +输出: 新的 .mcworld 文件 +""" + +import os +import sys +import zipfile +import tempfile +import shutil +from datetime import datetime + +def import_player(mcworld_path, player_dat, output_path=None): + """将角色数据导入到 .mcworld 文件""" + + if not os.path.exists(mcworld_path): + print(f"错误: 文件不存在 - {mcworld_path}") + return None + + if not os.path.exists(player_dat): + print(f"错误: 角色文件不存在 - {player_dat}") + return None + + # 读取角色数据 + with open(player_dat, 'rb') as f: + player_data = f.read() + print(f"读取角色数据: {len(player_data)} bytes") + + # 默认输出路径 + if output_path is None: + base = os.path.splitext(mcworld_path)[0] + output_path = f"{base}_imported.mcworld" + + # 创建临时目录 + temp_dir = tempfile.mkdtemp() + + try: + print(f"正在解压: {mcworld_path}") + with zipfile.ZipFile(mcworld_path, 'r') as zip_ref: + zip_ref.extractall(temp_dir) + + # 查找 db 目录 + db_path = os.path.join(temp_dir, 'db') + world_root = temp_dir + + if not os.path.exists(db_path): + for root, dirs, files in os.walk(temp_dir): + if 'db' in dirs: + db_path = os.path.join(root, 'db') + world_root = root + break + + if not os.path.exists(db_path): + print("错误: 找不到 db 目录") + return None + + # 写入玩家数据 + import leveldb + db = leveldb.LevelDB(db_path) + db.put(b'~local_player', player_data) + del db + + print("✓ 角色数据已写入") + + # 重新打包 + print(f"正在打包: {output_path}") + with zipfile.ZipFile(output_path, 'w', zipfile.ZIP_DEFLATED) as zipf: + for root, dirs, files in os.walk(world_root): + for file in files: + file_path = os.path.join(root, file) + arc_name = os.path.relpath(file_path, world_root) + zipf.write(file_path, arc_name) + + print(f"\n✓ 导入成功!") + print(f" 输出文件: {output_path}") + return output_path + + finally: + shutil.rmtree(temp_dir, ignore_errors=True) + + +def main(): + if len(sys.argv) < 3: + print(""" +Minecraft 基岩版角色导入工具 +============================ + +用法: + python import_player.py <.mcworld文件> <.dat角色文件> [输出文件] + +示例: + python import_player.py "World.mcworld" "player.dat" + python import_player.py "World.mcworld" "player.dat" "NewWorld.mcworld" + """) + return + + mcworld_path = sys.argv[1] + player_dat = sys.argv[2] + output_path = sys.argv[3] if len(sys.argv) > 3 else None + + import_player(mcworld_path, player_dat, output_path) + + +if __name__ == '__main__': + main()