Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/development/compiling-dolphin-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
sidebar_position: 2
title: Building DolphinUWP from Source - Stern & SirMangler
description: Complete guide for building DolphinUWP from source for Xbox deployment
slug: compiling-dolphin-guide
---

# Building DolphinUWP from Source - Stern & SirMangler
Expand Down
3 changes: 2 additions & 1 deletion docs/development/compiling-mesa-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
sidebar_position: 4
sidebar_position: 3
title: How to Compile Mesa for UWP
description: Complete guide for compiling Mesa graphics library for Universal Windows Platform
slug: compiling-mesa-guide
---

# How to Compile Mesa for UWP
Expand Down
3 changes: 2 additions & 1 deletion docs/development/compiling-xbsx2-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
sidebar_position: 1
sidebar_position: 4
title: Building XBSX2 from Source - Stern
description: Complete guide for compiling XBSX2 for Xbox deployment
slug: compiling-xbsx2-guide
---

# Guide to Build XBSX2
Expand Down
3 changes: 2 additions & 1 deletion docs/development/compiling-xenia-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
sidebar_position: 3
sidebar_position: 5
title: Building Xenia Canary (UWP) from Source - Stern & SirMangler
description: Complete guide for building Xenia Canary UWP from source for Xbox deployment
slug: compiling-xenia-guide
---

# Building Xenia Canary (UWP) from Source - Stern & SirMangler
Expand Down
21 changes: 15 additions & 6 deletions docs/development/index.mdx
Original file line number Diff line number Diff line change
@@ -1,18 +1,27 @@
---
title: Development Guides
sidebar_position: 1
description: Compiling emulators and development tooling for Xbox Developer Mode UWP workflows.
slug: /development
---

# Development Guides

This section contains guides for compiling and developing emulators and applications for Xbox Developer Mode.

## Compiling Emulators
## Compiling emulators

- **[Compiling XBSX2](./compiling-xbsx2-guide)** - Build the PS2 emulator from source
- **[Compiling Dolphin](./compiling-dolphin-guide)** - Build the GameCube/Wii emulator from source
- **[Compiling Xenia](./compiling-xenia-guide)** - Build the Xbox 360 emulator from source
- **[Compiling Mesa](./compiling-mesa-guide)** - Build graphics drivers for better compatibility
- **[Compiling XBSX2](/docs/development/compiling-xbsx2-guide)** - Build the PS2 emulator from source
- **[Compiling Dolphin](/docs/development/compiling-dolphin-guide)** - Build the GameCube/Wii emulator from source
- **[Compiling Xenia](/docs/development/compiling-xenia-guide)** - Build the Xbox 360 emulator from source
- **[Compiling Mesa](/docs/development/compiling-mesa-guide)** - Build graphics drivers for better compatibility

## Development Tools
## Development tools

These guides will help you set up your development environment and compile emulators that may offer better performance or features than pre-compiled versions.

End-user setup for **community native ports and experimental UWP apps** (installed MSIX, data files, USB layout) is in the sidebar under **Experimental UWP (community)** and **Native ports & engines (community)**.

## Prerequisites

Before compiling emulators, ensure you have:
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 1
sidebar_position: 2
title: BoxedWine UWP Setup Guide
description: Complete guide for installing and using BoxedWine Windows emulator on Xbox
tags:
Expand All @@ -8,6 +8,7 @@ tags:
- uwp
- windows
- xbox
slug: boxedwine-guide
---

import AtAGlance from '@site/src/components/AtAGlance';
Expand All @@ -24,7 +25,7 @@ This guide explains how to install and run BoxedWine, a Windows application emul
{ label: 'Dev Mode', value: 'Required' },
{ label: 'Storage', value: 'NTFS USB for app zips, internal is limited' },
{ label: 'User folder', value: 'ZIPs live on USB, app data stored internally' },
{ label: 'Difficulty', value: 'Intermediate - 2030 minutes' },
{ label: 'Difficulty', value: 'Intermediate - 20-30 minutes' },
{ label: 'BIOS/keys', value: 'None' },
{ label: 'Controllers', value: 'Xbox gamepad, UI is cursor-driven' },
]}
Expand Down
5 changes: 3 additions & 2 deletions docs/emulation/dolphin-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 2
sidebar_position: 3
title: Dolphin UWP Guide
description: Comprehensive guide for setting up and using Dolphin UWP on Xbox
tags:
Expand All @@ -8,6 +8,7 @@ tags:
- gamecube
- wii
- uwp
slug: dolphin-guide
---

