Dusklight
Twilight Princess on PC and mobile, built from the decompilation, with a variety of fixes and improvements.
Dusklight brings a classic adventure to PC and mobile platforms with a variety of fixes and improvements. See the README below for details.
README
On GitHub 
Overview
Dusklight is a reverse-engineered reimplementation of Twilight Princess.
It aims to be as accurate as possible to the original while also providing new options, enhancements, and tools to customize your experience.
Setup
1. Dump your game
You must dump your own copy of the game. Please see this article for instructions. After dumping, you can use a program like Dolphin or nodtool to convert the .iso to .rvz to save space.
Dusklight currently supports all commercial discs except for Wii's Korean release.
2. Install Dusklight
Visit the official installation guide for full instructions.
Building
If you'd like to build Dusklight from source, please read the build instructions.
Pull requests are welcomed! Note that we do not accept contributions that are primarily AI-generated and will close your PR if we suspect as much. Please also see the code conventions.
Credits
Special thanks to the TP decompilation team, the GC/Wii decompilation community, the Aurora developers, the TP speedrunning community, and all contributors.
From the project's repository, fetched . Images load from GitHub.
Releases
Feed-
Release notes
What's new:
- Added: New InterpService: Provides interpolation for custom model rendering. (#2636)
- Added: GfxService v1.4: Provides backing textures for resolved framebuffers. (#2643, Aurora #260)
- Fixed: Vulkan startup crash on Android devices with Adreno GPUs, including the Galaxy S23 and Odin 2. (Aurora
bded88e95d, #2563) - Fixed: HTTPS requests failing in Linux AppImage builds because system CA certificates weren't found. (Borealis
4ac5e7052a) - Fixed: WebSocket service being unavailable in Linux AppImage builds. (
40457c6adb, Borealis4ac5e7052a) - Fixed: False memory card corruption errors after resetting and switching game modes. (
7b60dc8f24) - Fixed: Incorrect camera framing in the cutscene before Goron Mines. (#2648, #956)
- Fixed: Crashes and missing fire when retrying the burning house sequence in Kakariko Village after dying. (#2649, #1441)
- Changed: Significantly improved Mod Manager performance, especially with a large number of mods. (
ceda410434,eb5ad19dbc) - Changed: Significantly improved Logs window performance. (
55e2904ce0) - Changed: Updated bundled Dusklight Randomizer to v1.0.6. (
b9c370d5d1)- Fixed entrance randomizer logic incorrectly treating human and wolf abilities as interchangeable in Twilight. (Randomizer
cfa99c1944) - Fixed some logical areas not taking into account that you could change time of day with Midna. (Randomizer
cfa99c1944) - Fixed boss exits when dungeon entrances are shuffled but boss entrances are not. (Randomizer
6f650ca077) - Fixed inaccessible doors in Kakariko Twilight before obtaining the village's warp portal, which could cause entrance randomizer softlocks. (Randomizer
12d7cf807a) - Fixed music staying muted after entering a shuffled boss room through the Forest Temple boss door. (Randomizer
ee58b04d21, Randomizer #85) - Fixed the map not appearing after howling at the Snowpeak Howling Stone. (Randomizer
2d97aa9a6c) - Prevented starting the broken goat-catching sequen…
- Fixed entrance randomizer logic incorrectly treating human and wolf abilities as interchangeable in Twilight. (Randomizer
-
v2.0.2 57k
Release notes
What's new:
- Added: Save Manager can now import saves between different regions, and between GC/Wii. (#2529,
97ca92a056) - Added: Speedrun Mode now displays enabled mods. (
7b917f20d1) - Fixed: Mouse buttons not working for Custom Action Bindings, such as First Person. (
3a1b863dc6, #2525) - Fixed: File selection not working on some sideloaded iOS installations. (Borealis
355186f3c9, #2601) - Fixed: Startup crash on Macs with AMD GPUs. (Aurora
08122911e8, #826) - Fixed: Music cutting out or failing to play across scene transitions, including the opening scene and King Bulblin victory cutscene. (#2560, #2503, #2516)
- Fixed: Crash when calling Midna while opening the map or item wheel with interpolation enabled, like the Map Glitch. (#2515, #2513)
- Fixed: Golden Wolf transition fades displaying incorrectly in Mirror Mode. (#2549)
- Fixed: "Double Defense" Magic Armor cheat preventing damage from attacks that normally deal a quarter heart. (#2548)
- Fixed: Shad not awarding the restored Dominion Rod when his randomized reward was the original item. (#2532)
- Fixed: Speedrun Mode allowing "Easy Quick Spin" and the debug camera's "Freeze Time" setting. (
c55cc18003) - Fixed: Default B/X button mappings on Xbox One and Xbox 360 controllers. (Aurora #256)
- Fixed: Mods only being able to send one WebSocket message on Windows. (Borealis
1fc93deb1b, #2585) - Changed: Updated bundled Dusklight Randomizer to v1.0.5. (
b245c6bef8)- Fixed a crash when rapidly switching game modes, and duplicate entries in the Excluded Locations list. (Randomizer #63, Randomizer #58)
- Prevent deleting seeds that are in use by a save file. (Randomizer #76)
- Fixed Ooccoo warps, boss-room death respawns, and returning to the dungeon entrance with entrance randomization. (Randomizer
13aa72b12d,44d508ef56,9339fdd6f4) - Fixed boss exits when both dungeon and boss entrances are randomized. ([Randomizer `…
- Added: Save Manager can now import saves between different regions, and between GC/Wii. (#2529,
-
v2.0.1 75k
Release notes
Thank you all for the incredible response to our v2 release! 24 hours later, we already have 18 mods on our mod site, and that number is growing steadily. As with every big release, there's some bugs that slip through the cracks, and we've done our best to knock them out quick. Enjoy!
What's new:
- Added: Option to change a save's region when importing
.gcior.dusksavefiles in Save Manager. (422d7bb1b6) - Fixed: Restored "Show Shader Compilation" option in Interface settings. (#2504, #2474)
- Fixed: Existing saves could be overwritten with empty slots after a load failure with "Instant Saves" enabled. (#2510)
- Fixed: Memory card errors caused by duplicate
.gcibackups in the save folder. (#2510, Aurora #254)- Now only
.gciwith an exact name match are loaded. Use Save Manager to import saves with custom filenames.
- Now only
- Fixed: Startup crash on Intel Macs. (
a0db21a43f) - Fixed: Vulkan startup crash, primarily affecting Android users. (Aurora
cb0e2794a5) - Fixed: Crash when exiting from the Dusklight launch menu. (
a2a9158576) - Fixed: Crashes with mods that replace dialogue, including Linkle. (
e916b61ca0) - Fixed: Audio crashes with mods that replace sound effects, including the reported Zant fight crash with Linkle. (#2505, #2495)
- Fixed: "UI Scale" changes not immediately updating fonts and other menu elements. (#2472)
- Fixed: Mods button being available before a disc is loaded. (
2bdc1e54e3) - Changed: Removed execution time limits for Luau mods. (
ec4d628720) - Changed: Updated bundled Dusklight Randomizer to v1.0.4. (
4300fddde5)- Fixed exporting seed data for seeds already used by a save file. (Randomizer #48)
- Fixed logic around the Great Bridge of Hylia when starting in Lanayru Twilight. (Randomizer
5c1ea2c9f2)
Thanks to all contributors:
@encounter
@gymnast86
@Irastris
@PJB3005
@TakaRikkaFull Changelog: github.com/TwilitRealm/dusklight/compare/v2.0.0...v2.0.1
- Added: Option to change a save's region when importing
-
v2.0.0 36k
Release notes
Dusklight 2.0 is here! This update brings mod support, an in-game mod browser, and our own built-in randomizer, alongside more polish, performance improvements, and ways to play. Thank you to everyone who helped make it happen!
Mods and built-in mods
- Added: Mod support! Install gameplay mods, asset replacements, and texture packs as
.duskbundles, and manage them from the Mods menu. (Modders: check out our modding documentation!) - Added: An in-game mod browser: search for mods, view information and screenshots, and download and install without leaving Dusklight.
- Added: Mod update checks, release notes, and a quick way to update all mods.
- Added: Drag and drop
.duskmods onto the Dusklight window to install them. - Added: Enable, disable, and reload mods in-game, with dependency handling and per-mod settings and logs.
- Added: Built-in Dusklight Randomizer, our own randomizer with seed generation, settings presets, shareable
permalinks, and more.
- Customize which items are shuffled, including shop items, NPC gifts, Golden Bugs, Poe Souls, Hidden Skills, and dungeon keys.
- Randomize entrances to dungeons, boss rooms, caves, interiors, and overworld areas.
- Choose starting equipment, skip the prologue and other sequences, and customize the requirements for reaching Hyrule Castle.
- Detailed randomizer spoiler logs to help when you get stuck, with in-game export options for logs and seed data.
- Added: Built-in Cosmetics mod: customize Link's outfits, hair and equipment, Wolf Link, Epona, Midna, and HUD colors.
For mod creators
- Added: Asset-only mods: replace disc files, individual files inside
.arcarchives, and textures without writing code or repacking an entire game archive. - Added: Powerful native C++ mods with direct access to game code and built-in mod services. Use hooks on game functions to add or change nearly anything.
- Added: Luau script mods for simpler UI, settings, and configurable asset replacements, without requiring native mod builds.
- Added: Versioned services and dependencies, allowing mods to be compatible across Dusklight versions and even provide features for other mods to build on.
- Added: A standalone mod SDK and project template, with easy builds for all supported platforms. (Quick start)
- Added: Custom game modes, with separate save files and control over starting and loading a game.
- Added: Custom actors, stage edits, player spawns, and item rewards for gameplay mods.
- Added: Custom dialogue and message flows, including new choices, events, full-color text, and gradients.
- Added: Custom mod windows, dialogs, controls, notifications, and interface themes.
- Added: Audio replacement APIs for sound effects, instrument samples, and streamed music. (audio API, JAudio documentation)
- Added: Direct GPU rendering and custom camera support for mods, including rendering to separate windows.
- Added: Native file pickers, persistent storage, and networking services for mods.
Disc support and saves
- Added: Japanese GameCube disc support. (#2227)
- Added: Wii disc support, including North American revisions 0 and 2, Japanese, and PAL releases. Dusklight now works with all retail GameCube and Wii discs except the Korean Wii release. (#2296, #2376)
- Added: Save Manager: import and export saves, create and restore backups, and manage saved mod data. Ava…
- Added: Mod support! Install gameplay mods, asset replacements, and texture packs as
-
v1.4.1 321k
Release notes
What's new:
- Added: Support Clawshot hanging & Hawkeye with touch controls
- Added: Configure Android Surface.setFrameRate; improves performance on some devices
- Fixed: Texture replacement regressions in v1.4.0 (load ordering & missing UI textures)
- Fixed: Performance regression on some GPUs (AMD on Windows in particular)
- Fixed: Keyboard focus issues on Android and iOS
- Fixed: Lock 4:3 aspect issue on PowerVR GPUs
- Fixed: Hidden Dusklight menu still receiving inputs in some circumstances
- Fixed: GPU backend fallback regression
Full Changelog: github.com/TwilitRealm/dusklight/compare/v1.4.0...v1.4.1
-
v1.4.0 15k
Release notes
With the release of Dusklight, it's been our goal to raise the bar for quality and polish in ports. First, we focused our efforts on accuracy, stability and quality of life. Now, we're excited to bring some long-awaited features and improvements: full mouse controls, mobile touch controls, and a complete performance overhaul, among many others! And don't worry, we still have some even bigger features coming soon. Please stay posted!
What's new:
- Added: Mobile touch controls & customization
- Added: Mouse control for third-person camera
- Added: Mouse/touch support for in-game menus (disable via "Mouse/Touch in Menus" setting)
- Added: Native gyro/rumble support on Android and iOS
- Added: Overhauled performance; up to 4x improvement on CPU-bottlenecked devices
- We've optimized every part of the renderer, from game particles to GPU frame submission
- Framerates should be much more stable across areas and with heavy effects
- Added: ASTC DDS support for texture replacements
- Texture pack authors can now ship desktop packs with BC7, and mobile packs with ASTC
- Added: Load mipmaps from DDS files
- Texture pack authors can now ship mipmaps within DDS files, rather than requiring separate
_mip*sidecars - Recent Dolphin versions also support this
- Texture pack authors can now ship mipmaps within DDS files, rather than requiring separate
- Added: "Swap Direct Select Input" option: enables Direct Select by default for item wheel
- Added: Improved scaling for Memory Card and Name Select screens
- Added: Individual X and Y sensitivity settings for Free Camera
- Added: "Enable Controller LED" setting for supported controllers
- Added: Preview when changing "Enable Texture Replacements"
- Added: "Button Fishing" QoL option from TPHD
- Added: Interpolate most particles, fishing rod line, door chains, hookshot chains
- Added: "Glitched" acheivements count beyond 100% completion (no longer requires Glitched for 100%)
- Added: "HUD Scale" setting for in-game HUD
- Added: "Freeze Time" setting for debug camera
- Added: "Restore Wii 1.0 Glitches" now restores Green Chu merging
- Added: "Magic Armor Behavior" cheat: Normal, On Damage, Double Defense, Invincible, Cosmetic
- Added: "Remember Window Size" setting
- Added: Automatically initialize Memory Card when "Instant Saves" is enabled
- Added: Automatically prune
dawn_cache.db - Fixed: Crash when talking to the Zora under the waterfall in Zora's Domain
- Fixed: Snowpeak avalanche not triggering with bloom disabled (yes, you read that right)
- Fixed: Hidden Village crash after getting Ilia's Charm from Impaz
- Fixed: Monkey loading crash in Forest Temple
- Fixed: Ganondorf's cape texture & tearing
- Fixed: Poe Counter in Mirror Mode
- Fixed: Respawning in final Zant fight phase
- Fixed: Mirror mode sign arrows
- Fixed: Issues with Unicode in data folder paths
- Fixed: macOS 12 support
- Fixed: Package Visual C++ Redistributable DLLs on Windows
- Fixed: Performance issues & crashes with map rendering
- Fixed: Texture LOD bias & sampler settings for replaced textures
- Fixed: Crash with incorrectly-sized texture replacements
- Fixed: Issues with pipeline cache sometimes not populating, causing pop-in
- Changed: Remove embedded
gamecontrollerdb.txt- This broke mappings for various controllers, notably Switch Pro controller on Android
- The game now loads custom controller mappings from
<data folder>/gamecontrollerdb.txtif manually created
Thanks to all contributors:
@SuperDude88
@PJB3005
@Abzol
@GiorgioMendieta
@JaxonKEKW
@tangzero
@superyu1337
@flash-computer
@encounter
@Sirius902
@5upern1ce
@tomlube
@qubitnano
@ReillyBrogan
@Irastris
@MelonSpeedruns
@jtrees
@dooplecks
@KevinLemaMartinez
@ZipoLabs
@itssecretnate
@BoLThompson
@Kyrio
@matthewdavidrichardanderson
@Ahmad8864
@R0dn3ySFull Changelog: ht…
-
v1.3.1 134k
Release notes
What's new:
- Fixed: Several issues with configuration saving & loading
- Resolves a regression in v1.3.0 where some Android devices would corrupt config file on exit, then crash on launch
- Fixed: Enter key clearing text inputs
- Fixed: Missing chains in Arbiter's Grounds, Hyrule Castle
- Fixed: Improved crash reporting in log files
Thanks to all contributors:
@PJB3005
@dooplecks
@Irastris
@encounterFull Changelog: github.com/TwilitRealm/dusklight/compare/v1.3.0...v1.3.1
- Fixed: Several issues with configuration saving & loading
-
v1.3.0 26k
Release notes
What's New:
- Added: New, modernized Depth of Field implementation (+ "Classic" option)
- Added: "Data Folder" configuration on Android
- NOTE: Large transfers (e.g. texture packs) may cause the app to sit on a black screen on restart. Be patient!
- Added: ARM64 Windows and Linux builds
- Added: Numpad "Enter" now works in menus
- Added: Poe Counter from TPHD
- Added: Option to "Hide Owl Statue Markers" after completion
- Added: New achievements: "Gorge Skip", "Hero Mode", "Autospin Annihilation", "Surgical Skewer" & "Early City"
- Added: Updated Steam Controller support on Linux
- Added: "Invert Air/Swim Axis" options
- Added: Better crash reporting in log files
- Fixed: Adreno vertex shader issues ("vertex explosions", etc.)
- Works around an Adreno driver bug triggered by 16-bit integer arithmetic (thanks @qwtel)
- Fixed: VersionName and VersionCode not updating for Android APK
- Fixed: Refactor string handling in the original game to prevent crashes or undefined behavior
- Fixed: Credits crash on Linux/Android
- Fixed: Some instances where Wolf Link couldn't howl
- Fixed: "No Heart Drops" now functions more similarly to TPHD
- Fixed: THP (demo video) playback stuttering
- Fixed: Map offset when using Mirror mode
- Fixed: Collection/Pause/File select screen presentation when ultrawide
- Fixed: Various crashes, including Zora River and foreign languages
- Fixed: Goats and snowboarding achievement checks, Indomitable achievement, 100% completion achievement check
- Fixed: Ignore software renderers when choosing graphics backend
- This works around an issue where D3D12 falling back to "Microsoft Basic Renderer" can crash before the Vulkan or D3D11 backends have a chance to initialize.
- Fixed: Reduce log file verbosity
- Fixed: Rare issue where settings wouldn't save
Thanks to all contributors:
@PJB3005
@Krutonium
@JaxonKEKW
@TakaRikka
@itssecretnate
@dooplecks
@Irastris
@SailorSnoW
@SiggeMcKvack
@encounter
@SuperDude88
@CarlosManuelRodr
@ReillyBrogan
@Abzol
@magcius
@qwertyquerty
@superyu1337
@Ahmad8864
@qwtelFull Changelog: github.com/TwilitRealm/dusklight/compare/v1.2.0...v1.3.0
-
v1.2.0 106k
Release notes
What's New:
- Added: Experimental D3D11 (Windows) and OpenGL ES (Android) graphics backends
- This allows Dusklight to run on devices that don't support Vulkan 1.1, D3D12 or Metal, but be warned that performance and accuracy may suffer! These backends are provided on a best-effort basis.
- Added: Capped FPS option: set any framerate limit
- Added: "Area" output resampling option
- Smoother resampler for both upscaling and downscaling from the internal resolution
- Added: Many, many fixes and improvements to interpolation
- Added: Better achievement logic for Skybook characters
- Added: Autosave safety (no autosave after loading a state, no autosave after reset, etc.)
- Added: Ctrl-R to reset now triggers on release, like the button combo
- Added: Option to remove button binds with only controller (press same button again)
- Added: Option to enable and disable texture replacements in-game
- Fixed: Various crashes on all platforms (Goron Mines elevator & others)
- Fixed: Off-center aim reticle on devices with "safe area" (notches, in-screen cameras, etc)
- Fixed: Mipmap texture replacement regression in v1.1.1
- Fixed: Softlock on title screen when resetting while saving
- Fixed: Item wheel pause buffer now displays a synchronized (non-interpolated) frame
- Fixed: PAL keyboard
- Fixed: Shoulder buttons incorrectly setting analog values
- Fixed: Ook and Zant jump locations
- Fixed: "Fast Tears of Light" bug where tears could travel out of bounds
- Fixed: macOS Game Mode on macOS <26
- Fixed: Booting on macOS 14, and possibly booting on x64
- Fixed: Rollgoal completion to scale better with Bigger wallets
- Fixed: Dusklight gives better info when graphics backends fail to load
- Fixed: Allow transform level in Editor to go up to 15
- Fixed: Copy/delete effects on save screen
Known issues:
- No solution has been found for the Adreno driver issues yet.
Thanks to all contributors:
@JaxonWasTaken
@SuperDude88
@TakaRikka
@tomlube
@SailorSnoW
@MelonSpeedruns
@Irastris
@qwertyquerty
@PJB3005
@matthewdavidrichardanderson
@AceOfSpades-JFK
@korrectional
@Krutonium
@Abzol
@dooplecks
@SrBananaMan
@GiorgioMendieta
@Pheenoh
@xCyberxx
@superyu1337Full Changelog: github.com/TwilitRealm/dusklight/compare/v1.1.1...v1.2.0
- Added: Experimental D3D11 (Windows) and OpenGL ES (Android) graphics backends
-
v1.1.1 128k
Release notes
Release v1.1.1
The first release as Dusklight!
Our entire team has been working very hard to address issues and add new features.What's new:
- Added: Custom action binds for Dusklight Menu, Turbo, Midna, and First Person Camera
- Added: D-Pad menu navigation in-game
- Added: Change Data Folder & Portable Mode (desktop only; Android coming soon)
- Portable Mode (Windows only): saves, texture packs and config are stored next to the .exe in
data/ - Change Data Folder (Windows/Linux/macOS): saves, texture packs and config are stored in a custom location
- Portable Mode (Windows only): saves, texture packs and config are stored next to the .exe in
- Added: Warp menu (requires "Enable Advanced Settings")
- Added: "Enable Discord Rich Presence", "Show Input Viewer" settings
- Added: "Fast Roll", "Infinite Seeds", "Invincible Enemies" cheats
- Added: PNG format for custom textures (not recommended in a pack, but useful for development)
- Added: Improved Speedrun Mode
- Fixed: Z improperly mapped to Menu by default (it now properly maps to RB)
- Fixed: "Pause on Focus Lost" causing the game to freeze on startup
- Fixed: Fishing log on USA version
- Fixed: Linux crash in Temple of Time
- Fixed: Prelaunch softlock
- Fixed: Pillarbox widezoom cutscenes instead of cropping
- Fixed: World map off center when switching mirror mode
- Fixed: Don't autosave after loading a save state
- Fixed: Bloom pulse speed
- Fixed: "Invert First Person X/Y" now only inverts stick, not gyro
- Fixed: Texture replacements with Unicode characters in the path on Windows
- Fixed: LJA achievement triggering from cutscene teleport
- Fixed: Fast Iron Boots rolling underwater
- Fixed: Many different crashes
Known issues:
- Adreno graphical issues. Lots of effort has been spent trying to work around driver bugs to no avail.
- You should manually unbind digital trigger buttons (by pressing Escape) in Controller Configuration to avoid conflicts
Thanks to all contributors:
@Pheenoh
@Krutonium
@SuperDude88
@Irastris
@encounter
@dooplecks
@flash-computer
@itssecretnate
@BoLThompson
@RibShark
@joeycato
@qwertyquerty
@tomlube
@Sulfrix
@PJB3005
@MelonSpeedruns
@gymnast86
@SailorSnoWFull Changelog: github.com/TwilitRealm/dusklight/compare/v1.0.1...v1.1.1
-
v1.0.1 171k
Release notes
Release v1.0.1
We are genuinely moved and appreciative of the reception that Dusk has recieved in the last 24 hours.
The stories of people reliving their childhood, honoring their late friends, and enjoying the project are deeply moving for the team to read.
The YouTube trailer getting 220k views in 24 hours and media coverage from large and small creators brings us joy and validates the immense effort poured into the project.
This release brings many fixes for common issues that people have hit with the initial release. Cheers all!What's new:
- Added: Dusk data can now be accessed from the Files app on Android and iOS
- Android: If you have trouble finding Dusk in your files app, try this Files app. Open the left nav and scroll to the bottom.
- Added: "Open Data Folder" in Settings -> Interface
- Added: Crash reporting (opt-in)
- Added: Enable Game Mode on iOS
- Added: Option to invert axes while aiming
- Added: Actor spawning debug tool
- Added: Easier first person with freecam
- Added: Improved "no graphics backend" message
- Added: Symlink support in
texture_replacements - Fixed: Worked around an Adreno GPU driver bug with alpha discard (Ilia hair, foliage, etc. on Android)
- Fixed: Android not copying initial pipeline cache
- Delete
pipeline_cache.dbfrom data to get the full cache; eliminates pop-in issues
- Delete
- Fixed: Recording Mode disabling music until quit
- Fixed: Keyboard binds not working
- Fixed: Unicode characters in filepaths
- Fixed: Freezing when minimizing the window
- Fixed: Default controller mappings (Z/Back button binding, etc.)
- Fixed: Gyro aiming and inverting view axes
- Fixed: macOS 14 support (untested)
- Fixed: Crashes when moving between monitors with different scaling
- Fixed: Gyro sensitivity axis names were swapped
Thanks for the contributions from @Krutonium, @Project516, @Markos-Th09, and @juliosanz.
Full Changelog: github.com/TwilitRealm/dusk/compare/v1.0.0...v1.0.1
- Added: Dusk data can now be accessed from the Files app on Android and iOS
-
v1.0.0 168k
Release notes
Dusk is available now
We're so excited to share this with the world. First, this wouldn't have been possible without so many people in the
ZeldaRET community, GameCube / Wii decompilation community and beyond coming together to dedicate their talent to this.
Huge thanks to all of them!When we started the Twilight Princess decompilation project in August 2020, it was hard to imagine it would ever be
finished, much less to see it used for a project like this. Years and years of effort have been poured into the
decompilation by contributors all over the world, resulting in the largest decompilation project ever completed.Starting in late February, we embarked on the journey to bring the finished decompilation project to more platforms.
Along the way, we've worked with so many talented people and developed something that we're really proud of.Dusk is a labor of love by people who love Twilight Princess and reverse engineering. Happy (early) 20th birthday to
Twilight Princess! Please enjoy Dusk, and look forward to future updates. -
v1.0.0-rc.1 1.2k
Release notes
What's new:
- Added: New achievements
- Added: Update checker (won't work until we're public)
- Added: Mouse input for "gyro source", a.k.a. mouse aiming
- Added: Interpolate fades & camera bars
- Added: Interpolate B&C chain links
- Added: Update checks & disc info to mobile prelaunch menu
- Added: "Background Input" and "Pause on Focus Lost" interface settings
- Added: "Notifications" interface setting for achievements & controller connections
- Fixed: Many mobile issues
- Fixed: Disable autosave in speedrun mode
- Fixed: Linux AppImage icons
- Fixed: Limit Super Clawshot to 600 chain links
- Fixed: Letter menu page numbers
- Removed: Ctrl-R to reset
Full Changelog: github.com/TwilitRealm/dusk/compare/v0.6.3...v1.0.0-rc.1
-
v0.6.3 365
Release notes
What's new:
- Added: New FPS counter in Settings
- Added: "Advanced Settings" toggle for ImGui/Debug stuff
- Added: Reset/Quit confirmation modals
- Added: Mobile layout for prelaunch menu
- Added: Keyboard controls & roll support to Fly Cam
- Added: "Recording Mode" under Interface
- Added: Deadzone, trigger threshold, rumble config in new Controller Config
- Fixed: Actually fix displacement clip math accuracy
- Fixed: Linux OSReport crash
- Fixed: UI tweaks to resolution view & sub-menus
Full Changelog: github.com/TwilitRealm/dusk/compare/v0.6.2...v0.6.3
-
v0.6.2 196
Release notes
What's new:
- Added: Allow Sun's Song / quick transform in ToT past
- Added: Controller connected/disconnected toasts
- Added: Keyboard/mouse controller binding support
- Added: Verify disc image when selected
- Added: Increased Link heap size for mods
- Added: Procedurally-generate HQ minimap textures
- Added: Inner ring rotation for autosave indicator
- Fixed: Swapped shield labels in Editor
- Fixed: Increased accuracy for displacement clipping
- Fixed: Dungeon door bug on ARM64
- Fixed: Area flag calculation in Editor
Full Changelog: github.com/TwilitRealm/dusk/compare/v0.6.1...v0.6.2
-
v0.6.1 211
Release notes
What's new:
- Added: Mirror mode improvements
- Mirror map
- Mirror stereo audio
- Mirror Dusk prelaunch menu
- Mirror Kargarok controls
- Mirror rodeo controls
- Added: Debug fly cam option
- Added: Dusk menu sounds
- Added: Reworked Dusk prelaunch menu (check it out!)
- Added: 3-finger tap to toggle menu on mobile
- Added: New Achievement toasts
- Added: New autosave indicator (it's cool)
- Added: Dusk UI now respects 4:3 aspect lock
- Fixed: Numerous UI issues
- Fixed: Undefined behavior in Morpheel
- Fixed: Instant text fixes for Barnes' shop & others
Full Changelog: github.com/TwilitRealm/dusk/compare/v0.6.0...v0.6.1
- Added: Mirror mode improvements
-
v0.6.0 179
Release notes
What's new:
- Added: Completely overhauled UI
- Full controller support (press Back/Select or R+Start to pull up menu bar)
- Old ImGui menu is still available via Shift+F1 while we finish porting things
- Please poke around and provide feedback!
- Added: Autosave feature (experimental)
- Added: Spatial audio feature (HRTF)
- Added: Widescreen field & dungeon maps, Bulblin count
- Added: Region flags in Save Editor
- Fixed: Various issues with Free Camera
- Fixed: Cutscene haze/water ghosting in widescreen
- Fixed: Cutscene trim height in widescreen
- Fixed: Crash while changing tunics while reflection active
- Fixed: Bow aiming in first person
- Fixed: Mirror of Twilight portal visible from behind
- Fixed: Shadow camera interpolation (fixes B&C shadow & others)
- Fixed: Plumm game score reset
- Fixed: Map highlights
- Fixed: Shadow Midna eye going blank at distance
- Original game behavior, but we fix it for high IR
- Fixed: Fyer canon repair cutscene interpolation
- Fixed: Chains interpolation
- Changed: Increase game heap size by an order of magnitude
- Hopefully provides ample space for mods, and eliminates heap exhaustion crashes. Needs lots of testing
Full Changelog: github.com/TwilitRealm/dusk/compare/v0.5.3...v0.6.0
- Added: Completely overhauled UI
-
v0.5.3 188
Release notes
What's new:
- Add option for only fishing once for Sera's cat
- Achievement fixes & new achievements
- Fix BiT achievement getting triggered accidentally
- "Thank You Berry Much", "Email Me", "Friendly Fire", "Long Jump Attack", "Heavy Hitter" added
- Fix "Instant Text" clearing shop messages too early
- Smooth out map shadow rendering
- Fix draw crash with Super Clawshot enabled
Known issues:
- Freecam is still a bit wonky
- Occasional memory allocation crashes from exhausted heaps
Full Changelog: github.com/TwilitRealm/dusk/compare/v0.5.2...v0.5.3
-
v0.5.2 167
Release notes
What's new:
- Fixed: Reverted broken controller support for UI (overhaul in the works)
- Fixed: "Disable Main HUD" bugs
- Fixed: Improved freecam & allow freecam in target mode
Full Changelog: github.com/TwilitRealm/dusk/compare/v0.5.1...v0.5.2
-
v0.5.1 162
Release notes
What's new:
- Added: Speedrun timer feature
- Added: Rumble intensity & test rumble in controller config
- Added: Rough but functional controller support for Dusk menus (press Back/Minus to focus menu bar)
- Fixed: Freecam invert X axis option
- Fixed: Wrong grass texture in certain places
- Fixed: Item texture sometimes getting swapped with the map
- Fixed: Particle rendering slowdown in Palace of Twilight (and possibly elsewhere)
- Fixed: Map shadow rendering performance (it's now re-enabled, with an option to disable)
- Fixed: Ghost riders in horseback go the wrong way / Argorok cutscene where the camera was in the wrong place
- Fixed: Only show language selector if using a PAL disc
- Fixed: Plumm's Score not reset between plays
- Fixed: More Palace of Twilight platforms disappearing
Full Changelog: github.com/TwilitRealm/dusk/compare/v0.5.0...v0.5.1
Works for me
Did it work on your PC? A quick report tells other players which versions are safe to try.
Discussion
No posts yet. Ask a question, share your setup or post a clip.
Sign in to post