soyjxck / dod3-recomp

# Drakengard 3 Recompiled
A native PC port of **Drakengard 3** (Drag-On Dragoon 3, PlayStation 3,
BLUS31197) for Windows and macOS, made by static recompilation of the game's
code on the ps3recomp toolkit.
The game's PowerPC and SPU code is translated to C++ ahead of time and built
into a normal executable, with the PS3's system libraries replaced by native
implementations and the RSX graphics by Direct3D 12, Metal or Vulkan. There
is no emulation at run time.
**Nothing of the game is in this repository.** You need your own copy of
Drakengard 3: the US disc and the game's 1.01 update, plus whatever DLC you
own. The installer takes them from there.
If this helped you, consider buying me a coffee
## Installing
What you need:
- A PC with Windows 10 or 11 (64-bit), a GPU with Direct3D 12 and a CPU with
 AVX2 (Intel Haswell / AMD Zen or newer), or a Mac with Apple silicon on
 macOS 13 or newer. About 16 GB of free disk space, 10 GB more for the
 Japanese voice pack.
- Your disc, US release (BLUS31197), dumped to a folder or a **decrypted**
 `.iso` (PS3 Disc Dumper
 writes one; an image from an ordinary disc tool is still encrypted and is
 refused, as are other regions).
- The 1.01 update, as the package a PlayStation 3 downloads:
 `UP0082-BLUS31197_00-DOD3PATCH0000000-A0101-V0101-PE.pkg`.
- Optionally, the DLC packages you own (`UP0082-NPUB31251_00-...`). No
 licence files are needed.
Windows:
1. Download `dod3-recomp- -win64.zip` from the
 releases and unzip it
 anywhere (not inside Program Files).
2. Run `dod3.exe`. SmartScreen may warn the first time, as the program is not
 signed: "More info", then "Run anyway".
3. In the setup that opens, add your files (the disc image or folder, the
 update package, any DLC packages) with Add Files / Add Folder, in any
 order, then Install. The game's files are copied into the `game` folder
 next to `dod3.exe` (a few minutes).
4. Start Game.
macOS:
1. Download `dod3-recomp- -macos-arm64.zip` from the
 releases, unzip it and
 move "Drakengard 3 Recompiled.app" to Applications.
2. The app is not notarised, so macOS refuses it the first time. On macOS 15
 and later: open it once, then allow it in System Settings > Privacy &
 Security ("Open Anyway"). On macOS 13 and 14: Control-click the app,
 choose Open, then Open again.
3. The setup opens as on Windows. The game's files go into
 `~/Library/Application Support/Drakengard 3 Recompiled`.
Settings (resolution, display mode, frame-rate cap, anti-aliasing, field of
view, draw distance, skipping the intro) are in the game's own Settings
menu, under Graphics Settings, System Settings and Advanced Graphics, or in
`dod3.ini`.
docs/PLAYING.md has the controls, the saves, the Japanese
voices, and what to do if something goes wrong.
## Building
The port is built in three steps: the game's PPU code is lifted to C++, its
SPU programs are lifted, and the whole is compiled with CMake. Lifting needs
the game's executable, so you need your own copy of the game first.
1. **Toolchai