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
116 changes: 116 additions & 0 deletions docs/emulation/dosbox-pure-uwp-guide.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
---
title: "DOSBox Pure UWP Guide"
sidebar_position: 4
description: "A guide for setting up DOSBox Pure UWP on dev mode."
tags:
- guides
- emulators
- xbox
slug: dosbox-pure-uwp-guide
---


### Requirements
- You will need the latest DOSBox Pure UWP `.zip` release.
- DOSBox Pure UWP is a standalone DOS emulator for Windows and Xbox Dev Mode.
- It does not require RetroArch.

### Install DOSBox Pure UWP
- Download the latest `.zip` release.
- Extract the `.zip`.
- Install the `.msix` via the Xbox Device Portal.

### Add DOS Games
- Launch DOSBox Pure UWP.
- Select **Load Game**.
- Press **A** to open the built-in file browser.
- Browse to your DOS game file.
- Select the file to launch it.

Supported formats include:

| Format | Description |
| --- | --- |
| `.zip` | ZIP archive containing DOS game files |
| `.dosz` | DOSBox Pure compressed archive |
| `.exe` | DOS executable |
| `.com` | DOS COM file |
| `.bat` | DOS batch file |
| `.iso` | CD-ROM image |
| `.chd` | Compressed CD image |
| `.cue` + `.bin` | CUE and BIN CD image |
| `.img` / `.ima` | Floppy disk image |
| `.vhd` | Virtual hard disk |
| `.conf` | DOSBox configuration file |

### Creating ZIP Files
The easiest way to package a DOS game is as a `.zip` file.

For single-folder games, zip the contents of the game folder.

Example:

```text
DOOM/
├── DOOM.EXE
├── DOOM.WAD
├── SETUP.EXE
└── README.TXT
```

On Windows:

```text
Right click the folder > Send to > Compressed (zipped) folder
```

### ZIP File Notes
- Use uppercase filenames and extensions where possible.
- Include launchers such as `INSTALL.BAT` or `SETUP.EXE` if the game needs them.
- Do not put ZIP files inside other ZIP files.
- Keep ZIP files below 4GB where possible on Xbox.

### Multiple Disk Games
Games with multiple floppy disks can be packaged in one ZIP.

Example:

```text
KQ5.ZIP
├── DISK1/
├── DISK2/
└── DISK3/
```

DOSBox Pure's built-in menu can be used to swap disks during gameplay.

### Default Xbox Controls

| Xbox Control | Default Action |
| --- | --- |
| D-pad | Navigate menus / arrow keys in-game |
| A | Confirm / primary action |
| B | Back / cancel |
| X | Varies by game |
| Y | Varies by game |
| LB / RB | Page up/down in menus / disk swap |
| LT / RT | Triggers, mapped per game |
| Left Stick | Mouse emulation |
| Right Stick | Scroll / secondary input |
| Start | PUREMENU |
| Back | Close menu / exit |

### Keyboard and Mouse
- Keyboard input uses standard DOS keyboard mapping.
- On Windows, USB mouse input works directly.
- On Xbox, mouse input is emulated through the left analogue stick.
- USB mouse input is not supported on Xbox due to UWP platform limitations.

Useful keyboard shortcuts:

| Key | Action |
| --- | --- |
| F10 | Toggle menu |
| Ctrl + L | Open system file picker fallback |

---
2 changes: 1 addition & 1 deletion docs/emulation/flycast-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 4
sidebar_position: 5
title: Flycast Guide
description: Complete guide for setting up and using Flycast Dreamcast/NAOMI emulator on Xbox
tags:
Expand Down
2 changes: 1 addition & 1 deletion docs/emulation/ppsspp-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 5
sidebar_position: 6
title: PPSSPP Setup Guide
description: Complete guide for setting up PPSSPP PSP emulator on Xbox for both external USB and internal storage
tags:
Expand Down
2 changes: 1 addition & 1 deletion docs/emulation/retroarch-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 6
sidebar_position: 7
title: RetroArch Setup Guide (Mesa/Angle for Xbox)
description: Complete guide for installing and setting up RetroArch on Xbox Developer Mode
tags:
Expand Down
2 changes: 1 addition & 1 deletion docs/emulation/segamodel3-g920-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Sega Model 3 G920 Guide"
sidebar_position: 7
sidebar_position: 8
description: "A guide for setting up Sega Model 3 G920 on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/emulation/segamodel3-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Sega Model 3 Guide"
sidebar_position: 8
sidebar_position: 9
description: "A guide for setting up Sega Model 3 on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/emulation/xbsx2-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 9
sidebar_position: 10
title: XBSX2 PS2 Emulator Setup Guide
description: Complete guide for installing and setting up XBSX2 PS2 emulator on Xbox Series X/S
tags:
Expand Down
145 changes: 145 additions & 0 deletions docs/ports/uhexen2-guide.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,145 @@
---
title: "uHexen2 Guide"
sidebar_position: 60
description: "A guide for setting up uHexen2 on dev mode."
tags:
- guides
- ports
- xbox
slug: uhexen2-guide
---


