From 95e6ac54cf8560b14dbad20c781262a4962cf74f Mon Sep 17 00:00:00 2001
From: doop <56421834+dooplecks@users.noreply.github.com>
Date: Mon, 4 May 2026 00:02:09 -0400
Subject: [PATCH] Random UI and README tweaks (#653)
---
README.md | 43 ++++++++++++++++++++++--------------
assets/dusk_options.png | Bin 83757 -> 0 bytes
res/rml/prelaunch.rcss | 44 ++++++++++++++++++++++++++++---------
src/dusk/ui/prelaunch.cpp | 45 +++++++++++++++++++++++---------------
4 files changed, 88 insertions(+), 44 deletions(-)
delete mode 100644 assets/dusk_options.png
diff --git a/README.md b/README.md
index 85c899aeb0..02b1ded875 100644
--- a/README.md
+++ b/README.md
@@ -1,37 +1,48 @@
-
+
+

-- ### **[Official Website](https://twilitrealm.dev)**
-- ### **[Discord](https://discord.gg/QACynxeyna)**
+
+ Official Website
+ •
+ Discord
+
+
# 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
-**⚠️ Dusk does NOT provide any copyrighted assets. You must provide your own copy of the game.**
-### 1. Verify your ROM dump
-First make sure your dump of the game is clean and supported by Dusk. You can do this by checking the sha1 hash of your dump against this list of supported versions.
+> [!IMPORTANT]
+> Dusk does *not* provide any copyrighted assets. You must provide your own copy of the original game.
-| Version | sha1 hash |
-|--------------| ---------------------------------------- |
-| GameCube USA | 75edd3ddff41f125d1b4ce1a40378f1b565519e7 |
-| GameCube PAL | 2601822a488eeb86fb89db16ca8f29c2c953e1ca |
+### 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 folder
-- Launch Dusk
-- Select Options, then set the ISO Path to your supported game dump
-- Press Start Game to play!
-
+- Extract the .zip file
+- Launch Dusk
+- Press **Select Disc Image**, navigate to your game dump, and select the file
+- Press **Start Game** to 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.
+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).
diff --git a/assets/dusk_options.png b/assets/dusk_options.png
deleted file mode 100644
index 4ed4ad7563d0325f41ab82dd605f9236d546f320..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 83757
zcmeFZcT|(v+cxTqqs)lHI1ZvBFp7eTfJ&2^aV&@k2q;xR1S!&l009Dtioz%Y0wU59
z1qA6*LlPh=3epmKO$a@d6bK;!0_5y~zwf;7I_La#zO}x8Ue;nI56QFle)hi0bzk>=
z^X!I+!Jb`*c5U0XZI9vAOXl0Qi9Fo4?U(bv{tW)&R%-btc=-uxZt%~xV&dT$aPf=V
z1>+0bww1<-t~u=h*S|fuY6IQ2P3(*C_a})H*B)-$CU|dn>B7xm2Ra4z>d#xN4GT0&
z7-{#u?;epS