龙神克斯

龙神克斯-NX
_{^{(REE-You-JI-NX)}}

Ryujinx 是一款开源 Nintendo Switch 模拟器，由 gdkchan 创建，用 C# 编写。该模拟器旨在提供卓越的准确性和性能、用户友好的界面和一致的构建。它是从头开始编写的，项目的开发于 2017 年 9 月开始。Ryujinx 可在 MIT 许可证下在 Github 上使用。

待办事项清单

1. 启用构建操作。
2. 寻找新的开发人员（如果您想贡献，请随意，但请测试您正在工作并保持代码干净，就像 Gdkchan 所做的那样）

兼容性

截至 2024 年 5 月，Ryujinx 已在约 4,300 款游戏上进行了测试；超过 4,100 个启动菜单并进入游戏，其中大约 3,550 个被认为可以玩。

您可以在此处查看兼容性列表。

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

用法

要运行此模拟器，您的 PC 必须配备至少 8GiB RAM；未能满足此要求可能会导致游戏体验不佳或意外崩溃。

有关如何设置模拟器的信息，请参阅我们的设置和配置指南。

对于我们的本地无线 (LDN) 版本，请参阅我们的多人游戏：本地游戏/本地无线指南 。

Avalonia UI 附带多种语言的翻译。请参阅 Crowdin 了解更多信息。

最新版本

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

适用于 Windows、macOS 和 Linux 的最新自动构建可以在 Github 版本上找到。

文档

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

建筑

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

步骤1

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

步骤2

在命令行上使用git clone https://github.com/Ryujinx/Ryujinx来克隆存储库，或者使用 Code --> Download zip 按钮来获取文件。

步骤3

要构建 Ryujinx，请在项目目录中打开命令提示符。您可以在 Windows 上通过在文件资源管理器中按住 Shift 键，然后右键单击并选择Open command window here来快速访问它。然后输入以下命令： dotnet build -c Release -o build构建文件将在新创建的构建目录中找到。

Ryujinx系统文件存储在Ryujinx文件夹中。该文件夹位于用户文件夹中，可以通过单击 GUI 中“文件”菜单下的Open Ryujinx Folder来访问该文件夹。

特征

• 声音的

  完全支持音频输出，不支持音频输入（麦克风）。我们使用 OpenAL 的 C# 包装器，并使用 SDL2 和 libsoundio 作为后备。

• 中央处理器

  CPU 模拟器 ARMeilleure 可模拟 ARMv8 CPU，目前支持大多数 64 位 ARMv8 和部分 ARMv7（及更早版本）指令，包括部分 32 位支持。它将 ARM 代码转换为自定义 IR，执行一些优化，然后将其转换为 x86 代码。根据用户的喜好，可以使用三种内存管理器选项，利用基于软件（较慢）和主机映射模式（更快）。默认情况下设置最快的选项（主机，未选中）。 Ryujinx 还具有可选的配置文件持久翻译缓存，它本质上是缓存翻译后的函数，这样它们就不需要在每次游戏加载时都进行翻译。最终结果是几乎每个游戏的加载时间（启动游戏和到达标题屏幕之间的时间量）都显着减少。注：默认情况下，此功能在“选项”菜单 >“系统”选项卡中启用。在第三次启动时解锁性能改进之前，您必须启动游戏至少两次到标题屏幕或更远的位置！这些改进是永久性的，不需要任何额外的启动。

• 图形处理器

  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 包含打开特定游戏相应 mods 文件夹的快捷方式。

• 配置

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

所有参与该项目的开发人员都会在空闲时间进行这些工作，但该项目有几项费用：

• 可破解的任天堂 Switch 控制台对硬件进行逆向工程
• 用于测试目的的附加计算机硬件（例如用于诊断图形错误的 GPU 等）
• 各种软件开发工具的许可证（例如Jetbrains、IDA）
• Web 托管和基础设施维护（例如 LDN 服务器）

通过 Patreon 收到的所有资金均被视为支持该项目的捐款。订阅者可以提前获得进度报告并独家获得开发者访谈。

执照

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

制作人员

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