SWITCH EMULATION GUIDE

Switch 模拟器与 OCW 安装指南

任天堂马造聊天群：1006352506

OCW 官方网站Eden 项目主页Ryujinx 项目页Yuzu 归档参考返回守门网

二、准备文件

  1. 模拟器或真实 Switch：本教程的 OCW 官方流程针对装有 Atmosphère 的改装 Switch；模拟器配置方式不能直接套用。
  2. OCW mod package：从 OCW 官网下载 OCW 模组包，解压后把内容合并到 SD 卡根目录。模组包会把文件放进 atmosphere/。
  3. ocw-config.json：从 OCW 官网下载你的个人配置文件。它用于识别你的 OCW 身份，不要分享给别人，也不要重复下载。
  4. 游戏版本：Super Mario Maker 2 必须是 3.0.2 或 3.0.3。启动游戏后，版本号应显示在右下角；没有版本号通常表示 1.0.0。
  5. 游戏、更新和 DLC：使用自己合法取得的游戏内容。OCW 使用前先确认游戏版本符合官网要求。
不要混用概念。 ocw-config.json 是 OCW 个人配置文件，不等同于模拟器的 prod.keys 或 title.keys；OCW mod package 也不是模拟器系统密钥。

三、模拟器选择

Eden 项目主页可访问

优先作为新用户的主线选择。请以项目主页和发布页当前提供的版本为准，桌面端与 Android 端的菜单和权限步骤可能不同。

打开 Eden 官网

Ryujinx（龙神） 历史版本参考

曾经成熟的桌面端模拟器。原项目停止开发后，下载入口和版本来源可能发生变化。不要把第三方打包站当作官方来源。

打开项目页

Yuzu 已停更

官方项目已停止维护。下面链接仅作历史资料或归档参考，文件安全性和兼容性需要自行核对。

打开归档参考页

三种模拟器都可以安装，但配置入口不完全相同。本文不把电脑端菜单直接套到 Android，也不把停更项目描述成当前维护项目。

四、Windows 安装流程

1
下载并解压模拟器从对应项目页下载 Windows 版本，解压到没有中文和空格的目录，例如 D:\Emulators\Eden\。首次运行时记录模拟器自己的用户目录位置。
2
导入密钥打开模拟器的用户目录，在 keys 或项目说明指定的目录放入自己的 prod.keys。不同模拟器菜单名称可能不同，放置位置以当前版本的用户目录说明为准。
3
安装固件在模拟器的系统/固件菜单中选择从目录安装，指向自己转储的固件目录。安装完成后重启模拟器。
4
添加游戏目录在设置中的游戏目录选项添加 .xci 或 .nsp 所在目录。不要把单个文件当作目录添加。
5
配置图形和输入优先尝试 Vulkan，分辨率从 1x 开始；确认手柄被识别后再绑定按键。遇到渲染异常时只改一个选项并重新测试。
6
安装更新和 DLC使用模拟器提供的“安装到 NAND/系统存储”等入口，选择自己转储的更新或 DLC 文件。安装后检查游戏版本，不要把 DLC 文件直接放进游戏目录当作 MOD。

五、Android 安装流程

设备建议：Android 10 以上；高性能 Snapdragon/Adreno 设备通常更容易获得稳定的 Vulkan 表现。实际兼容性取决于芯片、驱动、游戏和模拟器版本。
1
安装 Android 版本从 Eden 项目页或项目发布页取得 APK，安装前核对项目来源和哈希。Android 安装包不要与 Windows 版本混用。
2
选择文件目录在首次启动时授予文件访问权限，把密钥、固件和游戏放在容易识别的目录，例如 Documents/Switch/。按应用提示选择文件或目录，不要只填写文件名。
3
导入密钥和固件在应用的 Keys/System/Firmware 页面分别选择对应文件。出现“已导入”或版本信息后再继续，不要重复导入多份不同版本密钥。
4
添加游戏和更新添加保存游戏的目录，长按游戏进入更新/DLC 安装入口。Android 版菜单名称会随版本变化，以当前界面为准。
5
设置图形和手柄先用 Vulkan、1x 分辨率和默认驱动；触屏映射只作为临时方案，马造类游戏优先使用蓝牙手柄。出现发热或卡顿时降低分辨率和帧率。

