obaidr1 / hercules-recompiled

# Hercules Recompiled
A native PC (Windows and Linux) port of the 1997 PlayStation action game *Disney's
Hercules* (all five PAL releases: English, French, German, Italian, Spanish), plus the decompilation work
behind it. The game logic runs unchanged as statically recompiled code; only
the platform layer is replaced: 1080p, true 16:9, HD sprites, level textures
and HUD, a CRT simulation, save states, and a launcher styled after the
game's own title menus (in German, English, French, Spanish and Italian)
that boots straight into the level you pick.
**This repository contains no game data.** You need your own copy of the
game. Every graphic, sound and code byte of the game is read from your disc
image at build or run time, and everything made from it (extracted files,
disassembly, HD texture packs, launcher artwork) stays out of git. The
prebuilt downloads contain the game's program code translated to x86-64, but
no graphics, sound, video or level data: those still come from your disc.
The optional HD texture packs (upscaled from the game's graphics) are
published separately as the hd-packs
release; the launcher can also make them from your disc instead.
Fan project, not affiliated with or endorsed by Disney or Sony.
## Download
Prebuilt for players who don't want to build it themselves:
| System | Download |
|--------|----------|
| Windows 10/11 (x64) | **hercules-recompiled-windows-x64.zip** |
| Linux (x64, glibc 2.35+: Ubuntu 22.04, Debian 12, Fedora 36 or newer) | **hercules-recompiled-linux-x64.zip** |
Checksums and release notes: latest release.
1. Unzip into a folder of its own (the archive has no top-level folder).
2. Start `Hercules_Recompiled.exe` (Windows) or `./Hercules_Recompiled` (Linux).
3. On first start, pick your disc image: the `.cue` of a dump of one of the
 **PAL releases** SCES-00891 (English), -00892 (French), -00893 (German),
 -00894 (Italian) or -00895 (Spanish), `.cue` + `.bin`. The launcher's
 language picks the release; it asks for that release's disc and remembers
 it (`disc.cfg`, `disc- .cfg`) next to the program.
4. Choose a level in the launcher. Keyboard, mouse and gamepads work; F11
 toggles fullscreen.
5. In the game, **Esc** (gamepad: **Select + Start**) opens the menu:
 HD on/off, CRT picture, 16:9 or 4:3, volume, the controls and more,
 all switched live. Every key is listed in CONTROLS.md.
Windows shows a SmartScreen warning because the program is not signed:
click **More info → Run anyway**.
**Updates come by themselves** (from 0.5.0 on): on start the launcher checks
for a new release, shows its changelog and installs it on request. Settings,
saves, the disc path and the HD graphics stay. *Options → General → Auto
updates* turns the check off. Coming from 0.4.0 or older: unzip the new
download over your existing folder once, so your HD graphics and saves stay.
**HD graphics are downloaded after your first game** (from 0.5.1 on): the
launcher fetches the pack for your release from the
hd-packs
release in the