如何快速转换3DS游戏文件？3dsconv：Nintendo 3DS爱好者的终极CCI转CIA工具

3dsconv是一款免费开源的Python脚本工具，专为Nintendo 3DS玩家设计，能够快速将CCI格式（.cci、.3ds）游戏文件转换为CIA格式。无论是解密文件检测还是高级加密处理，这款工具都能轻松应对，让你的3DS游戏管理更高效。

🌟 为什么选择3dsconv？核心功能解析

✅ 一键格式转换：3DS游戏文件的万能转换器

3dsconv的核心功能是将Nintendo 3DS的CTR Cart Image（CCI）文件无损转换为CTR Importable Archive（CIA）格式。只需简单操作，即可让你的游戏文件兼容更多3DS自制系统，无需复杂的命令行知识。

🔍 智能加密识别：三种加密状态自动检测

工具能精准识别CCI文件的加密状态：

• 已解密文件
• 原始NCCH加密（slot 0x2C）
• zerokey加密文件

对于加密文件，3dsconv需要pyaes支持（通过pip install pyaes安装），原始NCCH加密则需ARM9引导ROM文件（详情见下文）。

⚙️ 丰富高级选项：定制你的转换体验

3dsconv提供多种实用参数，满足进阶用户需求：

• --output=<dir>：指定输出目录（默认当前目录）
• --boot9=<file>：设置ARM9引导ROM路径
• --overwrite：覆盖已存在的转换文件
• --ignore-bad-hashes：忽略无效哈希值继续转换
• --ignore-encryption：忽略加密头部，强制按未加密文件处理
• --verbose：显示详细转换过程
• --dev-keys：使用开发者单元密钥（适用于系统更新等特殊标题）

🚀 快速上手：3dsconv安装与基础使用

🔧 两种安装方式：适合不同用户需求

方法1：直接使用脚本（推荐新手）

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/3d/3dsconv
2. 进入目录：cd 3dsconv
3. 直接运行：python3 3dsconv.py game.3ds

方法2：系统安装（适合频繁使用）

python3 setup.py install

安装后可在任何目录直接调用：3dsconv game.3ds

🖱️ Windows用户福利：拖拽即转换

在Windows系统中，只需将CCI文件直接拖拽到3dsconv.exe图标上，即可自动完成转换，无需命令行操作！

🔒 高级加密处理：ARM9引导ROM配置指南

📌 什么是ARM9引导ROM？

ARM9引导ROM（boot9.bin）是处理原始NCCH加密文件必需的组件。3dsconv会按以下顺序查找该文件：

1. --boot9参数指定路径
2. 当前目录的boot9.bin（完整版本）或boot9_prot.bin（保护版本）
3. 用户主目录.3ds文件夹下的对应文件

📥 如何获取boot9.bin？

通过boot9strap获取：

1. 按照3DS Guide教程安装boot9strap
2. 开机时按住START+SELECT+X组合键
3. 引导ROM会自动 dump 到SD卡的sdmc:/boot9strap/boot9.bin

🔍 验证文件完整性：官方SHA256值

• boot9.bin: 2f88744feed717856386400a44bba4b9ca62e76a32c715d4f309c399bf28166f
• boot9_prot.bin: 7331f7edece3dd33f2ab4bd0b3a5d607229fd19212c10b734cedcaf78c1a7b98

👨💻 开发者模式：系统更新标题转换教程

📋 什么是开发者模式？

使用--dev-keys参数可启用开发者模式，专为加密的系统更新标题设计。此模式需要certchain-dev.bin证书链文件，工具会在以下位置查找：

• 当前目录
• 用户主目录.3ds文件夹

📝 如何获取certchain-dev.bin？

从开发者版CIA中提取：

ctrtool --certs=certchain-dev.bin title.cia

官方SHA256值：7921ae82c9dcf411351314f2fe2c67378c6a872d2524f71b3c002b4d4a56846f

📦 Windows独立版制作：无需Python环境运行

如果你需要在没有Python的Windows电脑上使用3dsconv，可以将其打包为独立EXE文件（需Python 3.4环境，3.5+暂不支持）：

1. 克隆仓库并进入目录
2. 打开命令提示符，运行：

py -3.4 -m py2exe.build_exe 3dsconv.py -b 0

3. 生成的3dsconv.exe位于dist文件夹中

⚠️ 注意事项：工具局限性说明

虽然3dsconv功能强大，但需注意：

• Decrypt9WIP和GodMode9已支持直接将游戏卡dump为CIA格式
• 开发者模式转换的CIA文件仍需在开发者单元上使用
• 零售密钥加密的标题需外部解密才能转换

📜 开源许可与致谢

3dsconv采用MIT许可证，核心依赖pyaes同样为MIT许可。2.0版本前的历史代码可在Gist查看。

无论是3DS自制系统爱好者还是游戏开发者，3dsconv都是你管理游戏文件的得力助手。简单、高效、免费——立即尝试，让3DS文件转换变得前所未有的轻松！