### Requirements
- You will need the game data from a legally owned copy of **Hexen II**.
- The app does not include the retail PAK files.
- This is **Hexen II: Hammer of Thyrion**, packaged for Xbox Dev Mode.

### Install uHexen2
- Install the uHexen2 app via the Xbox Device Portal including the dependency file.
- Launch the app once, then close it.
- This creates the app's LocalState folder.

### Base Game Setup
Using the Xbox Device Portal file browser, place the base game PAK files here:

```text
LocalState/data1/pak0.pak
LocalState/data1/pak1.pak
```

Do not leave the files inside a ZIP file.

Do not place them inside another folder.

Once the files are in place, start the app again.

### Portal of Praevus Setup
Portal of Praevus requires the base game PAK files as well as its own retail PAK file.

Keep the `data1` folder in place, then add:

```text
LocalState/portals/pak3.pak
```

Close and reopen the app after copying the file.

Portal of Praevus is detected automatically.

The Single Player menu will show:

- **New Mission** for Portal of Praevus
- **Old Mission** for the original Hexen II campaign

Portal saves are stored here:

```text
LocalState/portals/
```

### Music Setup
External music replaces the original MIDI tracks and is required for music playback in this UWP build. Without these files, the game will have no music.

OGG is recommended, but this build also accepts:

- Opus
- MP3
- FLAC
- WAV
- `.it`
- `.s3m`
- `.xm`
- `.mod`

### Base Game Music
Place the base game music files here:

```text
LocalState/data1/music/
```

The files must use the game's track names.

For OGG, the base game tracks should be named:

```text
casa1.ogg
casa2.ogg
casa3.ogg
casa4.ogg
egyp1.ogg
egyp2.ogg
egyp3.ogg
meso1.ogg
meso2.ogg
meso3.ogg
roma1.ogg
roma2.ogg
roma3.ogg
casb1.ogg
casb2.ogg
casb3.ogg
```

Do not use `trackXX` names.

### Portal of Praevus Music
Place Portal music here:

```text
LocalState/portals/music/
```

Use these track names:

```text
tulku1.ogg
tulku2.ogg
tulku3.ogg
tulku4.ogg
tulku5.ogg
tulku6.ogg
tulku7.ogg
tulku8.ogg
tulku9.ogg
tulku10.ogg
```

### Enable Music In-Game
In the game, open **Options**.

Set:

```text
Music Type: All Codecs
```

Then raise **Music Volume** above zero.

MIDI and CD music modes do not play these external music files in the UWP build.

### Saves and Settings
Saves and settings are kept in LocalState.

---
2 changes: 1 addition & 1 deletion docs/ports/virtua-fighter-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Virtua Fighter Guide"
sidebar_position: 60
sidebar_position: 61
description: "A guide for setting up Virtua Fighter on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/virtua-racing-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Virtua Racing Guide"
sidebar_position: 61
sidebar_position: 62
description: "A guide for setting up Virtua Racing on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/vvvvvv-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "VVVVVV (V6) Guide"
sidebar_position: 62
sidebar_position: 63
description: "A guide for setting up VVVVVV (V6) on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/zelda3-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Zelda 3 Guide"
sidebar_position: 63
sidebar_position: 64
description: "A guide for setting up Zelda 3 on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/zelda64-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Zelda 64 Recompiled Guide"
sidebar_position: 64
sidebar_position: 65
description: "A guide for setting up Zelda 64 Recompiled on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/zircon-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Zircon (Quake) Guide"
sidebar_position: 65
sidebar_position: 66
description: "A guide for setting up Zircon (Quake) on dev mode."
tags:
- guides
Expand Down