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: 24
sidebar_position: 25
description: "A guide for setting up Chrono Divide on dev mode."
tags:
- guides
Expand Down
208 changes: 208 additions & 0 deletions docs/ports/dusk-guide.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,208 @@
---
title: "Dusk (Twilight Princess) Guide"
sidebar_position: 10
description: "A guide for setting up Dusk (Twilight Princess) on dev mode"
tags:
- guides
- ports
- xbox
slug: dusk-uwp-guide
---

## Requirements

You need:

- The Dusk UWP `.zip` package
- Xbox Developer Mode
- Xbox Device Portal access
- A USB external drive for your game dump
- A clean, legally dumped **GameCube** disc image of Twilight Princess
- Optional: a **DDS** texture pack

---

## Supported Game Dump Hashes

Before setting up Dusk, make sure your dump is clean and supported.

Check the **SHA-1** hash of your dump and compare it with the supported versions below.

| Version | SHA-1 hash |
| --- | --- |
| GameCube USA | `75edd3ddff41f125d1b4ce1a40378f1b565519e7` |
| GameCube EUR | `2601822a488eeb86fb89db16ca8f29c2c953e1ca` |

Once you have verified your ROM, copy it to your external drive.

If you have not already prepared your external drive for Dev Mode, follow this [USB setup guide](https://wiki.sternserv.xyz/docs/xbox-setup/xbox-developer-mode-setup#setting-up-usb-drive-for-emulation) first.

---

## Install Dusk UWP

1. Extract the Dusk UWP release package:

```text
dusk_uwp.zip
```

2. Open the extracted folder.
3. Find the Dusk `.msixbundle` file.
4. Open the Xbox Device Portal in your browser.
5. Go to the app installation page.
6. Choose the Dusk `.msixbundle`.
7. Add the required dependency file from the `x64` dependency folder.
8. Install the package.

---

## First Boot Setup

1. Connect your external drive to the Xbox.
2. Launch Dusk.
3. Choose **Select Disc Image**.
4. The Xbox file picker will open.
5. Select your supported Twilight Princess GameCube dump from the external drive.
6. Follow the on screen prompt for opening the Dusk menu.
7. Choose either the normal experience or the Dusk experience when prompted.

---

## Texture Pack Requirements

Texture packs must be in **DDS** format.

A correct texture pack should contain a folder named:

```text
GZ2
```

Inside `GZ2`, you should see folders such as:

```text
CREATURE
ENVIRONMENT
LINK
NPC
```

The full `GZ2` folder must end up inside Dusk's texture replacement folder in Xbox internal app storage.

---

## Texture Pack Memory Warning

Use a **1080p** texture pack for Xbox Dev Mode.

Avoid **4K** texture packs. They are likely to exceed the Xbox Dev Mode **5020 MB** memory limit. If the texture pack is too large, Dusk may crash, fail to load textures or run out of memory.

---

## Texture Replacement Path

Texture replacements go here inside the Dusk app's `LocalState` folder:

```text
LocalState\TwilitRealm\Dusk\texture_replacements
```

---

## Upload Texture Packs Through Xbox Device Portal

1. Open the Xbox Device Portal in your browser.
2. Go to **File Explorer**.
3. Open **LocalAppData**.
4. Open the Dusk app folder.
5. Open **LocalState**.
6. Open this folder path:

```text
TwilitRealm\Dusk\texture_replacements
```

---

## Recommended Upload Method

Ensure the texture pack's `GZ2` folder is in `.zip` format and upload it to:

```text
LocalState\TwilitRealm\Dusk\texture_replacements
```

When prompted by Device Portal, choose to extract the zip automatically.

After extraction, the folder should look like this:

```text
texture_replacements\GZ2\CREATURE
texture_replacements\GZ2\ENVIRONMENT
texture_replacements\GZ2\LINK
texture_replacements\GZ2\NPC
```

If the upload hangs forever in Device Portal, use this method instead:

1. On your PC, open the texture pack's `GZ2` folder.
2. Zip each folder inside `GZ2` separately.

For example:

```text
CREATURE.zip
ENVIRONMENT.zip
LINK.zip
NPC.zip
```

3. In the Xbox Device Portal, open:

```text
LocalState\TwilitRealm\Dusk\texture_replacements\GZ2
```

You may need to create the `GZ2` folder if it does not already exist.

4. Upload one zipped folder at a time.
5. When prompted, choose to extract the contents of the zip into the current directory.
6. Repeat until every folder from the texture pack's `GZ2` folder has been uploaded and extracted.

After extraction, the folder should look like this:

```text
texture_replacements\GZ2\CREATURE
texture_replacements\GZ2\ENVIRONMENT
texture_replacements\GZ2\LINK
texture_replacements\GZ2\NPC
```

If the folder layout is correct, Dusk should load the replacement textures automatically.

---

## Troubleshooting

### The game does not detect my dump

Recheck the SHA-1 hash. The dump must match one of the supported GameCube versions.

### The game launches but textures do not load

Check the folder layout.

This is correct:

```text
LocalState\TwilitRealm\Dusk\texture_replacements\GZ2\LINK
```

This is wrong:

```text
LocalState\TwilitRealm\Dusk\texture_replacements\LINK
```

The `GZ2` folder must not be skipped.
2 changes: 1 addition & 1 deletion docs/ports/dxxrebirth-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "DXX Rebirth Guide"
sidebar_position: 10
sidebar_position: 11
description: "A guide for setting up DXX Rebirth on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/gzdoom-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 11
sidebar_position: 12
title: GZDoom Setup and Modding Guide
description: Complete guide for installing and setting up GZDoom Doom engine port on Xbox
tags:
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/inferno-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Inferno Guide"
sidebar_position: 12
sidebar_position: 13
description: "A guide for setting up Inferno on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/ioquake3-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "ioquake3 Guide"
sidebar_position: 13
sidebar_position: 14
description: "A guide for setting up ioquake3 on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/jazz2-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Jazz² Resurrection Guide"
sidebar_position: 14
sidebar_position: 15
description: "A guide for setting up Jazz² Resurrection on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/jkdf2-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Open JKDF2 Guide"
sidebar_position: 18
sidebar_position: 19
description: "A guide for setting up Open JKDF2 on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/maze-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Maze0x72 Guide"
sidebar_position: 15
sidebar_position: 16
description: "A guide for setting up Maze0x72 on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/mine-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Minesweeper 3D Guide"
sidebar_position: 16
sidebar_position: 17
description: "A guide for setting up Minesweeper 3D on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/nzp-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Nazi Zombies: Portable Guide"
sidebar_position: 17
sidebar_position: 18
description: "A guide for setting up Nazi Zombies: Portable on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/openbor-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "OpenBOR Guide"
sidebar_position: 19
sidebar_position: 20
description: "A guide for setting up OpenBOR on dev mode."
tags:
- ports
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/openlara-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "OpenLara Guide"
sidebar_position: 20
sidebar_position: 21
description: "A guide for setting up OpenLara on dev mode."
tags:
- guides
Expand Down
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: 21
sidebar_position: 22
description: "A guide for setting up OpenTyrian 2000 on 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: 22
sidebar_position: 23
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: 23
sidebar_position: 24
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: 25
sidebar_position: 26
description: "A guide for setting up Relic Hunters Zero on 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: 26
sidebar_position: 27
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/sm64coopdx-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "sm64coopdx Guide"
sidebar_position: 27
sidebar_position: 28
description: "A guide for setting up sm64coopdx on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/snake-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Snake Guide"
sidebar_position: 28
sidebar_position: 29
description: "A guide for setting up Snake on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/soh-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "SOH (Ship of Harkinian) Foxtrot UWP Edition Guide"
sidebar_position: 29
sidebar_position: 30
description: "A guide for setting up SOH (Ship of Harkinian) Foxtrot UWP Edition on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/sonic-adventure-blast2-uwp-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 34
sidebar_position: 35
title: Sonic Adventure Blast 2 UWP Setup Guide
description: Complete guide for installing and setting up Sonic Adventure Blast 2 UWP on Xbox
tags:
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/sonic-unleashed-recompiled-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 41
sidebar_position: 42
title: Sonic Unleashed Recompiled UWP Setup Guide
description: Complete guide for installing and setting up Sonic Unleashed Recompiled UWP on Xbox
tags:
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/sonic1decomp-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Sonic 1 Decompilation Guide"
sidebar_position: 31
sidebar_position: 32
description: "A guide for setting up Sonic 1 Decompilation on dev mode."
tags:
- guides
Expand Down
2 changes: 1 addition & 1 deletion docs/ports/sonic2decomp-guide.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Sonic 2 Decompilation Guide"
sidebar_position: 32
sidebar_position: 33
description: "A guide for setting up Sonic 2 Decompilation on dev mode."
tags:
- guides
Expand Down
Loading