GUARDIAN HEROES HD Remaster 0.1.0
=====================================

A native PC recompilation of Guardian Heroes (Sega Saturn, Treasure, 1996), remastered: high resolution, 16:9
widescreen, languages, HD textures and a settings menu inside the game.
Non-profit fan project, not affiliated with SEGA or Treasure. The game is NOT included: you need YOUR OWN copy of
the disc.

WHAT YOU NEED
- An image of your Guardian Heroes (USA) disc as .cue + .bin (the music is CD audio tracks; a lone .iso will not
  do). The program checks it and copies its data into the install folder.
- 64-bit Windows 10/11 (or Linux x86_64 / Steam Deck; macOS is experimental, see below) and a Vulkan GPU.

INSTALL (Windows)
1. Unpack the WHOLE zip into any folder.
2. Run GHLauncher.exe: it asks for the disc image (.cue), checks it and offers to download the HD PACK (optional,
   encrypted and bound to your disc; without it the game looks as on the Saturn).
3. Play from the shortcut or from GHLauncher.exe. The launcher tells you about game and pack updates; you can also
   look for them inside the game: OPTIONS > PC OPTIONS.

ABOUT v0.1: CHARACTERS STILL LOOK AS ON THE SATURN
Characters, enemies, effects and items (sprites) still look as they did on the Saturn because we are working on
their HD version. This is expected in v0.1: they will arrive in an update of the HD pack (that is why HD CHARACTERS
says "COMING SOON" in PC OPTIONS). The v0.1 HD pack brings HD backgrounds, portraits, faces, text, logo and intro.

WINDOWS SMARTSCREEN / ANTIVIRUS WARNING
The program has no paid code-signing certificate, so Windows may show "Windows protected your PC".
Click "More info" > "Run anyway". Some antivirus tools may flag it because it is a new, rarely downloaded
executable (false positive). Only download it from the official GitHub page
(github.com/faligame/Guardian-Heroes-HD-Remaster) and, if you like, check the sums in SHA256SUMS.txt.

LINUX AND STEAM DECK
- Unpack the .tar.gz (or use the .AppImage: make it executable with "chmod +x" and open it).
- Steam Deck: in Desktop Mode add the AppImage to Steam as a "Non-Steam Game", then play in Game Mode with the
  built-in controller.

macOS (EXPERIMENTAL, UNTESTED)
The macOS build is cross-compiled without a Mac and has never been tested. In v0.1 it has no launcher: the app is
the game.
1. Unzip and move "Guardian Heroes HD Remaster.app" to Applications.
2. It is not notarized by Apple: the first time Gatekeeper will say it "cannot be opened because it is from an
   unidentified developer" or that it "is damaged". macOS 14 or older: right-click the app > Open > Open. macOS 15
   or newer: open it once, then System Settings > Privacy & Security > Open Anyway. If it says it "is damaged", in
   Terminal: xattr -dr com.apple.quarantine "/Applications/Guardian Heroes HD Remaster.app"
3. On first start it asks for your disc image (.cue) with a file dialog. If no dialog shows up, copy the .cue and
   its .bin files to ~/Library/Application Support/Guardian Heroes HD Remaster/importar/ and open the app again.
4. HD pack: inside the game, OPTIONS > PC OPTIONS > HD PACK (it downloads; then restart the game). New versions of
   the game are downloaded from the GitHub page.
Your data (disc copy, pack, saves) lives in ~/Library/Application Support/Guardian Heroes HD Remaster/.
If it does not work, please tell us on GitHub (Issues) with what Terminal shows for:
"/Applications/Guardian Heroes HD Remaster.app/Contents/MacOS/guardian_heroes"

KEYS
Keyboard: arrows, Z X C (A B C), A S D (X Y Z), Q W (L R), Enter (START).
Gamepad (by position, PlayStation names): Square = A, Cross = B, Circle = C, Triangle = X, L1 = Y, R1 = Z, L2 = L, R2 = R, OPTIONS/Start = START.
F9 or Back/Select: SEGA SATURN / HD Remaster view.  F11 or Alt+Enter: full screen.  F12: screenshot.  Esc: quit.

YOUR DATA
- datos/  the copy of your disc (never shared).   packs/  the HD pack.   saves/  saves and settings (port.cfg).
- Updates never touch saves/, datos/ or packs/. To uninstall: Windows Settings > Apps, or GHLauncher.exe; your
  saves are only deleted if you ask for it.

LICENSES
Third-party code and its licenses are in LICENSES/ (SDL3, dav1d, zstd, Mbed TLS, Dear ImGui, stb, dr_libs,
Vulkan-Headers, the LLVM/mingw-w64 runtime and the Chakra Petch font, OFL). Guardian Heroes is (c) SEGA / Treasure.
