# Orta PC Recomp — Panzer Dragoon Orta, recompiled for PC

A native Windows build of **Panzer Dragoon Orta** (original Xbox), made by
statically recompiling the game's code to C and running it on a PC
reimplementation of the Xbox kernel, GPU (NV2A → Direct3D 11) and audio.

Built on [xboxrecomp](https://github.com/sp00nznet/xboxrecomp) by sp00nznet
(MIT, with xemu-derived parts under LGPL-2.1). Many GPU behaviours are matched
against [xemu](https://xemu.app).

> **Status:** work in progress. The game is once again playable from start to
> finish on Windows, every episode through to the last boss, and the Pandora's
> Box extras now run too.
> See [docs/KNOWN_ISSUES.md](docs/KNOWN_ISSUES.md) and [docs/ROADMAP.md](docs/ROADMAP.md).

## You need your own copy of the game

This repository contains **no game code or assets** — no XBE, no disc files,
no recompiled game code, no textures. You supply files from your own disc.

## Requirements

- Windows 10 or 11, 64-bit
- A DirectX 11 graphics card
- An Xbox controller or any XInput pad
- Your own copy of Panzer Dragoon Orta

## Repository layout

| Path | What it is |
|---|---|
| `xboxrecomp-main/` | The xboxrecomp toolkit, with this project's changes: the recompiler (`tools/`) and the runtime (`src/`), which covers the kernel, the NV2A GPU on Direct3D 11, audio, input and video |
| `orta/` | The Orta game project: `main.c` (settings.ini, start-up), `recomp_manual.c` (hand-written replacements such as controller, rumble and crash guards), `overlay.cpp` (the F1 settings menu), the build scripts and the playtest package template |
| `orta/seeds/` | Function addresses found while playing, which the recompiler needs. They are addresses only, with no game code. Copy them to `xboxrecomp-main/game_files/` before translating |
| `orta/third_party/imgui/` | Dear ImGui 1.91.9 (MIT) |
| `docs/` | Roadmap, known issues and changelog |

## Installing

Download `OrtaPC_Setup.exe` from the Releases page and run it.

- It looks for your Panzer Dragoon Orta disc image (`.iso`) by itself, in
  Downloads, Desktop, Documents, Videos, your user folder and then each drive.
  If it doesn't find it, press **Disc image...** (or **Folder...** for an
  unpacked copy with `default.xbe` in it).
- It checks the disc is Panzer Dragoon Orta, North American release.
- It downloads Python, the capstone disassembler and the llvm-mingw compiler
  (about 300 MB) into `%LOCALAPPDATA%\Orta PC Setup`, translates and compiles
  the game (20-30 minutes), installs it where you chose, and then deletes that
  work folder.
- At the end it prepares the graphics shaders the game needs to start (a few
  minutes), so the first start is quick.
- The install folder gets `setup_log.txt`; send it along with any problem
  report. If Setup stops part-way, run it again: it reuses what it already
  downloaded and compiled.

## Settings and files

- **Launcher:** shown the first time the game starts (and whenever Shift is
  held while it starts): resolution, display mode, widescreen, VSync, volume,
  music, sound effects and speakers.
- **F1 menu** (or Back + Start on the pad) while playing: the same settings
  and more. Everything is saved to `settings.ini` next to the game.
- **Anti-aliasing:** Off, FXAA (fast) or FXAA (high quality), in the launcher
  and the F1 menu (`AntiAliasing = 0/1/2` in `[Display]`).
- **Audio:** separate Music and Sound effects levels, 0-200 (70 is the
  original mix, above 100 boosts). Speakers can be Stereo or 5.1; 5.1 takes
  effect when the game next starts. An experimental switch that tells the game
  it is on a Dolby Digital console: `RECOMP_AUDIO_AC3 = 1` under `[Advanced]`.
- **Data folder** next to the game: the game's cache (`Data\Cache`), the
  compiled graphics shaders (`Data\shader_cache`) and the console's save
  areas. Deleting `Cache` and `shader_cache` gives the game a fresh start;
  the first start after that is slow again. Episode saves are in
  `game_files\UDATA`. (If the game folder can't be written to, Data goes in
  `%LOCALAPPDATA%\Orta PC` instead.)
- **Problem reports:** each run writes `session_log.txt` next to the game,
  and the run before is kept as `session_log_previous.txt`. Send these with
  any report. Every 10 seconds the log also notes how much CPU the game used
  and on which threads (`[PERF]` lines), which helps with "it runs slowly"
  reports.

To make the installer yourself: `installer/build_setup.sh` builds the
`Setup.exe` stub (clang + lld-link, no C runtime), and
`python installer/make_release.py OrtaPC_Setup.exe` appends the sources to it.

## Building by hand

You need Windows 10/11 with Visual Studio 2022 (Desktop C++), CMake 3.20+ and
Python 3.

1. Copy `default.xbe` and the rest of the disc's files from **your own copy of
   the game** into `xboxrecomp-main/game_files/`.
2. Copy the three files from `orta/seeds/` into the same folder.
3. From a Developer PowerShell for VS 2022, in `orta/`, run
   `powershell -ExecutionPolicy Bypass -File .\orta_loop.ps1`. It
   disassembles and translates the game to C in `orta/src/recomp/gen/` (this
   output is never committed), builds with CMake into `build64/`, and starts
   the game.
4. `orta_package.ps1` then gathers a playable folder: the exe,
   `settings.ini`, `engine.ini` and the README from `orta/package/`.

The toolkit's own guide, `xboxrecomp-main/docs/GETTING_STARTED.md`, explains
the pipeline in depth.

## Licence

Code from xboxrecomp keeps its MIT licence (`xboxrecomp-main/LICENSE`). The
xemu-derived files keep their LGPL-2.1-or-later licence and notices
(`xboxrecomp-main/NOTICE`, `xboxrecomp-main/LICENSES/`). Dear ImGui is MIT
(`orta/third_party/imgui/LICENSE.txt`).