Releases: ShrineFox/BustupEditor
BustupEditor v2.1.2
- Add searchbox (search by character name, expression name, outfit name)
- Add paste with replacement images option (separate in case you only want to copy/paste the other parameters)
- Check if replacement images exist before creating bustup .BINs
BustupEditor v2.1.1
- Override mouth/eye preview with replacement frames
BustupEditor v2.1
- Fix extracting bustups for P5 PS3
-- Doesn't auto-combine or repack P5 PS3 bustups yet
-- Doesn't support P5 PS4 bustups yet - Add individual paths for bustup images to project
-- This allows you to create custom bins even without ever having to unpack existing bustup bins - Adds editable character, outfit, and expression name fields (for easier labelling)
-- Changing the character name for one bustup entry will change it for all entries with a matching MajorID.
-- You can optionally apply outfit/expression names for the selected entry to all of a character's entries with matching IDs. - Adds "New Project" button that lets you load a default P5 PS3 or P5R event/navi project
-- Uses names from the Amicitia Wiki. Only P5R stuff is named at the moment.
-- This way, you never have to load the game's files or identify bustup entries yourself in order to get started. - Adds (EXTREMELY WIP) "convert to navi project" option
-- It doesn't seem to match them up quite right yet, and I still need to make sure they're properly scaled to 4x4 dimensions so that the game doesn't crash. But it's a start.
BustupEditor Initial Release
BustupEditor
You can use this GUI to extract & repack DDS images from bustup .BIN files found in Persona 5 Royal (PC/Switch).
Previously known as BustupParamEditorGUI. See older releases for versions that worked with Persona 5 (PS3).
Features
- Import a .DAT file and it will automatically extract all nearby Bustup .BIN files (if present).
- Add/remove bustup parameter entries, reposition eye/mouth frames, change animation style, and preview animation frames.
- Export a new .DAT file (and automatically repack extracted .BINs if found).
- Save/load projects as .json so you can resume editing where you left off.
- Set a name for a selected bustup parameter entries so you can easily find it in the list.
- Copy the selected bustup entry's parameters, and Paste to apply positional offsets to all selected list entries.
How to Use
- Use CriFSLibGUI to extract the contents from CPK files in
Steam\steamapps\common\P5R\CPK. - Extract the latest Release and run
BustupEditor.exe.
Editing Dialog Portrait Bustups
- Click on
File>Import. - Navigate to
BASE.CPK_unpacked\BUSTUP\DATAand chooseBUSTUP_PARAM.DAT.
(If you only want to edit position/entry data and not unpack/repack bustups, move this file out of the folder first). - Select the entry that you want to edit in the list. Right click and choose
Open Image Folder. - Use a program that can edit DDS files (such as Paint.NET) to edit and replace the images.
- Re-select the entry in the program to reload the image preview.
- Change the selected eye/mouth frame number in the bottom right to preview blinking/talking.
- Use the offset options on the bottom left to re-align the eyes and mouth if needed.
- Click on
File>Exportto choose a new location to save your modified.DATto.
(If you don't want to repack all bustups, which can take awhile, remove all but your edited ones from theExtractedfolder).
Editing Navigator Bustups
Same as above, but import BASE.CPK_unpacked\FONT\ASSIST\MSGASSISTBUSTUPPARAM.DAT instead.
Future Plans
- Reimplement support for the PS3 version of Persona 5.
- Support for bustup .BINs containing GNF (PS4).
BustupParamEditorGUI v1.0
- Thanks to zarroboogs, you can now change how bustups animate when they appear in-game.
- This version of the program uses the character, expression, and outfit IDs of each parameter entry to create a list of bustups, so custom bustups with unique ids can be created and extracted.
- You can now add custom bustup parameter entries thanks to the above change.
- You can rename the ids of existing bustup entries and create .bins for them if they don't already have one.
- The program will try to recover the last paths for bustup parameters and .bins that you used on startup.
BustupParamEditorGUI 0.9
This program shares features between previous projects DDS2Tool and BustupParamEditor.
By specifying a path to either bustup_param.dat (found in ps3.cpk\bustup\data)
or msgAssistBustupParam.dat (data.cpk\font\assist) and selecting a bustup,
you can change the values for X and Y positioning of the mouth, eyes, or the entire bustup itself.
Features
- Provide a path to your corresponding folder of bustup .BIN files to automatically extract the DDS images.
- Extracted DDS files are automatically converted to PNG.
- Preview the bustup parameters in real time while editing the positional values.
- Flip between animation frames for the mouth and eyes in the preview.
- Edit the extracted images and even repack them into a new .BIN file when you're satisfied.
- Quickly copy and paste positional values between bustups using the Edit menu.
Disclaimers
Be sure to make copies of the original files before using this program!
Changes are saved directly to the selected BIN files and cannot be undone.
You have to edit the combined PNG files to preview custom bustup images in the program. (The preview doesn't use the uncombined DDS images).
You must save over the original DDS files with your edits if you want to repack your custom bustup as a BIN. (The PNG files do not get converted back to DDS or repacked into the BIN.)
Known Bugs With This Version
- While editing the "Assist" bustup parameters, changes to Mouth Position Y do not yet get saved properly.