六、Linux 安装流程

1
下载并赋予执行权限下载 Linux 版本，解压后运行 chmod +x Eden，再执行 ./Eden。发行版依赖以项目发布说明为准。
2
配置 Vulkan 驱动确认显卡驱动、Mesa 或 NVIDIA 驱动正常，再在模拟器中选择 Vulkan。不要在驱动未正常工作的情况下反复更换模拟器。
3
导入密钥、固件和游戏流程与桌面端相同，但用户目录位置不同。用模拟器的“打开用户目录”功能定位路径，不要猜测目录。
4
Steam Deck在桌面模式完成配置后，可以把模拟器添加为 Steam 非 Steam 游戏；游戏文件和模拟器建议放在空间充足的内部 SSD 或 SD 卡。

七、SMM2 OCW 官方安装流程

任天堂马造聊天群：QQ群 1006352506，用于交流马造、OCW 和关卡创作。

OCW（Open Course World）是独立的第三方服务。以下步骤依据 OCW 官网的设置说明整理，主要适用于装有 Atmosphère 的改装 Switch；不能把这套流程直接当成模拟器安装流程。
如果你只想上传关卡：不需要改装 Switch，也不需要安装 OCW 模组。使用网页浏览器和普通、未改装的 Switch，进入 OCW 官网的 MAKE 部分，按官网说明导入关卡。

在装有 Atmosphère 的 Switch 上游玩 OCW

1
准备 Atmosphère 和隔离环境将 Atmosphère 正确安装到 SD 卡。OCW 官网建议使用 EmuMMC，并配合 DNS 阻断列表；请先完成 Atmosphère/EmuMMC 的基础设置，再进行 OCW 配置。
2
确认马造版本启动 Super Mario Maker 2，在右下角检查版本号。OCW 官网说明要求版本为 3.0.2 或 3.0.3；如果看不到版本号，通常是 1.0.0，需要先解决更新问题。
3
下载并安装 OCW mod package从 OCW 官网下载模组包并解压。把解压出的内容复制到 SD 卡根目录，并选择合并现有文件夹。不要在 SD 卡根目录额外套一层同名文件夹；完成后应看到包内文件合并进 atmosphere/。
4
下载个人配置文件从 OCW 官网下载你的 ocw-config.json。这是用于识别你在 OCW 上的个人配置文件，不要发给别人。官网提醒：再次下载会使之前下载的 token 失效；如果要在多台设备上设置，应只下载一次并安全复制。
5
检查 SD 卡根目录配置完成后，SD 卡根目录至少应有两个并列项目：atmosphere/ 和 ocw-config.json，旁边可以保留 SD 卡原有的其他文件。
6
启动并验证启动 Mario Maker 2，进入 Course World。能正常进入 OCW 并加载课程，说明基础设置完成。遇到问题时通过 OCW 官网提供的 Discord 联系项目方。

账户管理和上传关卡

  1. 可选：进入 OCW 的 Your Account 页面管理课程。
  2. 在账户页面导入你创建的关卡。
  3. 只上传关卡不需要安装 OCW mod；按照官网的 MAKE 部分操作即可。
重要提示： OCW 的 ocw-config.json 不是模拟器的系统密钥。它属于个人身份配置，必须保密；不要重复下载，也不要把它上传到公共网盘或发到群里。

八、常见问题

现象处理顺序
提示找不到密钥先确认你遇到的是模拟器系统密钥问题，还是 OCW 配置问题。ocw-config.json 只能放在 Switch SD 卡根目录；它不是模拟器的系统密钥，也不应放进模拟器的 keys 目录。
游戏黑屏或闪退关闭 MOD，确认固件和更新版本，图形后端在 Vulkan/OpenGL 之间只切换一次测试，并查看模拟器日志。
OCW 补丁不生效确认游戏版本、补丁版本和目录层级；不要把 exefs/romfs 内容散放到游戏根目录。
能启动但无法连接查看 OCW 官网状态与说明，确认网络可访问、补丁已启用，不要绑定真实任天堂账号。
手机发热卡顿降到 1x 分辨率、关闭省电限制、改善散热并使用外接手柄；不同驱动只逐个测试。