Dusklight (Dusk) Known Issues, Bugs, and Technical Fixes
Dusklight (previously known as Dusk) is a native port of The Legend of Zelda: Twilight Princess. Since its launch in May 2026, the project has received very rapid improvements. This guide covers known issues and their fixes based on the latest v1.3.0 release.
Status Ticker: 🟢 Current Stable Version: v1.3.0
If you are still using v1.0.0 or v1.0.1, it is strongly recommended to update immediately. Version 1.3.0 fixes many crashes and texture issues. Along with this, capped FPS options and experimental D3D11/OpenGL ES backends have also been added.
The “Big 5” Quick Fixes
| Issue | Likely Cause | The Fix |
|---|---|---|
| Missing or broken textures | Old version or wrong folder | Update to v1.3.0 and place GZ2 folder correctly |
| Android graphical glitches | Adreno GPU Vulkan issues | Switch Graphics Backend to OpenGL ES |
| Stuck at 30 FPS | Framerate locked | Enable Unlock Framerate in Video settings |
| Ilia hair missing/white | v1.0.0 bug | Update to v1.0.1 or newer |
| AppImage won’t launch | Missing permissions | Run chmod +x on Linux/Steam Deck |
Android / Mobile Fixes
Adreno GPUs (which are common in Samsung and some Snapdragon devices) still have known issues like stretched textures and screen flickering.
Fix:
Go to Settings → Prelaunch → Graphics Backend and select OpenGL ES.
The save data visibility issue was fixed in v1.0.1. For easy access: Use Settings → Interface → Open Data Folder.
Mobile touch controls can also be adjusted through the (3-finger tap) menu.
Steam Deck / Linux Fixes
AppImage permission error:
In Desktop Mode, make the file executable or use the chmod +x command. Let me tell you that this issue has mostly been fixed in v1.0.1.
Gyro aiming is not working:
Disable Steam Input gyro-to-mouse conflicts and enable native gyro inside Dusklight settings.
The Linux build runs quite efficiently on Steam Deck and provides good battery life with 60–90 FPS.
Windows PC Fixes
Missing DLL errors: Install the latest Microsoft Visual C++ Redistributable (x64).
Black screen or crashes: Try different graphics backends (D3D12 → Vulkan → D3D11).
Pulsating bloom at high FPS
This is a known issue (#825).
Fix:
Use the new capped FPS option added in v1.3.0 to lock the framerate.
Graphics & Performance Issues
Shader stutter on first play: Normal behavior. It builds a cache and improves after the first few areas.
Texture packs not loading: Drop the full GZ2 folder (e.g. GZ2E01) inside the texture_replacements directory. v1.3.0 added an in-game toggle for texture replacements.
Mac shader cache crash (#826): Still open on some Apple Silicon setups. Try switching to Metal or Vulkan backend.
How to Report a New Bug
Check the official GitHub Issues page first: TwilitRealm/dusklight. Join the project’s Discord and post in the tech-support channel with your platform, version, and exact error.
Most launch-day problems have been resolved in v1.3.0. Keeping your build updated is the best way to enjoy a smooth Twilight Princess experience in 2026.