3dsconv 使用教程

1. 项目介绍

3dsconv 是一个基于 Python 3 的脚本工具，用于将任天堂 3DS 的 CTR Cart Image 文件（通常扩展名为 .cci 或 .3ds) 转换为 CTR Importable Archive 格式（即 .cia 文件）。此工具支持原始 NCCH 加密的解密以及 zerokey 加密的处理。转换过程可能需要 pyaes 库。此外，对于原版 NCCH 加密，还需要提供保护的 ARM9 启动 ROM。

2. 项目快速启动

环境准备

确保你已经安装了以下软件：

• Python 3.x
• pip (Python 包管理器)

安装 3dsconv

打开终端或命令提示符，运行以下命令来安装 3dsconv：

pip install git+https://github.com/ihaveamac/3dsconv.git

转换文件

要转换 .cci 或 .3ds 文件，使用以下命令：

3dsconv input_file.cci output_file.cia

将 input_file.cci 替换为你的源文件路径，output_file.cia 替换为目标 .cia 文件名。

3. 应用案例和最佳实践

• 游戏卡带备份：如果你有一个能够导出游戏卡片数据的工具（如 Decrypt9WIP 或 GodMode9），你可以利用 3dsconv 将 .cci 文件转换成 .cia 文件，然后通过 3DS 的系统导入功能进行备份。
• 加密管理：在需要处理加密游戏时，正确配置 3dsconv 的选项以解密或验证 NCCH 加密。
• 多版本管理：为不同版本的游戏创建不同的 .cia 备份，便于管理和更新。

4. 典型生态项目

3dsconv 主要是独立使用的工具，但与其他任天堂3DS相关的项目结合使用可以提升用户体验，例如：

• Decrypt9WIP：一个3DS自制程序，用于读取和修改3DS固件及游戏数据。
• GodMode9：类似的功能强大的工具，允许直接对3DS文件系统操作。
• hblauncher：作为3DS上的Homebrew Launcher，可以用来运行自制程序，包括3dsconv的执行环境。

这些生态项目共同构成了3DS社区中管理游戏的核心工具链。