mirror of
https://github.com/TwilitRealm/dusklight
synced 2026-06-11 12:39:48 -04:00
Irastris
08321699cd
* Start game execution as soon as a disk image is available * Do not update dDemo_c if prelaunch document is visible * Prevent intro music until prelaunch has popped * Replace "Start Game" references with "Play" * Make prelaunch layout respect mirror mode * Add drop shadow to prelaunch disk-status and version-info * Remove ImGui prelaunch * Add "Change Disk Image" button to prelaunch options * Actually validate discs and make prelaunch very betterer :) * Check your build before pushing dumbass, and go to sleep * "Disc" consistency, adjust restart notice logic * Better LanguageSelect logic * Add restart notice to SaveTypeSelect * Added wind sounds to the pre-launch menu * Add Modal document, use it for disc verification * Consolidate Modal and PresetWindow * Squash various bugs, rearrange document flow * Allow Window inheritors to opt-out of being toggleable * Tweak focus behavior/syntax * Implement "Restart Now" option * Tweaks * Remove a bunch of dynamic_cast * Update README.md --------- Co-authored-by: Luke Street <luke@street.dev>
56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
<div align="center">
|
|
<img src="res/logo-mascot.png" alt="Logo" width="640">
|
|
|
|
<p align="center">
|
|
<a href="https://twilitrealm.dev">Official Website</a>
|
|
•
|
|
<a href="https://discord.gg/QACynxeyna">Discord</a>
|
|
</p>
|
|
</div>
|
|
|
|
# Overview
|
|
|
|
Dusk 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
|
|
|
|
> [!IMPORTANT]
|
|
> Dusk does *not* provide any copyrighted assets. You must provide your own copy of the original game.
|
|
|
|
### 1. Verify your dump
|
|
|
|
First, make sure your dump of the game is clean and supported by Dusk. You can do this by checking the SHA-1 hash of your dump against this list of supported versions:
|
|
|
|
| Version | SHA-1 hash |
|
|
|--------------| ------------------------------------------ |
|
|
| GameCube USA | `75edd3ddff41f125d1b4ce1a40378f1b565519e7` |
|
|
| GameCube EUR | `2601822a488eeb86fb89db16ca8f29c2c953e1ca` |
|
|
|
|
### 2. Download [Dusk](https://github.com/TwilitRealm/dusk/releases)
|
|
|
|
### 3. Setup the game
|
|
|
|
- Extract the .zip file
|
|
- Launch Dusk
|
|
- Press **Select Disc Image** and provide the path to your supported game dump.
|
|
- Press **Play**!
|
|
|
|
# Building
|
|
|
|
If you'd like to build Dusk from source, please read the [build instructions](docs/building.md).
|
|
|
|
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.
|
|
|
|
# Credits
|
|
|
|
Special thanks to the [TP decompilation](https://github.com/zeldaret/tp) team, the GC/Wii decompilation community, the [Aurora](https://github.com/encounter/aurora) developers, the [TP speedrunning community](https://zsrtp.link), and all [contributors](https://github.com/TwilitRealm/dusk/graphs/contributors).
|
|
|
|
<br/>
|
|
<div align="center">
|
|
<a href="https://github.com/encounter/aurora">
|
|
<img src="assets/aurora-powered.png" alt="Powered by Aurora" width="800">
|
|
</a>
|
|
</div>
|