Skip to main content

Dusklight (Twilight Princess) Guide

Requirements​

You need:

  • The Dusklight 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 Dusklight, make sure your dump is clean and supported.

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

VersionSHA-1 hash
GameCube USA75edd3ddff41f125d1b4ce1a40378f1b565519e7
GameCube EUR2601822a488eeb86fb89db16ca8f29c2c953e1ca

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 first.

Install Dusklight UWP​

  1. Extract the Dusklight UWP release package:
dusklight_uwp.zip
  1. Open the extracted folder.
  2. Find the Dusklight .msixbundle file.
  3. Open the Xbox Device Portal in your browser.
  4. Go to the app installation page.
  5. Choose the Dusklight .msixbundle.
  6. Add the required dependency file from the x64 dependency folder.
  7. Install the package.

First Boot Setup​

  1. Connect your external drive to the Xbox.
  2. Launch Dusklight.
  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 Dusklight menu.
  7. Choose either the normal experience or the Dusklight experience when prompted.

Texture Pack Requirements​

Texture packs must be in DDS format.

A correct texture pack should contain a folder named:

GZ2

Inside GZ2, you should see folders such as:

CREATURE
ENVIRONMENT
LINK
NPC

The full GZ2 folder must end up inside Dusklight'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 5120 MB memory limit. If the texture pack is too large, Dusklight may crash, fail to load textures or run out of memory.

Texture Replacement Path​

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

LocalState\TwilitRealm\Dusklight\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 Dusklight app folder.
  5. Open LocalState.
  6. Open this folder path:
TwilitRealm\Dusklight\texture_replacements

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

LocalState\TwilitRealm\Dusklight\texture_replacements

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

After extraction, the folder should look like this:

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:

CREATURE.zip
ENVIRONMENT.zip
LINK.zip
NPC.zip
  1. In the Xbox Device Portal, open:
LocalState\TwilitRealm\Dusklight\texture_replacements\GZ2

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

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

After extraction, the folder should look like this:

texture_replacements\GZ2\CREATURE
texture_replacements\GZ2\ENVIRONMENT
texture_replacements\GZ2\LINK
texture_replacements\GZ2\NPC

If the folder layout is correct, Dusklight 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:

LocalState\TwilitRealm\Dusklight\texture_replacements\GZ2\LINK

This is wrong:

LocalState\TwilitRealm\Dusklight\texture_replacements\LINK

The GZ2 folder must not be skipped.