kion @ psp2i.dev

Reverse-engineering and rebuilding two Phantasy Star games. Two families of repos, one per game:

	Game	Goal
psp2i	Phantasy Star Portable 2 Infinity (PSP, 2011)	run the game natively — no ISO, no emulator
psz	Phantasy Star Zero (NDS, 2008)	measured ground truth for a Godot remake

Phantasy Star Portable 2 Infinity ("psp2i")

• psp2i-standalone — the flagship: PSP2i as a native executable. An Android APK that boots straight into the game comes first, desktop builds (Windows/Linux/macOS) next, and decompilation as a follow-on once the game runs standalone.
• ppsspp-psp2i — a PPSSPP fork: the emulator base the standalone bundle is built from.
• psp2i-re — a reverse-engineering knowledge graph of the game binary (NPJH50332). Companion to psp2i-standalone: standalone keeps the game playable while psp2i-re grows understanding — renovating the house while living in it. Every claim is tied to evidence pulled from the binary; guesses stay quarantined until a test confirms them.
• psp2i-android (private) — the umbrella for the Android recompile effort: a PPSSPP v1.20.4 fork, the web-based FPB/asset unpacker, tooling, and the game data itself via Git LFS. Private because it bundles copyrighted game material that can't live on a public host.

Phantasy Star Zero ("psz")

Both psz repos exist to feed psz-godot (on GitHub) — the Godot remake — with measured fact instead of guesswork.

• psz-re — reverse engineering the NDS ROM: data tables and behaviour read straight out of the binary (damage formulas, enemy AI, spawn tables, drop rates). Output is documents and JSON specs, not a playable build.
• psz-melonmix — a melonDS fork carrying a Phantasy Star Zero plugin (modelled on KHMelonMix). Instrumentation first: make the original game emit machine-readable combat ground truth so the remake can be tuned against measurements; single-screen widescreen presentation second.

How it all fits together

graph TD
    subgraph PSP2I["Phantasy Star Portable 2 Infinity"]
        PP["ppsspp-psp2i<br/>PPSSPP fork"]
        SA["psp2i-standalone<br/>native build"]
        RE["psp2i-re<br/>RE knowledge graph"]
        AN["psp2i-android<br/>private: APK effort"]
        PP --> SA
        RE <-->|"playable / understanding"| SA
        AN --> SA
    end
    subgraph PSZ["Phantasy Star Zero"]
        ZR["psz-re<br/>ROM reverse engineering"]
        ZM["psz-melonmix<br/>instrumented emulator"]
    end
    GOD["psz-godot<br/>Godot remake, on GitHub"]
    ZR -->|"specs & JSON"| GOD
    ZM -->|"combat measurements"| GOD

Private repos are visible to their owner only; everything else is cloneable — git clone https://psp2i.dev/kion/<repo>.git.