Adding New Music
Tools You’ll Need
Section titled “Tools You’ll Need”- Phos Music Manager
- AtomEncd
- (For P5R) This script for encrypting ADX files
- (If unpacking/repacking AWB) Sonic Audio Tools
Introduction
Section titled “Introduction”Music addition (new songs not replacing any existing songs) is possible for the PC releases of P3P, P4G, and P5R using the BGME Framework. To add new music, this mod must be downloaded and set as a dependency for your mod.
Additional documentation on BGME can be found here.
Adding New Music
Section titled “Adding New Music”There are two main ways to add new music in Persona games.
- Phos Music Manager is a music manager designed to simplify music replacement or addition in Persona 3 Portable (PC), Persona 4 Golden (PC x64), and Persona 5 Royal (PC). It automatically handles all steps needed to encode and export music.
- If you would rather manually add new music files, AtomEncd should be used instead.
Adding New Music Files
Section titled “Adding New Music Files”More detailed documentation on the Phos Music Manager can be found here.
To add new music files to your project, click on the + icon next to the Build button.
A popup will open where you can enter details about the new song you are adding.
- Name: the name of the track
- Category (optional): the category shown in caps (ex: Regular Battles, Events, etc.). This is purely for organizational purposes.
- Tags (optional): any tags to more clearly detail what the track is for (ex: Normal, Results Screen, etc.). This is purely for organizational purposes.
- Output Path: the file path of the exported file.
- Encoder: the encoder that should be used for the exported file.
The output path and encoder depend on the game being modded.
Output Path
Section titled “Output Path”The output path should be set to FEmulator/AWB/snd00_bgm.awb/songID.hca, where songID.hca is the ID of the new track you are adding. Use IDs ranging from 678 up to 835 for new music.
If you want your mod to be compatible with existing BGME music mods, make sure to check what IDs those mods are using. Music Enhancement Pack uses IDs 679-692, Anime Music Expansion uses IDs 775-821, and Restored Game Over Music uses ID 774.
Encoder
Section titled “Encoder”The encoder should be set to HCA.
Output Path
Section titled “Output Path”The output path should be set to FEmulator/AWB/BGM_42.AWB/songID.ADX, where songID.ADX is the ID of the new track you are adding. Use IDs ranging from 0 up to 9999 for new music.
Encoder
Section titled “Encoder”The encoder should be set to ADX (Persona 5 Royal PC). If you do not have this option, follow this to install it.
Output Path
Section titled “Output Path”The output path should be set to P5REssentials\CPK\Phos Music Manager\data\sound\bgm\songID.ADX, where songID.ADX is the ID of the new track you are adding. Any new ID up to 99999999999 is supported.
Using IDs larger than 1000 is recommended to avoid crashes.
Encoder
Section titled “Encoder”The encoder should be set to ADX.
Encoding Music
Section titled “Encoding Music”Follow the process to replace audio using AtomEncd.
Adding Music to your Mod
Section titled “Adding Music to your Mod”Audio files should be placed in the proper directory depending on what game you are modding.
Place your audio file in FEmulator/AWB/snd00_bgm.awb/songID.hca, where songID.hca is the ID of the new track you are adding. Use IDs ranging from 678 up to 835 for new music.
If you want your mod to be compatible with existing BGME music mods, make sure to check what IDs those mods are using. Music Enhancement Pack uses IDs 679-692, Anime Music Expansion uses IDs 775-821, and Restored Game Over Music uses ID 774.
Place your audio file in FEmulator/AWB/BGM_42.AWB/songID.ADX, where songID.ADX is the ID of the new track you are adding. Use IDs ranging from 0 up to 9999 for new music.
Place your audio file in P5REssentials\CPK\Phos Music Manager\data\sound\bgm\songID.ADX, where songID.ADX is the ID of the new track you are adding. Any new ID up to 99999999999 is supported.
Using IDs larger than 1000 is recommended to avoid crashes.
Using New Music
Section titled “Using New Music”New music can be used right away in events and flowscript by calling their IDs. To change battle music using BGME, follow the guide here.