PersonaRM

Native PC runtime · Persona 2: Eternal Punishment

Run the game natively. Bring your own copy.

PersonaRM is an open-source runtime and launcher for Windows and Linux, in active development. It rebuilds the PlayStation 1 hardware the game needs. Not playable yet, but the game's real executable already plays its intro, shows the title screen and, on a new game, reaches free movement of the player character and the main menu, in an optional SDL3 window, with music and sound effects.

  • GPL v3+
  • Windows · Linux
  • C++17
  • No game files included
01

Built on Bring Your Own Copy

No game content

PersonaRM contains no game binaries, ROMs, or assets. The runtime is the only thing you download.

Your disc, your files

Point PersonaRM at a disc image from a copy you own: .cue/.bin, .iso, or .img.

Enhancements

Save states (F5 / F8, ten slots), hold-to-fast-forward up to 16×, and a widescreen prototype work now; controller glyphs come next.

02

Hardware, being rebuilt

MIPS-I CPU

R3000A interpreter with branch and load delay slots. It is the reference the rest is checked against.

Geometry engine

GTE vector and matrix math: all 22 commands, not yet checked against real-hardware results.

GPU and VRAM

Software rasterizer over 1 MB of VRAM: polygons, lines, sprites, CLUT textures and semi-transparency.

MDEC video

Decodes the game's 320×240 STR videos with their XA audio; timing values are approximated.

SPU audio

24 voices with ADPCM, pitch, envelopes and reverb. The interpolation table is still an approximation.

Disc handling

ISO 9660 and raw CD-ROM XA images with .cue resolution, plus tools that map the game's data files.

Display modes

4:3 works, and a widescreen prototype (16:9, 21:9) is in. Planned: Fill.

Controllers

Keyboard and gamepad work in the window; the left stick drives the d-pad. Planned: mouse, and PlayStation, Xbox, and Nintendo profiles.

Memory card and saves

Standard 128 KB card files via --memcard1 and --memcard2. Disc 1 saves and CONTINUE work, and save states snapshot the whole machine at any moment.

03

Project status

PersonaRM is in active development and not playable yet. The plan: get the CPU provably correct, finish the machine core, boot the game, then compile its code ahead of time.

Current phase: step 4 of 6, static recompilation (in progress). The CPU and the machine core are done. Step 3, first boot, continues for playing further: on JP disc 1 the first battle is reached and won from a save at the school, with no emulator bugs on that path, and several battles played by hand showed no glitches. Top priority now is a lightweight launcher (Rust + egui) that starts the game with these settings; it is being built. Disc 1 plays its intro with sound, shows the title screen and, on a new game, reaches free movement and the main menu. The boot matches the PCSX-Redux reference emulator up to the first overlay loads. Music and sound effects now play, with the SPU on emulated time. The recompiler now covers overlays too, each validated by a hash of its code in RAM, with the interpreter as fallback. On disc 1 it runs essentially 100% of instructions as native code, and the trace still matches the interpreter exactly up to free movement. Device timing now advances lazily, with exact results: on a fast PC the interpreter went from about 74 to 129 fps, and the recompiled mode from about 100 to 370 fps. Memory cards work: standard 128 KB .mcd files via --memcard1 and --memcard2. On disc 1 the game saves from the main menu, and after a reboot CONTINUE loads the save. The SDL3 window can run the recompiled mode (--recomp) with memory cards, as a developer build. Mods: a first version of texture dump and replacement is in the SDL3 window (--texture-dump and --mods; see the mods row in the status table). The game's text system has been located: dialogue uses the game's own 16-bit character codes in event banks, drawn with a 12x12 font, and text speed is a single setting in the main executable. The faster-text option is in: personarm_sdl --text-speed normal|fast|instant (or gameplay.text_speed in a mod manifest). It is built on a small, game-agnostic gameplay-patch layer: patches are applied when the game writes a given memory word, guarded by the expected bytes. The first dialogue line takes 138 frames to appear at normal, 48 at fast and 6 at instant. Disc 1 only for now. Disc 2, the Sumaru TV Special Preview Disc, now boots and runs: it is a promotional TV-channel disc with ATLUS and channel videos and a newspaper TV listing, and each programme is a short in-engine scene with dialogue (a weather report, a variety show, Igor in the Velvet Room). Its interpreter and recompiled modes match exactly, with about 99.99% of instructions running as native code. The US release (SLUS-01158) boots to free movement and the main menu with English text, and its recompiled mode matches the interpreter. The JP release is still the primary target; the future launcher will let you pick English by booting the US disc. A settings file (settings.json, see docs/SETTINGS.md) covers window mode and scale, integer scaling, aspect, vsync, fps target, internal resolution, volume and mute, key and pad remapping, save folder, per-game options and pause on focus loss; command-line flags override it. Internal resolution (--resolution-scale 1-4) runs 2x in real time on the software rasterizer; 3x and 4x run with the GPU renderer (--renderer gpu, prototype), and it cannot yet be combined with frame interpolation. The p2text tool extracts and reinserts field dialogue (docs/TRANSLATION_TOOLS.md); it round-trips all of disc 1 with 0 failures. With file mods (docs/MOD_FILES.md), edited dialogue now shows in the running game, verified on the shrine scene. Translations ship only as patches, never as game text. Recent additions: the menu cursor and UI labels on JP disc 1 are visible again (a GPU reset no longer wipes video memory); the gamepad's left stick drives the d-pad, and button presses are logged; --record-input records a play session as a replayable input script (the replay is byte-identical from the same starting state); widescreen (--widescreen 16:9 or 21:9) is a prototype; a GPU renderer prototype (--renderer gpu) runs at up to 9x (4K) or auto; save states (F5 / F8) and hold-to-fast-forward are in; p2text warns when a translated line overflows the 288 px dialogue window. Next: the launcher, completing the GPU renderer, and fps 30 and 90.

