Ryujinx

<h1 align="center"> <br> <a href="https://ryujinx.org/"><img src="https://yellow-cdn.veclightyear.com/835a84d5/cf6399f1-360a-417a-beca-d5a354094a44.svg" alt="Ryujinx" width="150"></a> <br> <b>Ryujinx</b> <br> _{^{<b>(发音为 REE-YOU-JINX)</b>}} <br> </h1> <p align="center"> Ryujinx 是一个由 gdkchan 创建的开源任天堂 Switch 模拟器，使用 C# 编写。 这个模拟器旨在提供卓越的准确性和性能、用户友好的界面以及持续稳定的构建。 它从零开始编写，项目开发始于 2017 年 9 月。 Ryujinx 在 Github 上以 <a href="https://github.com/Ryujinx/Ryujinx/blob/master/LICENSE.txt" target="_blank">MIT 许可证</a>发布。 <br /> </p> <p align="center"> <a href="https://github.com/Ryujinx/Ryujinx/actions/workflows/release.yml"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/1af95cdb-2403-4c7f-9cfb-0da0029c7244.svg" alt=""> </a> <a href="https://crwd.in/ryujinx"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/3503f0c8-a83a-454b-b4a5-5cdedb58fec0.svg" alt=""> </a> <a href="https://discord.com/invite/VkQYXAZ"> <img src="https://img.shields.io/discord/410208534861447168?color=5865F2&label=Ryujinx&logo=discord&logoColor=white" alt="Discord"> </a> <br> <br> <img src="https://yellow-cdn.veclightyear.com/835a84d5/7306f530-bc3c-40c7-8432-b8f630a74399.png"> </p>

兼容性

截至 2024 年 5 月，Ryujinx 已经测试了大约 4,300 个游戏标题； 超过 4,100 个游戏可以进入菜单并进入游戏，其中约有 3,550 个被认为是可玩的。

您可以在这里查看兼容性列表。

任何人都可以自由提交新的游戏测试或更新现有的游戏测试条目； 只需遵循新问题模板和测试指南，或在适用的游戏问题下回复即可。 使用搜索功能查看游戏是否已经被测试过！

使用

要运行这个模拟器，您的电脑必须至少配备 8GiB 的内存； 如果不满足这个要求可能会导致糟糕的游戏体验或意外崩溃。

请查看我们的设置和配置指南了解如何设置模拟器。

对于我们的本地无线（LDN）版本，请查看我们的多人游戏：本地游戏/本地无线指南 。

Avalonia UI 提供了多种语言的翻译。有关更多信息，请查看 Crowdin。

最新构建

这些构建会自动为 master 分支的每次提交编译。 虽然我们努力确保在推送更新之前实现最佳的稳定性和性能，但我们的自动构建可能不稳定或完全损坏。

如果您想查看模拟器更新的详细信息，可以访问我们的更新日志。

Windows、macOS 和 Linux 的最新自动构建可以在官方网站上找到。

文档

如果您计划贡献或只是想了解更多关于这个项目的信息，请阅读我们的文档。

构建

如果您希望自己构建模拟器，请按照以下步骤操作：

步骤 1

安装 .NET 8.0（或更高版本）SDK。 确保您的 SDK 版本高于或等于 global.json 中指定的所需版本。

步骤 2

使用命令行中的 git clone https://github.com/Ryujinx/Ryujinx 克隆存储库，或使用 Code --> Download zip 按钮下载文件。

步骤 3

要构建 Ryujinx，请在项目目录内打开命令提示符。 在 Windows 上，您可以在文件资源管理器中按住 Shift 键，然后右键单击并选择"在此处打开命令窗口"来快速访问它。 然后输入以下命令：dotnet build -c Release -o build 构建的文件将位于新创建的 build 目录中。

Ryujinx 系统文件存储在 Ryujinx 文件夹中。 该文件夹位于用户文件夹中，可以通过在 GUI 的文件菜单下点击"打开 Ryujinx 文件夹"来访问。

