Command Line Interface

Command-Line Interface

FEBuilderGBA provides a cross-platform CLI (FEBuilderGBA.CLI) for automation and scripting.

Basic Usage

FEBuilderGBA.CLI [options]

Commands

Information

--version              # Show application version
--help                 # Show help message

ROM Operations

--rom=rom.gba --lint              # Run lint validation
--rom=rom.gba --rebuild           # Rebuild/defragment ROM
--rom=rom.gba --makeups           # Create UPS patch
--rom=rom.gba --applyups=patch.ups  # Apply UPS patch

Text Export/Import

# Export all text to TSV
--rom=rom.gba --translate --out=texts.tsv

# Import text from TSV
--rom=rom.gba --translate --in=texts.tsv

# Validate round-trip (exit 0=lossless, 2=mismatches)
--translate-roundtrip --rom=rom.gba

Struct Data Export/Import

# Export a single table
--export-data --rom=rom.gba --table=units --out=units.tsv

# Export all tables
--export-data --rom=rom.gba --table=all --out=data

# Import data
--import-data --rom=rom.gba --table=units --in=units.tsv

# Validate round-trip
--data-roundtrip --rom=rom.gba --table=all

Available Tables

units, classes, items, portraits, sound_room, sound_boss_bgm, support_units, support_talks, support_attributes, event_haiku, event_battle_talk, event_force_sortie, worldmap_points, worldmap_paths, worldmap_bgm, map_settings, link_arena_deny, cc_branch, menu_definitions, item_weapon_triangle, map_exit_points, ai_map_settings, ai_perform_items, ai_perform_staff, ai_steal_items, ai_targets, generic_enemy_portraits, status_options, ed_retreat, ed_epithet, ed_epilogue_a, ed_epilogue_b, ed_epilogue_c, op_class_demo, op_class_font, op_prologue, class_alpha_names, summon_units, summons_demon_king, monster_probability

Graphics

--decreasecolor --in=input.png --out=output.png [--noScale] [--noReserve1stColor] [--ignoreTSA]

Other

--rom=rom.gba --disasm [params]          # Disassembly
--rom=rom.gba --pointercalc=0x12345      # Pointer calculation
--rom=rom.gba --songexchange             # Song data exchange
--rom=rom.gba --convertmap1picture       # Convert map to image