SubsystemStatus
Launcher (disc scan and verification)Launching the game is a stub; a lightweight launcher (Rust + egui) is being built
Disc reader and PS-X EXE loaderImplemented
Static analysis toolsImplemented
MIPS-I CPU interpreterConformance suite passing
GTE and GPU rasterizerImplemented
MDEC video and XA audioWired in, timing approximated
SPU audioMusic and sound effects play; interpolation approximated
BIOS HLE and kernel eventsImplemented
Interrupts, VBlank and timersImplemented
DMA, CD-ROM and SPUWired into the bus
Real-game bootDisc 1: free movement and main menu; the menu cursor and UI labels on JP disc 1 are visible again (a GPU reset no longer wipes video memory); a first battle reached and won from a school save, with no emulator bugs on that path; disc 2 (Sumaru TV Special Preview Disc) boots and runs
Static recompilerv0: function-level C++ generation, synthetic G2 passing; overlays covered (code-hash checked); not yet playable end to end
Memory cards and savesWorks: 128 KB .mcd cards; disc 1 saves and CONTINUE
Mods: texture dump and replacementFirst version; texture mods are in the SDL3 window only, off by default. --texture-dump saves each texture uploaded to video memory as PNG (once per content hash); --mods draws replacement PNGs from mods/<name>/textures/ (optional manifest.json priority). Output stays at native resolution; palette variants share one PNG; textures uploaded in pieces give one PNG per piece. Mods must contain only the modder's own images, never original game files. File mods (files/Fnnnn.BIN): a mod can replace a whole disc file, and the running game loads it instead of the disc copy; the file may grow. Works with --mods in personarm --boot and personarm_sdl, on JP disc 1 and the US release, in interpreter and recompiled modes. With no mods active, output is byte-identical. See docs/MOD_FILES.md
Text speed optionDisc 1 only; --text-speed takes normal, fast or instant (or gameplay.text_speed in a mod manifest). Built on a small, game-agnostic gameplay-patch layer. The first dialogue line takes 138 frames to appear at normal, 48 at fast and 6 at instant
Window, input and audio (SDL3)Works; the gamepad's left stick drives the d-pad and button presses are logged; full SPU and CD/XA mix in the window; runs with --recomp and --memcard1/2; optional frame interpolation (off by default)
US release (SLUS-01158)Boots to free movement and the main menu with English text; recompiled mode matches the interpreter. The JP release remains the primary target
Settings file (settings.json)In the per-user config folder, or given with --settings; command-line flags override it. fps_target 30 and 90 are not supported yet (they run at 60); language is stored only
Internal resolution (--resolution-scale)1 to 4, or video.resolution_scale in the settings file. 2x runs in real time on the software rasterizer; 3x and 4x run with the GPU renderer (--renderer gpu, see below); not yet combinable with frame interpolation
Translation tools (p2text)Extracts and reinserts field dialogue; round-trips all of disc 1 with 0 failures. With file mods, edited dialogue shows in the running game (JP disc 1, verified on the shrine scene). Translations ship only as patches. p2text warns when a translated line overflows the 288 px dialogue window; US glyph widths are read from the user's disc.
GPU renderer (--renderer gpu)Prototype on SDL_gpu (D3D12 on Windows). At 4x about 8 ms per frame in total (6.5 ms emulation plus readback) against about 37 ms in software. Scale 1 to 9 (up to 4K) or auto. Some features still fall back to the software renderer or are missing. See docs/GPU_RENDERER.md
Widescreen (--widescreen, video.widescreen)Prototype: --widescreen 16:9 or 21:9 shows a wider 3D view. Dialogue, text and portraits over 3D keep 4:3; menus and FMV stay 4:3. Known issue: empty room edges are visible at the sides. See docs/WIDESCREEN.md
Save states and fast-forwardF5 save, F8 load, F6/F7 slot. Deterministic. The memory card is never touched by states. Hold Tab or R3 to fast-forward: up to 4x by default (video.fast_forward_max), 16x max
Input recording (--record-input)Records a play session as a replayable input script; the replay is byte-identical from the same starting state
04

Quick start

Not playable yet. There are no releases yet; build from source. Most commands below manage disc images and configuration for development.
  1. Get a legal copy

    You need the disc of Persona 2: Eternal Punishment, from a copy you own.

  2. Download or build PersonaRM

    Build from source using the instructions in the README. There are no releases yet.

  3. Point it at your discs

    Scan a folder and verify the image:

    personarm --scan "/path/to/discs"
    personarm --verify-disc "/path/to/disc1.cue"
    personarm --portal
    # developer build (-DPRM_WITH_SDL3=ON, recompiled code generated locally):
    personarm_sdl "/path/to/disc1.cue" --recomp --memcard1 "/path/to/card1.mcd"

Settings are stored in personarm_config.json. The SDL3 window also reads settings.json (see docs/SETTINGS.md). Run personarm --help for all options.

05

For developers

Architecture

A central engine routes memory through a KUSEG, KSEG0, and KSEG1 bus to RAM, scratchpad, GPU, SPU, and the controller SPI.

Read ARCHITECTURE.md →

Build and test

CMake 3.20+, C++17, and a Python test runner. Continuous integration runs on Windows and Linux.

Developer Guide →

Contribute

Bug reports, feature requests, and pull requests are welcome. Read the contributor rules first.

CONTRIBUTING.md →

Ready to descend?

Clone the repository, build it, and bring your own disc.

Open on GitHub