企业官网建设流程全解析

zelda-tmc-3ds是一个将《塞尔达传说：缩小帽》（The Minish Cap）原生移植到 Nintendo 3DS 的开源项目，基于 Project Picori 开发，支持 CIA 与 3DSX 两种安装方式，配合 GBA ROM 即可在 3DS 双屏上体验真宽屏的塞尔达缩小帽冒险。本文是一篇面向新手的完整安装教程，只需约 10 分钟即可完成 CIA/3DSX 安装与 ROM 配置。

zelda-tmc-3ds 是什么？先了解 3 个核心亮点

在开始安装之前，花 1 分钟了解一下这个项目能给你什么：

• 原生 3DS 双屏体验🎮：上屏为 400x240 真宽屏游戏画面，下屏提供实时地图、地下城信息、任务状态和触摸道具栏
• 新旧 3DS 均可流畅运行：New 3DS 自动启用 804 MHz 加速、L2 缓存和多核渲染；Old 3DS 使用优化渲染器与自适应掉帧策略，保证引擎 60 Hz 稳定推进
• 内置更新器与诊断工具：游戏内Settings > Update可切换 Stable / Pre-release 通道在线更新；遇到问题按L + R + A即可生成诊断快照

安装前准备：3 项检查清单

在动手之前，请确认你已具备以下条件：

⚠️重要提示：本项目不附带任何 ROM 或任天堂游戏资源，你必须自己提供合法获得的 GBA ROM。ROM 仅保存在 SD 卡本地，永远不会被打包进 CIA 中。

一键安装步骤：CIA / 3DSX 二选一

方式一：CIA 安装（推荐，用 FBI）

1. 将tmc-3ds-v2.2.cia复制到 SD 卡任意位置
2. 打开FBI文件管理器，找到该文件并选择安装
3. 安装完成后，主界面会出现塞尔达缩小帽的图标

方式二：3DSX 安装（用 Homebrew Launcher）

将tmc-3ds-v2.2.3dsx复制到sdmc:/3ds/下，通过Homebrew Launcher启动即可。

ROM 配置一步到位：创建文件夹 + 放入 ROM

这是最关键的一步，只需两条命令式操作：

1. 在 SD 卡上创建如下文件夹（注意名称和空格，必须完全一致）：

sdmc:/3ds/The Minish Cap 3DS/

2. 将你的.gbaROM 放入该文件夹，文件名随便起，只要扩展名是.gba即可。

游戏启动时会自动识别 USA 和欧洲版的游戏代码，并加载对应的内部数据配置，无需任何额外设置。

推荐选用欧洲版 ROM

官方强烈建议使用欧洲版 ROM，原因有三：

• 它是整个移植开发过程中测试最充分的版本，USA 版在某些关卡可能存在未被覆盖到的差异行为
• 欧洲版自带多语言（包含英文），使用它没有任何劣势
• 项目原生支持欧洲版玩法回移，无需打补丁 ROM

你也可以用 SHA-1 校验值确认 ROM 是否干净（未修改）：

USA: b4bd50e4131b027c334547b4524e2dbbd4227130 Europe: cff199b36ff173fb6faf152653d1bccf87c26fb7

完整校验文件可在 docs/roms/tmc.sha1 和 docs/roms/tmc_eu.sha1 中查阅（另附 SHA-256 版本）。

首次启动：画面设置怎么选

进入游戏后，建议先到Settings（设置）里配置画面：

• 上屏比例：Wide（宽屏，推荐）、Original（原始 4:3）、Stretch（拉伸）
• 显示风格：Blur（线性滤波）、Bilinear（2 倍锐化双线性）、Pixel Perfect（逐像素完美还原）

比例与滤镜相互独立，例如Wide + Pixel Perfect会保留正常宽屏视野。所有设置会自动持久保存，下次启动自动恢复。

常见问题 FAQ：音频、更新与崩溃排查

🔊 游戏没有声音？

音频依赖 3DS 的 DSP 固件。如果自制软件音频不工作，请打开Luma3DS 的 Rosalina 菜单，使用：

Miscellaneous options > Dump DSP firmware

导出固件后重启游戏即可。

🔄 如何更新到新版本？

游戏内置更新器：打开Settings > Update，选择Stable或Pre-release通道，点按版本号可在上屏阅读更新日志，确认Download Update后自动下载并安装。注意：更新前请先保存游戏，更新成功后应用会关闭。CIA 版会校验标题 ID 与 SHA-256，3DSX 版带回滚保护，更新失败不影响现有安装。

💥 崩溃或画面异常怎么办？

按L + R + A组合键，游戏会暂停并在sdmc:/3ds/The Minish Cap 3DS/dumps/下生成诊断转储（截图、内存、运行状态、性能数据等）。报 Bug 时附上该转储，能大幅帮助开发者定位问题。

总结：你的 10 分钟行动清单

1. ✅ 从 Releases 下载tmc-3ds-v2.2.cia（或 3DSX）
2. ✅ 用 FBI 安装 CIA（或放入 Homebrew Launcher）
3. ✅ 创建sdmc:/3ds/The Minish Cap 3DS/文件夹
4. ✅ 放入合法获得的.gbaROM（推荐欧洲版）
5. ✅ 启动游戏，配置宽屏画面，开始冒险 🗡️

更多细节可参考 README.md 主文档、platform/3ds/README.md 平台指南与 docs/INSTALL.md 构建安装说明。祝你在迷你世界的冒险愉快！