PSX TRILOGY RECOMP  {VERSION}
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.