import AtAGlance from '@site/src/components/AtAGlance';
Expand All @@ -24,7 +25,7 @@ This guide provides comprehensive instructions for setting up and using Dolphin
{ label: 'Dev Mode', value: 'Required (Retail not supported)' },
{ label: 'Storage', value: 'USB NTFS recommended, internal storage limited and risky to clean' },
{ label: 'User folder', value: 'USB:\\Dolphin (preferred) or LocalFolder\\[FULLNAME]\\LocalCache\\Dolphin' },
{ label: 'Difficulty', value: 'Intermediate - about 2030 minutes (USB method)' },
{ label: 'Difficulty', value: 'Intermediate - about 20-30 minutes (USB method)' },
{ label: 'BIOS/keys', value: 'None required, optional Wii NAND for menu' },
{ label: 'Controllers', value: 'Xbox gamepad, custom mappings best synced from PC' },
]}
Expand Down
5 changes: 3 additions & 2 deletions docs/emulation/flycast-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 8
sidebar_position: 4
title: Flycast Guide
description: Complete guide for setting up and using Flycast Dreamcast/NAOMI emulator on Xbox
tags:
Expand All @@ -8,6 +8,7 @@ tags:
- dreamcast
- naomi
- uwp
slug: flycast-guide
---

import AtAGlance from '@site/src/components/AtAGlance';
Expand All @@ -22,7 +23,7 @@ import AtAGlance from '@site/src/components/AtAGlance';
{ label: 'Dev Mode', value: 'Required (Retail not supported)' },
{ label: 'Storage', value: 'USB NTFS recommended for ROMs/BIOS, textures must be internal' },
{ label: 'User folder', value: 'LocalAppData\\Flycast\\LocalState (Data\\textures for packs)' },
{ label: 'Difficulty', value: 'Intermediate - about 1520 minutes' },
{ label: 'Difficulty', value: 'Intermediate - about 15-20 minutes' },
{ label: 'BIOS/keys', value: 'dc_boot optional but recommended for compatibility' },
{ label: 'Controllers', value: 'Xbox gamepad, set app type to Game' },
]}
Expand Down
28 changes: 21 additions & 7 deletions docs/emulation/index.mdx
Original file line number Diff line number Diff line change
@@ -1,29 +1,43 @@
---
title: Emulation Guides
sidebar_position: 1
description: Overview of Xbox Developer Mode emulation guides with setup prerequisites.
slug: /emulation
tags:
- emulation
- xbox
- dev-mode
slug: /emulation
---

# Emulation Guides

Welcome to the comprehensive emulation guides for Xbox Developer Mode! This section contains detailed guides for setting up and configuring various emulators to run classic games on your Xbox console.

## Available Emulators
## Available emulators

- **[XBSX2 (PS2)](/docs/emulation/xbsx2-guide)** - PlayStation 2 emulator with excellent compatibility
- **[Dolphin (GC/Wii)](/docs/emulation/dolphin-guide)** - GameCube and Wii emulator
- **[PPSSPP (PSP)](/docs/emulation/ppsspp-guide)** - PlayStation Portable emulator
- **[RetroArch](/docs/emulation/retroarch-guide)** - Multi-system emulator with many cores
- **[Flycast](/docs/emulation/flycast-guide)** - Dreamcast and Naomi emulator
- **[TouchHLE](/docs/emulation/touchhle-guide)** - iOS emulator for classic iPhone/iPad apps
- **[ChonkyStation3](/docs/emulation/chonkystation3-guide)** - PlayStation 3 emulator (experimental)
- **[Panda3DS](/docs/emulation/panda3ds-guide)** - Nintendo 3DS emulator
- **[BoxedWine (Wine on Xbox)](/docs/emulation/boxedwine-guide)** - running some Windows `.exe` payloads under a Wine-based UWP host

## Experimental console emulators

These builds are unfinished or unstable. Full walkthroughs are under **Experimental UWP (community)** in the sidebar.

- **[ChonkyStation3 (PS3)](/docs/experimental/chonkystation3-guide)** - proof-of-concept PS3 UWP emulator
- **[Panda3DS (3DS)](/docs/experimental/panda3ds-guide)** - 3DS UWP emulator (early)
- **[TouchHLE](/docs/experimental/touchhle-guide)** - early iOS app compatibility layer / emulator

