DurangoRuntime 0.1.0-preview  (public pre-release, Windows x64)
=====================================================
By drakolordx7: https://github.com/drakolordx7/DurangoRuntime
License: GPL-3.0-or-later with attribution terms (LICENSE, NOTICE). Third-party parts: THIRD_PARTY_NOTICES.md, licenses\.

DurangoRuntime runs Xbox One games on a Windows PC. It does not contain any game. You bring a dump of a game you own;
prepare.cmd rewrites the game's own executables so that they load the runtime in runtime\ (an Xbox One system layer for Windows)
instead of the console's system software. The game's data stays in your dump.

What you need
  * Your own dump of a supported game. games\<title>\title.toml names the exact version; any other version is refused:
      Halo 5: Guardians (2018 build 97230) 1.1.31695.21: the folder that holds RootFolder\ (title halo5-2018)
      Sonic Mania 1.0.4.2: the folder that holds Mount\ (title sonic-mania)
      Terraria 4.4.14.1081: the folder that holds Mount\ (title terraria)
  * 64-bit Windows 10 or 11 with a DirectX 11 (Terraria: DirectX 12) GPU and current graphics drivers.
  * Nothing else: no Visual Studio, no Python, no compiler. Everything prepare needs is in this folder.

How to use
  1. Unzip this folder anywhere you can write to.
  2. Open a command prompt in it and run:    .\prepare.cmd "<path to your dump>"
     For Halo 5 the dump folder is the one that holds RootFolder, the content folder (halo-5-x1-na-...-assets) and xg_x.dll.
  3. prepare checks the dump, writes the playable folder playable\<name>\ (no game data in it) and says what to start.
     Halo 5 also generates its multiplayer map and game variants from your dump, which takes a minute or two.
  4. Start the .exe in that folder. Read the README.txt that prepare wrote there: settings, controls, known issues.
  Keep your dump where it is: the playable folder reads the game's data from it (durango_rt.cfg names the place).
  Saves go to playable\saves\, outside the game folder.

What is in this folder
  prepare.cmd        the one command above
  bin\prepare\       prepare.exe with the Python, lief and pefile it runs on; the Python files it runs are the ones in
                     recomp\ and tools\, so you can read them
  runtime\           the prebuilt runtime: durango_rt.dll, SDL3.dll (gamepads), the FFmpeg DLLs (XMA audio), the export list
                     prepare reads, and the settings table (runtime\*\*.inc) that checks the title files
  redist\            the Microsoft Visual C++ runtime DLLs, unmodified, copied next to every game exe so nothing has to be installed
  games\             one title.toml per supported game (Halo 5 also its controller / key prompt pictures)
  licenses\          the licences and notices of everything shipped here (SDL3, FFmpeg and its source, libdeflate, Xelu prompts, ...)

Not in this folder, on purpose: any game file, any patched game executable, any Microsoft SDK header or symbol data.
The playable folder that prepare makes DOES contain the rewritten game executable of your dump: never share it, only this zip.

This is a pre-release. Expect crashes, wrong graphics and slow speed (the README.txt in the playable folder lists the known issues).
Not affiliated with or endorsed by the publishers of any game, Microsoft or Xbox. Game content belongs to its owners.
