Curated game-data tables

At a glance

Where

TOML tables under data/gamedata/ (committed; no Sony bytes)

Crate

crates/gamedata (legaia_gamedata::Database) + the gamedata-tool CLI; needs no disc

Sources

Three GameFAQs walkthroughs (factual columns only) + Stann0x's music table

Confidence

Disc-checked wherever a disc record exists: prices, equip slots, accessory passives, enemy stats, spells, shop stock, casino prizes

Rendered on

Arts, Magic, Shops, Monsters, Music tracks

Why this exists

Reverse engineering yields raw records - an art's direction bytes, a spell's MP cost, a monster's stat block - but no names and no second source to check the numbers against. The curated tables supply both.

• Art records parsed from the disc get a name and a retail AP cost to check against.
• Item ids seen in cheat codes and inventory bytes resolve to display names.
• Spell records link to MP / element / target; monster records to location and drop tables.
• Boss stat blocks bracket the damage-formula work: predicted hits-to-kill must land inside the guide's numbers.

Source attribution

Only factual columns are committed - names, prices, command sequences, MP costs, locations, drop tables. Guide prose is copyrightable and is never reproduced; Sony-owned bytes stay out of the repo entirely.

Where the data lives

Implementation: crates/gamedata.

Schema · Arts

Each art carries a player-facing command (tokens Arms / Ra-Seru / High / Low) and a directions array of raw direction bytes - the prefix that appears in the on-disc art record. The mapping is per character because Noa is left-handed.

The action_constant field (0x1B..=0x32) joins the per-character art-name table in crates/art.

Schema · Magic

21 Seru spells and 8 Ra-Seru summons. element is one of eight lowercase values (fire … evil); target is single_enemy, all_enemies, single_ally, all_allies or self. Seru spells also carry absorb_lv1..3 - the percent chance a kill captures the Lv1 / Lv2 / Lv3 mist variant (Gimard 55/60/80, Gilium 1/1/1). Summons are egg-derived and have no absorb rate.

Magic levelling

Schema · Items, weapons, armor, accessories

Every row carries a stable snake_case key that the shop, casino, fishing and enemy tables reference. accessories.toml adds an effect_class (hp_max_pct, ap_accrual_pct, revive_once, elemental_def, …) - a structured re-encoding of the guide's effect text for the engine to dispatch on, and the field the disc's accessory passive index is checked against.

Schema · Enemies

Per enemy: name, location, optional element and boss, optional drop / steal keys, steal_chance, and the stat columns HP / MP / EXP / Gold / ATK / SPD / UDF / LDF / INT / AGL. The stats are the in-battle values the player fights, not the raw disc record - see cross-validation.

Schema · Shops

One [[shop]] per merchant, inventory as item keys. gamedata-tool shop <town> joins the keys against the four item tables and prints a priced inventory.

Schema · Casino + Muscle Dome

Schema · Sol Tower

sol_tower.toml is location-scoped: a per-floor map ([[floor]] with named sections) and side-quest chains ([[side_quest]] with ordered steps and reward pointers). scene_label = "town0d" ties it to the scene name map and the field-VM bundle.

Cross-validation

Disc-free rules run with cargo test -p legaia-gamedata; the disc-gated joins skip without extracted/SCUS_942.54. The disc is the tie-breaker.

Disc-free rules

• Every art's action_constant resolves to a name in crates/art; its direction bytes are in 1..=4 and equal the per-character mapping of its command tokens.
• AP costs match kind: regulars ≤ 36, hypers 30-70, supers 48-72, miracles 99; one Miracle Art per character.
• Magic has exactly 21 Seru + 8 Ra-Seru rows; every element is canonical.
• Every shop / prize / fishing / Muscle Dome / drop / steal key resolves to an item row.
• Armor slot ∈ {armor, helmet, shoes}; equip ∈ {Vahn, Noa, Gala, None}; item category ∈ {consumable, permanent_stat, key, art_book, fishing_lure}.

Disc-gated joins

The enemy join is the one with a twist: the curated stats are what the player fights, and retail boosts the disc record at battle load - UDF / LDF ×2, ATK ×5/4, INT ×9/8, HP / SPD / AGL unchanged - and scales rewards separately (EXP ×3/4, gold ×5/16). This international-vs-raw difficulty difference was first surfaced by Zetopheonix; the loader is on the battle page.

Library API

use legaia_gamedata::{Database, Character};

let db = Database::load();
for art in db.arts_for(Character::Vahn) {
    println!("{:?} {:>3} AP  {}", art.kind, art.ap, art.name);
}
let art = db.find_art_by_directions(Character::Vahn, &[1, 2, 4]).unwrap();   // Hyper Elbow
let ap = db.ap_cost_for_action(Character::Gala, 0x1B).unwrap();                // 99, Biron Rage
for entry in db.shop_inventory("Rim Elm", "Variety Shop").unwrap() {
    println!("  {:>20}  {:>5}G", entry.name, entry.price.unwrap_or(0));
}

CLI

From source: cargo run -p legaia-gamedata --bin gamedata-tool -- <subcommand>.

How this helps the reverse engineering

How we know

See also