Bokasm

Bokasm

Description	Tools for extracting MFT files and (de)compiling bytecode of Boktai ROMs.
Target ROM	Boktai 1/2/3 (U and J)
Author	Raphi
License	MIT
Dependencies	Python 3
Released at	2024-01-02
Homepage	https://git.sr.ht/~raphi/bokasm
Download	https://git.sr.ht/~raphi/bokasm/archive/master.tar.gz

Note

Bokasm is obsolete and has been superseded by BokMagic.

Usage

Extract all MFT files from a ROM:

# This will extract everything into a GAMEID_data/ (in this case U3IJ_data) directory:
python3 -m bokasm.extract boktai_1_j.gba

# Add extra information to the disassembly:
python3 -m bokasm.extract boktai_1_j.gba --verbose --hexdump

Disassemble a single script:

python3 -m bokasm.disasm boktai_1_j.gba 0xe68e36

Assembling a single script:

# Create "script.bin" from "script.asm":
python3 -m bokasm.asm script.asm

# Assemble from stdin to stdout:
printf "return\ni32 0x777\nend" | python3 -m bokasm.asm | xxd

Injecting a modified script into a ROM. If you know what's good for you, the modified script should be the same size or smaller as the original script when assembled. Otherwise you'll corrupt the following script(s).

$EDITOR U3IE_data/scripts/1234.asm

# Create output.gba from original.gba
python3 -m tools.splice \
    --input path/to/original.gba \
    path/to/output.gba \
    U3IE_data \
    # Script ID to inject. You can also specify multiple IDs.
    1234