DuskPort

Dusklight: Bekannte Bugs & Workarounds

Verifizierte Bugs in Dusklight — was v1.0.1 behoben hat (Apple Silicon, Windows-Sonderzeichen, Ilia-Haare, iOS-Spielstände) und was noch offen ist.

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

Dies ist eine verifizierte Fehlerliste — jeder Eintrag hier stammt aus einem echten GitHub-Issue, einem offiziellen FAQ-Eintrag oder einem bestätigten Community-Report. Wir listen keine „häufigen Fehler” auf, die wir nicht selbst belegt haben.

Falls dein Problem hier nicht auftaucht, schau auf der Dusklight-GitHub-Issues-Seite nach den neuesten Meldungen oder frag im Discord des Teams unter discord.gg/dusktp (betrieben vom TwilitRealm-Team – nicht von uns).

Zuletzt aktualisiert: 2026-06-20. Die meisten Status-Angaben spiegeln den Stand ab dem v1.0.1-Release vom 2026-05-11 wider; die v1.4.0- und v1.4.1-Abschnitte enthalten zusätzliche Crash-, Regressions- und Mobile-Fixes, die am 2026-06-16 veröffentlicht wurden.

Direkt zu einem bestimmten Problem

Jedes Problem unten hat auch eine eigene Seite mit einer in sich geschlossenen Lösung. Durchsuchbar nach Fehlermeldung:

Abstürze & Startprobleme

Disc / ROM

Controller & Input

Grafik

Performance

Spielstand-Migration

Die vollständige kategorisierte Liste (mit Workarounds und Quellenangaben) folgt unten.

✅ In v1.0.1 behoben (2026-05-11)

Wer noch v1.0.0 nutzt und auf einen dieser Fehler gestoßen ist: Update auf v1.0.1.

ProblemSymptomFix in v1.0.1
#779, #805Apple Silicon – Absturz beim StartVon Mitarbeiter tomlube geschlossen: “Fixed in 1.0.1”
#807Windows – nicht-lateinischer Benutzername, Dusklight startet lautlos nichtUnicode-Pfadbehandlung hinzugefügt
#804iOS – Spielstand für Nutzer nicht zugänglichDusklight-Daten erscheinen jetzt in der Files-App auf Android & iOS; neues Menü „Open Data Folder” unter Einstellungen → Interface
#821Recording Mode schaltet Musik bis zum Neustart stummBehoben
#827Android – Ilia ohne Haare (Adreno Alpha-Discard)Workaround implementiert
#830macOS – Tastatur-Binding funktioniert nichtBehoben
Standard-Controller-Belegung (Z/Back)Falsche Standard-BelegungStandardwerte korrigiert
Gyro-Empfindlichkeits-Achsenbezeichnungen vertauschtPitch/Yaw-Labels vertauschtLabels korrigiert
Fenster-Minimize-FreezeEinige Konfigurationen froren beim Minimieren einBehoben
Monitor-Skalierungs-CrashAbsturz beim Wechsel zwischen Monitoren mit unterschiedlicher DPIBehoben

Die vollständigen v1.0.1-Patchnotes findest du im Changelog.

✅ Außerdem in v1.4.0 behoben (2026-06-16)

v1.4.0 hat mehrere Abstürze und Bugs behoben, die auf dieser Seite nicht einzeln gelistet sind, aber relevant sein können, wenn du sie erlebt hast:

  • Absturz beim Gespräch mit der Zora unter dem Wasserfall in Zoras Domäne
  • Crash im Versteckten Dorf nach dem Erhalt von Ilias Amulett von Impaz
  • Lade-Crash des Affen im Waldtempel
  • Respawn-Problem in der letzten Zant-Kampfphase
  • Ganondorfs Umhang-Textur & Tearing
  • Performance-Probleme & Abstürze beim Karten-Rendering
  • macOS 12-Unterstützung wiederhergestellt

