diff --git a/docs/emulation/dosbox-pure-uwp-guide.mdx b/docs/emulation/dosbox-pure-uwp-guide.mdx new file mode 100644 index 0000000..7bb9c61 --- /dev/null +++ b/docs/emulation/dosbox-pure-uwp-guide.mdx @@ -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 | + +--- diff --git a/docs/emulation/flycast-guide.mdx b/docs/emulation/flycast-guide.mdx index 68692fa..2621179 100644 --- a/docs/emulation/flycast-guide.mdx +++ b/docs/emulation/flycast-guide.mdx @@ -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: diff --git a/docs/emulation/ppsspp-guide.mdx b/docs/emulation/ppsspp-guide.mdx index 23594b8..56a2d61 100644 --- a/docs/emulation/ppsspp-guide.mdx +++ b/docs/emulation/ppsspp-guide.mdx @@ -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: diff --git a/docs/emulation/retroarch-guide.mdx b/docs/emulation/retroarch-guide.mdx index bb98f83..b175457 100644 --- a/docs/emulation/retroarch-guide.mdx +++ b/docs/emulation/retroarch-guide.mdx @@ -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: diff --git a/docs/emulation/segamodel3-g920-guide.mdx b/docs/emulation/segamodel3-g920-guide.mdx index 59090ad..83666f4 100644 --- a/docs/emulation/segamodel3-g920-guide.mdx +++ b/docs/emulation/segamodel3-g920-guide.mdx @@ -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 diff --git a/docs/emulation/segamodel3-guide.mdx b/docs/emulation/segamodel3-guide.mdx index 4bcef89..9bbb645 100644 --- a/docs/emulation/segamodel3-guide.mdx +++ b/docs/emulation/segamodel3-guide.mdx @@ -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 diff --git a/docs/emulation/xbsx2-guide.mdx b/docs/emulation/xbsx2-guide.mdx index e7c37f1..141b6da 100644 --- a/docs/emulation/xbsx2-guide.mdx +++ b/docs/emulation/xbsx2-guide.mdx @@ -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: diff --git a/docs/ports/uhexen2-guide.mdx b/docs/ports/uhexen2-guide.mdx new file mode 100644 index 0000000..fd1730d --- /dev/null +++ b/docs/ports/uhexen2-guide.mdx @@ -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. + +--- diff --git a/docs/ports/virtua-fighter-guide.mdx b/docs/ports/virtua-fighter-guide.mdx index 343dffa..85a9537 100644 --- a/docs/ports/virtua-fighter-guide.mdx +++ b/docs/ports/virtua-fighter-guide.mdx @@ -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 diff --git a/docs/ports/virtua-racing-guide.mdx b/docs/ports/virtua-racing-guide.mdx index f02b0eb..482a165 100644 --- a/docs/ports/virtua-racing-guide.mdx +++ b/docs/ports/virtua-racing-guide.mdx @@ -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 diff --git a/docs/ports/vvvvvv-guide.mdx b/docs/ports/vvvvvv-guide.mdx index dfc0337..25371be 100644 --- a/docs/ports/vvvvvv-guide.mdx +++ b/docs/ports/vvvvvv-guide.mdx @@ -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 diff --git a/docs/ports/zelda3-guide.mdx b/docs/ports/zelda3-guide.mdx index a524228..ccd54b3 100644 --- a/docs/ports/zelda3-guide.mdx +++ b/docs/ports/zelda3-guide.mdx @@ -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 diff --git a/docs/ports/zelda64-guide.mdx b/docs/ports/zelda64-guide.mdx index 07314b2..3d80561 100644 --- a/docs/ports/zelda64-guide.mdx +++ b/docs/ports/zelda64-guide.mdx @@ -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 diff --git a/docs/ports/zircon-guide.mdx b/docs/ports/zircon-guide.mdx index 9e54285..3afb346 100644 --- a/docs/ports/zircon-guide.mdx +++ b/docs/ports/zircon-guide.mdx @@ -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