PSX TRILOGY RECOMP  0.2.0
A PSX Recomp Trilogy of Three Trilogy Games

Native Windows recompilations of three PlayStation games:
  Die Hard Trilogy (1996)               Probe Entertainment / Fox Interactive
  Die Hard Trilogy 2: Viva Las Vegas    n-Space / Fox Interactive
  Alien Trilogy (1996)                  Probe Entertainment / Acclaim

This is an unofficial fan project. No disc images are included. You need your own
disc images of these supported USA or Europe/PAL editions:
  SLUS-00119  Die Hard Trilogy
  SLUS-01015  Die Hard Trilogy 2: Viva Las Vegas
  SLUS-00007  Alien Trilogy (USA)
  SLES-00445  Die Hard Trilogy (Europe / PAL)
  SLES-02746  Die Hard Trilogy 2 (Europe / PAL)
  SLES-00101  Alien Trilogy (Europe / PAL)

QUICK START
  1. Unzip this folder anywhere (a normal folder, not Program Files).
  2. Put your disc images in the "discs" folder. Any of these work:
       .cue with its .bin files    .chd    .iso    .img    a bare .bin    .pbp
       or a .zip / .7z containing one of those (a Redump set with split tracks
       and no cue sheet is fine; the launcher writes the cue)
  3. Run Play.cmd. The launcher finds the images, works out which game each one
     is, checks it against the reference dump, and registers it. A .pbp package
     is unpacked into the game's folder; every other format is used where it is.
  4. Pick a game and press PLAY. OPTIONS holds display, audio, keyboard, gamepad,
     mouse and shortcut settings; DOCS opens the game's documentation; DISCS
     re-runs the import. Missing editions are greyed out and cannot launch.
     WIKI opens the collection research wiki in your default browser; DOCS
     opens the selected edition guide there. No server is needed.

NOTES ON DISC FORMATS
  A .cue/.bin set or a .chd of the full disc keeps the CD audio (music).
  A cooked 2048-byte .iso plays but its music will be silent.
  Alternative rips need matching boot code; this does not verify all disc data.
  Unknown executable revisions are refused.
  To swap a disc later, delete games\<game>\disc.ini and press DISCS.

WHAT IS IN HERE
  Play.cmd                      starts the launcher
  launcher\                     the launcher, key presets, the disc identifier
  discs\                        drop your images here
  games\<game>\build\           the recompiled runtime for that game, its
                                bundled OpenBIOS, mod catalog, precompiled
                                overlay cache and a toolchain the runtime uses
                                to compile newly discovered code in the background
  games\<game>\docs\index.html  full documentation: controls, options, history
  games\<game>\saves\           memory cards
  LICENSES\                     PSXRecomp, OpenBIOS and third-party notices

The runtime is built with PSXRecomp (https://github.com/mstan/psxrecomp) and
boots the games with OpenBIOS; no Sony BIOS is included or required. Game
titles, artwork and characters belong to their owners; nothing here is endorsed
by 20th Century Studios, Disney, Acclaim, Probe or n-Space.

KNOWN LIMITS
  These builds are experimental. See VERIFICATION.md for bounded boot and
  control-test evidence. Physical mouse feel, full playthroughs, saving, CD
  audio accuracy and every mode are not verified. If a game exits with an
  error, the launcher shows the log path. Synthesized CUEs use the Redump layout; audio timing is unverified.

FEEDBACK
  GIVE FEEDBACK opens a prefilled GitHub issue in your browser. Review and submit
  with your own account; no files or personal information are uploaded by the launcher.
  https://github.com/LevonFrench/PSX-Trilogy-Recomp/issues

LICENSE
  Original collection code: MIT. Bundled framework: PolyForm Noncommercial.
  See LICENSE, NOTICE.md and LICENSES for the respective component terms.

--------------------------------------------------------------------
Linux notes for this build
--------------------------------------------------------------------
Start the collection with:

    ./Play.sh              list the editions
    ./Play.sh <edition>    launch one

Everything you own - settings, keybinds, memory cards, save states, mod
selections, disc registrations and logs - lives in the data root:

    $PSXTRILOGY_DATA_ROOT               if you set it (absolute path)
    $XDG_DATA_HOME/PSXTrilogyRecomp     if XDG_DATA_HOME is set
    $HOME/.local/share/PSXTrilogyRecomp otherwise

Nothing is ever written inside this installed tree, so the install may sit on
read-only storage, and updating or moving it never disturbs your state.
"./Play.sh --portable" keeps the data root inside the install directory instead.

This package contains no game data. You supply your own disc image; put it at
<data root>/<edition>/disc/game.cue

OVERLAY COMPILATION
This Linux build ships a PREBUILT native overlay shard cache and no overlay
compiler. Runtime-driven overlay compilation does not exist on Linux in this
framework revision - the code path returns immediately on any non-Windows host -
so a bundled compiler could never be invoked, and one is deliberately not
shipped. Overlay regions outside the shipped cache run on the interpreter.

SHARED LIBRARIES
The runtimes are ordinary dynamically linked ELF64 executables. They are NOT
statically linked. They resolve against a stock Ubuntu 24.04 x86_64 system plus
its OpenGL loader (libglvnd). Your own graphics driver is used; none is bundled.

OVERLAY CACHE: this package was built with an explicit override.
One or more editions ship with NO native overlay shard cache, so
their overlays run on the interpreter. The stated reason was:

  Only DHT USA has a Linux overlay cache at this pin; the other five editions use interpreter fallback for dynamic overlays.
