Unseen Desire 0.1.7
A screen-reader accessibility mod for Persona 5 Royal (PC, Steam)

Unseen Desire reads what Persona 5 Royal shows through your screen reader (NVDA, JAWS and others, through Prism): the menus, the
dialogue, the battles, the shops, the Velvet Room, the confidants, the cutscenes and more. It also adds sounds and keys to find
your way in the real world, the Palaces and Mementos: a scanner of what is around you, a guide beacon, walking there by
itself, wall sounds, the Third Eye's colours, and a map you can move through.


Installing
----------

1. Download "Unseen Desire Installer.exe" from heavenay.com and open it. Persona 5 Royal must be closed.
2. Choose how to install:
   - With Reloaded II, recommended if you want to use more mods with the game. Reloaded II is the mod loader every Persona 5
     Royal mod uses; it goes into the folder you choose, and a "Reloaded II" shortcut in the Start menu opens it to add mods.
     If Reloaded II is already on your PC, the mod is added to it.
   - Without Reloaded II. The mod still needs Reloaded II to load into the game, but it is kept hidden inside the mod's folder
     and you never see it.
3. Before anything is written, the installer tells you how much it downloads, how much space it needs (about 1 GB) and
   where each part goes. The game files the mod reads are extracted from your own copy of the game into the mod's GameData
   folder: nothing of the game is downloaded.
4. If Microsoft's .NET 9 or Visual C++ runtime is missing, the installer gets it from Microsoft; Windows asks for permission.
5. When it is done, start the game with the "Persona 5 Royal - Unseen Desire" shortcut on your Desktop or in
   the Start menu.

Updating: open "Unseen Desire Installer.exe" again, the one you downloaded or a new copy from heavenay.com. Only the files that
changed are downloaded; your settings and the
extracted game data stay as they are. While a Testing version is up, the installer also asks which version you want: Stable, or
Testing with the newest fixes and maybe new bugs. Open it again and choose the other one to switch.

The zip, for a manual install (you already use Reloaded II, or prefer to do it by hand):
1. Copy every folder inside the zip's Mods folder into Reloaded II's Mods folder.
2. In Reloaded II, add Persona 5 Royal if it is not there yet, and enable Unseen Desire for it (the mods it needs load with it).
3. Start the game through Reloaded II. On the first start the mod extracts the game files it reads from your own game into
   its GameData folder by itself: it says "preparing its game data" and, a few seconds later, "The game data is ready".


The first start
---------------

At the title screen a short setup asks a few questions: the dialogue, the cutscene subtitles, 3D sound for headphones, the
cutscene descriptions, the menu descriptions and the auto walk's limit. F1 opens the mod menu any time (on a controller,
LT, RT and Start together): every setting, every sound's volume, and the Help, with each key and how things work. The mod's
own tutorials come in the game as you meet each thing.


Keys: keyboard
--------------

Navigation:
- Minus and equals, or Home and End: The previous or next category of the scanner.
- Left and right bracket, or Page Up and Page Down: The previous or next entry of the category, nearest first.
- Shift and the left or right bracket: The first or the last entry.
- Backslash: The selected entry again, with its way there leg by leg and how far.
- P: The guide beacon to the selected entry; again to stop it.
- Backspace: Auto walk to the selected entry; again to stop.
- U: Where next: picks the next place to explore, says it and starts the beacon.
- Ctrl, the Third Eye: While you hold it, the way to the next turn of the route is spoken.

Where and when:
- Comma: Where you are.
- Slash: The room or corridor you are in, or the street you are on.
- Period: Today: the date, the time of day, the weather and the mission.
- Shift and comma: The Phan-Site poll and its comment, while it is on screen.

Speech:
- Shift and slash: The dialogue reader on or off: off is voice mode.
- Ctrl and P: The last line again.
- Ctrl and the left or right bracket: Older or newer lines in the speech history.
- I and K in a dialogue: I says who is speaking, K the line on screen, in voice mode too. In a battle as well.

Sounds and the camera:
- Shift and period: The wall sounds on or off.
- Shift and I: The camera to north; twice quickly locks it there.
- Shift and J, Shift and L: The camera left or right, to the next main direction.
- Shift and K: The camera free again.

The map cursor:
- G: Open or close the map cursor, on you. With G cursor on the minimap checked in the General settings, it opens over the game's map drawing instead, by squares as the map screen's cursor; there P guides you to it.
- I, J, K and L: Move it one meter ahead, left, behind or right, as the camera faces; hold to keep going.
- Shift and I, J, K or L: Move it by room: through the way out on that side, or on along a corridor.
- Comma: Where the cursor is from you.
- Slash: The cursor's room in full.
- Backslash: Where the cursor is, and everything near it, again.
- Home: The cursor back to you.
- P: Guide you to the cursor with the beacon; it closes the cursor.
- Backspace: Walk you to the cursor; it closes the cursor.
- Escape: Close it.

The game's map screen:
- M, in a Palace, on a Mementos floor or in the real world: The game's map; a cursor starts on you by itself.
- I, J, K and L: Move it one square north, west, south or east, as the map is drawn; the squares are sized to the map. Each square says what is in it.
- Shift and I, J, K or L: Through the nearest door that way, into the next room.
- Tab: Zoom in to one meter steps that walk the floor, or back out to squares; the game zooms its picture too.
- Comma: Where the cursor is from you.
- Backslash: The square the cursor is on again, with its whole room.
- Home: The cursor back to you.
- Backspace: The bookmark where the cursor is, one at a time: a new one replaces it; on it, take it away. It is gone when you leave the area.
- In Mementos: I, J, K and L move a square of 8 meters, four to a piece of track; Shift and I, J, K or L move a whole piece.
- Q and E: The game's own: the map's other pages and floors; the cursor follows.

