BotW-Save-Manager 使用教程

项目介绍

BotW-Save-Manager 是一个专为《塞尔达传说：旷野之息》（Breath of the Wild）设计的存档管理工具，支持任天堂Switch和Wii U平台的存档文件转换。该项目基于WemI0的BOTW_SaveConv项目进行更新和扩展，使用DotNET 6框架开发，支持Windows和Linux系统。

重要提示：此工具不是存档编辑器！如果您需要编辑存档内容，请使用Marc Robledo的BOTW存档编辑器来修改存档内容，该编辑器支持WiiU和Switch文件。

环境准备

在开始使用BotW-Save-Manager之前，请确保您的系统已安装DotNET 6.0 Runtime。您可以从微软官方下载并安装：

• Windows x64系统：下载DotNET 6.0 Runtime for Windows
• Linux系统：查看DotNET 6.0 Linux安装指南

快速启动

下载与安装

1. 访问项目仓库并下载最新版本的BotwSaveEditor
2. 解压下载的文件到您选择的目录
3. 运行BotwSaveEditor.exe文件

注意：在Windows上运行时可能会遇到SmartScreen警告，这是因为应用程序未签名。对于社区项目来说，签名应用程序成本较高，因此这是正常现象。请选择"更多信息"并点击"仍要运行"。

使用方法

桌面应用程序

常规方法：

1. 打开存档：使用文件 > 打开存档文件夹 (Ctrl + O)或双击界面浏览WiiU或Switch存档文件夹，也可以直接将存档文件夹拖放到界面上
2. 转换存档：打开存档后，点击转换按钮，浏览并选择一个空文件夹来保存转换后的文件
3. 查看日志：转换过程中会显示调试日志记录转换进度
4. 完成转换：转换完成且没有错误时，会提示转换成功

快速方法：

1. 快速转换：使用文件 > 转换存档 (F3)，导航到WiiU或Switch存档文件夹
2. 选择输出：在第二个文件夹选择提示中，浏览并选择一个空文件夹来保存转换后的文件
3. 等待完成：等待转换过程完成并确认成功提示

控制台应用程序

1. 拖放存档：将WiiU或Switch存档文件夹拖放到控制台窗口
2. 选择输出：等待存档处理完成后，将一个空文件夹拖放到控制台窗口来保存转换后的文件
3. 等待完成：再次等待直到显示完成消息

技术原理

BotW-Save-Manager通过分析存档文件的结构和特定的二进制模式来识别和转换不同平台的存档格式。核心转换逻辑位于BotwSaveManager.Core/BotwSave.cs文件中，该文件定义了：

• SaveType枚举：标识WiiU和Switch存档类型
• 文件头识别：通过特定的二进制头标识不同版本的游戏存档
• 哈希验证：使用预定义的哈希值验证存档完整性
• 字节顺序转换：根据不同平台的需求反转字节顺序

应用场景

跨平台存档转移

如果您在Wii U上玩《塞尔达传说：旷野之息》，并希望将存档转移到Switch上继续游戏，可以使用此工具将Wii U的存档文件转换为Switch格式。

存档备份与恢复

定期备份存档文件是一个好习惯。使用此工具，您可以轻松地将当前存档转换并保存到另一个文件夹，以便在需要时恢复。

项目结构

项目采用模块化设计，主要包含：

• BotwSaveManager.Core：核心转换逻辑库
• BotwSaveManager：桌面应用程序界面
• BotwSaveManager.Console：控制台应用程序

核心功能类包括：

• BotwSave：处理存档加载和转换
• DirectoryHelper：目录操作辅助类
• Logger：日志记录功能
• Extensions：扩展方法集合

注意事项

1. 转换目前支持相同更新版本的BOTW Switch和WiiU存档文件（升级/降级未经测试）
2. 确保目标文件夹为空，以避免文件冲突
3. 转换过程中会自动创建源目录的备份
4. 如果遇到版本识别问题，可以使用跳过版本检查选项

通过本教程，您应该已经掌握了BotW-Save-Manager的基本使用方法。希望这个工具能帮助您更好地享受《塞尔达传说：旷野之息》的游戏体验！