No game content
PersonaRM contains no game binaries, ROMs, or assets. The runtime is the only thing you download.
Native PC runtime · Persona 2: Eternal Punishment
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.
PersonaRM contains no game binaries, ROMs, or assets. The runtime is the only thing you download.
Point PersonaRM at a disc image from a copy you own: .cue/.bin, .iso,
or .img.
Save states (F5 / F8, ten slots), hold-to-fast-forward up to 16×, and a widescreen prototype work now; controller glyphs come next.
R3000A interpreter with branch and load delay slots. It is the reference the rest is checked against.
GTE vector and matrix math: all 22 commands, not yet checked against real-hardware results.
Software rasterizer over 1 MB of VRAM: polygons, lines, sprites, CLUT textures and semi-transparency.
Decodes the game's 320×240 STR videos with their XA audio; timing values are approximated.
24 voices with ADPCM, pitch, envelopes and reverb. The interpolation table is still an approximation.
ISO 9660 and raw CD-ROM XA images with .cue resolution, plus tools that map the game's data files.
4:3 works, and a widescreen prototype (16:9, 21:9) is in. Planned: Fill.
Keyboard and gamepad work in the window; the left stick drives the d-pad. Planned: mouse, and PlayStation, Xbox, and Nintendo profiles.
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.
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.
--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 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 instantsettings.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--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 interpolationp2text)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.--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, 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.mdvideo.fast_forward_max), 16x max--record-input)Records a play session as a replayable input script; the replay is byte-identical from the same starting stateYou need the disc of Persona 2: Eternal Punishment, from a copy you own.
Build from source using the instructions in the README. There are no releases yet.
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.
A central engine routes memory through a KUSEG, KSEG0, and KSEG1 bus to RAM, scratchpad, GPU, SPU, and the controller SPI.
Read ARCHITECTURE.md →CMake 3.20+, C++17, and a Python test runner. Continuous integration runs on Windows and Linux.
Developer Guide →Bug reports, feature requests, and pull requests are welcome. Read the contributor rules first.
CONTRIBUTING.md →Licensed under GPL v3 or later. Fork it, study it, and improve it.
Browse the repository →Clone the repository, build it, and bring your own disc.
Open on GitHub