Frequently Asked Questions

Amicitia

What is Amicitia?
Amicitia (latin for "friendship") is a modding network dedicated to Atlus JRPGs. It is named after TGEnigma's all-in-one editor application.
Top
How do I browse mods/tools/guides?
Mods, tools, and guides are all organized by date last updated at amicitia.github.io. You may narrow down results by choosing a game or content type.
Clicking on the title of a post reveals the download/guide links, description, update notes and tags.
You can continue browsing similar content by clicking on a tag or author name.
Easily share specific posts with friends by clicking the hyperlink icon in the corner of a post.
Top
How can I contribute directly to the listing?
Since the site is open source, "Contributors" (Github users that moderate the repository) can merge pull requests submitted by anybody.
Check out the Github repository for amicitia.github.io. Create your own fork, clone it with your program of choice (git or Github Desktop) and make changes as you see fit.
You can submit your fork as a pull request to be merged with our main branch.
Generally, only the .tsv files in the /db/ folder need editing. See here for how to update the .tsv files from a Google or Excel spreadsheet.
Top

Modding

How do I install mods?
For most mods, you can use the Mod Compendium, a Windows application for managing mods for several Persona games.
Extract your downloaded mods in the program's mod folder, e.g. ModCompendium/Mods/Persona5/MODNAME/Data/...
See this guide for a more detailed, step-by-step explanation.

For P3FES, P4G and P5, there also exists Aemulus Package Manager, a more up-to-date and better maintained alternative to the Mod Compendium. It allows for BIN merging, table patching etc. which greatly improves compatibility when mods have conflicting files.

The Mod Compendium does not support mods made for Aemulus at this time as they take advantage of Aemulus's new features, such as table patches and loose unpacked files.
However, Aemulus does support mods in the Mod Compendium format.
Top
How do I extract game data?
This varies from game to game, so it's best to check the game's wiki page for specific directions. Generally, Atlus games use CRIWARE formats such as CPK and CVM. You can use PKGView to extract PKG files, and 7zip or UltraISO to extract ISO and CVM files. Use CriPakGUI for CPK files.
Top
How do I create my own mods?
Using the Mod Compendium (or Aemulus for P3FES/P4G/P5), click the New button and fill out the Title, Description, Version and Author of your mod.
You can then begin placing modded files in the mod's newly generated folder, matching the original game's file layout.

For example, if you were to replace CAMP.BIN from Persona 4, you'd put it in:
ModCompendium/Mods/Persona4/MODNAME/Data/DATA/INIT/CAMP.BIN.
Things to note:
The second "DATA" folder, in this case, is because it is found in the DATA.CVM file.

For Aemulus, it's a little different. You would include only the edited files from CAMP.BIN like so:
AemulusPackageManager/Packages/Persona 4 Golden/MODNAME/data_e/init/init/datMsg/datWeaponHelp.bmd.
Things to note:
1. This example differs a little (i.e. "data_e") due to Aemulus only supporting the PC version of Persona 4 Golden, which is structured differently than P4 PS2.
2. The contents of Aemulus mods go in the root of the mod folder rather than inside another "Data" folder.
3. The rest of the path is derived from the path of the edited file inside the .bin, which can be found using Amicitia. "datWeaponHelp.bmd" is inside a file called "init/datMsg.pak" inside "init.bin", thus the two "init" folders.
Top
How do I share my mods?
We prefer that you upload mods in Mod Compendium or Aemulus Package format and then share the link in the appropriate forum.
Gamebanana has several sections for Persona games, and an active userbase, so we recommend uploading there and then linking to the mod's page here. For mods bigger than 1GB such as music mods, use a filesharing site like MEGA or Google Drive.
Just select your mod's folder, e.g. ModCompendium/Mods/Persona5/MODNAME, right click it and compress it in a .zip file. This way, it's much lighter to upload and download than a full ISO or patch, is more legal, and makes it easy for everyone to organize and combine multiple mods.
Top

