DeSmuME DS Zelda Mod:
=====================

v1.0

Modified DeSmuME RetroArch core.

A more seamless way to 100% the games with just a dual analog controller.

Requirements:
-------------

- RetroArch
- Phantom Hourglass/Spirit Tracks (U) Region rom, with d-pad patch applied.

Instructions:
-------------

- Copy desmume_ds_zelda_mod_libretro.dll into RetroArch\cores
- Copy desmume_ds_zelda_mod_libretro.info into RetroArch\info

- Select ROM and set core association to "Nintendo - DS (DeSmuME - DS Zelda Mod)", setting as a favourite is recommended for easy access.

Features:
---------

- New adaptive control setup (see below)

- Proper crosshair (scales with resolution, auto-hide timeout, button toggle to force on)

- Built in codes within core options with a focus on mini-games, completionism

- Added custom date support in core options, and a button toggle to switch date to enable masked shop in Phantom Hourglass

- Proper mic blow that works with everything

- Wide/Ultra-wide aspect ratio support (should update when you change screens)

- Spirit Tracks: Auto Frameskip/Disable xBRZ for ghost zelda/bosses/cutscenes that suffer the most from texture thrashing

Notes:
------

- Disable Integer Scaling in RetroArch to allow the image to stretch (keeps AR)

- Some boss fights require both screens in the normal top/bottom arrangement, see section below for which

- Newer RetroArch has a habit of stealing the mouse input and trapping it on the current monitor, and is currently unfixable
  Recommend disabling the mouse: Settings\Input\Port 1 Controls\Mouse Index -> 1

- The codes in the code section are written in C++, and execute every frame, AR Codes were too limited (no bitwise operations)

- The crosshair is drawn directly in the frame, so when the AR is wide, it stretches as well, it can optionally be adjusted (default)

- See Core Options in the Quick Menu to configure, Date Override is added at the beginning, New Options and Codes added to the end

Phantom Hourglass:
==================

D-pad - Menu Shortcuts

Select - Auto-Hide Cursor Toggle
X (hold) + Select - Close Lid

Start - Start
X (hold) + Start - Enable Beedle's Masked Shop (requires restart, only works if date isn't already forced in core options)

Y - Spin Slash
A - A
B - B (Forced Horizontal Slash)
X (tap) - B
X (hold) - Shift Modifier

L - Tap on Screen
L2 - Mic Blow / (hold) Allows Vertical Slash on B

R - Item
R2 - Force Walk

R-stick - Controls Crosshair
R3 - Swaps Screens

L-stick - 360 Movement, Small Radius (walk), Large Radius (run), radius can be adjusted
L3 - A

X + L-stick Up/Down - Rub Screen
X + L-stick Down - Final Bosses: Enables Hourglass Frame
X + L-stick Left/Right - Final Bosses: Draws Hourglass

Mini-Games:
-----------

L-stick Left/Right - Auto-Fishes, Push/Push-Hold in Opposite Direction of Fish

Boat Controls:
--------------

L-stick Up/Down - Go / Stop
L-stick Left/Right - Jump

D-pad Right - Route Menu

Spirit Tracks:
==============

D-pad - Shortcuts

Select - Auto-Hide Cursor Toggle
X (hold) + Select - Close Lid

Start - Start

Y - Spin Slash
A - A
B - B (Forced Horizontal Slash)
X (tap) - B
X (hold) - Shift Modifier

L - Tap on Screen
L2 - Mic Blow / Allows Vertical Slash on B

R - Item
R2 - Force Walk

R-stick - Controls Crosshair
R3 - Swaps Screens

L-stick - 360 Movement, Small Radius (walk), Large Radius (run), radius can be adjusted
L3 - A

X + L-stick Up/Down - Rub Screen
X + L-stick Down - Final Boss: Zelda Fires Arrow

Train Controls:
---------------

R - Train Whistle

L-stick Up/Down - Shift Speed Gear Up/Down
L-stick Left/Right - Switch Track from Left/Right

X (hold) + L-stick - Up: Normal, Down: Stop, Right: Fast, Left: Reverse

Flute:
------

Use L to press on screen, R-stick to move left/right, and press L3 to blow

(optional): Use the code in the codes section of core options to auto succeed the song learning mini-game

Dual Screen Boss Fights:
------------------------

   You might want to change the layout to top/bottom for these particular fights.

   Phantom Hourglass:

     - Crayk - Temple of Courage (First shot only, not really needed if you're fast)
     - Cubus Sisters - Ghost Ship (Required)
     - Gleeok - Temple of Ice (Required)
     - Eox - Mutoh's Temple (Not needed, but helpful)
     - Phase One: Bellum (Not needed, but helpful)

   Spirit Tracks:

     - Cragma - Fire Temple (Not needed, but helpful)
     - Skeldritch - Sand Temple (Not needed, but helpful)
     - Possessed Zelda and Chancellor Cole (Required)

Example Core Options:
---------------------

AMD 5900X/Nvidia RTX 2070 Super:

    CPU Cores (4), Internal Resolution (1536/1152 - 2304/1728), OpenGL Rasterizer (ON), MultiSampling AA (8),
    Texture Smoothing (ON), xBRZ (4), Texture Deposterization (OFF), Screen Layout: (hybrid/bottom),
    Hybrid Layout (3:1, OFF, OFF, OFF), Pointer Acceleration Modifier Percent (40), Pointer Colour (Black),
    Ghost Zelda/Boss Fix (Frame Drop Fix): No xBRZ (ON), Aspect Ratio (4:3), RetroArch: Settings\Video\Scaling\Integer Scale (OFF)

    Dual Screen Boss Fights - Screen Layout (top/bottom), Aspect Ratio (16:9)
