ff9mapkit 1.0.0b3__py3-none-any.whl

ff9mapkit/data/provenance/manifest.json

@@ -0,0 +1,65 @@
+{
+  "_note": "ff9mapkit ships NO Final Fantasy IX game data. These entries describe how to regenerate the small set of base assets the kit needs from YOUR OWN install via `ff9mapkit extract-templates`. The .patch files contain only our edits + copy offsets (never game bytes). See docs/PROVENANCE.md.",
+  "blank": {
+    "source_fbg": "fbg_n11_ldbm_map203_lb_hng_0",
+    "patch": "blank.{lang}.patch",
+    "sha256": {
+      "us": "2289085a5dc1030d8cd1541619e34a0bd722a0957d0849bfaf077c7e30e90452",
+      "uk": "2289085a5dc1030d8cd1541619e34a0bd722a0957d0849bfaf077c7e30e90452",
+      "fr": "b06d7768c8485ee4c48443e2384730a0d447d2af8e84d87a20a3ee2a23c45f6b",
+      "gr": "5676ef381393767a4fef715cdfe1eca947fef10b1d0ec80dd247a0301fa66a34",
+      "it": "d968b0d1bafe3b2c60ee02c91a435986f71c23b4afb1e78fa65a67294c5b290b",
+      "es": "eb6ac7333a273333b9d7e296408a2cfad41b059acd06679c3fb2a50b815234ac",
+      "jp": "e5595df0fcd0685bf8702b2286ac28bc0f8c54169e4c881e61ff5c0ec09c1219"
+    }
+  },
+  "region_template": {
+    "source_fbg": "fbg_n01_alxt_map031_at_wpn_0",
+    "lang": "us",
+    "patch": "region_template.patch",
+    "sha256": "c170b2664771d697c0dbfd728c306e3c2059695ce4eb68e8f1dcf0f0c1e3e914"
+  },
+  "fixtures": {
+    "alex100-us.eb.bytes": {
+      "source_fbg": "fbg_n01_alxt_map016_at_msa_0",
+      "kind": "event_with_gateway",
+      "lang": "us",
+      "gateway": {
+        "target": 4000,
+        "entrance": 0,
+        "zone": [
+          [
+            -700,
+            2200
+          ],
+          [
+            200,
+            2200
+          ],
+          [
+            200,
+            3400
+          ],
+          [
+            -700,
+            3400
+          ]
+        ]
+      },
+      "sha256": "015258162cc8d28afc3b025d7b06037d1cead63778c611acc2cb834e26b70076"
+    },
+    "grgr.bgx": {
+      "source_fbg": "fbg_n21_grgr_map420_gr_cen_0",
+      "kind": "camera_bgx",
+      "sha256": "2d6acbd6963514b41eb0103fc885a113a59af7b9d2fc57eb43324c9d955d48ab"
+    },
+    "multifloor.bgi.bytes": {
+      "source_fbg": "fbg_n00_tshp_map008_th_upr_0",
+      "kind": "walkmesh_verbatim",
+      "sha256": "ec6bc267950284ccf68adfd531ff923b42eb2aef90e603e53e463afd8a99fd18"
+    }
+  },
+  "goldens": {
+    "EVT_HUT_INT.eb.bytes/us": "d23b507fdf75d12d8bf6762b0a4d834da61beab83cfd31c0df97f443fe533513"
+  }
+}

ff9mapkit/data/provenance/region_template.patch

@@ -0,0 +1 @@
+{"src_sha256": "136694da842d4ec61a48268cad65c6d4664b8216ea95a3447f9933029601743d", "out_len": 272, "out_sha256": "c170b2664771d697c0dbfd728c306e3c2059695ce4eb68e8f1dcf0f0c1e3e914", "insert_bytes": 5, "ops": [["c", 21732, 104], ["i", "6700"], ["c", 21838, 4], ["i", "6700"], ["c", 21844, 157], ["i", "67"], ["c", 22015, 2]]}

ff9mapkit/data/reference_arcs.toml