## Arcade & specialty setups

- **[Sega Model 3 (Supermodel)](/docs/emulation/segamodel3-guide)** - Model 3 arcade
- **[Sega Model 3 (G920-focused)](/docs/emulation/segamodel3-g920-guide)** - Supermodel with steering-wheel notes

GZDoom, Raze, OpenBOR, Sonic fan ports, and other native ports and source engines live under **Native ports & engines (community)** in the sidebar. That list is long, so use your browser or the site search when you need a specific title.

## Getting Started
## Getting started

Before setting up any emulator, make sure you have:

Expand All @@ -33,6 +47,6 @@ Before setting up any emulator, make sure you have:

Each guide contains detailed installation instructions, configuration steps, and troubleshooting tips.

## Need Help?
## Need help?

If you encounter issues, check the [FAQ](/docs/faq) or [report issues](https://github.com/SternXD/devmodewiki/issues) on GitHub.
5 changes: 3 additions & 2 deletions docs/emulation/ppsspp-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 4
sidebar_position: 5
title: PPSSPP Setup Guide
description: Complete guide for setting up PPSSPP PSP emulator on Xbox for both external USB and internal storage
tags:
Expand All @@ -8,6 +8,7 @@ tags:
- ppsspp
- uwp
- xbox
slug: ppsspp-guide
---

import AtAGlance from '@site/src/components/AtAGlance';
Expand All @@ -26,7 +27,7 @@ If you have not prepared your USB for emulators yet (NTFS format and correct per
{ label: 'Dev Mode', value: 'Required (Retail not supported)' },
{ label: 'Storage', value: 'USB NTFS recommended, internal LocalState works but slower' },
{ label: 'User folder', value: 'USB:\\PSP (Create or Choose a PSP folder) or LocalAppData\\PPSSPP\\LocalState\\PSP' },
{ label: 'Difficulty', value: 'Easy - about 1015 minutes' },
{ label: 'Difficulty', value: 'Easy - about 10-15 minutes' },
{ label: 'BIOS/keys', value: 'None needed, use PSP ISOs/CSOs/CHDs' },
{ label: 'Controllers', value: 'Xbox gamepad, remap in-app' },
]}
Expand Down
5 changes: 3 additions & 2 deletions docs/emulation/retroarch-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,12 +1,13 @@
---
sidebar_position: 5
sidebar_position: 6
title: RetroArch Setup Guide (Mesa/Angle for Xbox)
description: Complete guide for installing and setting up RetroArch on Xbox Developer Mode
tags:
- emulation
- retroarch
- uwp
- xbox
slug: retroarch-guide
---

import AtAGlance from '@site/src/components/AtAGlance';
Expand All @@ -23,7 +24,7 @@ This guide provides instructions for installing and setting up RetroArch (Mesa f
{ label: 'Dev Mode', value: 'Required (Retail not supported)' },
{ label: 'Storage', value: 'USB NTFS recommended, internal LocalState/D: works for all-local setups' },
{ label: 'User folders', value: 'Set via Settings > Directory, BIOS in LocalState\\system' },
{ label: 'Difficulty', value: 'Intermediate - 2030 minutes initial setup' },
{ label: 'Difficulty', value: 'Intermediate - 20-30 minutes initial setup' },
{ label: 'BIOS/keys', value: 'Per-core BIOS in system directory as needed' },
{ label: 'Controllers', value: 'Xbox gamepad, set App type to Game for best performance' },
]}
Expand Down
43 changes: 43 additions & 0 deletions docs/emulation/segamodel3-g920-guide.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: "Sega Model 3 G920 Guide"
sidebar_position: 7
description: "A guide for setting up Sega Model 3 G920 on dev mode."
tags:
- guides
- emulation
- xbox
slug: segamodel3-g920-guide
---


### Requirements:
- Xbox Series X/S.
- External USB.
- Logitech G920.
- `Microsoft.VCLibs.x64.14.00.appx` dependency file.

### Prepare Game Files
1. Create a folder named `Sega Model 3` on your USB drive under the `Games` directory.
2. Place your games in this folder. Ensure the files are in **ZIP format**.
3. Connect the USB drive to your Xbox.

