DuskPort

Dusklight auf Windows installieren — Twilight Princess PC-Port

Dusklight — den nativen Twilight-Princess-PC-Port — auf Windows 10 oder 11 installieren. Verifizierte Dateipfade, echte Einstellungsmenüs und Hash-Verifizierung Schritt für Schritt.

Veröffentlicht 2026-05-10 ·Aktualisiert 2026-06-20

Diese Anleitung führt dich Schritt für Schritt durch die Installation von Dusklight — dem nativen Twilight-Princess-PC-Port von TwilitRealm, veröffentlicht am 9. Mai 2026 — auf einem Windows-10- oder Windows-11-Rechner.

Zeitaufwand: ~10 Minuten (wenn dein Disc-Dump bereits fertig ist) Schwierigkeit: Einfach

Bevor du anfängst

Du brauchst drei Dinge:

1. Einen 64-Bit-Windows-10- oder -11-PC

Dusklight liefert 64-Bit-Windows-Binaries für x86_64 (Intel/AMD) und ARM64 (Windows on ARM — z. B. Snapdragon X / Surface). Wähle den passenden Build für deine CPU. Eine 32-Bit-Version gibt es nicht.

2. Eines von sieben Grafik-Backends

Dusklight unterstützt D3D12, D3D11, Metal (auf Windows irrelevant), Vulkan, OpenGL, OpenGL ES und WebGPU. Wenn deine GPU aus den letzten ~10 Jahren stammt und aktuelle Treiber hat, passt das. Das Standard-Backend lässt sich in Settings → Prelaunch → Graphics Backend ändern, falls die automatische Auswahl nicht funktioniert.

3. Deinen eigenen GameCube-Twilight-Princess-Disc-Dump

Dusklight enthält keine Spieldateien. Du musst deine eigene Retail-GameCube-Disc legal auslesen. Falls du noch keinen Dump hast, folge zuerst der Anleitung So liest du deine TP-Disc legal aus.

Dusklight akzeptiert nur:

  • NTSC-U (USA), Game-ID GZ2E01, SHA-1 75edd3ddff41f125d1b4ce1a40378f1b565519e7
  • PAL (Europa / Australien), Game-ID GZ2P01, SHA-1 2601822a488eeb86fb89db16ca8f29c2c953e1ca

NTSC-J und Wii-Dumps werden zwar erkannt, aber abgelehnt (du siehst dann „The selected game is not supported by Dusklight”). Wii- und Japan-Unterstützung ist auf der Roadmap.

Unterstützte Disc-Image-Formate: ISO, GCM, CISO, GCZ, NFS, RVZ, WBFS, WIA, TGC.

Schritt 1 — Dusklight herunterladen

  1. Öffne die offizielle Releases-Seite: github.com/TwilitRealm/dusklight/releases
  2. Suche das neueste Release (aktuell v1.4.1, erschienen am 16. Juni 2026)
  3. Lade unter Assets den passenden Build für deine CPU herunter:
    • x86_64 (Intel/AMD): Dusklight-v1.4.1-win32-x86_64.zip (~35,9 MB)
    • ARM64 (Windows on ARM): Dusklight-v1.4.1-win32-arm64.zip (~33,0 MB)

⚠️ Lade nur von der offiziellen GitHub-Releases-Seite oder von twilitrealm.dev herunter. Finger weg von Drittanbieter-„Gratis-Download”-Seiten und Torrents — dort kann Malware oder manipulierter Code enthalten sein.

Den Download lässt sich in PowerShell verifizieren:

Get-FileHash -Algorithm SHA256 .\Dusklight-v1.4.1-win32-x86_64.zip

Den ausgegebenen Hash mit dem vergleichen, was die offizielle Release-Seite neben dem Asset veröffentlicht.

Schritt 2 — Archiv entpacken

Rechtsklick auf die ZIP → Alle extrahieren…, oder 7-Zip / WinRAR verwenden.

In einen Ordner entpacken, den du dir merkst. Sinnvolle Optionen:

  • C:\Games\Dusklight\
  • D:\Emulation\Dusklight\