@@ -0,0 +1,89 @@
+# FF9 reference arc -- the DISC 1 STORY SPINE, laid out as a chain of forkable arcs / REGIONS.
+#
+# DUAL USE: each [[arc]] below is a forkable FF9 REGION. The GUI's "Browse FF9 regions…" catalog (Import tab,
+# or Ctrl-K "Fork FF9 regions") reads this table to fork a region as a campaign -- pick one, or several to
+# compose into one. The CLI `reference-arcs` instead chains the same arcs into a multi-campaign journeys.toml.
+#
+# This is the north-star planning + fork-and-test harness (CLAUDE.md "fork FIDELITY, not a release"):
+# each [[arc]] below is ONE campaign you produce with `import-chain <seed> --verbatim`, and the arcs chain
+# in order as a multi-campaign JOURNEY. The loop is: fork an arc -> deploy the journey -> walk it -> ask
+# "does it play identically?" -> refine -> move to the next arc. It is NOT a one-click rebuild of FF9 (the
+# world map is unmoddable and the narrative-state layer is the weak axis -- docs/FORK_FIDELITY.md).
+#
+# Seeds are drafted from reference/field-manifest.tsv + the in-game-proven import-chain seeds. EDIT freely
+# (this is YOUR game knowledge): correct a `seed`, add an optional `zone = "<FBG token>"` to widen the fork
+# past the seed's own zone, or add `beat = <ScenarioCounter>` to seed an arc's story state on entry.
+
+title = "FF9 -- Disc 1 spine"
+
+[[arc]]
+key = "alexandria"
+name = "Alexandria / Prima Vista"
+seed = 100
+note = "The opening: the Tantalus play, kidnapping Garnet, the escape from Alexandria. (Prima Vista = 50.)"
+
+[[arc]]
+key = "evil_forest"
+name = "Evil Forest"
+seed = 250
+note = "The crash-landing, Blank, the petrification -- the party first comes together. (seed = ef_ent, the forest ENTRANCE; field 152/ef_fr6 is an isolated cutscene screen.)"
+
+[[arc]]
+key = "ice_cavern"
+name = "Ice Cavern"
+seed = 300
+note = "Through the Ice Cavern to the world map. PROVEN forkable (the 300 -> Outside 312 arc, in-game proven)."
+
+[[arc]]
+key = "dali"
+name = "Dali"
+seed = 350
+note = "Dali village + the underground black-mage production line. PROVEN forkable (Dali Inn / Weapon Shop)."
+
+[[arc]]
+key = "cargo_ship"
+name = "Cargo Ship"
+seed = 507
+note = "The cargo ship out of Dali toward Lindblum. (seed = ca_dck_0, the walkable deck; field 500/ca_dck_1 is an isolated cutscene variant.)"
+
+[[arc]]
+key = "lindblum"
+name = "Lindblum"
+seed = 550
+note = "Lindblum: the Festival of the Hunt and Lindblum Castle. (--whole-zone forks the whole ldbm zone, ~70 screens across discs; Lindblum CASTLE is its own zone -- add it as a separate arc if you want it.)"
+
+[[arc]]
+key = "gizamaluke"
+name = "Gizamaluke's Grotto"
+seed = 701
+note = "The grotto guardian and the broken bell gate, on the road to Burmecia."
+
+[[arc]]
+key = "burmecia"
+name = "Burmecia"
+seed = 750
+note = "The rain-ruined kingdom of Burmecia; the first encounter with Beatrix."
+
+[[arc]]
+key = "south_gate"
+name = "South Gate"
+seed = 800
+note = "The South Gate / Bohden Station road (North Gate = 851)."
+
+[[arc]]
+key = "treno"
+name = "Treno"
+seed = 1908
+note = "The City of Nobles: the auction house, Queen Stella's cards, Dr. Tot's tower. (seed = tr_gat, the city gate; field 916/tr_whf is an isolated screen.)"
+
+[[arc]]
+key = "gargan_roo"
+name = "Gargan Roo"
+seed = 950
+note = "The gargant tunnel linking the Treno region to Cleyra."
+
+[[arc]]
+key = "cleyra"
+name = "Cleyra"
+seed = 1000
+note = "The sandstorm-shrouded sanctuary and Alexandria's attack -- the disc-1 climax."