### Launch the Emulator
1. Disconnect your Xbox controller now or wheel inputs will not work.
2. Open the emulator using your Logitech G920.
3. A file explorer will appear. Navigate to your `Games` folder, then `Sega Model 3`, and select a game to play.

### Enable Widescreen & Customize Controls
1. Access the **Xbox Device Portal** again.
2. Go to **File Explorer** > **Development Files** > **Windows Apps**.
3. Find the `Sega Model 3` folder, open the `Config` folder, and download the `Supermodel.ini` file.
4. Open the `.ini` file in **Notepad**:
- To enable widescreen:
Find `Widescreen = false`, change it to `true`.
- To customize controls:
Edit the **Xbox Controller ↔ Supermodel Input ID-Tags** in the file.
5. Save the file, then upload it back to the **Config** folder via the Xbox Device Portal, replacing the original file.

### Additional Notes:
- Use the `.ini` file to further customize settings like graphics, controls, and more.
- If you encounter issues, revisit the portal to make adjustments.
- This build is compatible with the Logitech G920 and is configured for racing games only.
40 changes: 40 additions & 0 deletions docs/emulation/segamodel3-guide.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
title: "Sega Model 3 Guide"
sidebar_position: 8
description: "A guide for setting up Sega Model 3 on dev mode."
tags:
- guides
- emulation
- xbox
slug: segamodel3-guide
---


### Requirements:
- Xbox Series X/S.
- External USB.
- `Microsoft.VCLibs.x64.14.00.appx` dependency file.

### Prepare Game Files
1. Create a folder named `Sega Model 3` on your USB drive under the `Games` directory.
2. Place your games in this folder. Ensure the files are in **ZIP format**.
3. Connect the USB drive to your Xbox.

### Launch the Emulator
1. Open the emulator.
2. A file explorer will appear. Navigate to your `Games` folder, then `Sega Model 3`, and select a game to play.

### Enable Widescreen & Customize Controls
1. Access the **Xbox Device Portal** again.
2. Go to **File Explorer** > **Development Files** > **Windows Apps**.
3. Find the `Sega Model 3` folder, open the `Config` folder, and download the `Supermodel.ini` file.
4. Open the `.ini` file in **Notepad**:
- To enable widescreen:
Find `Widescreen = false`, change it to `true`.
- To customize controls:
Edit the **Xbox Controller ↔ Supermodel Input ID-Tags** in the file.
5. Save the file, then upload it back to the **Config** folder via the Xbox Device Portal, replacing the original file.

### Additional Notes:
- Use the `.ini` file to further customize settings like graphics, controls, and more.
- If you encounter issues, revisit the portal to make adjustments.
5 changes: 3 additions & 2 deletions docs/emulation/xbsx2-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 7
sidebar_position: 9
title: XBSX2 PS2 Emulator Setup Guide
description: Complete guide for installing and setting up XBSX2 PS2 emulator on Xbox Series X/S
tags:
Expand All @@ -9,6 +9,7 @@ tags:
- pcsx2
- uwp
- xbox
slug: xbsx2-guide
---

import AtAGlance from '@site/src/components/AtAGlance';
Expand All @@ -32,7 +33,7 @@ XBSX2 is an emulator that allows you to play PlayStation 2 (PS2) games on your X
{ label: 'Dev Mode', value: 'Required (Retail not supported)' },
{ label: 'Storage', value: 'USB NTFS recommended, internal LocalState/D: works but limited' },
{ label: 'User folder', value: 'Store BIOS/games on USB, LocalState/D: usable if needed' },
{ label: 'Difficulty', value: 'Intermediate - about 2030 minutes' },
{ label: 'Difficulty', value: 'Intermediate - about 20-30 minutes' },
{ label: 'BIOS/keys', value: 'PS2 BIOS required to boot games' },
{ label: 'Controllers', value: 'Xbox gamepad, supports custom mappings' },
]}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 1
sidebar_position: 2
title: ChonkyStation 3 UWP (Proof of Concept) Guide
description: Complete guide for installing and running ChonkyStation 3 UWP PS3 emulator on Xbox
tags:
Expand All @@ -8,6 +8,7 @@ tags:
- chonkystation3
- uwp
- experimental
slug: chonkystation3-guide
---

import AtAGlance from '@site/src/components/AtAGlance';
Expand Down
Loading