In a menu:
- I and K: Move between the rows of a long screen, or a phone chat's messages.
- J and L: Read the current row one item at a time.

In a battle:
- F2: The battle keys, with your own keys.
- I and K: Move between the rows of what you aim at, or of the panel you open.
- J and L: Read the current row one item at a time.
- O: Whose turn it is, with everything about them.
- Semicolon and apostrophe: The previous or next party member.
- Period: The goals of the battle.

Darts:
- Minus and equals: The target's ring, inward or outward: inner bull, bull, inner single, triple, outer single, double.
- Left and right brackets: The target's number, round the board in its own order.
- Comma: Where the oval is, and which way your target lies from it.
- I and K: The rows of what the darts screen shows: the points left, with the game's checkout when it shows one; the round and the darts left; this round's darts; your target and its way from the oval. J and L stay the game's: they turn the oval.

This menu:
- F1: Open or close the mod menu.
- Up and down arrows: Move through the sections and the rows.
- Left and right arrows: Change a row's value; for a sound, its volume.
- Enter: Open a section, or turn a checkbox or a sound on or off.
- Escape: Go back, or close the menu from the top.

Keys: controller
----------------

Navigation:
- Hold LT: Hold LT to use these keys. Both triggers held work the same. A stays the game's, so you can act while the Third Eye is on.
- D-pad up and down: The previous and next entry of the scanner, nearest first. The list does not wrap.
- D-pad left and right: The previous and next category: Places, N P Cs, Interactables, Exits and the rest. A category with nothing in it is skipped.
- Y: The guide beacon to the selected entry; again to stop it.
- X: The selected entry again: where it is, its way leg by leg and how far.
- B: This room, or the street you are on.
- Left stick click: Auto walk to the selected entry.
- Right stick: The camera: right or left turns it 90 degrees, up faces north (twice locks it there), down frees it.
- LT and R3: Where next: picks the next place to explore, says it and starts the beacon.

Speech:
- Hold RT: Hold RT to use these keys.
- A: Where you are. While the Phan-Site poll is on screen, the poll and its comment.
- Y: The date, the time of day and the weather. To open the game's menu while running, let go of RT first.
- Right stick click: Open or close the map cursor.
- D-pad down: The dialogue reader on or off: voice mode.
- D-pad up: The last line again.
- D-pad left and right: Older and newer lines in the speech history.
- In a battle: While a dialogue is on screen, while an All-Out Attack plays and on the results after a battle, RT and the d-pad, and RT and X, work in a battle too.
- B: The wall sounds on or off.
- X: Stop the screen reader talking, for a long text you do not want to hear out.

The map cursor:
- Right stick: Move the cursor ahead, behind, left or right, as the camera faces.
- LT and the right stick: Move it by room.
- LT and X, Y, B, left stick click: As in the field: the spot, the guide there, the room, auto walk there.
- RT and A: Where the cursor is.
- LT and A: Bring the cursor back to you.
- B, or RT and the right stick click: Close it.

The map screen:
- Right stick: Move the cursor one square north, south, west or east, as the map is drawn.
- LT and the right stick: Through the nearest door that way into the next room; in Mementos a whole piece.
- Y: Zoom in to one meter steps, or back out to squares; the game zooms its picture too.
- LT and A: Bring the cursor back to you.
- RT and A: Where the cursor is from you.
- LT and X: The square the cursor is on again, with its room.
- LT and left stick click: Your bookmark here, or take it away.
- B: Close the map, as the game does.

In a menu:
- Right stick: Moves through the mod's rows on a long screen, as I, J, K and L do: up and down the rows, left and right the items of a row.
- Right stick in a dialogue: Up says who is speaking, down the line on screen, as I and K do.

In a battle:
- The game's buttons: The triggers, Start and View are the game's in a battle: Order, Baton Pass, Rush and Showtime.
- Right stick: Moves through the rows of what you aim at or open, as I, J, K and L.
- Right stick click: Whose turn, with everything about them.
- Left stick click: The next party member, round the party.
- Both stick clicks together: The battle keys.

Darts:
- Hold LT, d-pad left and right: The target's ring, inward or outward.
- Hold LT, d-pad up and down: The target's number, round the board.
- RT: The game's aim: in darts the mod's RT keys stand aside, so you can throw while you hold it.
- Right stick up and down: The darts rows: the points left and the checkout, the round and the darts left, this round's darts, your target. Left and right stay the game's: they turn the oval.

This menu:
- LT, RT and Start: Open or close the mod menu, outside a battle.
- Inside it: The d-pad moves, A chooses, B goes back or closes it.
- Which pads: An Xbox pad works as it is. A PlayStation or Switch Pro pad works too, with no Steam Input and no DS4Windows: plug it in before you start the game. A PlayStation pad hears its own button names.


Thanks
------

Made by Haru. Website: heavenay.com
The sounds are by Saul (Discord: msaul), except the end-of-list knock, the Shadow-in-line tick and the map cursor's sounds.
Unseen Desire uses Reloaded II and its mods, Prism, NAudio and the SADIE II head (3D sound): see THIRD-PARTY.txt and the licenses
folder.


Licence
-------

Unseen Desire is free software under the GNU General Public License, version 3 (LICENSE). Its source code is available on request:
ask through heavenay.com.

Unseen Desire is a fan-made accessibility tool. It is not made or endorsed by Atlus or SEGA. Persona 5 Royal is their game: you need
your own copy.
