Decompile

Convert BF and BMD into flowscripts and messagescripts

As previously mentioned, AtlusScriptCompiler can decompile .BF and .BMD into .FLOW and .MSG respectively. This allows us to view scripts in plain text and edit to our liking.

1. Specifying the Input File

First, you must tell the program what file we're working with. For decompiling, this must be a .BF or .BMD file.

C:\Users\Username>"C:\Path\To\AtlusScriptCompiler.exe" "C:\Path\To\input.bmd"

You can simply drag AtlusScriptCompiler.exe and then input.bmd onto the command prompt window. This will automatically wrap each paths in quotes, which keeps arguments separate in case your paths contain spaces.‌

2. Specify that you are Decompiling

Now, let's tell the program what to do with that file. Add -Decompile, separated by a space.

C:\Users\Username>"C:\Path\To\AtlusScriptCompiler.exe" "C:\Path\To\input.bmd" -Decompile

2. Specifying the Library

A Flowscript Library instructs the compiler on function names and parameters. In order to work with the input file, you have to tell the compiler which Library to use with -Library.

C:\Users\Username>"C:\Path\To\AtlusScriptCompiler.exe" "C:\Path\To\input.bmd" -Decompile -Library P5

Included Libraries

Library Name	Usage
DigitalDevilSaga	-LibraryDDS
Nocturne	-LibrarySMT3
Persona3	-LibraryP3
Persona3FES	-LibraryP3FES
Persona3Portable	-LibraryP3P
Persona4	-LibraryP4
Persona4Golden	-LibraryP4G
Persona5	-LibraryP5
Persona5Royal	-LibraryP5R
PersonaQ2	-LibraryPQ2

Not all games have libraries available. Knowledge of reverse engineering game executables is required to generate a library, as you'll have to find the offsets of function signatures yourself. A sample script for dumping that data from P3/P4 (PS2) can be seen here.‌‌

3. Specifying Encoding

‌An Encoding can be specified using -Encoding. It lets the compiler know what set of characters to use.

C:\Users\Username>"C:\Path\To\AtlusScriptCompiler.exe" "C:\Path\To\input.bmd" =Decompile -Library P5 -Encoding P5

Encodings

Game Name	Usage
Persona 5	-EncodingP5
Persona 4	-EncodingP4
Persona 3 (FES)	-EncodingP3
PersonaQ(2) or any game using Shift-JIS/CP932	-EncodingSJ‌

5. Specifying the Output File

‌Finally, you can name the Output File using -Out.

C:\Users\Username>"C:\Path\To\AtlusScriptCompiler.exe" "C:\Path\To\input.bmd" -Decompile -Library P5 -Encoding P5 -Out "C:\Path\To\output.msg"

If -Out is not specified, it will default to the input filename and folder, but with the output filetype appended. In this case, that would be C:\Path\To\input.bmd.msg.‌

Conclusion

At this point, you can press Enterto begin decompiling.

To learn how to put a new or edited script back in the game, keep reading.

Compile