Dissidia 012 Duodecim (PSP) running natively on the Steam Deck and Linux, no emulator, plus modding tools for adding new characters, swapping character models and creating new effects and animations. The native build is called Dissidia Trēdecim.
You need your own copy of the game as an .iso or .cso. The European PSN release (ULES01505) is the one it was built against; the US UMD (ULUS10566) works too.
Put it at ~/dissidia/game.iso: make a dissidia folder in your home folder and copy the game into it, named game.iso. Every command below uses that path. A .cso can be named game.iso too; it is recognised by its contents.
No terminal needed. In Desktop Mode (Steam button > Power > Switch to Desktop):
- On GitHub, open
psprecomp/games/dissidia/tools/deck_gui.shand click Download raw file. It lands in your Downloads folder. - In Dolphin, right-click it > Properties > Permissions > tick Is executable. Then double-click it and choose Execute.
- Follow the dialogs. It downloads the project into
~/dissidia/repo, asks for your game file (.isoor.cso, from the Deck, an SD card or a USB stick; it is placed at~/dissidia/game.iso), builds the game with a progress bar and adds Dissidia Trēdecim to Steam.
Then switch back to Game Mode and start Dissidia Trēdecim from your library.
The tool leaves a Dissidia Trēdecim Setup icon on the desktop and in the application menu (Games). Double-click it to Update (latest code and mods, only what changed is rebuilt), change the look (Retro or Crisp), check the Deck is ready, or read the last log. If you already have ~/dissidia/repo from before, the downloaded tool brings it up to date and carries on from there.
Prefer the terminal? deck_gui.sh is a front end for deck_setup.sh; the same in Konsole:
cd ~/dissidia
git clone https://github.com/dissidia-fan/dissidia repo
repo/psprecomp/games/dissidia/tools/deck_setup.sh ~/dissidia/game.iso --install-distrobox --add-to-steamand to update: ~/dissidia/repo/psprecomp/games/dissidia/tools/deck_setup.sh ~/dissidia/game.iso --update
Controls, display options, troubleshooting: docs/steamdeck.md.
Ubuntu/Debian; about 8 GB of disk needed. First put your game at ~/dissidia/game.iso (a folder called dissidia in your home folder, the file renamed game.iso). Then, in a terminal:
git clone https://github.com/dissidia-fan/dissidia ~/dissidia/repo
~/dissidia/repo/psprecomp/games/dissidia/tools/install.sh ~/dissidia/game.isoThe last command does everything: installs the build tools (it asks for your password for apt) and Rust, extracts and decrypts the game, and compiles it. It takes a while (tens of minutes; add --jobs 2 if it runs out of memory). If it stops part-way, run it again; finished steps are skipped. Then play with ~/dissidia/work/play.sh.
To update later: ~/dissidia/repo/psprecomp/games/dissidia/tools/install.sh ~/dissidia/game.iso --update
Gamepads work out of the box. Keyboard: arrows, X/Z/A/S for the face buttons, Q/W shoulders, Space = Start, Tab = Select. Saves are in ~/dissidia/work/ms0/PSP/SAVEDATA/.
Needs Homebrew; about 8 GB of disk. First put your game at ~/dissidia/game.iso (a folder called dissidia in your home folder, the file renamed game.iso). Then, in Terminal:
git clone https://github.com/dissidia-fan/dissidia ~/dissidia/repo
~/dissidia/repo/psprecomp/games/dissidia/tools/install.sh ~/dissidia/game.isoThe last command does everything: installs the build tools with Homebrew and Rust, extracts and decrypts the game, and compiles it. If Apple's command line tools are missing it opens their installer first; run the command again when that finishes. It takes a while (tens of minutes). If it stops part-way, run it again; finished steps are skipped. Then play with ~/dissidia/work/play.sh.
To update later: ~/dissidia/repo/psprecomp/games/dissidia/tools/install.sh ~/dissidia/game.iso --update
Gamepads work out of the box. Keyboard: arrows, X/Z/A/S for the face buttons, Q/W shoulders, Space = Start, Tab = Select. Saves are in ~/dissidia/work/ms0/PSP/SAVEDATA/.
Character mod folders in mods/ are built and loaded every time the game starts. What each step does and every runtime option: docs/native-build.md.
No game data (bring your own ISO), no character mods (mods/_template/ shows the layout), no texture packs (the loader works with the community packs credited below), no third-party mod ports, no game artwork.
A character is one folder in mods/: its menu pictures, moves and models as files you can read and edit. You need the native build working first (above), since added characters only run there; on a PSP or in PPSSPP only changes to the game's own characters work.
- Start in the Dissidia Move Studio. Open
studio/index.html, set the mods folder (the repo'smods) and your game ISO, then pick + New character… at the top of the character list. Give them a name, a series and the retail character it is built on (its skeleton, animations, voice and moves are the starting point), and optionally a full-body picture for the menus. - Make their moves in the Studio: copy moves from any retail or mod character, place events on the timeline, tune each hit's damage and knock-back, edit the effects, and press Save. The Character tab sets the name, slot and how the menu pictures are cropped.
- Give them a body and animations in Blender with the add-on: import the character from its mod folder, model or retarget, then Save moves to folder. Back in the Studio, Reload and point moves at the new animations.
- Play. Start the game: every folder in
mods/is built in before it runs, and the new character is on the Quick Battle grid. Deleting a folder (or"enabled": falsein itsmod.json) takes the character out again. - Share by zipping the folder. It holds data only, no scripts, and whoever gets it unzips it into their own
mods/; anything it borrows from the retail game is read from their own disc.
To change one of the game's own characters instead, pick them in the Studio (with the ISO set), edit, and press Save as mod.
Up to 6 characters can be added: the character select screens have no room for a 7th for now.
More detail:
- mods/README.md: what is in a character folder, the command-line tools, sharing.
- studio/README.md: the Move Studio, panel by panel.
- blender/README.md: installing and using the Blender add-on.
- docs/: everything else (roster, formats, events, audio, how the native build was made).
psprecomp/ is a fork of PSPRecomp (static recompiler + runtime). Everything Dissidia-specific is in psprecomp/games/dissidia/.
Findings in the docs carry a confidence (confirmed / inferred / medium / low); inferred ones are educated guesses from disassembly, not tested facts. Corrections welcome. The project was developed with heavy use of an AI assistant (Claude, by Anthropic), which did most of the reverse engineering and wrote most of the code, under my direction and testing.
- PSPRecomp: the recompiler and runtime this is forked from (GPL-2.0).
- PPSSPP: VFPU maths (
psprecomp/runtime/src/vfpu_ppsspp, GPL-2.0+), and the emulator used for every comparison and trace. - DissDlcToolkit (adriangl): the object-table format and the DLC route.
- dissidia-012-sora (MatNyaga): notes on effect-package ids and CPU AI.
- D012FFRT and LiinkPK/Dissidia-012-HD-Textures (LiinkPK, ajb3art): HD texture packs. Not included.
- atracdenc: ATRAC3 encoding for new BGM.
- Fonts: Cinzel and Crimson Text (SIL Open Font License).
- Everyone in the Dissidia modding community without whom this work could never have happened.
psprecomp/ is GPL-2.0 (see psprecomp/LICENSE), and so are the changes made to it here. Dissidia 012 Duodecim and Final Fantasy are trademarks of Square Enix; this project is not affiliated with or endorsed by Square Enix.