Persona 3&4 (PS2)

How do I run mods?
New Method:
You can use the HostFS Patch on PCSX2 to load changed files on the fly without ever repacking CVMs or your ISO. See here for more info.

Old Method:
Once you have used the Mod Compendium to generate new CVM and SLUS (executable) files, you need to use UltraISO Premium (paid software) to create a bootable ISO for PCSX2. Unfortunately, there are no other known programs that can reliably suffice. PowerISO should work fine for consoles, however.
Open your ISO and drag the replacement files onto the window to replace them, then save. For Persona 4, delete ZZZZZZ.BIN first to free up an extra 741 MB. This will prevent a very long hang that occurs when booting up an ISO that goes over the 4GB limit.
Top
What mods are possible?
- BGM swaps and replacements (using AtomENCD for ADX)
- Text edits (using PM1MessageScriptEditor for PM1 files, AtlusScriptCompiler for BMD)
- Voice edits (using using AtomENCD for ADX, PuyoTools for AFS, ACXTool for ACX)
- Font edits (using PersonaFont for FNT)
- Model/Texture edits and swaps (using Amicitia for RMD/PAC/TMX/SPR)
- Animation swaps (only for RMD files with the same skeleton, using Amicitia)
- Script Edits (using AtlusScriptCompiler for BF)
- Custom Animated Cutscenes (using DCMovieCreator for SFD)
Top
What limitations are there?
- There is no editor (yet) for TBL files, which contain sets of data for Personas, Skills, Items, Names etc.
- Custom animations and skeletons for models are not yet possible
- You cannot add new files to the game as our executable patcher does not support that (unless using the HostFS Patch)
- There is no event editor yet so all you can do is edit existing text
- No custom field object position editing yet (No triggers, entities, props etc)
- No custom EPLs yet
Top

Persona 5 (PS3)

How do I run mods?
For best results, use the European PKG version of the game (not all patches are supported for the ISO version or USA release due to differences).

If you're using the digital English version of the game (installed from a PKG), you need to use the Persona 5 Mod Loader. This adds support to the game for loading modded files from a new CPK called mod.cpk, which takes priority over the contents of all other CPKs. The Japanese release already has this thanks to bugfix updates (named patch3ps3.cpk).
- For RPCS3, place the downloaded patch.yml in the root folder of the emulator, replacing the existing one. Follow this guide for changing your PPU hash, if necessary.
- For PS3 hardware, use a CFW like Rebug and follow this guide on patching your EBOOT to support mod loading using patch.yml. Place your mod.cpk (and/or modded EBOOT if using CFW) in the game's USRDIR folder and start the game.
Top
What mods are possible?
- BGM/voice swaps and replacements (using AtomENCD for ADX, SonicAudioTools for ACB/AWB)
- Text and Script edits (using AtlusScriptCompiler for BMD/BF)
- Font edits (using PersonaFont for FNT)
- Model/Texture/Animation edits and swaps (using GFDStudio for GMD/GAP)
- TBL edits (using 010 Editor with our Binary Templates for now)
- Texture edits
- Custom bustups (using DDS2Tool)
- Event editing (using EVTTool)
- EPL Extraction/Injection (GMD only, no particles - using EPLInjector)
- Custom PLGs (vectorized UI elements) using io_plg
- Custom Animated Cutscenes (using Scaleform VideoEncoder)
- Custom dialog cutins (using P5 Cutin Tool)
Top
What limitations are there?

- No custom field object editing yet (No triggers, entities, etc)
- No custom EPLs (particles) yet
Top

Persona 5 Royal (PS4)

