3DS 游戏格式转换不求人：3dsconv 一条命令把 .3ds 变成 .cia

【免费下载链接】3dsconvPython script to convert Nintendo 3DS CCI (".cci", ".3ds") files to the CIA format项目地址: https://gitcode.com/gh_mirrors/3d/3dsconv

前阵子朋友兴冲冲地拷给我一个 3DS 游戏镜像，文件名后缀是.3ds。我满心欢喜地把文件塞进 SD 卡，打开 FBI 准备安装——结果发现压根装不了。查了一圈才明白：3DS 主机直接能装的是 CIA 格式，而.3ds/.cci这种卡带镜像必须先转换成 CIA 才能安装。就在我准备放弃、打算手动去翻各种老旧教程的时候，有人给我推荐了一个叫3dsconv的开源工具，它是一个用 Python 写的小脚本，专门把任天堂 3DS 的 CCI（.3ds/.cci）文件转换成可直接安装的 CIA 格式。我花了几分钟跑通之后只想说一句：怎么没早点遇见它。

先说清楚它到底解决了什么问题

3DS 游戏的"卡带镜像"和"安装包"是两种东西。前者是你用 GodMode9 之类工具从卡带里完整转储出来的原始镜像，后缀通常是.3ds；后者才是 FBI 等工具能识别、能写进主机内存的 CIA 安装包。3dsconv干的就是这两者之间的"翻译"工作，而且它最大的本事在于：能自动判断你的镜像到底是哪种加密状态，然后挑对应的路子去处理。

• 完全没加密的镜像，直接转；
• 用原始 NCCH 加密（slot 0x2C）的，它需要一份 boot9.bin 密钥文件来解密；
• 用 zerokey 加密的，它自己就能搞定。

你不需要去判断文件是哪种状态，脚本会替你读加密标志位，然后告诉你"这个文件是加密的 / 未加密的 / zerokey 加密的"。整个过程就是一句命令的事。

跟着我做：从零到第一次转换成功

先说环境。你需要一台装了 Python 3 的电脑（Windows、macOS、Linux 都行），然后按下面这几步走。

第一步，把项目拉下来：

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/3d/3dsconv cd 3dsconv

第二步，装解密依赖：

# 加密文件的解密依赖 pip install pyaes

这一步很重要。没有 pyaes，脚本也能跑，但遇到加密文件就只能干瞪眼。

第三步，确认脚本能正常启动。直接不带任何参数运行它，屏幕会打印出完整的用法说明：

# 不带参数运行，会打印帮助信息 python3 3dsconv/3dsconv.py

看到3dsconv.py ~ version 4.21和以Convert Nintendo 3DS CCI (.3ds/.cci) to CIA开头的那段说明，就说明环境没问题了。

第四步，正式转换第一个文件：

# 把 my_game.3ds 转换成 my_game.cia python3 3dsconv/3dsconv.py my_game.3ds -o my_game.cia

等一下，参数我写错了，正确的是--output=：

# 指定输出文件名或目录 python3 3dsconv/3dsconv.py my_game.3ds --output=./cia_files/

运行之后你会看到类似这样的输出：

Converting my_game (encrypted)... Writing Game Executable CXI... 45.2% 8126464 / 17971200

注意那个百分比进度条，它是实时刷新的，文件越大你越能体会到它的存在感。转换完成后，同目录（或你指定的输出目录）里就会多出一个my_game.cia，把它复制到 SD 卡，用 FBI 就能装了。

批量转换也顺带说说，因为这可能是你最常用的场景。脚本支持一次给多个文件，甚至支持通配符，比如我想把games/目录下所有.3ds一次性转掉：

# 批量转换 games 目录下所有 .3ds 文件 python3 3dsconv/3dsconv.py games/*.3ds --output=converted/

一批游戏丢进去，喝口水的功夫就全好了，比一个个手动操作舒服太多。

我在转换路上踩过的三个坑

工具本身很稳，但第一次用的时候我确实栽过几个跟头，都记下来了，你大概率也会遇到。

坑一：加密文件转不了，提示找不到 bootROM。我拿到的第一个游戏镜像是用原始 NCCH 加密的，直接跑转换，屏幕弹出一句Error: bootROM not found, encryption will not be supported。这时候我才知道：要解密这类文件，需要一份从 3DS 主机里提取的 ARM9 bootROM（俗称 boot9.bin）。如果你自己有一台破解过的 3DS，可以用 boot9strap 按住 START+SELECT+X 开机把它转储出来；网上也有很多现成途径，但请务必只在合法范围内使用。拿到boot9.bin之后，把它放到脚本所在目录，或者在命令里用--boot9=指过去：

