Orta Recomp

Orta PC Recomp is a native Windows port of Panzer Dragoon Orta, recompiled from its original Xbox code to C.

README

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 by sp00nznet (MIT, with xemu-derived parts under LGPL-2.1). Many GPU behaviours are matched against xemu.

Status: work in progress. Every episode is playable from start to finish. See docs/KNOWN_ISSUES.md and 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

PathWhat 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.
  • 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.

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).