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
2 changes: 1 addition & 1 deletion docs/ports/chronodivide-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Red Alert 2: Chrono Divide Guide"
sidebar_position: 32
sidebar_position: 33
description: "A guide for setting up Chrono Divide on dev mode."
tags:
- guides
Expand Down
15 changes: 12 additions & 3 deletions docs/ports/openmohaa-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -209,11 +209,20 @@ The shipped magnitude is:
0.007
```

Keep `j_yaw` negative for normal horizontal aiming.
### Invert vertical aiming
To invert the right stick:

Keep `j_pitch` positive for normal vertical aiming.
```cfg
bind PAD0_RIGHTSTICK_UP "+lookdown"
bind PAD0_RIGHTSTICK_DOWN "+lookup"
```

To restore normal vertical aiming:

Make `j_pitch` negative to invert vertical aiming.
```cfg
bind PAD0_RIGHTSTICK_UP "+lookup"
bind PAD0_RIGHTSTICK_DOWN "+lookdown"
```

### Mods
Some desktop mod PK3 files have been tested and work on Xbox.
Expand Down
207 changes: 207 additions & 0 deletions docs/ports/openmw-guide.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,207 @@
---
title: "OpenMW Guide"
sidebar_position: 28
description: "A guide for setting up OpenMW on Xbox Dev Mode."
tags:
- guides
- ports
- xbox
slug: openmw-guide
---

Getting OpenMW running on an Xbox Series S or Series X in Developer Mode is a fantastic way to experience *The Elder Scrolls III: Morrowind* on modern console hardware. Because this is an unofficial community port running through a custom translation layer, setting everything up properly takes a bit of care.

This guide walks you through installation, storage configuration, performance tuning, and migrating desktop mod lists.

*This is an unofficial port. Xbox specific issues should be discussed in dev mode community discords and not reported to the upstream OpenMW development team.*

### Requirements
- You will need an Xbox Series S or Xbox Series X configured for Developer Mode (Xbox One is not supported).
- You will need the OpenMW `.msix` package.
- You will need the dependency file supplied with the release.
- You will need your own legally owned copy of **The Elder Scrolls III: Morrowind**. The **Game of the Year (GOTY)** edition is strongly recommended, as it includes the **Tribunal** and **Bloodmoon** expansions.

This port is strictly an engine package and does not include original game files, textures, or mods.

### Install OpenMW
1. Open the **Xbox Device Portal** on your browser while your console is in Developer Mode.
2. Install the OpenMW `.msix` bundle via the App Manager.
3. Install the required dependency file supplied with the release.

### External Storage Setup
Copy the complete **contents** of Morrowind's original `Data Files` folder to your USB drive:

```text
E:/OpenMW/data
```

The folder should contain essential files such as:

```text
Morrowind.esm
Morrowind.bsa
```

It should also contain subdirectories including:

```text
Meshes
Music
Sound
Textures
```

Add the **Tribunal** and **Bloodmoon** files as well if your edition includes them.

OpenMW automatically uses external storage when it finds:

```text
E:/OpenMW/data/Morrowind.esm
```

If this file is not found, OpenMW will fall back to internal `LocalState` storage instead.

### Internal Storage Setup
1. Access the app's `LocalState` folder in the Xbox Device Portal.
2. Create this folder:

```text
LocalState/data
```

3. Upload the **contents** of your Morrowind `Data Files` directory into:

```text
LocalState/data
```

OpenMW will use internal storage whenever it detects:

```text
LocalState/data/Morrowind.esm
```

### First Launch & Controls
A clean first launch automatically generates a default configuration file:

```text
openmw.cfg
```

*Tribunal* and *Bloodmoon* expansions are automatically recognized when their files are present.

The launcher features graphics settings alongside three core modding tabs:
- **Data Directories**
- **Content Files**
- **Archive Files**

#### Launcher Controls
- **D-pad:** Navigate menus
- **A:** Select / Confirm
- **B:** Go back
- **LB / RB:** Switch tabs
- **D-pad Left / Right:** Switch between list items and sidebar buttons
- **Menu / Start:** Launch Morrowind directly from any page

Start with an unmodded, vanilla game first to verify your base installation works smoothly before adding mods.

#### Recommended Initial Settings
On your first launch, run through these menus to tweak your base configuration:

* **Graphics:** Set your resolution and enable **VSync**. If playing on a higher resolution display, increase the **UI Scale** for better text readability and enable **Stretch menu background** to display backgrounds cleanly in widescreen.
* **Input:** Enable **Controller menus** for easier console navigation. You may also want to reduce the **Menu cursor speed**.
* **Gameplay:** Check the **Gameplay** tab for additional quality of life toggles and settings to fit your playstyle.

### Performance & Graphics Settings
Because OpenMW translates graphics calls through a custom multi-layer pipeline:

```text
OpenMW > OpenSceneGraph > desktop OpenGL > Mesa/Gallium > Xbox GPU
```

Performance can drop quickly if heavy visual settings are enabled. To maintain a steadier frame rate:
- Keep **post-processing off**.
- Keep **shadows off**, or only enable essential options with modest shadow resolution.
- Keep **water textures and reflections modest**, and avoid combining multiple water effects.
- Keep **viewing distance sensible**; avoid expansive distant terrain.
- Reduce the **rendering resolution** if you need to lower GPU load. You can only do this in the launcher, not in game.

> **Important Warning:** Anti-aliasing is disabled by default because it crashes Mesa. Do not attempt to add or restore an `antialiasing` setting in `settings.cfg`.

### Installing Mods on Xbox
External mods can be stored on your USB drive under:

```text
E:/OpenMW/mods
```

Keep each mod inside its own dedicated subfolder while preserving the directory structure provided by the mod author. Internal mods can also be stored under `LocalState`.

In the launcher:
1. Add the mod's actual data folder under **Data Directories**.
2. Enable its required plugins under **Content Files**.
3. Add any `.bsa` files under **Archive Files**.
4. Arrange your load order strictly according to the mod instructions.

Avoid enabling every plugin automatically, as mods often include optional or mutually exclusive plugin choices.

### Move a Desktop Mod Setup to Xbox
For a large mod list (such as the **Morrowind Starter Pack** from Modding-OpenMW), configuring and testing everything on PC first is much easier.

1. Finish and validate the setup on PC.
2. Let `openmw-navmeshtool` finish generating navigation data if you want pre-built pathfinding caches.
3. Copy your complete PC mods folder to your USB drive:

```text
E:/OpenMW/mods
```

4. In `openmw.cfg`, replace desktop drive paths with USB drive paths:

```text
data="E:/OpenMW/mods/Patch for Purists"
```

*(Replaces paths like `data="C:\OpenMWMods\Patch for Purists"`)*

5. Change the main game data path to:

```text
data="E:/OpenMW/data"
```

6. Check that no `data=` line still points to local PC drives.
7. Upload `openmw.cfg`, `settings.cfg`, and `navmesh.db` (if generated) directly to the root of `LocalState`.

*Note on Performance:* Complex setups like the Morrowind Starter Pack run around **15–25 FPS** on console. Treat heavy modding as an experimental compatibility test rather than a target for high-framerate gameplay.

#### If Performance Drops Severely, Lower Settings in This Order:
1. Disable post-processing.
2. Reduce or disable shadows.
3. Lower water quality and reflections.
4. Reduce viewing distance and distant terrain.
5. Lower rendering resolution.
6. Remove heavy visual or texture overhaul mods.
7. Reduce active script-heavy plugins in your load order.

### Saves & Backups
OpenMW keeps saves, configuration files, logs, caches, and `navmesh.db` inside `LocalState`. Always back up `LocalState` via the Xbox Device Portal before uninstalling the app or making major changes to your mod list.

### Quick Fixes

#### Morrowind is not found
Verify that `Morrowind.esm` exists in one of these paths:
```text
E:/OpenMW/data/Morrowind.esm
LocalState/data/Morrowind.esm
```

#### Copied desktop settings crash the game
Remove anti-aliasing and desktop only post-processing settings from `settings.cfg`. Start with lighter shadow and water options.

#### Performance is poor
Disable post-processing first. Next, reduce shadows, water effects, viewing distance, and resolution. Test on a clean, unmodded save.

---

**MewLew**
2 changes: 1 addition & 1 deletion docs/ports/opentyrian-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "OpenTyrian 2000 Guide"
sidebar_position: 28
sidebar_position: 29
description: "A guide for setting up OpenTyrian 2000 on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/pekka-kana-2-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Pekka Kana 2 Guide"
sidebar_position: 29
sidebar_position: 30
description: "A guide for setting up Pekka Kana 2 on Xbox Dev Mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/perfectdark-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Perfect Dark Guide"
sidebar_position: 30
sidebar_position: 31
description: "A guide for setting up Perfect Dark on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/razeuwp-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 31
sidebar_position: 32
title: RazeUWP Setup Guide
description: Complete guide for installing and setting up RazeUWP Build engine port on Xbox
tags:
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/relichunters-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Relic Hunters Zero Guide"
sidebar_position: 33
sidebar_position: 34
description: "A guide for setting up Relic Hunters Zero on dev mode."
tags:
- guides
Expand Down
80 changes: 80 additions & 0 deletions docs/ports/ridge-racer-collection-guide.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
---
title: "Ridge Racer Collection Guide"
sidebar_position: 35
description: "A guide for setting up Ridge Racer Collection on Xbox Dev Mode."
tags:
- guides
- ports
- xbox
slug: ridge-racer-collection-guide
---


### Requirements
- You will need **Ridge Racer Collection**.
- You will need your own legally acquired ROM files.

Required files:

```text
namcoc71.bin
namcoc74.bin
raverace.zip
ridgera2.zip
ridgerac.zip
ridgeracb.zip
```

Currently, only the **world ROM set** is supported.

Japanese ROM support is planned for a later build.

### Features
Ridge Racer Collection supports:

- Xbox One, and Xbox Series consoles
- wheels, shifters, and pedals
- force feedback on Xbox Series consoles
- up to 4K rendering on Xbox Series consoles
- cross-play between supported platforms
- online multiplayer
- up to 8 players in **Ridge Racer 2** and **Rave Racer**

### Xbox One and Xbox Series Setup
- Install the app through the Xbox Device Portal.
- Place the required ROM files on the root of a USB storage device.
- Launch the app on the console.

On first boot, the ROM files will be copied into the correct location automatically.

Once the copy is complete, the USB storage device can be disconnected.

### Wheel Setup
If using a wheel, pedals, or gear shifter, configure them before playing.

Open:

```text
Options > Wheel Settings
```

Then run the button setup.

### Online Play
Online play is free to use.

No subscription or registration is required.

Cross-play is supported between all platforms.

Currently, online mode only supports sequential shifting for manual transmissions.

Automatic transmission is unaffected.

H-shifters cannot currently be used in online mode.

### Known Issues
- Synthetic force feedback for **Ridge Racer** and **Ridge Racer 2** is still work in progress.
- Only the world ROM set is currently supported. Japanese ROM support is planned for a later build.

---
2 changes: 1 addition & 1 deletion docs/ports/rigelengine-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Rigel Engine Guide"
sidebar_position: 34
sidebar_position: 36
description: "A guide for setting up and using Rigel Engine on Xbox Dev Mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/rsdkv4-uwp-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "RSDKv4 UWP Guide"
sidebar_position: 35
sidebar_position: 37
description: "A guide for setting up RSDKv4 UWP on Xbox Dev Mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/sdlpop-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "SDLPOP (Prince of Persia) Guide"
sidebar_position: 36
sidebar_position: 38
description: "A guide for setting up SDLPOP (Prince of Persia) on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/sega-rally-championship-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Sega Rally Championship Guide"
sidebar_position: 37
sidebar_position: 39
description: "A guide for setting up Sega Rally Championship on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/sm64coopdx-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "sm64coopdx Guide"
sidebar_position: 38
sidebar_position: 40
description: "A guide for setting up sm64coopdx on dev mode."
tags:
- guides
Expand Down
Loading