功能

• 音频 完全支持音频输出，但不支持音频输入（麦克风）。 我们使用C#封装的OpenAL，以及SDL2和libsoundio作为备选方案。

• CPU

  CPU模拟器ARMeilleure模拟ARMv8 CPU，目前支持大多数64位ARMv8指令和部分ARMv7（及更早版本）指令，包括部分32位支持。 它将ARM代码转换为自定义IR，进行一些优化，然后转换为x86代码。 根据用户偏好，有三种内存管理选项可用，包括基于软件（较慢）和主机映射（更快）模式。 默认设置为最快选项（主机，未检查）。 Ryujinx还具有可选的剖析持久化翻译缓存功能，它会缓存已翻译的函数，这样每次加载游戏时就不需要重新翻译。 结果是几乎所有游戏的加载时间（从启动游戏到进入标题画面的时间）都显著减少。 注意：此功能在选项菜单 > 系统选项卡中默认启用。 您必须至少将游戏启动到标题画面或更远两次，才能在第三次启动时解锁性能改进！ 这些改进是永久性的，以后不需要额外启动。

• GPU

  GPU模拟器通过自定义构建的OpenTK或Silk.NET，使用OpenGL（最低4.5版）、Vulkan或Metal（通过MoltenVK）API来模拟Switch的Maxwell GPU。 目前Ryujinx为最终用户提供六种图形增强功能：磁盘着色器缓存、分辨率缩放、抗锯齿、缩放滤镜（包括FSR）、各向异性过滤和纵横比调整。 这些增强功能可以在GUI中根据需要进行调整或切换。

• 输入

  我们目前支持键盘、鼠标、触摸输入、JoyCon输入支持，以及几乎所有控制器。 大多数情况下原生支持动作控制；对于双JoyCon动作支持，目前需要DS4Windows或BetterJoy。 在所有情况下，您都可以在输入配置菜单中设置所有内容。

• DLC和修改

  Ryujinx能够通过GUI管理附加内容/可下载内容。 还支持Mod（romfs、exefs和运行时Mod，如作弊）； GUI中包含一个快捷方式，可打开特定游戏的相应Mod文件夹。

• 配置

  模拟器有启用或禁用某些日志记录、重新映射控制器等设置。 您可以通过图形界面或手动通过配置文件Config.json进行所有配置，该文件位于用户文件夹中，可以通过单击GUI中文件菜单下的打开Ryujinx文件夹访问。

联系方式

如果您有贡献、建议、需要模拟器支持或只是想与团队联系，请加入我们的Discord服务器。 您也可以查看我们的常见问题。

捐赠

如果您想在经济上支持该项目，Ryujinx有一个活跃的Patreon活动。

<a href="https://www.patreon.com/ryujinx"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/5f1100dc-6136-40f7-b1eb-f32f695e61a6.png?format=500w" width="150"> </a>

所有参与项目的开发人员都是在业余时间工作，但项目有几项开支：

• 可破解的Nintendo Switch主机，用于逆向工程硬件
• 额外的计算机硬件用于测试（例如，用于诊断图形错误的GPU等）
• 各种软件开发工具的许可证（例如Jetbrains、IDA）
• 网络托管和基础设施维护（例如LDN服务器）

通过Patreon收到的所有资金都被视为支持项目的捐赠。赞助人可以提前获得进度报告并独家访问开发者访谈。

许可证

本软件根据MIT许可证条款授权。 该项目使用了libvpx项目（BSD许可）和ffmpeg项目（LGPLv3许可）编写的代码。 有关更多详细信息，请参阅LICENSE.txt和THIRDPARTY.md。

鸣谢

• LibHac用于我们的文件系统。
• AmiiboAPI用于我们的Amiibo模拟。
• ldn_mitm用于我们可用的多人游戏模式之一。
• ShellLink用于Windows快捷方式生成。