# 显式指定 boot9.bin 的路径 python3 3dsconv/3dsconv.py my_game.3ds --boot9=./keys/boot9.bin

另外，这个脚本内置了 boot9.bin 的 SHA256 校验值（2f88744feed717856386400a44bba4b9ca62e76a32c715d4f309c399bf28166f），如果你下载的密钥文件不对，它会直接告诉你"密钥无效"，不会拿错误密钥硬算。我第一次就从某个来路不明的网站下到了坏文件，折腾半天才反应过来。建议拿到文件后先用sha256sum boot9.bin对一下。

坑二：文件明明存在，却说转换失败。有一次我重跑命令，脚本提示Error: "xxx.cia" already exists. Use --overwrite to force conversion.我一开始还以为是 bug，后来才明白这是它的防呆设计：默认不覆盖同名输出文件，避免你辛辛苦苦转出来的东西被意外冲掉。想重新转，加个--overwrite就行：

# 覆盖已存在的输出文件 python3 3dsconv/3dsconv.py my_game.3ds --overwrite

坑三：提示文件哈希对不上。还有个更隐蔽的情况：转换过程中突然冒出This file may be corrupt (invalid ExtHeader hash).。这通常是镜像在拷贝过程中损坏了，或者是个假加密状态的怪文件。如果你确定这个文件其实是未加密的，可以用--ignore-encryption让它忽略加密标志；如果只是哈希校验不通过但结构完好，就用--ignore-bad-hashes强制转换。我那次是前者——一个声称"已解密"但加密位还是置位的文件，加上--ignore-encryption后就顺利过了。

玩熟了之后，还能这么用

跑通基础转换之后，我发现这脚本还有不少进阶玩法，这里挑几个我实际用过的。

开发者版游戏用--dev-keys。如果你手头有开发机（dev-unit）用的游戏，转换时要加这个参数，它会改用开发密钥，并且会去找certchain-dev.bin证书链文件。注意输出的 CIA 仍是开发密钥加密的，只能在开发机上用——别指望拿它绕过零售机限制，README 里说得很清楚。

用环境变量省去反复指定路径。如果你不想每次都敲--boot9=，可以把密钥路径写进环境变量，一劳永逸：

# 设置 boot9.bin 的默认路径 export BOOT9_PATH="/home/me/keys/boot9.bin"

之后不带--boot9=参数，脚本也会按顺序去找：命令行指定 →BOOT9_PATH→ 当前目录的boot9.bin→boot9_prot.bin→~/.3ds/下的两个文件。

用--verbose看全过程。加了这个参数，脚本会把每一步都摊开给你看：Title ID、各分区大小、Normal Key、每一步的 SHA-256 哈希值……适合想搞清楚"它到底对我的文件做了什么"的人。

Windows 用户还能打成免 Python 的 exe。用 py2exe 可以把3dsconv.py打包成3dsconv.exe，之后在 Windows 上直接把.3ds文件拖到 exe 图标上就能转换，妈妈再也不用担心我记不住命令。

和整个 3DS 自制生态串起来用。我自己现在的工作流是这样的：GodMode9 从卡带转储出.3ds→ 3dsconv 转成.cia→ 有闲心的话用 ctrtool 验证一下 CIA 内部结构 → 拷贝到 SD 卡用 FBI 安装。这一套下来，从"手里有个游戏"到"主机里能玩"基本不需要碰任何图形化软件。

写在最后

说到底，3dsconv 就是个"小而美"的工具：一条命令、一个进度条、一堆稳妥的哈希校验，就把 3DS 游戏格式转换这件事从"折腾一下午"变成了"几十秒搞定"。它也提醒了我一件事——很多看起来吓人的技术问题，背后往往藏着某个帮你把脏活累活全干了的开源脚本。

最后提醒一句：请只转换你合法拥有的游戏备份，别拿它碰盗版资源。如果你在用的过程中发现了问题，或者有想加的功能，不妨去项目仓库提个 Issue 或者 Pull Request。这是个欢迎社区参与的开源项目，MIT 协议，谁都能来出一份力。去 clone 一份试试吧，第一条命令跑通之后，你会回来感谢自己的。

【免费下载链接】3dsconvPython script to convert Nintendo 3DS CCI (".cci", ".3ds") files to the CIA format项目地址: https://gitcode.com/gh_mirrors/3d/3dsconv