Dawnlight

"Dawnlight" is a Mod for Dusklight with lots of additional features and improvements. Included patches: - Added an Android virtual touchscreen controller with editable touch layout, opacity, scale, presets, and separated import/export for touch control settings. - Added an editable in-game HUD overlay system with per-element X/Y position and scale for buttons, hearts, rupees, D-Pad, and minimap. - Added HUD backing texture visibility, HUD item/text anchor controls, item/text scale controls, round X/Y HUD buttons, and HUD import/export. - Added minimap HUD slide direction selection: Left -> Right or Right -> Left. - Added Wii U controller style support with ZL and Minus touch/physical inputs, relabeled controller buttons, R item binding, Midna on D-Pad Down, visible R binding in the item screen, and R ammo display support. - Added ZL jump support: forward jump, standing jump, ZL+B jump attack, cliff drop jumps, and ledge grab compatibility. - Added camera aim options: aim movement, Vanilla / 3rd Person / Cinema aim modes, third-person reticles for supported items, crosshair alignment fixes, and walking animation/audio in Cinema aim. - Added save import/export under Prelaunch Save File Type and fixed save import crash handling. - Added New Game+ flow with source-save selection, inventory/currency/heart/ammo carryover, NG+ save badges (+1, +2, ...), NG+ damage multiplier linkage, NG+ enemy health scaling. - Added New Game and New Game+ intro skip prompt that jumps to the Faron Woods Twilight section with required items and story flags applied. # Dawnlight Platform README Dawnlight is based on Dusklight and keeps the upstream app identity internally for compatibility. This means saves, settings, and data folders still use `TwilitRealm/Dusklight` paths. Most Dawnlight patches are platform-independent because they live in the shared game and engine code. This includes the HUD layout editor, Wii U controller style, ZL jump, aim modes, New Game+, intro skip, NG+ save markers, and NG+ scaling. Android-specific code is only used for Android file picker support and Android URI import/export handling. Touch controls are shared code, but they are enabled by default only on Android and iOS. ## Platform Setup ### Android 1. Install the Android APK. 2. Launch Dawnlight. 3. Select a supported Twilight Princess GameCube disc image. 4. Open Settings to configure touch controls, HUD layout, controller style, aim mode, and New Game+ options. HUD layout import: - Put `hud_layout_settings.json` anywhere the Android file picker can access, for example `Downloads` or `Documents`. - In Dawnlight, open `Settings -> Overlay -> Import HUD Layout`. - Select the JSON file. The Android app data folder is private to the app, so manually copying the file into the internal config folder is not recommended. Use the in-app import button instead. ### iOS 1. Install the IPA with AltStore, Sideloadly, TrollStore, or another sideloading method. 2. Launch Dawnlight. 3. Select a supported Twilight Princess GameCube disc image. 4. Configure settings in-game. HUD layout import: - Put `hud_layout_settings.json` in the Files app, for example in iCloud Drive or On My iPhone/iPad. - In Dawnlight, open `Settings -> Overlay -> Import HUD Layout`. - Select the JSON file. The default iOS data location is the app's Documents folder. HUD layout export is currently not supported by the iOS save dialog, so use import or desktop/Android export when sharing layouts. ### Windows 1. Download `Dawnlight--win32-x86_64.zip`. 2. Extract the ZIP. 3. Run `dusklight.exe`. 4. Select a supported Twilight Princess GameCube disc image. HUD layout import: - Recommended: place `hud_layout_settings.json` anywhere convenient and import it with `Settings -> Overlay -> Import HUD Layout`. - Default data folder: `%APPDATA%\TwilitRealm\Dusklight\` - If you use a custom data folder in Dawnlight, use that folder instead. ### Linux 1. Download `Dawnlight--linux-x86_64. AppImage`. 2. Make it executable, for example: `chmod +x Dawnlight--linux-x86_64. AppImage`. 3. Run the AppImage. 4. Select a supported Twilight Princess GameCube disc image. HUD layout import: - Recommended: place `hud_layout_settings.json` anywhere convenient and import it with `Settings -> Overlay -> Import HUD Layout`. - Default data folder: `$XDG_DATA_HOME/TwilitRealm/Dusklight/` - If `XDG_DATA_HOME` is not set, the usual fallback is `~/.local/share/TwilitRealm/Dusklight/`. - If you use a custom data folder in Dawnlight, use that folder instead. ### macOS 1. Download the correct ZIP:    - Apple Silicon: `Dawnlight--macos-arm64.zip`    - Intel Mac: `Dawnlight-*-macos-x86_64.zip` 2. Extract the ZIP. 3. Open `Dusklight.app`. If macOS blocks it, right-click the app and choose Open. 4. Select a supported Twilight Princess GameCube disc image. HUD layout import: - Recommended: place `hud_layout_settings.json` anywhere convenient and import it with `Settings -> Overlay -&