3dsconv 使用教程3 步把 3DS 游戏从 CCI 转成 CIA【免费下载链接】3dsconvPython script to convert Nintendo 3DS CCI (.cci, .3ds) files to the CIA format项目地址: https://gitcode.com/gh_mirrors/3d/3dsconv你的 SD 卡里躺着一堆.3ds卡带镜像想装进 3DS 主机却被告知格式不支持——这是许多 3DS 玩家都遇到过的事。3dsconv正是为解决这个痛点而生的开源小工具它用 Python 编写可以把任天堂 3DS 的 CCI.cci/.3ds文件转换为 3DS 能直接安装的 CIA 格式一条命令完成转换全程无需手动干预。下面这份 3dsconv 使用教程会带你从安装走到原理再到排错。动手前的 3 步准备安装到首次转换第 1 步克隆仓库并安装依赖项目依赖极简只有一个加密库pyaes它负责 AES-CTR 加解密。git clone https://gitcode.com/gh_mirrors/3d/3dsconv cd 3dsconv pip install pyaes第 2 步确认工具能跑起来直接运行主脚本且不带任何参数工具会打印版本号和完整的帮助信息python3 3dsconv/3dsconv.py看到3dsconv.py ~ version 4.21以及以Convert Nintendo 3DS CCI (.3ds/.cci) to CIA开头的帮助文本就说明一切就绪。你也可以写个小脚本做自动化验证#!/usr/bin/env python3 # verify_3dsconv.py —— 验证工具是否就绪 import subprocess result subprocess.run( [python3, 3dsconv/3dsconv.py], # 不带参数会打印版本号和帮助信息 capture_outputTrue, textTrue ) if Convert Nintendo 3DS CCI in result.stdout: print(3dsconv 已就绪可以开始转换) else: print(输出异常, result.stdout, result.stderr)第 3 步执行第一条转换命令单个文件转换只需一行命令--output指定输出目录python3 3dsconv/3dsconv.py my_game.3ds --outputcia_files/批量转换同样简单把多个文件一次性传给脚本即可python3 3dsconv/3dsconv.py game1.3ds game2.3ds game3.3ds --outputcia_files/转换过程中你会看到实时的进度条百分比 已处理字节数结束后命令行会汇总成功转换了 N 个文件。如果目标目录里已有同名.cia脚本会拒绝覆盖并提示你加上--overwrite。一行命令背后CCI 转 CIA 发生了什么知其然也要知其所以然理解内部流程能帮你排查 90% 的报错。整个转换可以拆成四步验证文件身份读取0x100处的 4 字节必须是NCSD再检查 Game Executable 分区头部必须是NCCH。这一步能拦截掉 NAND 转储等伪装文件。判断加密状态读取分区偏移0x18F处的加密标志位决定走哪条解密路线。提取并重组内容抽出 Game Executable CXI、Manual CFA、Download Play 子容器等分区同时从 ExeFS 中提取游戏图标SMDH。重构 CIA 容器按规范写入 CIA 头、证书链、ticket、tmd、分块记录与 Meta 区并在过程中实时计算 SHA-256 写入各字段。其中最有意思的是第 2 步——加密检测。源码里的判断逻辑非常直白# 读取加密标志位Game Executable 分区偏移 0x18F 处 rom.seek(game_cxi_offset 0x18F) bitmask rom.read(1)[0] encrypted not (bitmask 0x4) # 0x4 位未置位 → 原版 NCCH 加密slot 0x2C zerokey_encrypted bitmask 0x1 # 0x1 位置位 → zerokey 加密也就是说一个 CCI 文件在工具眼里只有三种状态未加密、原版 NCCH 加密和zerokey 加密。对加密文件脚本会结合 boot9 中提取的密钥与分区头部的 KeyY 推导出解密密钥用 pyaes 的 CTR 模式解密 ExtHeader 和 ExeFS 头部完成转换后还会把补丁后的头部重新加密写回保证输出文件符合 3DS 的安装规范。加密游戏怎么处理boot9.bin 的获取与搜索顺序如果你的.3ds是加密的大多数自购卡带 dump 都是工具需要一份ARM9 bootROM来推导密钥。获取方法很简单在已安装 boot9strap 的 3DS 主机上开机时按住START SELECT Xboot9 就会被转储到 SD 卡的sdmc:/boot9strap/boot9.bin。拿到文件后把它放进以下任一位置即可脚本会按顺序自动查找查找顺序位置说明1--boot9参数或环境变量BOOT9_PATH用户显式指定优先级最高2当前目录下的boot9.bin完整版 bootROM3当前目录下的boot9_prot.bin受保护版 bootROM4~/.3ds/boot9.bin完整版用户主目录5~/.3ds/boot9_prot.bin受保护版用户主目录为了确认文件完整可以用官方给出的哈希值校验sha256sum boot9.bin # 期望输出2f88744feed717856386400a44bba4b9ca62e76a32c715d4f309c399bf28166f工具内置了密钥校验会在加载 boot9 时比对 key 的 MD5文件不对会提示Corrupt file (invalid key)。如果没找到 boot9启动时会直接提示bootROM not found, encryption will not be supported这时处理加密文件必然失败。进阶选项一览从覆盖写到开发者密钥工具的参数不多但每个都有明确的适用场景参数作用典型用法--outputdir指定输出目录--output./cia_files--boot9file指定 boot9.bin 路径--boot9./keys/boot9.bin--overwrite覆盖已存在的输出文件--overwrite--ignore-bad-hashes忽略无效哈希强行转换--ignore-bad-hashes--ignore-encryption无视加密标志位按未加密处理--ignore-encryption--verbose打印详细过程密钥、各分区大小、哈希--verbose--dev-keys使用开发机密钥进行转换--dev-keys组合使用很常见比如处理一个已解密的 ROM同时希望看到详细日志python3 3dsconv/3dsconv.py my_game.3ds --outputcia_files/ --overwrite --verbose关于--dev-keys要特别说明它只适用于开发机加密的标题主要用于 SystemUpdater而且输出文件仍然是开发机密钥加密的普通零售机装不了。使用前需要把certchain-dev.bin放在当前目录或~/.3ds/下可以用ctrtool --certscertchain-dev.bin title.cia从开发版 CIA 中提取。零售版游戏请勿使用此参数。另外工具还支持通过环境变量BOOT9_PATH预设 boot9 路径适合在多项目间复用的场景export BOOT9_PATH/path/to/your/boot9.bin高频报错排错症状、原因与解法这里整理了几个最常见的报错按症状 → 原因 → 解法的节奏快速定位症状原因解法bootROM not found, encryption will not be supported没装 pyaes 或没找到 boot9pip install pyaes按搜索顺序表放好 boot9或用--boot9指定This file may be corrupt (invalid ExtHeader hash)加密状态判断错误或文件确实损坏已解密的 ROM 加--ignore-encryption确认文件无误后再加--ignore-bad-hashesxxx.cia already exists输出目录已有同名文件加上--overwritexxx doesnt exist.路径写错或通配符没匹配到文件检查路径脚本支持*.3ds这类通配符is not a CCI file (missing NCSD/NCCH magic)输入文件不是合法的 CCI如 NAND 转储确认文件确实是卡带 dumpIcon not found in the ExeFS.分区内找不到游戏图标数据多为文件异常换源重新 dump一个实用建议遇到任何可疑情况都先加--verbose重跑一遍。它会打印标题 ID、各分区大小、解密密钥、每段的 SHA-256信息量足够定位绝大多数问题。几点避坑提醒与诚实的说明最后是一些实战中的经验总结工具定位README 里作者自己说明了Decrypt9WIP 和 GodMode9 如今已支持直接把卡带转储为 CIA3dsconv因此部分过时但对于手头已有的存量.3ds转储文件它依然是最轻量、最省事的转换方案。转换前先备份永远保留原始.3ds文件转换过程是只读输入、新建输出的但以防万一。磁盘空间一个 4GB 的 CCI 转出的 CIA 体积接近原始大小请确保输出盘有足够空间。合法使用请只转换自己合法拥有的游戏备份不要涉及盗版分发。掌握这几个要点你已经能用3dsconv独立完成从卡带转储到 CIA 安装的全流程。装上游戏享受掌上时光吧。【免费下载链接】3dsconvPython script to convert Nintendo 3DS CCI (.cci, .3ds) files to the CIA format项目地址: https://gitcode.com/gh_mirrors/3d/3dsconv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
