SH3-PC launcher
===============

This is the launcher built from the sh3-pc source in this repository, with the
recompiled game code left out. That code is generated from *your* copy of Silent
Hill 3 for PC (sh3.exe, 3,338,240 bytes), so no ready-made binary can contain it.

What works in this build
- the warning screen, the menu, Options (resolution, game threads, widescreen on/off,
  filter off/CRT/VHS, game folder,
  picking a folder, sh3.exe or a disc, importing the downloaded .zip, and
  installing a mod from a .zip) and the credits roll
- what you hand it: a game folder, the game's own sh3.exe, a PC installation
  disc, a PlayStation 2 disc image (.iso, or .bin with or without its .cue) or a
  PS2 ELF. Each one is identified from its contents and either started or
  refused with the reason, e.g.:
    "That is Silent Hill 3 for the PlayStation 2: the disc starts SLUS_206.22,
     which is MIPS code with the console's own data formats."
- the folder you point it at is remembered in sh3-pc.ini beside the executable.

What does not work in this build
- Play as the port. The game's own code is the recompiled part, which is missing
  here, so Play offers to start the copy's own sh3.exe instead (the NoCD
  executable in the Full-Rip). Build from your copy for the port itself:
  docs/BUILD-WINDOWS.md.

Usage
  sh3-pc-launcher.exe "D:\Games\Silent Hill 3"
  sh3-pc-launcher.exe "D:\Games\Silent Hill 3\sh3.exe"
  sh3-pc-launcher.exe "D:\Silent Hill 3 (PS2).iso"
  sh3-pc-launcher.exe "D:\Downloads\Silent-Hill-3-Full-Rip.zip"
or drop any of those onto the executable or the launcher window. The zip is
unpacked beside itself and the folder with sh3.exe and data/ inside becomes the
game; the same is in Options > Import a .zip download. Options > Widescreen and
Options > Filter write widescreen= and filter= into sh3.ini, which a build made from
your own sh3.exe reads (this launcher has no game code to apply them to). With nothing given the
launcher opens with no game: Play says what is missing, and Options holds Check
this copy, Import a .zip download, Game folder, Game disc or file and Install a
mod. Check this copy names what a folder, sh3.exe, disc image or .zip is and
offers the step that uses it, so a PS2 disc, a PC installation disc and a
playable copy are told apart before anything is started.

The PlayStation 2 release cannot be run by this port: it is MIPS code with the
console's own data formats and its own graphics and audio hardware, while this
port is a recompilation of the 2003 PC release. A PS2 image or program is
recognised, named, and then handed to PCSX2: when the emulator is installed
(%LOCALAPPDATA%\Programs\PCSX2, %ProgramFiles%\PCSX2, or PATH) the launcher asks
once and starts it with the image; without PCSX2 it says where to get it. The
note under the Options row says which of those happened, so it never promises
PCSX2 when it is not installed.

Silent Hill 3 is Konami's. No game files are included.

Steam Deck
----------
This same zip is the Deck build: add sh3-pc-launcher.exe as a non-Steam game, force
Proton Experimental (or Proton GE), then Import the Full-Rip zip and Play. Import
no longer needs Windows' tar.exe, and the game's install entry is written into the
Proton prefix instead of asking for administrator rights.
Controls: A picks, B goes back, D-pad or left stick moves, Start also picks.
