krushant1122/MetalNX

选用指南

AI 根据 README 整理 · 2026/10/28 12:41:22

使用方式

通过图形界面使用，可拖放 DMG 安装，也可通过命令行脚本构建。

查看 README 依据

- Apple Silicon Mac — M1, M2, M3, or M4 (any tier) - Nintendo Switch decryption keys (`prod.keys`) - Legally dumped game `.nsp` / `.nsz` base and update files --- ## Installation ### Option A — Drag-and-Drop DMG (Recommended) 1. [**Download MetalNX-2.0.0.dmg**](https://github.com/krushant1122/MetalNX/releases/tag/v2.0.0) 2. Mount the DMG and drag **MetalNX** into `/Applications` 3. Launch from Spotlight (`⌘ Space → MetalNX`) or Launchpad ### Build from Source ```bash git clone https://github.com/krushant1122/MetalNX.git cd MetalNX

# Compile, bundle, sign, create DMG, and install to /Applications ./tools/launcher/build.sh --install open "/Applications/MetalNX.app" ``` --- ## User Guide ### First Launch & Permissions On first open, grant the following in the startup sheet (or via **System Settings → Privacy & Security**): - **Full Disk Access** — required to read `.nsp` files from external drives or `~/Downloads` - **Applications Folder** — required to install compiled game bundles to `/Applications` ### Porting a Game (1 Click) 1. Open the **1-Click Port** tab

部署要求

需要 macOS 13.0 或更高版本，Apple Silicon Mac（M1/M2/M3/M4），以及 Nintendo Switch 解密密钥和合法转储的游戏文件。

查看 README 依据

6. Metal Pipeline State Object prebuilding (Metal-TT) 7. High-density icon embedding, code-signing & `/Applications` deployment Real-time progress bar, live ETA countdown, and full compiler terminal log throughout. ### 🧠 Hardware-Aware Profiles Automatically detects your Mac and recommends settings: - **MacBook Air (fanless)** → conservative `0.85×` scale, MetalFX Balanced, 60 FPS cap to prevent thermal throttling - **Mac Pro / Studio / Max / Ultra** → `1.00×–1.50×`, uncapped FPS, 16× AF --- ## Requirements - macOS 13.0 (Ventura) or newer

- Apple Silicon Mac — M1, M2, M3, or M4 (any tier) - Nintendo Switch decryption keys (`prod.keys`) - Legally dumped game `.nsp` / `.nsz` base and update files --- ## Installation ### Option A — Drag-and-Drop DMG (Recommended) 1. [**Download MetalNX-2.0.0.dmg**](https://github.com/krushant1122/MetalNX/releases/tag/v2.0.0) 2. Mount the DMG and drag **MetalNX** into `/Applications` 3. Launch from Spotlight (`⌘ Space → MetalNX`) or Launchpad ### Build from Source ```bash git clone https://github.com/krushant1122/MetalNX.git cd MetalNX

已知限制

作者明确指出这不是模拟器，游戏以原生 ARM64 代码运行。

查看 README 依据

[**Download MetalNX-2.0.8.dmg**](https://github.com/krushant1122/MetalNX/releases/tag/v2.0.8) · [User Guide](#user-guide) · [Compatibility Database](#compatibility-database) · [Build from Source](#build-from-source) </div> --- > **Not an emulator.** Games run their own native ARM64 machine code directly on Apple Silicon. Maxwell GPU shaders are recompiled once into native Apple Metal Shading Language (MSL). MetalNX is the graphical control center built on top of the `nxnative` engine. --- ## Screenshots <p align="center">