How do I run mods?
You need a HEN-compatible firmware (5.05 or 6.72) and a fake PKG of Persona 5 Royal (JP or CN). The English version is not dumpable yet. Install the PKG, dump the contents, and extract the CPKs by following the directions here.
Top
How do I create mods?
The latest Mod Compendium can auto-generate update PKG files for P5R JP on 6.72. You also have the option of doing this manually by creating a patch1R.cpk file with your changed files, placing it in the extracted update, generating a GP4 file with genGP4 and then a PKG using orbis-pub-cmd or orbis-pub-gen. Follow the directions here for more info on both methods.
Top
What limitations are there?
This is still being investigated as modding on PS4 is mostly brand new territory, and isn't as accessible to most modders. What is known, however, is that:
- Models use a new GFD version, and the animations are in a slightly new format with new types of keyframes. There is a fork of GFD Studio for converting them (for backporting purposes)
- The game is a lot pickier about custom materials so porting GMD mods from PS3 may result in graphical glitches
- A lot of scripts don't decompile yet due to new functions (which aren't mapped so they lack names like the original ones), but you can try this WIP Library for P5R. The GUI has also been updated to include P5R.
- Archives containing ADX files are encrypted. See here for more information
Top

PSVita

How do I play modded Vita games?
Currently, the only way to enjoy mods is with a PSVita or PSTV console with CFW. Fortunately, h-encore-2 makes it possible to get Henkaku on Firmwares as new as 3.65-3.72.
Top
I have Henkaku, now how do I install mods?
Follow this guide to set up Repatch, a plugin for modded Vitas that loads modded files (such as CPKs) from a custom folder.
Top

PC

How do I mod Persona 4 Golden on PC?
Use NR2_Unpacker to extract the PAC files in the game's installation directory.

To replace files at runtime, use ReloadedII and p4gpc.modloader (more info here) to read files from the "mods" folder in your P4G install directory. For example, to replace fc_01_01.AMD, the structure would look like: Day\mods\data00001\model\field\fc_01_01.AMD.
You can use the Mod Compendium's "PC Mode" to manage multiple mods easily, outputting them to a new folder each time you click Build. The structure for mod compendium files in a P4G PC mod would look like: Compendium\Mods\Persona4Golden\PC\P4D Models (PC)\Data\data00001\model\field\fc_01_01.AMD.

Or, to permanently replace files with modded ones in the PACs, use Pac Editor.exe. Open the form, drag the PAC containing the file you want to mod onto the EXE, and then drag your modded file. Finally, save as a new PAC. Replace your old PAC with the new PAC and you're Golden!
Top

3DS

How do I play modded 3DS games?
One way is to use Citra, a 3DS emulator. You can also follow this guide to get CFW on your 3DS. Be sure to enable game patching in the CFW settings and you'll be able to use layeredFS.
Top
If I use Citra, how do I mod my ROM?
Use DotNet3DSToolkit to extract and rebuild your CCI. Replace modded files (such as CPKs) before repacking.
Top

Switch

Will P5 Scramble modding be possible?
Maybe, although the game is developed by Koei Temco using the Three Houses engine. Most modding tools on this site are therefore completely ineffective for modding the game, and new ones would have to be made. It's theoretically possible since other KT games have been modded, but very difficult due to how the data is stored in large archives with no filenames.
Top
What about on PC? Shouldn't it be easier to mod?
No.
Top
Okay, what about Catherine Full Body?
That one uses CPKs and Atlus's usual file formats, so it should be just like modding anything else with LayeredFS. The "shader" CPK should have the highest priority if you wanted to repack that with your edited files. Also, it seems to use the exact same model format version as P5R.
Top

Other

Is there a Discord server?
Developers who are interested in helping create mods and tools can join TGE's private server by applying here. Note that membership is decided by his sole discretion, and is not guaranteed.
Anybody with reverse engineering experience is encouraged to apply!
Top
Do I need to credit you?
While credit to tool/mod authors is appreciated if you create content using our work (videos, mods of mods, forks/ports of our tools), it is all available for you to do whatever you want with.
Top
How can I support you?
We don't sell mods or software. Everything on this site is free to access, download and use. However, if you would like to help with hosting fees, you are more than welcome to do so.
Top