Update Dusk to Dusklight v1.2.0
Use this guide when you already installed Dusk and now see a newer Dusklight release. The goal is to update the app without losing saves, controller settings, texture packs, or your chosen data folder.
Dusklight-v1.2.0-* file from official releases, replace only the app, then launch clean before restoring mods or changing graphics backends.
Before you update
- Write down your current app version and platform.
- Back up saves before touching folders.
- Back up texture packs and mod folders separately from the app.
- Keep your supported Twilight Princess disc image where it is.
- Do not delete random Dusk or Dusklight data folders until the new version launches and saves correctly.
Safe update steps
- Open the official Dusklight releases page.
- Download the file that matches your platform: Windows, macOS, Linux, Android, iOS, or Steam Deck.
- Close the old Dusk app completely.
- Replace the application files, but do not delete saves, texture replacements, or config folders.
- Launch Dusklight with no new mods added.
- Confirm the app opens, sees the disc image, reaches gameplay, and can save.
- Restore texture packs or mods one at a time.
Platform notes
| Platform | Update note |
|---|---|
| Windows | v1.2.0 adds an experimental D3D11 fallback. Keep D3D12 or Vulkan as the first test, then try D3D11 only if the preferred path fails. |
| Steam Deck | Download the Linux x86_64 AppImage, update the non-Steam shortcut if the file name changed, and retest controls plus the capped FPS option. |
| Android | Install the v1.2.0 APK over the older app only after backing up important data. Vulkan remains the preferred path, while OpenGL ES is an experimental fallback. |
| macOS | Pick Apple silicon or Intel correctly. v1.2.0 includes macOS boot and Game Mode related fixes, but Gatekeeper first-launch rules still apply. |
| Linux desktop | Mark the AppImage executable if needed, verify the chosen data folder after first launch, and test the capped FPS setting before changing power tools. |
| iOS | Use the official IPA and your sideloading tool's normal update path. Back up saves before resigning or reinstalling. |
What v1.2.0 changes
v1.2.0 is the current official release to use for a fresh update. It adds experimental D3D11 on Windows and experimental OpenGL ES on Android for devices that cannot use the preferred D3D12, Vulkan, or Metal paths. These are fallback options, not proof that every old GPU or Android driver will behave perfectly.
The release also adds a capped FPS option, area output resampling, interpolation fixes, better Skybook achievement logic, autosave safety work, texture replacement toggling from inside the game, and a controller-only way to remove button binds. It fixes multiple crashes, a title-screen softlock, a mipmap texture replacement regression from v1.1.1, PAL keyboard behavior, shoulder analog values, several gameplay edge cases, and macOS boot or Game Mode issues.
v1.1.1 remains historically important because it introduced the Dusklight name, desktop Change Data Folder support, Windows Portable Mode, and PNG custom texture support. If you are updating from an older Dusk build, you may experience both transitions at once: the rename from Dusk to Dusklight and the newer v1.2.0 feature set.
After-update troubleshooting
The app opens but cannot find my files
You may be looking at a different data folder. Check whether you enabled Change Data Folder or Portable Mode, then move saves and texture packs deliberately instead of copying folders blindly.
My texture pack stopped working
Retest with one pack, one folder level, and the current data folder. v1.2.0 fixed a mipmap texture replacement regression from v1.1.1 and lets users toggle texture replacements in-game, so update before assuming the pack is permanently broken.
Controller buttons changed
Review custom action binds and digital trigger bindings after the update. v1.2.0 can remove button binds with only a controller, which helps Steam Deck, Android, and couch setups clean up duplicate trigger mappings.
Android graphics still look wrong
v1.2.0 adds experimental OpenGL ES, but Adreno driver issues remain unresolved in the official notes. Use a clean setup, record device and GPU details, test Vulkan and OpenGL ES separately, then check official issues.
Related pages
Need the file table? Use the download guide. Need rename context? Read Dusk is now Dusklight. If the update fails, use not working fixes, graphics backends, save file location, or known issues.