# Persona 3 FES (PS2) Mod Support

## Background

{% hint style="info" %}
The original version of **Persona 3 FES** has been around as long as the modding scene, so there is a decent amount of mods available. However, with the upcoming port of **Persona 3 Portable** on PC/Switch, you may notice a community effort to shift focus to that version. Many mods are **not** directly compatible due to substantial differences between P3FES and P3P.
{% endhint %}

Persona 3 FES is a 2006 turn-based JRPG released by Atlus on PS2. The game features dungeon crawling and life-sim elements. Combat is mainly based on summoning and fusing a party of Personas with different elemental affinities.

There is [a 2009 re-release](https://docs.shrinefox.com/getting-started/persona-3-portable-psp-mod-support) featuring many quality of life improvements (although with the removal of anime cutscenes and 3d fields/events) and a new female protagonist. A new port to PC Switch will release in January 2023.

## Modded PS2 Console

{% hint style="danger" %}
Missing info:

* How to mod a PS2 console
* How to launch modded .ISOs
  {% endhint %}

## Custom Firmware PS3 Console

{% hint style="danger" %}
Missing info:

* How to mod a PS3 console
* How to launch modded PS2 .ISOs
  {% endhint %}

## HEN on PS4 Console

If you have a moddable PS4, it's possible to create and install custom PS2 titles, including modded games. Please note that this requires use of the paid software UltraISO. You're also welcome to try equivalent, free .ISO creation tools to see if they work.

{% hint style="warning" %}
These games will only be usable while in "HEN" mode, which you will lose access to if you update the system firmware. Also, due to these titles being illegitimate, there is always a possible account/console ban risk.
{% endhint %}

1. Obtain an .ISO of the game. For detailed instructions on dumping your own game as an .ISO, see [this wiki page](https://emulation.gametechwiki.com/index.php/Ripping_games#Sony_PlayStation_1/2).
2. Follow the [Persona 5 Royal (PS4) Mod Support](https://docs.shrinefox.com/getting-started/persona-5-royal-ps4-mod-support) page up until the "Adding Mod Support" section to get HEN running on your moddable PS4.
3. Download the latest release of the [Mod Compendium](https://github.com/tge-was-taken/Mod-Compendium/releases).
4. Extract it somewhere on your PC [using 7-zip](https://www.7-zip.org/).
5. Choose **Persona 3 FES** in the games dropdown, and click the Settings button.
6. Provide the path to your ISO and the output path.
7. Download any mods you want from [ShrineFox.com/Browse](https://shrinefox.com/browse?game=P4\&type=Mod). Extract them to the Mod Compendium's "Mods" folder.
8. In the Mod Compendium, click the checkboxes next to each mod to enable them, and sort their priority with the up/down arrows on the right.
9. Click Build and a new set of .CVM files and a new executable will be output.
10. Manually replace these files by dragging them in the ISO and saving as a new ISO using UltraISO Premium (paid software).
11. Create a .PKG from your new .ISO using [PS4 PS2 Classics GUI](https://github.com/xXxTheDarkprogramerxXx/PS3Tools/releases/tag/PS4-PS2-Classics-Release\(AppVoyer\)).
12. Install the .PKG using the same steps found at the end of the [Persona 5 Royal (PS4) Mod Support](https://docs.shrinefox.com/getting-started/persona-5-royal-ps4-mod-support) page.
13. Run the game to ensure that it works!

## PCSX2 Emulator

{% hint style="warning" %}
Consider reading [this more up-to-date guide](https://gamebanana.com/tuts/15959) on getting set up with mods on PC or Steam Deck.
{% endhint %}

You can run this version of the game on PC using the **PCSX2 emulator**.

### Setting Up PCSX2

1. Download the [latest release](https://pcsx2.net/downloads/) for your platform.
2. Extract the .zip anywhere on your PC using [7-zip](https://www.7-zip.org/).
3. Download any [PS2 Firmware](https://www.mediafire.com/file/edp636rbtb77hk7/PS2_BIOS.zip) and install in PCSX2 during setup.
4. Obtain a .ISO of the game.
5. Launch the game to make sure it works!

For detailed instructions on dumping your own game as an .ISO, see [this wiki page](https://emulation.gametechwiki.com/index.php/Ripping_games#Sony_PlayStation_1/2).

### Patching the Game

In order to load modded files, you need to patch the executable of the game to look for them in an external directory. This patch is known as HostFS.

1. Go to ShrineFox.com's [Getting Started Page](https://shrinefox.com/GetStarted?platform=PS2\&game=P3FES\&region=USA).
2. Follow the instructions on the page to enter the game's CRC hash.
3. Enable any optional patches you'd like.
4. Download the .pnach file.
5. Close PCSX2. Place the .pnach in the folder called "**cheats**" next to PCSX2.exe.
6. Open the **PCSX2\_vm.ini** file in the PCSX2 folder with your text editor. \
   Change the line hostFS=disabled to **hostFS=enabled** then save and exit.
7. Make sure to check **on** the option **File > Enable Cheats** in PCSX2.
8. Open the game's .ISO with [7-zip](https://www.7-zip.org/). Extract the executable file, which should look like "SLUS\_216.21". Add the .ELF extension to it, which should give it the name "SLUS\_216.21.ELF."
9. Run the .ELF in PCSX2 to check if it works!

{% hint style="success" %}
An easy way to check if patches are working is to include the **Debug Log** patch and check if files are logged to the PCSX2 console as the game loads them. To view the console, go to **Misc > Show Console.**
{% endhint %}

## Installing Mods

To use community-made mods, or to eventually create your own, you'll need a mod manager.

1. Download the [latest release](https://github.com/TekkaGB/AemulusModManager/releases) of Aemulus Package Manager.
2. Extract it somewhere on your PC [using 7-zip](https://www.7-zip.org/).
3. Choose **Persona 3 FES** in the games dropdown, and click the Settings button.\
   The output path should be where your extracted .ELF file is for PCSX2.
4. Click on **Extract Original Files** in order to improve mod merging.

You can switch to the **GameBanana tab** to download community-submitted mods directly from the website. Enable them with the checkboxes and re-order their priority as desired.

Fill out the settings in Aemulus to point to the directory containing your extracted .ELF. \
Click **Build** and test it out in-game!

{% hint style="warning" %}
**Note:** If you're not using PCSX2/HostFS mode, you must use the merged output files from Aemulus in a new Mod Compendium mod. When built with the Mod Compendium, files will be output as new .CVM and a new executable. You must manually replace these files by dragging them in the ISO and saving as a new ISO using UltraISO Premium (paid software).
{% endhint %}

## Extracting Files

If you are looking to create your own mods for this game, you will want a full dump of all the game's original, unedited files.

{% hint style="info" %}
Persona 4 utilizes CriWare's .CVM archive format to store its individual files. You can think of it somewhat like a .zip file that contains the directory structure, but offers compression.
{% endhint %}

Open the game's .ISO with [7-zip](https://www.7-zip.org/). Click on each .CVM file and extract its contents to a file named after the CVM (i.e. DATA, BTL, BGM).

## Creating Mods

To begin exploring the files and learning how to edit them, see the [Persona 3 FES page](https://amicitia.miraheze.org/wiki/Persona_3) on the [Amicitia Wiki](https://shrinefox.com/wiki). Once you have an idea for a mod, open the **Aemulus Package Manager** and click on the **New** button. Fill out the form and it will create a mod folder for you.

Inside the mod folder, **match the structure** of the extracted .CVM contents. For instance, if you're editing a file in the DATA.CVM's /INIT/ folder, copy the unedited one from your .CVM dump to your mod folder and place it in a DATA/INIT/ folder.