Die vollständigen v1.4.0-Notes findest du im Changelog.

✅ Außerdem in v1.4.1 behoben (2026-06-16)

v1.4.1 ist ein Same-Day-Hotfix auf v1.4.0. Falls v1.4.0 bei dir neue Probleme verursacht hat: Update auf v1.4.1 — er behebt:

  • Texture-Replacement-Regressionen aus v1.4.0 (Ladereihenfolge & fehlende UI-Texturen)
  • Performance-Regression auf manchen GPUs (insbesondere AMD auf Windows)
  • Keyboard-Focus-Probleme auf Android und iOS
  • 4:3-Aspect-Lock-Problem auf PowerVR-GPUs
  • Verstecktes Dusklight-Menü empfing unter bestimmten Umständen weiterhin Eingaben
  • GPU-Backend-Fallback-Regression

Die vollständigen v1.4.1-Notes findest du im Changelog.

Abstürze & Startprobleme

Apple Silicon Shader-Cache-Crash (unabhängig von #779/#805)

Issue: #826 Symptom: Absturz beim Start auf M-Series-Macs mit einem WebGPU/Metal-RmlUi Gradient Pipeline-Shader-Compile-Fehler. Das ist ein anderer Bug als der ursprüngliche “Dusk quit unexpectedly”-dyld-Symbol-Missing-Crash aus v1.0.0 — dieser war #779 / #805 und ist in v1.0.1 geschlossen. Status (2026-05-13): Offen, wird untersucht. Markiert als “Known shader cache crash on macOS currently.” Workarounds:

  • Probiere ein anderes Grafik-Backend unter Einstellungen → Prelaunch → Graphics Backend — wechsle zwischen Metal / Vulkan / OpenGL
  • Verfolge #826 für Updates

Windows – nicht-lateinischer Benutzername — IN v1.0.1 BEHOBEN

Issue: #807 — geschlossen War: Dusklight startete nicht, wenn der Windows-Benutzername Nicht-Lateinzeichen enthielt (z.B. C:\Users\ミドナ). Fix: Unicode-Pfadbehandlung in v1.0.1 (2026-05-11) implementiert. Update auf v1.0.1 wenn du dieses Problem hattest.

Linux AppImage: „Couldn’t create directory ‘/TwilitRealm’”

Issue: #818 Symptom: Unter Linux (gemeldet auf CachyOS) startet eine AppImage-Variante nicht und gibt folgenden Fehler aus:

[fatal] [dusk] Unable to get PrefPath: Couldn't create directory '/TwilitRealm': 'Permission denied'

Status: Offen. Betrifft eine AppImage-Variante; die offiziellen .zip-Builds sind nicht betroffen. Workarounds:

  • Verwende stattdessen Dusk-v1.0.0-linux-x86_64.zip (oder linux-arm64.zip)
  • Falls du das AppImage bereits gestartet hast, räume auf: sudo rm -rf /TwilitRealm

Mac: „Dusklight ist beschädigt und kann nicht geöffnet werden”

Ursache: Gatekeeper-Quarantäne-Attribut. Dusklight ist nicht notarisiert. Status: Erwartetes Verhalten beim ersten Start (kein eigentlicher Bug). Fix: Im Terminal:

xattr -cr /Applications/Dusklight.app

Danach normal starten. Alternativ: beim ersten Mal Rechtsklick → Öffnen.

Zufällige Abstürze mitten in Cutscenes / im Gameplay (Windows)

Issue: #819 Gemeldetes Setup: Windows 11, i9-13980HX, RTX 4060, Xbox-One-Controller. Symptom: Abstürze während bestimmter Cutscenes (Zelda-Dialog, Ordona-Dialog) und beim Plattformerabschnitt über dem Giftsee in den Faronwäldern. Der Melder hatte Fast Spinner, Fast Iron Boots und Vollbild aktiviert. Status: Offen. Workarounds:

  • Deaktiviere Cheat-Optionen (Fast Spinner, Fast Iron Boots) vor wichtigen Cutscenes
  • Versuche Fenstermodus statt Vollbild
  • Verfolge das verlinkte Issue für Updates

Disc- / ROM-Probleme

„The selected disc image did not pass hash verification”

Ursache: Der XXH128-Hash deines Dumps stimmt nicht mit dem von Dusklight erwarteten Hash überein. Häufigste Ursachen: beschädigter Dump, falsche Region oder eine modifizierte/Scene-Version. Fix:

  1. Verifiziere den SHA-1 deines Dumps:
    • Windows: Get-FileHash -Algorithm SHA1 yourdump.iso
    • macOS / Linux: shasum -a 1 yourdump.iso
  2. Er muss exakt übereinstimmen:
    • 75edd3ddff41f125d1b4ce1a40378f1b565519e7 (NTSC-U)
    • 2601822a488eeb86fb89db16ca8f29c2c953e1ca (PAL)
  3. Wenn keiner passt, erstelle einen neuen Dump mit der Disc-Auslesen-Anleitung und aktivierter Checksummen-Verifizierung.

„The selected game is not supported by Dusklight”

Ursache: Du hast ein GameCube-Japan-, Wii-, Wii-Korea- oder Wii-U-HD-Disc-Image geladen. v1.0.0 akzeptiert nur GameCube NA und PAL. Fix: Nutze einen GameCube-NA- (GZ2E01) oder PAL- (GZ2P01) Dump. Weitere Regionen sind laut README auf der Roadmap des Projekts.

Modifizierte ISO lässt sich nicht laden

Verhalten: Hash-Mismatch ist bei einer modifizierten ISO (z.B. mit dem Linkle-Character-Mod) zu erwarten. Dusklight zeigt eine Warnung an, bietet aber einen „Continue anyway”-Pfad:

“Just install the [mod] as you usually would directly to the GameCube or Wii .iso and then direct Dusklight to that modded .iso file and confirm that you still want to use it when it tells you it’s probably corrupted or modified.” — TomoAries, r/pcgaming, 14 Upvotes

Mods funktionieren also — Dusklight warnt nur, dass der Hash von den bekannten Werten abweicht.

Controller- & Input-Probleme

Nicht-GCN-Controller mit WUP-028-Adapter erzeugt 4-GiB-Junk-Datei

Issue: #810 Symptom: Mit Nintendos WUP-028-GameCube-USB-Adapter verbunden: Wählt man im Dropdown einen Nicht-GCN-Controller aus, wird eine Junk-Datei von 2^32 + 32 Bytes (~4 GiB), größtenteils Nullen, geschrieben. Führt bei HDDs zu langen Hängern, bei SSDs zu kurzen. Status: Offen. Workarounds:

  • WUP-028-Adapter trennen, bevor du die Controller-Auswahl änderst
  • Oder den passenden GCN-Controller im Dropdown auswählen

Tastatur-Binding auf macOS nicht möglich — IN v1.0.1 BEHOBEN

Issue: #830 — geschlossen War: Tastatur-Bindings über Dusklights Controller-Konfig-UI funktionierten auf macOS nicht. Fix: Tastatur-Bindings in v1.0.1 (2026-05-11) repariert. Update auf v1.0.1.

Steam Controller lässt Mauszeiger auf dem Bildschirm

Issue: #811 Symptom: Bei Verwendung eines Steam Controllers bleibt der Mauszeiger während des Spiels sichtbar. Status: Offen.

AYN Thor – Rumble funktioniert nicht

Issue: #812 Status: Offen. Das AYN-Thor-Handheld wird unterstützt, Rumble ist aber defekt.

Interface-/Menü-Steuerung kann nicht neu belegt werden

Issue: #824 Symptom: Spiel-Controls lassen sich neu belegen, Menü- / UI-Navigation nicht. Status: Offenes Enhancement-Request.

D-Pad-Menünavigation funktioniert nicht

Issue: #814 Symptom: D-Pad navigiert keine Menüs. Status: Offenes Enhancement-Request.

Right Shoulder / Z – Belegungsverwirrung

Community-Report: Reddit-Nutzer LargeBirdInATree (r/pcgaming):

“Right Bumper is mapped to Right Trigger under ‘Digital Trigger’. I don’t know what ‘Digital Trigger’ is, and pressing left and right shoulder doesn’t appear to do anything.”

Workaround: Unter Einstellungen → Input → Controller → Configure Controller → Triggers bezeichnet „Digital Trigger”, ob die Trigger analog oder digital melden. Probiere verschiedene Konfigurationen durch, bis Bumper und Trigger so funktionieren, wie du es von deinem Controller erwartest.

Grafik- & Display-Probleme

Pulsierendes Bloom bei entsperrter Framerate

Issue: #825 (Label: Interpolation) Symptom: Der Bloom-Effekt pulsiert sichtbar, wenn Einstellungen → Video → Rendering → Unlock Framerate aktiviert ist. Status: Offen. Workaround: Framerate sperren (Unlock Framerate deaktivieren), bis ein Patch erscheint.

21:9 – Cutscenes werden oben und unten beschnitten

Issue: #813 Symptom: Auf Ultrawide-Displays (21:9) werden In-Game-Cutscenes oben und unten abgeschnitten. Status: Offen. Workaround: Für Cutscenes auf 16:9 wechseln, oder 4:3-Seitenverhältnis sperren (Einstellungen → Video → Display → Lock 4:3 Aspect Ratio) — das sorgt durchgehend für einheitliches Framing.

Tisch-Schatten in Bos Haus werden beschnitten

Issue: #815 Symptom: Spezifischer Beleuchtungsbug in Bos Haus im Ordon-Dorf. Status: Offen.

Mini-Map verschiebt sich bei aktiviertem Mirror Mode

Issue: #809 Symptom: Kosmetischer Positionierungsbug der Mini-Map im Mirror Mode. Status: Offen.

Ruckel beim Wechsel in die Egoperspektive

Issue: #816 Symptom: Kurzer Hitch beim Umschalten in die Ich-Perspektive. Status: Offen.

Interne Auflösung sieht aus wie 4:3, obwohl 4:3-Lock deaktiviert ist

Community-Report (r/SteamDeck): Nutzer SEANPLEASEDISABLEPVP (3 Upvotes):

“the ‘internal resolution’ setting for me defaults to 1216×896 for some reason, it looks like a 4:3 aspect ratio even though that’s turned off. EDIT: Nevermind, I had to toggle fullscreen lol.” Workaround (bestätigt): Vollbild-Modus unter Einstellungen → Video → Display → Toggle Fullscreen einmal aus- und wieder einschalten.

Audio-Probleme

Recording Mode schaltet Musik bis zum Neustart stumm — IN v1.0.1 BEHOBEN

Issues: #821, #832 — geschlossen War: Das Deaktivieren von Einstellungen → Interface → Recording Mode stellte die Musik nicht wieder her; ein Neustart von Dusklight war nötig. Fix: v1.0.1 (2026-05-11). Musik wird korrekt wieder aktiviert, wenn Recording Mode ausgeschaltet wird.

Mobile-Probleme (Android & iOS)

Android – Ilia ohne Haare — IN v1.0.1 BEHOBEN

Issue: #827 — Workaround implementiert War: Auf verschiedenen Android-Geräten (Retroid Pocket 5, Samsung Galaxy Serie u.a.) wurde das Charaktermodell von Ilia ohne Haare gerendert. Von mehreren Reddit-Nutzern bestätigt (splashtext 43 Upvotes, Shizzawn, OutsiderInCider). Fix: v1.0.1 (2026-05-11) enthält einen Adreno-GPU-Treiber-Workaround für Alpha-Discard. Update auf v1.0.1.

Android – Galaxy S26 Ultra visueller Bug („Käsefäden”)

Issue: #801 Status: Offen. Adreno 840 (Snapdragon 8 Elite Gen 5) scheint mehrere Restprobleme zu haben — gestreckte Texturen, Vertex-Explosionen, LOD-Bugs. Wird gemeinsam mit #750, #846, #1184 verfolgt. Laut offiziellem README: “we are also aware of a number of issues on devices with Adreno GPUs and are working to resolve them.”

iOS – Spielstand-Speicherort nicht zugänglich — IN v1.0.1 BEHOBEN

Issue: #804 — geschlossen War: Spielstand lag in der iOS-App-Sandbox; nicht in der Files-App sichtbar für Backup oder Transfer. Fix: v1.0.1 (2026-05-11) macht Dusklight-Daten in der Files-App auf iOS und Android sichtbar. Außerdem neues Menü Einstellungen → Interface → Open Data Folder, das direkt dorthin springt.

Android – Spielstand-Sandbox-Pfad

Der Android-Paketname ist dev.twilitrealm.dusk (nicht com.twilitrealm.dusk). Spielstände liegen unter /sdcard/Android/data/dev.twilitrealm.dusk/files/, inklusive Texture_Replacement/. Ab v1.0.1 empfiehlt sich der In-App-Button Open Data Folder statt manueller Navigation.

Spielstand-Migrationsprobleme

Dolphin-Spielstand wird in Dusklight nicht angezeigt

Ursache: Falscher Dateiname, falscher Pfad oder falsches Spielstand-Format. Fix (laut offiziellem FAQ):

  1. Die Dolphin-Spielstand-Datei liegt unter:
    • Windows: Documents\Dolphin Emulator\GC\USA\Card A\01-GZ2E01-gczelda2.gci
    • macOS: ~/Library/Application Support/Dolphin/GC/USA/Card A/01-GZ2E01-gczelda2.gci
    • Linux: ~/.local/share/dolphin-emu/GC/USA/Card A/01-GZ2E01-gczelda2.gci
  2. Der Dusklight-Spielstand-Ordner liegt unter:
    • Windows: %APPDATA%\TwilitRealm\Dusklight\USA\Card A\
    • macOS: ~/Library/Application Support/TwilitRealm/Dusklight/USA/Card A/
    • Linux: ~/.local/share/TwilitRealm/Dusklight/USA/Card A/
  3. Ersetze USA durch EUR, wenn du die PAL-Disc verwendest

Falls dein Dolphin-Spielstand im .raw-Format vorliegt (eine einzige Speicherkarten-Datei statt einzelner .gci-Dateien), nutze Dolphins Memory Card Tool, um die einzelne .gci zu extrahieren. Alternativ kannst du in Dusklight unter Einstellungen → Prelaunch → Save File Type auf Card Image umstellen, um .raw direkt zu verwenden.

Spielstand geladen, aber Fortschritt wird nicht übernommen

Du hast möglicherweise einen leeren Spielstand-Slot geladen. Lade in TP immer von Card A (das ist 01-GZ2*-gczelda2.gci). Die anderen Slots sind typischerweise leer.

Performance-Probleme

Bleibt bei 30 FPS hängen, obwohl Unlock Framerate aktiviert ist

Community-Report (r/pcgaming): Nutzer Thr0waway_Joe:

“I can’t get it past 30fps. Even with unlocked fps” Status: Sporadisch, bis v1.0.0 keine definitive Ursache gefunden. Mögliche Ursachen:

  • VSync sperrt noch (Einstellungen → Video → Display → Enable VSync → deaktivieren)
  • Monitor-Bildwiederholfrequenz als Cap
  • Grafik-Backend als Flaschenhals — probiere ein anderes (Einstellungen → Prelaunch → Graphics Backend)

Performance niedriger als erwartet

  • Interne Auflösung reduzieren (Einstellungen → Video → Resolution)
  • Framerate auf 60 begrenzen statt unbegrenzt
  • Post-Processing deaktivieren (Einstellungen → Video → Post-Processing → Bloom)
  • Anderes Grafik-Backend ausprobieren (D3D12 / Vulkan sind auf dem PC meist am schnellsten; Metal auf Mac; OpenGL ES auf Mobile)

„Strittige” / „Geklärte” Berichte

Ein Nutzer (r/pcgaming, WiglyWorm, 10 Upvotes) behauptete:

“I just watched a video where someone was playing this game uncapped and certain things like the mirror link battle were actually unwinnable due to FPS changes.”

Gegendarstellung von liamwilliams93:

“on this recomp it still runs the game logic at 30fps and uses interpolation to render at higher frame rates”

Fazit: Dusklights Design entkoppelt Spiellogik (30 Hz) von der Darstellung. Das „FPS-Gameplay-Problem” existiert in Dusklight nicht. Der ursprüngliche Nutzer hat vermutlich eine Dolphin- oder frühere Port-Implementierung vor Augen gehabt. Dusklights Interpolation beeinflusst das Gameplay-Timing nicht.

Bereits behobene Bugs (bitte nicht erneut melden)

Diese wurden von v0.x.x → v1.0.0 behoben — wer v1.0.0 nutzt, ist nicht betroffen:

  • Windows-Unicode-Pfade im AppData-Ordner (#767, #755 — geschlossen)
  • Gyro-Empfindlichkeits-Achsen vertauscht (#764, #759 — geschlossen)
  • Linux x86_64 startete nach dem Konfigurieren der Einstellungen nicht (#788 — geschlossen)
  • GameCube-Controller B / X vertauschte Standardbelegung (#732 — geschlossen)
  • Recording Mode Mute Streams – initialer Bug (anders als #821) (#735 — geschlossen)
  • Mac: Absturz nach Klick auf LiveSplit-Einstellung (#773 — geschlossen)

Wer auf einen dieser Fehler stößt, nutzt möglicherweise eine ältere Version. Update auf v1.0.0.

Neuen Bug melden

Falls dein Problem hier nicht gelistet ist:

  1. Die Dusklight-GitHub-Issues-Seite prüfen (jemand hat es vielleicht schon gemeldet)
  2. Falls neu: ein Issue auf GitHub eröffnen mit:
    • Betriebssystem + Version
    • Dusklight-Version
    • Reproduktionsschritte
    • Screenshots bei visuellen Problemen
  3. Oder im Discord des Dusklight-Teams melden: discord.gg/dusktp

Wir nehmen keine Bug-Reports für Dusklight entgegen — wir sind eine unabhängige Inhaltsseite, kein Teil des Projekts. Meldungen gehen direkt an TwilitRealm.

Versionshistorie dieser Seite

DatumÄnderung
2026-05-10Erstveröffentlichung basierend auf dem v1.0.0-GitHub-Issues-Snapshot und Community-Reports vom Launch-Tag
2026-06-16v1.4.0-Crash-Fix-Hinweis hinzugefügt (Zora-Wasserfall, Verstecktes Dorf, Waldtempel-Affe, letzte Zant-Phase, Karten-Rendering, macOS 12)
2026-06-20v1.4.1-Hotfix-Hinweis hinzugefügt (Texture-Replacement-Regressionen, AMD-auf-Windows-Performance, Android/iOS-Keyboard-Focus, PowerVR-4:3-Lock, verstecktes-Menü-Input-Leak, GPU-Backend-Fallback)

Diese Seite spiegelt den Stand von v1.0.0 ab 2026-05-10 wider. Dusklight veröffentlicht regelmäßig Patches — speichere diese Seite und schau wieder rein, oder beobachte die GitHub-Releases auf dem Laufenden zu bleiben.

← Übersicht · Installationsanleitungen