DevilutionX 3DS 平台完全指南：安装、操作与性能调优
DevilutionX 3DS 平台完全指南：安装、操作与性能调优
本指南以 docs/manual/platforms/3ds.md 为主体，系统讲解《暗黑破坏神 1》开源重制版 DevilutionX 在 Nintendo 3DS 上的安装方法、完整按键操作、触屏交互、跨平台多人联机、语言与字体处理，以及老款 3DS 机型上的性能优化方案。读完本文，你将掌握 3DS 版 DevilutionX 从部署到流畅运行的完整实操技能，并能理解其背后的平台实现原理（数据目录定位、系统语言检测与画面缩放逻辑）。
一、安装与数据文件准备
3DS 版的安装与其他平台一致：先在 DevilutionX 的 Releases 页面获取最新发布包，然后参照 docs/installing.md 中的通用安装说明操作。
在放入游戏文件之前，你需要先准备以下数据文件：
DIABDAT.MPQ：游戏本体数据，取自《暗黑破坏神》原版光盘或 GoG 安装目录；hellfire.mpq、hfmonk.mpq、hfmusic.mpq、hfvoice.mpq：地狱火资料片数据（可选）；devilutionx.mpq：DevilutionX 自带的必要资源包，运行游戏所必需；fonts.mpq：中、韩、日文用户必需，否则文字将无法显示（详见下文"翻译与语言"一节）。
在 3DS 上，这些 MPQ 文件与游戏配置（diablo.ini）共用同一个目录：SD 卡上的 /3ds/devilutionx。这一路径并非约定俗成，而是由源码硬编码实现的——在 Source/utils/sdl2_to_1_2_backports.cpp 中，3DS 平台的 SDL_GetBasePath() 被实现为返回 "file:sdmc:/3ds/devilutionx/"，而 SDL_GetPrefPath() 则返回 "sdmc:/3ds/devilutionx/"（同一文件 L876-L878），也就是说游戏的可执行文件目录、数据目录与配置目录在 3DS 上全部收敛于这一处，把 MPQ 复制进去即可被游戏识别。
从源码构建角度，3DS 目标由 devkitARM + libctru 工具链支撑：根 CMakeLists.txt 在 NINTENDO_3DS 条件下配置了应用标题、图标（Packaging/ctr/icon.png）、横幅（Packaging/ctr/banner.png）与 Packaging/ctr/template.rsf，并通过 CMake/platforms/ctr/Tools3DS.cmake 调用 3dsxtool、smdhtool/bannertool、makerom 等工具生成 .3dsx（自制软件）与 .cia（可安装到主机的数字包） 两种格式产物，同时提供 3dslink 网络加载目标便于调试。如果以 .3dsx 方式通过 Homebrew Launcher 运行，也属于官方支持的加载形态。
二、启动与基础操作
将游戏文件就绪后，直接从 3DS 主菜单（Homemenu）启动 Diablo 即可进入游戏。
一个值得注意的硬件前提：3DS 版运行依赖 DSP 固件文件。在 Source/platform/ctr/system.cpp 中，游戏会尝试读取 sdmc:/3ds/dspfirm.cdc，若缺失则提示运行 DSP1 应用至少一次以转储 DSP 固件。因此首次运行前，建议先通过 Homebrew 环境中的 DSP1 工具完成固件转储，否则音频相关功能可能无法正常工作。
完整按键对照表
3DS 版为双手柄布局设计了一套完整的快捷键体系（源文档 docs/manual/platforms/3ds.md 定义）：
| 按键组合 | 功能 |
|---|---|
| Circle-Pad 或 D-Pad | 移动英雄 |
| A | 攻击附近敌人、与镇民/商人对话、拾取/放置背包物品、主菜单中确认 |
| B | 选择法术、菜单中返回 |
| X | 拾取物品、开启附近箱子与门、使用背包中的物品 |
| Y | 施放法术、主菜单中删除角色 |
| L | 使用腰带中的生命药剂 |
| R | 使用腰带中的法力药剂 |
| Start + ↑ | 游戏菜单（备用：Start + Select） |
| Start + ↓ | 切换自动地图 |
| Start + ← | 角色面板（备用：ZL 或 Start + L） |
| Start + → | 物品栏（备用：ZR 或 Start + R） |
| Start + X | 切换画面缩放（Zoom） |
| Select + D-Pad | 移动自动地图或模拟鼠标 |
| Select + A/B/X/Y | 法术快捷键 |
| C-stick | 移动自动地图或模拟鼠标 |
| Select + ZL | 任务日志（备用：Start + Y） |
| Select + ZR | 法术书（备用：Start + B） |
该按键方案在源码层面由 Source/controls 目录下的输入映射与控制器处理逻辑（如 controller.cpp、controller_buttons.cpp）统一实现，Start/Select 组合键的修饰语义对应 modifier_hints.cpp 中的修饰键机制，便于单手快捷操作。
三、触屏操作
3DS 下屏（触控屏）提供鼠标替代能力，与"Select + D-Pad / C-stick 模拟鼠标"的操作互为补充：
- 单指拖拽：移动鼠标指针（指针会直接跳到手指所在位置）；
- 单指短点按：等同于鼠标左键单击。
这套触屏模拟在源码上对应 Source/controls/touch 目录下的触控处理实现，使 3DS 在缺少外接鼠标时仍可完成指向、点击等精确操作，尤其适用于物品栏整理与地图交互。
四、多人联机（TCP 跨平台）
3DS 版目前支持 TCP 模式的跨平台多人联机。进行联机前，你需要：
- 在主机的系统设置中开启 Wi-Fi 并配置网络连接；
- 按常规 TCP 游戏联机方式准备网络环境（端口转发、公网可达等）。
需要注意两个性能事实（源文档明确说明）：
- 客机（Guest）的游玩体验通常优于主机（Host）；
- 进行跨平台联机时，建议在硬件性能更强的其他平台上开房，让 3DS 作为客机加入，以获得更流畅的帧率表现。
从平台实现看，3DS 的网络能力由 Source/platform/ctr/sockets.cpp 与配套的 asio 兼容层（Source/platform/ctr/asio 下实现了 sys/socket.h、netinet/in.h 等 BSD Socket 头文件，并经由 CMake/platforms/ctr/asio_defs.cmake 接入）支撑，上层网络栈仍复用 Source/dvlnet 的抽象网络层（tcp_client/tcp_server 等），因此 3DS 能够无缝加入与 PC、Android 等平台互通的 TCP 游戏。
五、翻译与语言设置
自动语言检测
3DS 版会根据主机系统语言自动匹配游戏语言，无需手动配置。这一行为由 Source/platform/ctr/locale.cpp 实现：游戏通过 libctru 的 CFGU_GetSystemLanguage() 读取系统语言代码，并将其映射到 DevilutionX 的语言标识，例如：
CFG_LANGUAGE_JP→ja（日语）CFG_LANGUAGE_EN→en（英语）CFG_LANGUAGE_ZH→zh_CN（简体中文）CFG_LANGUAGE_TW→zh_TW（繁体中文）CFG_LANGUAGE_KO→ko（韩语）- 以及
fr、de、it、es、nl、pt_BR、ru等
仓库 Translations 目录中的各语言 .po 文件（如 Translations/zh_CN.po、Translations/ja.po、Translations/ko.po）即是对应语言包的来源。
中/韩/日文字体与内存限制
中文、韩文、日文用户必须额外下载 fonts.mpq 放入 /3ds/devilutionx，否则这些语言文字将缺失（空白）。这是因为 CJK 字符集的字形并未内置在基础资源包中，需要单独的字体文件提供。
同时请注意：目前不建议在老款 3DS（old 3DS）机型上使用中、韩、日文翻译。原因在于：游戏会在游玩过程中按需把额外字形符号加载进系统内存，而老款 3DS 的内存不足以容纳全部 CJK 符号，长时间游玩可能因内存耗尽而导致游戏崩溃。若你的机器是新款 3DS（New 3DS），内存更充裕，风险相对较低，但仍建议留意。
手动切换语言
如果需要覆盖系统语言检测，可以修改 diablo.ini 配置文件中的语言项（参考官方配置指南中关于 Language 的说明）。3DS 的配置文件目录与 MPQ 数据目录相同，即 SD 卡上的 /3ds/devilutionx，将修改后的 diablo.ini 放入该目录即可生效。
六、性能优化（老款 3DS 重点）
新款 3DS（New 3DS）的硬件相比老款（old 3DS）有显著提升，因此性能问题主要出现在老款机型上。优化手段同样是编辑 /3ds/devilutionx/diablo.ini。
最关键一步：恢复 640×480 原始分辨率
将画面设置为《暗黑破坏神》原版分辨率 640×480 可获得立竿见影的性能提升：
[Graphics]
Width=640
Height=480
改完分辨率后，若希望游戏画面拉伸铺满上屏全部区域，使用 Fit to Screen=1；若不喜欢画面被拉伸变形，则保持 Fit to Screen=0。
这一设置的底层行为可以在源码中看到：Source/platform/ctr/display.cpp 中的 Get3DSScalingFlag() 根据 Fit to Screen 与宽高比决定 SDL1 的缩放标志——开启时返回 SDL_FULLSCREEN（铺满全屏），关闭时若画面较宽（width * 3 < height * 5）则使用 SDL_FITHEIGHT，否则使用 SDL_FITWIDTH，即在不拉伸的前提下尽量贴合屏幕。
3DS 适用的图形设置全集
由于 3DS 使用的是 SDL1 图形后端（而非 SDL2），许多通用图形选项在 3DS 上不生效。以下列表是 3DS 上完整可用的全部图形设置项：
- Width：宽度（建议 640）
- Height：高度（建议 480）
- Fit to Screen：是否拉伸铺满上屏（0/1）
- Blended Transparency：混合透明度
- Gamma Correction：伽马校正
- Color Cycling：颜色循环（用于表现岩浆、水等动态色效）
- FPS Limiter：帧率限制器
除此之外的其他图形选项可以忽略，不会对 3DS 版产生实际作用。结合 Source/options.cpp 中的选项解析实现可知，这些项在启动时从 diablo.ini 读取并应用到渲染循环，修改后重启游戏即可生效。
七、资源与进一步阅读
- 更多安装细节与全平台数据文件准备：见 docs/installing.md；
- 从源码构建 3DS 版本：见 docs/building.md；
- 其他掌机平台的移植文档（Switch、Vita、RG350 等）：见 docs/manual/platforms 目录；
- 3DS 平台构建与打包脚本：见 CMake/platforms/ctr 与 Packaging/ctr；
- 3DS 平台运行时代码：见 Source/platform/ctr。
总结
DevilutionX 的 3DS 移植版将经典《暗黑破坏神》完整地带到了掌机上：通过 /3ds/devilutionx 统一的数据/配置目录、自动化的系统语言检测、完整的手柄与触屏映射，以及 TCP 跨平台联机支持，玩家几乎可以无门槛地在 3DS 上重温庇护之地。如果你使用老款 3DS，优先执行"640×480 分辨率 + 关闭拉伸"的性能优化方案，并谨慎使用中/韩/日翻译以避免内存耗尽；如果你的机器是新款 3DS，则可以按喜好开启更高的图形设置与 CJK 字体支持。