DuskPort

Twilight Princess Randomizer + Dusklight – Setup & Kompatibilität

TPR (Twilight Princess Randomizer) v1.3.0 läuft auf Dusklight über den Standard-Memory-Card-REL-Loader ohne ISO-Patching. Setup-Ablauf, aktueller Support und was noch nicht geht.

Veröffentlicht 2026-05-14 ·Aktualisiert 2026-05-14

Der Twilight Princess Randomizer (TPR) ist der kanonische TP-Randomizer – gepflegt von der Speedrunning-Community, nur für die GameCube-Version, und auf Laufzeit-Injektion statt ISO-Patching ausgelegt. Letzteres ist genau das, was ihn mit Dusklight kompatibel macht.

Das Projekt

ProjektTwilight Princess Randomizer (TPR)
Orgzsrtp – Zelda Speedruns Twilight Princess
Codegithub.com/zsrtp/Randomizer
Web-Generatortprandomizer.com
Wikiwiki.tprandomizer.com
Aktuelle Versionv1.3.0 (veröffentlicht 2026-04-25)
SprachenC++ 81,9%, Python, PowerPC-Assembler
MaintainerAECX (Gründer), Zephiles (Reverse Engineering), lunarsoap5 (Projektleitung), vbn598, Isaac
CommunityDiscord, 7.911 Mitglieder; aktive Races auf racetime.gg/tpr

Wie es funktioniert – und warum es mit Dusklight funktioniert

Der Randomizer patcht deine ISO nicht. Aus dem offiziellen Randomizer-Guide-Wiki:

“A script to patch the iso with the randomizer is in the works at the moment.”

Das heißt: In v1.3.0 bleibt die ISO unverändert. Die Randomisierung steckt in zwei Memory-Card-Dateien, die du in Dolphin/Dusklights GCI-Ordner legst:

DateiFunktion
Rel_Loader.gciLädt das Randomizer-REL (relocatable module) beim Start in den Speicher
seedData.gciKodiert den spezifischen Zufalls-Seed und die Regeln für deinen Run

Zur Laufzeit hängt sich der Loader in TPs Startsequenz ein und überlagert die randomisierte Item-Logik, ohne die Disc-Daten anzufassen. Der SHA-1 der ISO bleibt bit-identisch.

Warum das für Dusklight wichtig ist: Dusklights iso_validate.cpp berechnet einen Hash des Disc-Images und lehnt alles ab, was nicht dem bekannten GZ2E01- oder GZ2P01-Hash entspricht. ISO-patchende Randomizer würden diese Prüfung nicht bestehen. TPR patcht die ISO nicht, also besteht der Hash-Check, und die Laufzeit-REL-Injektion übernimmt die gesamte Randomisierung.

Im Dusklight-Tracker gibt es keine TPR-bezogenen Issues (Stand 2026-05-13), was mit „es funktioniert einfach” übereinstimmt.

Vorbehalt: Das ist eine redaktionelle Schlussfolgerung auf Basis der dokumentierten Architekturen. Wir haben selbst keinen vollständigen TPR-Durchlauf auf Dusklight gemacht, um jedes Randomizer-Szenario zu zertifizieren. Wenn du einen TPR-spezifischen Bug auf Dusklight findest, melde ihn im Dusklight-Tracker – wir aktualisieren dann diese Seite.

Setup-Ablauf

Was du brauchst

  • Eine legal ausgelesene GameCube-TP-ISO (USA, PAL oder JP – TPR unterstützt alle drei)
  • Dusklight v1.0.0+ installiert
  • Eine leere TP-Memory-Card oder die Bereitschaft, einen anderen Slot zu verwenden

Schritt für Schritt

  1. Seed generieren auf tprandomizer.com. Einstellungen wählen (Item-Pool, Logik-Schwierigkeit, Glitches an/aus, Kosmetik). Der Generator liefert einen Download mit Rel_Loader.gci und seedData.gci.

  2. GCIs in Dusklights Memory-Card-Ordner legen:

    • Windows: %APPDATA%\TwilitRealm\Dusk\USA\Card A\
    • macOS: ~/Library/Application Support/TwilitRealm/Dusk/USA/Card A/
    • Linux / Steam Deck: ~/.local/share/TwilitRealm/Dusk/USA/Card A/
    • Android: /sdcard/Android/data/dev.twilitrealm.dusk/files/USA/Card A/
    • EUR/ statt USA/ für PAL verwenden, JAP/ für Japan sobald unterstützt.

  3. Dusklight starten und die unveränderte TP-ISO normal laden. Die Hash-Verifizierung besteht (die ISO ist unberührt).

  4. Im Spiel übernimmt der Loader beim Start. Ab dort läuft ein normaler TPR-Run – das TPR-Wiki liefert spielspezifische Hinweise.

Falls etwas schiefläuft, gilt der Dolphin-Guide auf dem TPR-Wiki auch für Dusklight, da beide dieselben Memory-Card- und Gecko-Code-Konventionen verwenden.

Was nicht unterstützt wird

HD / Wii U / Switch / Mobile-Randomizer

ZielStatus
GameCube TP✅ Offizieller TPR, v1.3.0
Wii TP (echte HW oder vWii via Nintendont)✅ Läuft GC-TPR über Nintendont
TP HD (Wii U Cemu)❌ Kein offizieller HD-Randomizer. Eine veraltete Community-Entrance-Rando-Beta existiert unter sites.google.com, wird aber nicht mehr gepflegt
Switch (Homebrew)❌ Nicht anwendbar; das TwilitRealm-Team hat Switch-Ports ausgeschlossen
Android / iOS via Dusklight⚠️ Nicht verifiziert – der GCI-Loader-Pfad sollte funktionieren, aber wir haben es nicht getestet

ISO-Patching

Laut TPR-Wiki kommt das irgendwann noch („A script to patch the iso with the randomizer is in the works”). Wenn und falls es erscheint, wäre das ein alternativer Installations-Weg – aktuell ist der Memory-Card-REL-Loader der einzige Weg.

Archipelago (Multi-World-Randomizer)

Wenn du TP in einen Multi-Game-Randomizer-Race einbinden willst (z. B. TP + OoT + Pokémon alle zusammen randomisiert, Items zwischen den Welten geteilt), gibt es eine inoffizielle Archipelago-apworld:

github.com/WritingHusky/Twilight_Princess_apworld

Gleiches Ziel (GameCube TP), gleiche REL-Loader-Injektionsmethode. Kompatibel mit Dusklight nach derselben Logik wie TPR.

Verwandte Seiten

Zuletzt aktualisiert: 14. Mai 2026. TPR-Architektur, Version und Team entnommen aus der zsrtp-GitHub-Org und dem TPR-Wiki. Wir haben keinen vollständigen TPR-Durchlauf auf Dusklight gemacht – wenn dein Run auf Dusklight-spezifische Probleme stößt, melde sie im Dusklight-Tracker.