!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!
!!   THIS IS A TEST BUILD FOR DEVELOPMENT. IT IS NOT FOR PLAYING.
!!
!!   It is here to find bugs and crashes. Most of the game is untested: expect crashes,
!!   wrong graphics, frame-rate drops and lost saves. Only Seaside Hill and the special stage
!!   have been played through. To play Sonic Heroes, wait for the first real release.
!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

HOW TO REPORT A BUG OR A CRASH (save it right after the problem, before starting the game again):
- Hold F1 (or the controller's Back/View button) > About > Save a bug report. It writes
  bug-report-<date>.zip in the game's folder. After a crash, start the game once more and
  save the report then: the crashed run is in sonicheroes.prev.log inside the zip.
- Setup problems: setup.log in this folder.
- Pictures: settings menu > Save screenshot (shot_<number>.bmp next to the log).
- Open a report and attach the zip / logs (never game files):
  https://github.com/teclilla18/sonic-heroes-recomp/issues/new?template=bug_report.yml


Sonic Heroes native port 0.1.0-alpha.1 - unofficial fan project, not affiliated with SEGA or Nintendo.

This download contains NO game files. You need your own Sonic Heroes (USA) disc image:
G9SE8P, revision 0, a clean full .iso (1,459,978,240 bytes). The setup checks it.

The setup runs on a 64-bit Windows 10 (version 1803 or newer) or Windows 11 PC, with about 4 GB
free and internet the first time. Nothing else to install: it downloads its own build tools.

PLAY ON WINDOWS (no emulator: the game runs natively)

Needs: a graphics card with OpenGL 3.3.

1. Extract this whole zip to a folder you'll keep (for example C:\Games\SonicHeroes). Its path
   must use only English letters and digits (not under a Windows user name with accents).
   The game, your saves and settings live in that folder.
2. Double-click SonicHeroesLauncher.exe. If Windows warns, click More info > Run anyway.
   Click "Select disc...", pick your disc image and press INSTALL AND PLAY. The first run takes
   10-30 minutes; after that the launcher's PLAY button starts the game.
   The launcher also has the settings, mods and button remapping (Controls page).
   (Without the launcher: double-click "Install Sonic Heroes (PC).bat", then use the "Sonic Heroes"
   shortcut it makes.)

Controls: a game controller works (Xbox-style; up to 4 players with more controllers).
Keyboard: WASD = move, J = A, K = B, L = X, I = Y, Enter = START, U / O = L / R, P = Z,
arrow keys = C-stick, T F G H = D-pad. Change them on the launcher's Controls page.
Hold F1 (or the controller's Back/View button) = settings menu. F11 or Alt+Enter = fullscreen.

Updating: download the new version, extract it to a new folder and run the installer again.
Problems or bugs: https://github.com/teclilla18/sonic-heroes-recomp/issues (attach setup.log or
sonicheroes.log; never attach game files).

Never share your disc image or the files the setup builds from it.