Diese Orte vermeiden:

  • C:\Program Files\ — UAC-Berechtigungen können Probleme mit Konfiguration und Spielständen verursachen
  • Ordner, die von OneDrive / Dropbox synchronisiert werden — Dateikonflikte können Spielstände beschädigen
  • Pfade mit Nicht-ASCII-Zeichen waren bei v1.0.0 ein bekannter Startfehler (#807) — behoben in v1.0.1 (Unicode-Dateipfad-Unterstützung ergänzt am 11. Mai 2026). Falls du das noch siehst, auf das neueste Release updaten.

Schritt 3 — ROM-Dump verifizieren

Bevor du Dusklight startest, überprüfe den SHA-1-Hash deines Disc-Dumps. Das verhindert den häufigsten Fehler beim ersten Start.

In PowerShell in den Ordner mit deinem Disc-Image wechseln und ausführen:

Get-FileHash -Algorithm SHA1 .\your-dump.iso

(your-dump.iso durch deinen tatsächlichen Dateinamen ersetzen.)

Die Ausgabe muss exakt mit einem dieser Werte übereinstimmen:

  • 75EDD3DDFF41F125D1B4CE1A40378F1B565519E7 (NTSC-U)
  • 2601822A488EEB86FB89DB16CA8F29C2C953E1CA (PAL)

Falls keiner passt, ist dein Dump eins von:

  • Falsche Region (NTSC-J / Wii / Korea — in v1.0.0 nicht unterstützt)
  • Beschädigt (nochmals mit CleanRip und aktivierter Prüfsummen-Verifikation auslesen)
  • Ein „Scene”-Release mit Modifikationen

Hinweis: Dusklight nutzt intern XXH128-Hashes (nicht SHA-1) für seine eingebaute Verifizierung. Der SHA-1 oben ist zum externen Prüfen gedacht. Wenn dein SHA-1 stimmt, passt auch dein XXH128.

Schritt 4 — Dusklight zum ersten Mal starten

  1. Dusklight.exe im entpackten Ordner doppelklicken
  2. Windows SmartScreen warnt möglicherweise, dass der Herausgeber unbekannt ist. Auf Weitere Informationen → Trotzdem ausführen klicken. Das ist bei jeder nicht signierten Anwendung normal; Dusklight ist Open Source und nicht code-signiert.
  3. Das Dusklight-Prelaunch-Menü öffnet sich. Der Hauptknopf lautet Select Disc Image.
  4. Darauf klicken. Ein nativer Windows-Dateidialog öffnet sich mit dem Filter „Game Disc Images” (Endungen: iso, gcm, ciso, gcz, nfs, rvz, wbfs, wia, tgc).
  5. Zum Disc-Dump navigieren und ihn auswählen.
  6. Dusklight zeigt einen „Verifying disc image”-Overlay, während der XXH128-Hash berechnet wird. Das dauert ein paar Sekunden.
  7. Die Statuszeile unter dem Knopf wechselt zu „Disc ready.”
  8. Der Hauptknopf zeigt jetzt Play. Klicken zum Starten.

Falls die Verifizierung fehlschlägt, erscheint eine dieser Meldungen:

  • "The selected disc image could not be validated."
  • "Unable to read the selected file."
  • "The selected file is not a valid disc image."
  • "The selected game is not supported by Dusklight."
  • "Dusklight currently supports GameCube USA and PAL disc images only."
  • "The selected disc image did not pass hash verification. It may be corrupt or..."

In jedem Fall hilft die SHA-1-Mismatch-Fehlerbehebung weiter.

Schritt 5 — Controller einrichten

Der genaue Menüpfad lautet:

Settings → Input → Controller → Configure Controller

Damit öffnet sich ein Port-Fenster mit den Reitern Port 1, Port 2, … und den Seiten Controller / Buttons / Triggers / Sticks / Rumble. Im Bereich Options gibt es außerdem die Schalter Enable Dead Zones und Emulate Triggers.

Die meisten modernen Controller funktionieren Plug-and-Play:

ControllerHinweise
Xbox Wireless / Xbox SeriesPlug-and-Play
DualShock 4 / DualSenseNativ, Gyro funktioniert
Switch Pro ControllerNativ, Gyro funktioniert
8BitDo Pro 2 / UltimateNativ, Gyro funktioniert
GameCube via MayflashFunktioniert, wird als Standard-Gamepad erkannt

⚠️ Bekanntes Problem: Wenn ein Nintendo-WUP-028-GameCube-USB-Adapter angeschlossen ist, keinen Nicht-GCN-Controller aus dem Dropdown wählen — das löst einen bekannten Bug (#810) aus, der eine 4-GiB-Junk-Datei erzeugt. Adapter trennen oder den richtigen Controller auswählen.

Gyro-Aim aktivieren (DS4, DualSense, Pro Controller, 8BitDo Pro 2):

Settings → Input → Gyro → Gyro Aim → einschalten

Maussteuerung statt Gyro:

Settings → Input → Gyro → Gyro Input Method → auf Mouse setzen

Optional · Spielstände von Dolphin übertragen

Dusklight liest Standard-GameCube-.gci-Spielstanddateien. Wer bisher in Dolphin gespielt hat, kann den Spielstand mitnehmen.

Aus dem offiziellen Dusklight-FAQ (twilitrealm.dev/faq):

„Kopiere einfach die Datei 01-GZ2*-gczelda2.gci von Dolphin nach Dusklight.”

Die genauen Pfade:

  • Dolphin-Spielstand-Ordner (Standard): Documents\Dolphin Emulator\GC\USA\Card A\
    • Dateiname: 01-GZ2E01-gczelda2.gci (oder 01-GZ2P01-… für PAL)
  • Dusklight-Spielstand-Ordner: %APPDATA%\TwilitRealm\Dusklight\USA\Card A\
    • USA durch EUR ersetzen, wenn du die europäische Disc spielst
    • Beim ersten Start migriert Dusklight Spielstände automatisch aus dem alten %APPDATA%\TwilitRealm\Dusk\-Ordner

Die Datei aus Dolphins Ordner in Dusklights Ordner kopieren. Dusklight neu starten; der Spielstand erscheint im In-Game-Lademenu.

Falls deine Dolphin-Spielstände im .raw-Format statt als .gci vorliegen, zuerst mit Dolphins Memory Card Tool einzelne .gci-Dateien extrahieren. Alternativ das Spielstand-Format in Dusklight unter Settings → Prelaunch → Save File Type auf Card Image (nutzt .raw) umstellen.

Häufige Fehler und Lösungen

„The selected game is not supported by Dusklight.”

Du hast ein Wii-, Japan-, Korea- oder sonstiges nicht unterstütztes Disc-Image geladen. Dusklight akzeptiert nur GameCube USA + PAL. Wii- und NTSC-J-Unterstützung ist geplant, aber noch nicht veröffentlicht.

„The selected disc image did not pass hash verification…”

Dein Dump ist beschädigt, verändert oder aus der falschen Region. Nochmals mit CleanRip und Prüfsummen-Verifikation auslesen.

Stiller Startfehler bei einem Windows-Konto mit Nicht-ASCII-Benutzername

War ein Bug in v1.0.0 (#807) — behoben in v1.0.1 mit korrekter Unicode-Dateipfad-Unterstützung. Auf das neueste Release updaten, falls das noch auftritt.

Schwarzer Bildschirm mit Ton

Grafik-Backend wechseln: Settings → Prelaunch → Graphics Backend → D3D12, D3D11, Vulkan, OpenGL der Reihe nach durchprobieren.

Spiel ruckelt bei entsperrter Framerate

Es gibt einen bekannten pulsierenden-Bloom-Bug bei aktiviertem „Unlock Framerate” (#825). Entweder Framerate sperren (Settings → Video → Rendering → Unlock Framerate deaktivieren) oder das visuelle Artefakt vorerst akzeptieren.

Für weitere Probleme zuerst die Dusklight-GitHub-Issues-Seite prüfen, bevor du im Discord fragst.

Häufige Probleme unter Windows

Falls etwas nicht funktioniert — das sind die Probleme, die unter Windows am häufigsten auftreten, jeweils mit einem direkten Link zur Lösung:

Was als nächstes?

Zuletzt aktualisiert: 20. Juni 2026. Wir aktualisieren diese Anleitung, wenn Dusklight-Patches das Installationsverhalten ändern.

← Alle Installationsanleitungen · Hauptseite →