Install · Game data & first launch
Game data & first launch
Use this after Install. Dusklight targets The Legend of Zelda: Twilight Princess on Nintendo GameCube: you supply a legal disc image whose SHA-1 matches a supported retail build below. We do not host dumps or link to ROM sites.
For legal and technical context on disc images you own (no redistribution, verify hashes), see Disc dumps & mirrors. The engine project lists steps as verify → download → in-app setup; here, download is covered from the home page and Install guides. You may verify your dump before or after fetching Dusklight, but the hash must match before you rely on Play.
Graphics hardware
Dusklight needs a GPU with D3D12, Vulkan 1.1+, or Metal. Best-effort paths include D3D11 and OpenGL ES (Android) but may not reach full accuracy. Older Intel integrated and some Adreno GPUs are more prone to issues. See Requirements.
Install the app, then this page (by platform)
Getting Dusklight onto your device depends on the OS. Official steps also live on twilitrealm.dev/install. After launch, everyone follows sections 2 · Launch and 3 · Select disc image below — the same in-app flow the project documents for desktop and Android.
- Windows, macOS, Linux: extract or run the build from Install (pick your OS), then return here for hash check and disc attachment.
- Android: install the apk (Install → Android), launch Dusklight, then use Select Disc Image and Play like desktop — file pickers and permissions differ, not the core steps.
- iOS: installation is different — you must finish Install → iOS first (the project documents a AltStore-based path on that page). Only when Dusklight opens normally should you use sections 2–3 here to pick your verified dump.
GameCube disc images (.iso, .gcm) and this project
Guides and search phrases often mention a "Twilight Princess GameCube ISO." For Dusklight, that really means "a supported retail GameCube rip of Twilight Princess." Common container extensions include .iso, .gcm, .rvz, and files from ripping tools — the decisive check is matching one of the official hashes below. To save space after a clean rip, the upstream README suggests converting with Dolphin or nodtool.
Not supported yet: GameCube Japan, Wii builds, and Twilight Princess HD — only USA and EUR GameCube retail hashes below are listed today. Other regions are planned per upstream release notes.
1 · Verify your dump
Compare the SHA-1 of your image to a supported build below. If it does not match, Dusklight may refuse the file or behave incorrectly. Other retail builds may be added over time — watch release notes.
| Version | Game ID | SHA-1 |
|---|---|---|
| GameCube USA | GZ2E01 | 75edd3ddff41f125d1b4ce1a40378f1b565519e7 |
| GameCube EUR | GZ2P01 | 2601822a488eeb86fb89db16ca8f29c2c953e1ca |
Goal: a clean, byte-identical image of a disc you own. Examples with built-in tools:
- Windows (PowerShell):
Get-FileHash -Algorithm SHA1 .\path\to\dump.iso - macOS:
shasum -a 1 /path/to/dump.iso - Linux:
sha1sum /path/to/dump.iso
2 · Launch Dusklight
Open the app from your install location (Install). You should land in Dusklight's launcher: pick a disc image, optionally adjust settings the build exposes, and start once the file is accepted.
3 · Select disc image
- Choose Select Disc Image (or the equivalent entry in the menu).
- Point Dusklight at your verified GameCube dump file on disk or on-device storage (Android/iOS paths differ).
- Press Play once the image is accepted.
Android follows the same post-install flow as desktop once the apk is installed. iOS users must complete Install → iOS before these steps apply; paths and the Files app differ, but the launcher actions are the same.
Common questions
- Does this site provide Twilight Princess files or ISO links?
- No — only how to install Dusklight and how to verify your own GameCube rip.
- Can I use any Zelda Twilight Princess GameCube dump?
- Only if its SHA-1 matches a supported retail entry in the table. Other regions or edited images are not covered here unless noted in upstream release docs.
- ISO vs GCM vs RVZ — which do I need?
- Extensions are shorthand; correctness is checksum plus a clean rip. RVZ and other compressed containers can work when the data matches a supported build — re-verify after conversion.
- What GPU or graphics API does Dusklight need?
- At minimum: D3D12, Vulkan 1.1+, or Metal. Best-effort D3D11 / OpenGL ES may not reach full accuracy.
- What do disc product codes like GZ2E01 mean?
- Retail GameCube identifiers for supported Twilight Princess builds:
GZ2E01is the USA image andGZ2P01is the European image — same entries as the SHA-1 table above, just another way labels appear on dumps or guides. - Is Wii supported?
- These steps target supported GameCube builds. Wii or other SKU support is announced with the engine — check twilitrealm.dev and the FAQ.
- Where do I report bugs?
- Use GitHub Issues for the engine; use contact only for this website.