GRport 0.4.3 - Gravity Rush Remastered and Gravity Rush 2 on Windows
====================================================================

GRport is an unofficial, free fan project. It is not affiliated with, endorsed by or
sponsored by Sony Interactive Entertainment. "Gravity Rush", "PlayStation" and "PS4" are
trademarks of their owners. GRport contains no game files: you need your own copy of the
games, dumped from your own PS4.

Supported games
- Gravity Rush Remastered: Europe (CUSA01113) tested; USA (CUSA01130) expected to work.
- Gravity Rush 2 version 1.11: USA (CUSA03694) tested; Europe expected to work. The frame
  rate patches are for 1.11; if they don't fit a copy, it plays at 30 FPS.

Getting started
1. Unzip this folder anywhere (not inside Program Files).
2. Start GRport.exe and choose each game's dumped folder (the one with eboot.bin). An
   update can be copied over the game, or kept in its own folder next to it (for example
   CUSA03694-UPDATE or CUSA03694-patch): GRport adds it either way.
3. Press PLAY. The first PLAY prepares the game for GRport (about a minute); after that the
   game starts right away. Saves and settings stay in the user folder next to GRport.exe.

In the game
- Insert (keyboard) or L3+R3 (controller) opens GRport's menu: anti-aliasing (FSR 3.1,
  FSR 4 in the FSR edition (AMD's FSR 4.1.2 on Radeon RX 6000 and newer), DLSS on NVIDIA RTX cards, TAA) with sharpening, FSR 1 to scale to
  screens above 1080p, the FPS counter, and Quit game.
- Keyboard and mouse: see user/<game>/input.ini (F8 reloads it).
- Save and Load show a list of your saves: pick one, or New save for another slot.
  Up/Down (W/S, D-pad or stick, mouse) to choose, Enter / Cross (A) to confirm,
  Esc / Circle (B) to go back. "Game saved" or "Game loaded" shows when it is done.

Launcher SETUP
- Window: Fullscreen (exclusive), Borderless (a frameless window over the screen; use this
  one to stream or share your screen) or Window (with a title bar, at the chosen size).
- The language of menus and subtitles (the voices speak the games' invented language in
  every version).
- Gravity Rush Remastered frame rate: 60, 90, 120 or 144 FPS. Above 60 GRport adds Junmin
  Lee's gravity kick camera fix (downloaded at the first PLAY).
- Gravity Rush 2 frame rate: 30, 60, 90 or 120 FPS. Above 30 FPS GRport uses Junmin Lee's
  frame rate patches, downloaded from his GitHub repository at the first PLAY (an internet
  connection is needed once). The game runs at a fixed step: it slows down if the PC cannot
  hold the rate.
- Threading: Auto, On or Off per game. Auto and On prepare the game's GPU work on extra
  threads (much more FPS); set Off if a game crashes with it.
- Stick dead zone: 0 to 40% per game (10% by default; 0% is off). Raise it if a worn or
  wobbly controller stick moves the character on its own.
- PS4 Pro mode (Gravity Rush 2, experimental, off by default): the game uses its own
  PS4 Pro rendering. Turn it off if the game crashes or looks wrong.
- Shortcuts: Add to desktop, Add to Start menu.
- Saves: Import saves brings saves from another emulator or launcher (shadPS4, GR2fork,
  an older GRport folder) or decrypted PS4 saves (for example exported with Apollo Save
  Tool on a jailbroken PS4). A PS4's own USB backup is encrypted and can't be read. Your
  current saves are copied to user/<game>/savedata-backup-<date> first.
- Patches: Junmin Lee's optional patches, on or off per game. Gravity Rush 2: motion blur
  off, ambient occlusion trail fix, auto-exposure fix, skip intro, Cross confirms, cheats and
  unlocks. Gravity Rush Remastered: skip intro. They download from his repository at the
  first PLAY that needs them.
- Updates: GRport asks GitHub for a newer version when it starts; when one is out, the PLAY
  page offers it, downloads it and keeps your saves and settings.

Editions
- GRport-<version>-windows.zip: everything except FSR 4.
- GRport-<version>-windows-fsr.zip: the same plus FSR 4 (runtime/fsr4_shaders, and AMD's
  FSR 4.1.2 in runtime/fsr24).

Older CPUs
- Gravity Rush Remastered also runs on CPUs without BMI1/LZCNT/MOVBE (Intel 3rd generation
  Core and older): the first PLAY then builds instruction translations from your game files
  (a few minutes, once). Gravity Rush 2 needs a newer CPU.

Known problems
- Sound can stop after Alt+Tab.
- Tested so far: the openings and the early game of both games. Later areas may have issues.
- DLSS has not been tested on an NVIDIA card yet.
If something goes wrong: LOG > Copy for bug report, and open an issue on GitHub.

Credits and licenses
- GRport's runtime is based on the Bloodborne PC port runtime (GPL) and shadPS4 (GPL-2.0);
  the source is on GRport's GitHub page.
- Frame rate patches, crash fix and the optional patches of both games: Junmin Lee (not
  included; downloaded from his repository).
- FSR: AMD FidelityFX (licenses/ and runtime/fsr4_shaders/LICENSE-FSR4-v07.txt); FSR 4.1.2:
  AMD FSR SDK 2.4 (licenses/AMD-FSR-SDK-2.4-LICENSE.md, FSR edition).
- DLSS: NVIDIA DLSS SDK (licenses/NVIDIA-DLSS-LICENSE.txt).
- HE-VAG audio decoding: vgmstream (licenses/vgmstream-LICENSE.txt).
- Other libraries: see the licenses folder.
