hachi23 / unicorn_overlord_pc

# Unicorn Overlord PC (vwport)
A native Linux and Windows port of the PlayStation 4 version of **Unicorn Overlord**.
| Dump | State |
|---|---|
| CUSA36381 (Asia), app 01.04 (base game with the 1.04 English update) | Prologue, chapter 1 and its first battle played; saving and loading work; every system function the game imports is implemented |
> **Work in progress.** The game has not been played to the end, and it runs at about 50-60 FPS
> on a mid-range laptop. Read docs/KNOWN_ISSUES.md before reporting a bug.
### What it is
Not an emulator, and not a decompilation. The PS4 and a PC use the same kind of processor
(x86-64), so the game's own executable from your dump runs **directly on the PC's CPU**. What a
PC doesn't have is the PS4's operating system and GPU, so this project supplies both:
1. **Preparation** (`scripts/`): reads the game's `eboot.bin`, fixes up its addresses and links
 the game's bundled system modules into one image.
2. **Loader** (`src/probe.c`): loads that image into memory, applies a few small per-game code
 patches (for example the render resolution) and jumps into the game's code.
3. **Runtime** (`src/runtime_*.c`): about 700 PS4 system functions the game calls (memory,
 threads, files, audio, video decoding, controller, saves, and offline stand-ins for PSN),
 written for these games.
4. **GPU** (`gpu/`): the shadPS4 video core turns the
 PS4's GPU commands and shaders into Vulkan, with this port's multi-threaded draw pipeline on top.
5. **Start program** (`launcher/`): a one-time setup that installs your dump, then starts the
 game; the in-game menu is Dear ImGui (`gpu/shim/vw_overlay.cpp`).
Only the dump listed above is supported.
> **No game files are included.** You need a dump of your own copy. This project is not
> affiliated with Sony Interactive Entertainment, Atlus, Sega or Vanillaware.
## Download
Download v1.0.0 for Windows and Linux.
The release includes checksums, source and matching debug symbols.
Test builds of `main` are on the `latest` pre-release:
- **Linux:** `Unicorn-Overlord-x86_64.AppImage`. Make it executable (`chmod +x`) and run it. It
 keeps its `data/` folder next to the `.AppImage`.
- **Windows:** `Unicorn-Overlord-PC-windows.zip`. Extract it into its own folder and run
 `Unicorn Overlord.exe`; it keeps `data/` beside itself. Keep `LICENSE` and `licenses/` with it.
These are untested builds of the newest code. See docs/RELEASING.md for how
builds and releases are made.
## Requirements
- 64-bit Linux, or Windows 10 (1903+) / 11.
- A Vulkan 1.3 GPU.
- Your own dump of the game with the 1.04 update merged in, as a folder containing `eboot.bin`,
 `sce_module`, `sce_sys` and the `.CPK` files (about 7 GB).
## Playing
**First start:** choose your dump's folder. The start program checks it (title and version),
installs it into `data/game` and starts the game. On the same drive the install takes a
moment and needs no extra space (hard links); from another drive it copies about 7 GB with a
progress windo