From 3899eb855338d67e2a0f281db20150b60c05b457 Mon Sep 17 00:00:00 2001 From: Mew-Lew <167646123+Mew-Lew@users.noreply.github.com> Date: Sun, 18 Oct 2026 10:57:55 +0100 Subject: [PATCH] Add Warthog and NXbox guide --- docs/experimental/nxbox-guide.mdx | 49 ++++++++++++ docs/experimental/sm64hd-guide.mdx | 2 +- .../{megaman-x5.mdx => megamanx5-guide.mdx} | 0 docs/ports/{open-ce.mdx => opence-guide.mdx} | 2 +- docs/ports/warthog-guide.mdx | 75 +++++++++++++++++++ docs/ports/zelda3-guide.mdx | 2 +- docs/ports/zelda64-guide.mdx | 2 +- docs/ports/zircon-guide.mdx | 2 +- 8 files changed, 129 insertions(+), 5 deletions(-) create mode 100644 docs/experimental/nxbox-guide.mdx rename docs/ports/{megaman-x5.mdx => megamanx5-guide.mdx} (100%) rename docs/ports/{open-ce.mdx => opence-guide.mdx} (99%) create mode 100644 docs/ports/warthog-guide.mdx diff --git a/docs/experimental/nxbox-guide.mdx b/docs/experimental/nxbox-guide.mdx new file mode 100644 index 0000000..05ac6f5 --- /dev/null +++ b/docs/experimental/nxbox-guide.mdx @@ -0,0 +1,49 @@ +--- +sidebar_position: 4 +title: NXbox Guide +description: A guide for installing and using NXbox, an experimental Nintendo Switch emulator for Xbox Series consoles. +tags: + - emulation + - switch + - uwp + - experimental +slug: nxbox-guide +--- + +NXbox is an experimental Nintendo Switch emulator for Xbox Series consoles in Developer Mode. + +### Installation + +1. Make sure your Xbox Series X is in Developer Mode. +2. Download the `.appx` from the [latest NXbox release](https://github.com/NspxMiguel/NXbox/releases/latest). +3. In Device Portal, open **My games & apps → Add**. +4. Upload the `.appx` and select **Start**. +5. Once installed, open Dev Home, select NXbox → **View details**, and set **App type** to **Game**. + +### Keys and Game Setup + +1. Launch NXbox once to generate its folders, then close it. +2. In Device Portal, open **File explorer** → `LocalAppData` → NXbox package → `LocalState`. +3. Upload your `prod.keys` and `title.keys` to `LocalState\eden\keys`. +4. Upload your games to `LocalState\games`. +5. If required, upload your firmware files to `LocalState\firmware`. +6. Launch NXbox and select your game from the library. + +Supported game formats include `.nsp`, `.nsz` and `.xci`. Some games, such as Mario Kart 8 Deluxe, may also require firmware dumped from your own console. + +Internal developer storage is limited, so larger games can be stored on a USB drive in an `E:\NXbox\games` folder. + +### Settings and Tips + +- **Renderer:** Direct3D 12 is the default. To use the older OpenGL renderer, add `renderer_backend=0` to `LocalState\eden_settings.txt`. +- **Standalone apps:** [NXbox Pack](https://github.com/NspxMiguel/NXbox/tree/main/tools/nxbox-pack) packages games you own as individual Xbox apps that launch directly into the game. Available for Windows, macOS and Linux. +- **Updates:** NXbox checks its GitHub releases and updates itself. +- **Crash reports:** If you encounter a crash, attach `LocalState\nxbox_crash.txt` when [reporting an issue](https://github.com/NspxMiguel/NXbox/issues). + +### Compatibility + +The full compatibility table is available in the [NXbox README](https://github.com/NspxMiguel/NXbox#compatibility). + +--- + +*Contributor: NspxMiguel* diff --git a/docs/experimental/sm64hd-guide.mdx b/docs/experimental/sm64hd-guide.mdx index 5d26b91..36d87d3 100644 --- a/docs/experimental/sm64hd-guide.mdx +++ b/docs/experimental/sm64hd-guide.mdx @@ -1,6 +1,6 @@ --- title: "SM64HD Fan Remake (Super Mario 64) Guide" -sidebar_position: 4 +sidebar_position: 5 description: "A guide for setting up SM64HD Fan Remake (Super Mario 64) on dev mode." tags: - guides diff --git a/docs/ports/megaman-x5.mdx b/docs/ports/megamanx5-guide.mdx similarity index 100% rename from docs/ports/megaman-x5.mdx rename to docs/ports/megamanx5-guide.mdx diff --git a/docs/ports/open-ce.mdx b/docs/ports/opence-guide.mdx similarity index 99% rename from docs/ports/open-ce.mdx rename to docs/ports/opence-guide.mdx index e0b8f45..25abbd9 100644 --- a/docs/ports/open-ce.mdx +++ b/docs/ports/opence-guide.mdx @@ -6,7 +6,7 @@ tags: - xbox - ports - uwp -slug: open-ce +slug: opence-guide --- Based on OpenCE PC build 155. diff --git a/docs/ports/warthog-guide.mdx b/docs/ports/warthog-guide.mdx new file mode 100644 index 0000000..e72dae3 --- /dev/null +++ b/docs/ports/warthog-guide.mdx @@ -0,0 +1,75 @@ +--- +title: Warthog UWP +sidebar_position: 72 +description: Warthog UWP for Xbox Dev Mode. +tags: + - xbox + - ports + - uwp +slug: warthog-guide +--- + +### Installation + +1. Make sure your Xbox is in Dev Mode. +2. Open Xbox Device Portal on your computer. +3. Open **Home → Add**. +4. Upload `Warthog-UWP-x64.appx`. +5. Finish the installation. +6. Set Warthog as a **Game** in Dev Mode. +7. Launch Warthog. + +### Internal Storage Setup + +1. Launch Warthog once to create the `Developmentfiles/Warthog` folder. +2. Place your Halo ISO or XISO in the app's `Developmentfiles/Warthog` folder. +3. Launch Warthog. Your game should appear in the list. +4. Select the ISO or XISO. +5. Wait for extraction to reach 100%. + +The extracted game files, saves, profiles, settings, and cache are stored in `Developmentfiles/Warthog`. + +Future updates will not overwrite the game files, so you will not need to reinstall your game after updating Warthog. + +### External Storage Setup + +1. Connect a USB storage drive to the Xbox. +2. Place your Halo ISO or XISO on the USB drive. +3. Launch Warthog and select **External**. +4. Browse to and select the ISO or XISO. +5. Warthog will create an `Warthog` folder on the drive. +6. Wait for extraction to reach 100%. + +Keep the USB drive connected when using Warthog. Saves, profiles, settings, cache, and game files are stored inside the external `Warthog` folder. + +### Custom Maps + +Place custom map files directly inside the `custom_maps` folder. + +#### Internal Storage + +`Developmentfiles\Warthog\custom_maps` + +#### External Storage + +`USB:\Warthog\custom_maps` + +Copy the loose `.map` files into the folder. Do not copy the downloaded map's enclosing folder. + +Halo Custom Edition maps also require these three Halo Custom Edition resource maps in the same `custom_maps` folder: + +- `bitmaps.map` +- `sounds.map` +- `loc.map` + +Maps requiring OpenSauce are not supported. + +### Tips + +1. Warthog stores cache data, so you may experience stutters when loading something for the first time. This should quickly improve as the cache builds. + +Wort, Wort, Wort. + +--- + +*Contributor: ReviveMe* diff --git a/docs/ports/zelda3-guide.mdx b/docs/ports/zelda3-guide.mdx index ae31d9d..0786561 100644 --- a/docs/ports/zelda3-guide.mdx +++ b/docs/ports/zelda3-guide.mdx @@ -1,6 +1,6 @@ --- title: "Zelda 3 Guide" -sidebar_position: 72 +sidebar_position: 73 description: "A guide for setting up Zelda 3 on dev mode." tags: - guides diff --git a/docs/ports/zelda64-guide.mdx b/docs/ports/zelda64-guide.mdx index 7f48d3c..7336bce 100644 --- a/docs/ports/zelda64-guide.mdx +++ b/docs/ports/zelda64-guide.mdx @@ -1,6 +1,6 @@ --- title: "Zelda 64 Recompiled Guide" -sidebar_position: 73 +sidebar_position: 74 description: "A guide for setting up Zelda 64 Recompiled on dev mode." tags: - guides diff --git a/docs/ports/zircon-guide.mdx b/docs/ports/zircon-guide.mdx index a4db416..13a38e6 100644 --- a/docs/ports/zircon-guide.mdx +++ b/docs/ports/zircon-guide.mdx @@ -1,6 +1,6 @@ --- title: "Zircon (Quake) Guide" -sidebar_position: 74 +sidebar_position: 75 description: "A guide for setting up Zircon (Quake) on dev mode." tags: - guides