Normalize code style to match established conventions

An assistant-written stretch of code had drifted from the conventions the
older hand-written files establish. Sweeps the whole of src/ back into line.

Systematic:
- @returns -> @return (163 occurrences, 84 files). Concentrated in ui/ and
  rpg/cutscene/; the rest of the tree already used @return 646 times.
- Lowercase "null" -> "NULL" in assert/error message strings (170
  occurrences, 28 files), matching the dominant 441-use spelling. Covers
  "cannot be null", "must not be null" and adjectival uses.

Localized:
- sort.c: drop a stray #include <stdlib.h> that sat *above* the copyright
  header, leaving it the only file in the repo without a leading header
  block. Also drops the same redundant include from random.c and npcturn.c
  (dusk.h already pulls in stdlib.h).
- Convert 7 files' license headers from // lines to the /** */ block form.
- cutscenesystem.c: memset -> memoryZero, matching the identical call ~20
  lines further down and the rest of the codebase.
- Struct tags suffixed _t -> _s: threadlock_t -> threadmutex_s (which also
  makes the tag match its typedef) and chunkpos_t -> chunkpos_s.
- Convert 20 inline /* */ block comments to // across the mesh builders,
  assetfile.c and assetlocaleloader.c.
- Pointer truthiness if(!ptr) -> if(ptr == NULL) in 16 places, matching the
  267 existing explicit comparisons. Boolean !x checks are left alone.
- entityanim.h: drop a JSDoc-style type annotation from an @return.
- Document easing.h's 16 undeclared easing functions and
  assetjsonloader.h's 3 loader callbacks.

No behavioral change. Builds clean with no new warnings; ctest shows the
same 6 pre-existing failures as HEAD, verified against a pristine worktree.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>

assets/battle/moves.jsonc

@@ -1,21 +0,0 @@
-{
-  "moves": {
-    "fire": {
-      // Target flags
-      "enemies": true,
-      "allies": true,
-      "multiple": false,
-      "self": true,
-      "default": "enemy",
-      "target": "SINGLE_ENEMY"
-    },
-
-    "slash": {
-      "enemies": true,
-      "allies": true,
-      "self": false,
-      "default": "enemy",
-      "target": "SINGLE_ENEMY"
-    }
-  }
-}

assets/cutscenes/battle/moves/fire.jsonc

@@ -1,21 +0,0 @@
-{
-  "items": [
-    {
-      "type": "MODAL",
-      "title": "Fire",
-      "message": "A burst of flame scorches the target."
-    },
-    {
-      "type": "WAIT",
-      "seconds": 2
-    },
-    {
-      "type": "MODAL_CLOSE"
-    },
-    {
-      "type": "BATTLE_FIGHTER_DAMAGE",
-      "fighter": "target",
-      "amount": 12
-    }
-  ]
-}

assets/cutscenes/battle/moves/slash.jsonc

@@ -1,21 +0,0 @@
-{
-  "items": [
-    {
-      "type": "MODAL",
-      "title": "Slash",
-      "message": "A quick blade strike cuts across the target."
-    },
-    {
-      "type": "WAIT",
-      "seconds": 2
-    },
-    {
-      "type": "MODAL_CLOSE"
-    },
-    {
-      "type": "BATTLE_FIGHTER_DAMAGE",
-      "fighter": "target",
-      "amount": 8
-    }
-  ]
-}

assets/cutscenes/battletest.jsonc

@@ -1,18 +0,0 @@
-{
-  "items": [
-    {
-      "type": "BATTLE_START",
-      "enemies": [
-        {
-          "attack": 8, "defense": 4, "magic": 0, "speed": 5, "luck": 2,
-          "healthMax": 30, "mpMax": 0,
-          "abilities": ["fire"]
-        },
-        {
-          "attack": 6, "defense": 3, "magic": 0, "speed": 7, "luck": 2,
-          "healthMax": 20, "mpMax": 0
-        }
-      ]
-    }
-  ]
-}

assets/cutscenes/initial.jsonc

@@ -62,7 +62,7 @@
     },
     {
       "type": "CUTSCENE",
-      "name": "cutscenes/main_menu.jsonc"
+      "name": "main_menu"
     }
   ]
 }

assets/cutscenes/new_game.jsonc

@@ -1,11 +0,0 @@
-{
-  // Placeholder for the new-game intro flow - just shows a modal for now.
-  "items": [
-    {
-      "type": "MODAL",
-      "title": "New Game",
-      "message": "This is a placeholder for the new game intro.",
-      "blocking": true
-    }
-  ]
-}

assets/items/items.jsonc

@@ -1,7 +0,0 @@
-{
-  "items": {
-    "potion": { "type": "MEDICINE" },
-    "potato": { "type": "FOOD" },
-    "apple": { "type": "FOOD" }
-  }
-}

assets/locale/en_US.po

@@ -73,12 +73,6 @@ msgstr "Select Save"
 msgid "ui.select_save.empty"
 msgstr "Empty Slot"
 
-msgid "ui.select_save.corrupt"
-msgstr "Corrupted Save"
-
-msgid "ui.select_save.corrupt_warning"
-msgstr "This save file is corrupted and could not be loaded. Please contact support if this issue persists."
-
 msgid "ui.select_save.slot_format"
 msgstr "%s  Lv.%d  %s"
 
@@ -266,10 +260,6 @@ msgstr "loading"
 msgid "ui.autosave.saving"
 msgstr "SAVING"
 
-
-#
-# Items
-#
 msgid "item.potion.name"
 msgstr "Potion"
 
@@ -278,12 +268,3 @@ msgstr "Potato"
 
 msgid "item.apple.name"
 msgstr "Apple"
-
-#
-# Moves
-#
-msgid "move.fire.name"
-msgstr "Fire"
-
-msgid "move.slash.name"
-msgstr "Slash"

assets/maps/overworld/chunks/chunk_-1_0_0.json

@@ -1 +0,0 @@
-{"meshes":[{"file":"house_4_4.dmf","pos":[2,1,0]},{"file":"house_6_3.dmf","pos":[1,9,0]},{"file":"house_2_2.dmf","pos":[12,6,0]}],"tiles":[[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0]]}

assets/maps/overworld/chunks/chunk_0_0_0.json

@@ -1 +0,0 @@
-{"tiles":[[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[6,0],[2,0],[2,0],[2,0],[2,0],[2,0],[2,0],[7,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[3,0],[1,1],[1,1],[1,1],[1,1],[1,1],[1,1],[5,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[3,0],[1,1],[1,1],[1,1],[1,1],[1,1],[1,1],[5,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[3,0],[1,1],[1,1],[1,1],[1,1],[1,1],[1,1],[5,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[8,0],[4,0],[4,0],[4,0],[12,0],[1,1],[1,1],[5,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[3,0],[1,1],[1,1],[5,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[3,0],[1,1],[1,1],[5,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[8,0],[4,0],[4,0],[9,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0]],"meshes":[{"file":"house_5_3.dmf","pos":[1,1,0]}],"entities":[{"type":"global","globalId":3,"pos":[8,8,1]},{"type":"global","globalId":4,"pos":[12,2,0]}],"areas":[{"min":[11,3,0],"max":[16,9,10],"callbackId":1,"notify":3,"trigger":6}]}

assets/maps/overworld/chunks/chunk_0_1_0.json

@@ -1 +0,0 @@
-{"meshes":[{"file":"house_8_4.dmf","pos":[1,1,0]},{"file":"house_3_3.dmf","pos":[11,2,0]},{"file":"house_2_2.dmf","pos":[3,11,0]}],"tiles":[[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,null,null,null,[1,0],[1,0],null,null,null,[1,0],[1,0],[1,0],null,null,null,null,null,null,null,null,[1,0],[1,0],null,null,null,[1,0],[1,0],[1,0],null,null,null,null,null,null,null,null,[1,0],[1,0],null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0]]}

assets/maps/overworld/chunks/chunk_1_0_0.json

@@ -1 +0,0 @@
-{"meshes":[{"file":"house_3_2.dmf","pos":[1,1,0]},{"file":"house_2_3.dmf","pos":[7,2,0]},{"file":"house_4_2.dmf","pos":[1,8,0]},{"file":"house_1_1.dmf","pos":[11,10,0]},{"file":"house_5_2.dmf","pos":[13,6,0]}],"tiles":[[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,[1,0],[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,[1,0],null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0]]}

assets/maps/overworld/chunks/chunk_1_1_0.json

@@ -1 +0,0 @@
-{"meshes":[{"file":"house_5_5.dmf","pos":[3,2,0]},{"file":"house_2_3.dmf","pos":[10,3,0]},{"file":"house_3_1.dmf","pos":[1,12,0]}],"tiles":[[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],null,null,null,[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0]]}

assets/maps/overworld/chunks/chunk_2_0_0.json

@@ -1 +0,0 @@
-{"tiles":[[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,3],[1,3],[1,3],[1,3],[1,3],[1,3],[1,0],[1,0],[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,3],[1,3],[1,3],[1,3],[1,3],[1,3],[1,0],[1,0],[1,0],[1,0],null,null,[1,0],[1,0],[1,0],[1,0],[1,3],[1,3],[1,3],[1,3],[1,3],[1,3],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[4,2],[4,2],[4,2],[4,2],[4,2],[4,2],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[4,1],[4,1],[4,1],[4,1],[4,1],[4,1],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[4,0],[4,0],[4,0],[4,0],[4,0],[4,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0],[1,0]],"meshes":[]}

assets/models/chunks/chunk_-1_0_0_0.json

@@ -0,0 +1,10 @@
+{
+  "mesh": "meshes/chunks/chunk_-1_0_0_0.dmf",
+  "color": [
+    255,
+    255,
+    255,
+    255
+  ],
+  "texture": "tiles.png"
+}

assets/models/chunks/chunk_0_0_0_0.json

@@ -0,0 +1,10 @@
+{
+  "mesh": "meshes/chunks/chunk_0_0_0_0.dmf",
+  "color": [
+    255,
+    255,
+    255,
+    255
+  ],
+  "texture": "tiles.png"
+}

assets/models/chunks/chunk_0_1_0_0.json

@@ -0,0 +1,10 @@
+{
+  "mesh": "meshes/chunks/chunk_0_1_0_0.dmf",
+  "color": [
+    255,
+    255,
+    255,
+    255
+  ],
+  "texture": "tiles.png"
+}

assets/models/chunks/chunk_1_0_0_0.json

@@ -0,0 +1,10 @@
+{
+  "mesh": "meshes/chunks/chunk_1_0_0_0.dmf",
+  "color": [
+    255,
+    255,
+    255,
+    255
+  ],
+  "texture": "tiles.png"
+}

assets/models/chunks/chunk_1_1_0_0.json

@@ -0,0 +1,10 @@
+{
+  "mesh": "meshes/chunks/chunk_1_1_0_0.dmf",
+  "color": [
+    255,
+    255,
+    255,
+    255
+  ],
+  "texture": "tiles.png"
+}

assets/models/chunks/chunk_2_0_0_0.json

@@ -0,0 +1,10 @@
+{
+  "mesh": "meshes/chunks/chunk_2_0_0_0.dmf",
+  "color": [
+    255,
+    255,
+    255,
+    255
+  ],
+  "texture": "tiles.png"
+}

assets/party.jsonc

@@ -1,22 +0,0 @@
-{
-  "members": {
-    "hero": {
-      "attack": 10,
-      "defense": 5,
-      "magic": 0,
-      "speed": 10,
-      "luck": 0,
-      "healthMax": 30,
-      "mpMax": 10
-    },
-    "companion": {
-      "attack": 8,
-      "defense": 6,
-      "magic": 4,
-      "speed": 8,
-      "luck": 1,
-      "healthMax": 25,
-      "mpMax": 15
-    }
-  }
-}

assets/story/storyflag.jsonc

@@ -1,10 +0,0 @@
-{
-  "flags": {
-    "test": {
-      "initial": true
-    },
-    "test2": {
-      "initial": 1
-    }
-  }
-}

cmake/targets/linux.cmake

@@ -27,7 +27,6 @@ target_link_libraries(${DUSK_LIBRARY_TARGET_NAME} PUBLIC
 )
 
 set(DUSK_BACKTRACE ON CACHE BOOL "Enable backtrace support for assert failures.")
-set(DUSK_TRACK_MEMORY ON CACHE BOOL "Track memoryAllocate() call sites to help find memory leaks.")
 
 # Define platform-specific macros.
 target_compile_definitions(${DUSK_LIBRARY_TARGET_NAME} PUBLIC

cmake/targets/psp.cmake

@@ -60,19 +60,6 @@ target_compile_definitions(${DUSK_BINARY_TARGET_NAME} PUBLIC
   DUSK_DISPLAY_OVERSCAN=6
 )
 
-# logDebug()/logError() additionally write every call to a file on the
-# Memory Stick (ms0:/PSP/GAME/Dusk/*.log) - a real, measured source of
-# per-call hitching (fopen+write+fclose every log line), not just a
-# theoretical cost. Default off so a normal build doesn't pay it; opt in
-# with -DDUSK_PSP_LOG_FILE=ON when the log file itself is actually needed
-# (e.g. no way to see stdout on real hardware).
-set(DUSK_PSP_LOG_FILE OFF CACHE BOOL "Also write PSP debug/error logs to ms0:/PSP/GAME/Dusk/*.log (slow - Memory Stick I/O per call).")
-if(DUSK_PSP_LOG_FILE)
-  target_compile_definitions(${DUSK_BINARY_TARGET_NAME} PUBLIC
-    DUSK_PSP_LOG_FILE
-  )
-endif()
-
 if(NOT CMAKE_BUILD_TYPE STREQUAL "Debug")
   target_compile_definitions(${DUSK_BINARY_TARGET_NAME} PUBLIC
     DUSK_ASSERTIONS_FAKED

editor/client/public/map/map.js

@@ -345,14 +345,12 @@
     return promise;
   }
 
-  const MAP_NAME = "overworld";
-
   function chunkPaths(x, y, z) {
     return {
-      raw: `assetsraw/maps/${MAP_NAME}/chunks/chunk_${x}_${y}_${z}.json`,
+      raw: `assetsraw/chunks/chunk_${x}_${y}_${z}.json`,
-      dcf: `assets/maps/${MAP_NAME}/chunks/${x}_${y}_${z}.dcf`,
+      dcf: `assets/chunks/${x}_${y}_${z}.dcf`,
-      terrainDmf: `assets/maps/${MAP_NAME}/meshes/chunks/chunk_${x}_${y}_${z}_0.dmf`,
+      terrainDmf: `assets/meshes/chunks/chunk_${x}_${y}_${z}_0.dmf`,
-      terrainModel: `assets/maps/${MAP_NAME}/models/chunks/chunk_${x}_${y}_${z}_0.json`,
+      terrainModel: `assets/models/chunks/chunk_${x}_${y}_${z}_0.json`,
     };
   }
 
@@ -769,7 +767,7 @@
   async function buildChunkBrowseList() {
     const list = document.getElementById("chunkBrowseList");
     list.innerHTML = "";
-    const res = await apiLs(`assetsraw/maps/${MAP_NAME}/chunks`);
+    const res = await apiLs("assetsraw/chunks");
     for(const entry of res.entries || []) {
       const m = entry.name.match(/^chunk_(-?\d+)_(-?\d+)_(-?\d+)\.json$/);
       if(!m) continue;

editor/server/server.py

@@ -209,10 +209,7 @@ class Handler(BaseHTTPRequestHandler):
             self.send_json({"error": "invalid chunk coordinates"}, 400)
             return
 
-        json_path = (
+        json_path = PROJECT_ROOT / "assetsraw" / "chunks" / f"chunk_{x}_{y}_{z}.json"
-            PROJECT_ROOT / "assetsraw" / "maps" / "overworld" / "chunks"
-            / f"chunk_{x}_{y}_{z}.json"
-        )
         if not json_path.is_file():
             self.send_json({"error": "chunk json not found"}, 404)
             return

src/dusk/CMakeLists.txt

@@ -50,12 +50,6 @@ if(DUSK_BACKTRACE)
   )
 endif()
 
-if(DUSK_TRACK_MEMORY)
-  target_compile_definitions(${DUSK_LIBRARY_TARGET_NAME} PUBLIC
-    DUSK_TRACK_MEMORY
-  )
-endif()
-
 # Includes
 target_include_directories(${DUSK_LIBRARY_TARGET_NAME}
   PUBLIC
@@ -80,7 +74,6 @@ add_subdirectory(engine)
 add_subdirectory(error)
 add_subdirectory(input)
 add_subdirectory(locale)
-add_subdirectory(perf)
 add_subdirectory(rpg)
 add_subdirectory(scene)
 add_subdirectory(system)

src/dusk/animation/animation.c

@@ -1,7 +1,9 @@
-// Copyright (c) 2026 Dominic Masters
+/**
-//
+ * Copyright (c) 2026 Dominic Masters
-// This software is released under the MIT License.
+ *
-// https://opensource.org/licenses/MIT
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
 
 #include "animation.h"
 #include "assert/assert.h"
@@ -14,9 +16,9 @@ void animationInit(
   uint16_t *keyframeCounts,
   const uint16_t layerCount
 ) {
-  assertNotNull(anim, "Animation pointer cannot be null.");
+  assertNotNull(anim, "Animation pointer cannot be NULL.");
-  assertNotNull(keyframes, "Keyframes pointer cannot be null.");
+  assertNotNull(keyframes, "Keyframes pointer cannot be NULL.");
-  assertNotNull(keyframeCounts, "Keyframe counts pointer cannot be null.");
+  assertNotNull(keyframeCounts, "Keyframe counts pointer cannot be NULL.");
   assertTrue(layerCount > 0, "Layer count must be greater than zero.");
 
   memoryZero(anim, sizeof(animation_t));
@@ -49,7 +51,7 @@ void animationInit(
 }
 
 float_t animationGetLayerValue(const animation_t *anim, const uint16_t layer) {
-  assertNotNull(anim, "Animation pointer cannot be null.");
+  assertNotNull(anim, "Animation pointer cannot be NULL.");
   assertTrue(layer < anim->layerCount, "Layer index out of bounds.");
 
   uint16_t keyframeCount = anim->keyframeCounts[layer];
@@ -61,7 +63,7 @@ void animationUpdate(
   animation_t *anim,
   const float_t deltaTime
 ) {
-  assertNotNull(anim, "Animation pointer cannot be null.");
+  assertNotNull(anim, "Animation pointer cannot be NULL.");
   assertTrue(deltaTime >= 0, "Delta time must be non-negative.");
 
   bool_t justCompleted = false;

src/dusk/animation/animation.h

@@ -1,7 +1,9 @@
-// Copyright (c) 2026 Dominic Masters
+/**
-//
+ * Copyright (c) 2026 Dominic Masters
-// This software is released under the MIT License.
+ *
-// https://opensource.org/licenses/MIT
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
 
 #pragma once
 #include "keyframe.h"

src/dusk/animation/easing.c

@@ -1,7 +1,9 @@
-// Copyright (c) 2026 Dominic Masters
+/**
-//
+ * Copyright (c) 2026 Dominic Masters
-// This software is released under the MIT License.
+ *
-// https://opensource.org/licenses/MIT
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
 
 #include "easing.h"
 #include "assert/assert.h"

src/dusk/animation/easing.h

@@ -1,7 +1,9 @@
-// Copyright (c) 2026 Dominic Masters
+/**
-//
+ * Copyright (c) 2026 Dominic Masters
-// This software is released under the MIT License.
+ *
-// https://opensource.org/licenses/MIT
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
 
 #pragma once
 #include "dusk.h"
@@ -45,19 +47,136 @@ extern const easingfn_t EASING_FUNCTIONS[EASING_COUNT];
  */
 float_t easingApply(const easingtype_t type, const float_t t);
 
+/**
+ * No easing - returns t unchanged.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, equal to t.
+ */
 float_t easingLinear(const float_t t);
+
+/**
+ * Sinusoidal easing in: starts slow, accelerates to the end.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingInSine(const float_t t);
+
+/**
+ * Sinusoidal easing out: starts fast, decelerates to the end.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingOutSine(const float_t t);
+
+/**
+ * Sinusoidal easing in and out: slow at both ends, fastest in
+ * the middle.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingInOutSine(const float_t t);
+
+/**
+ * Quadratic easing in: starts slow, accelerates to the end.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingInQuad(const float_t t);
+
+/**
+ * Quadratic easing out: starts fast, decelerates to the end.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingOutQuad(const float_t t);
+
+/**
+ * Quadratic easing in and out: slow at both ends, fastest in the
+ * middle.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingInOutQuad(const float_t t);
+
+/**
+ * Cubic easing in: starts slow, accelerates to the end.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingInCubic(const float_t t);
+
+/**
+ * Cubic easing out: starts fast, decelerates to the end.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingOutCubic(const float_t t);
+
+/**
+ * Cubic easing in and out: slow at both ends, fastest in the
+ * middle.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingInOutCubic(const float_t t);
+
+/**
+ * Quartic easing in: starts slow, accelerates to the end.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingInQuart(const float_t t);
+
+/**
+ * Quartic easing out: starts fast, decelerates to the end.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingOutQuart(const float_t t);
+
+/**
+ * Quartic easing in and out: slow at both ends, fastest in the
+ * middle.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, in the range [0, 1].
+ */
 float_t easingInOutQuart(const float_t t);
+
+/**
+ * Back easing in: overshoots backwards before moving to the end.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, which may fall below 0.
+ */
 float_t easingInBack(const float_t t);
+
+/**
+ * Back easing out: overshoots past the end before settling on it.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, which may rise above 1.
+ */
 float_t easingOutBack(const float_t t);
+
+/**
+ * Back easing in and out: overshoots backwards at the start and
+ * past the end before settling on it.
+ *
+ * @param t The input time, in the range [0, 1].
+ * @return The eased value, which may fall below 0 or rise above 1.
+ */
 float_t easingInOutBack(const float_t t);
+

src/dusk/animation/keyframe.c

@@ -14,7 +14,7 @@ float_t keyframeGetValue(
   const uint32_t keyframeCount,
   const float_t time
 ) {
-  assertNotNull(keyframes, "Keyframes pointer cannot be null.");
+  assertNotNull(keyframes, "Keyframes pointer cannot be NULL.");
   assertTrue(keyframeCount > 0, "Keyframe count must be more than 0.");
   assertTrue(time >= 0, "Time must be non-negative.");
   #ifdef DUSK_ASSERTIONS

src/dusk/animation/keyframe.h

@@ -1,7 +1,9 @@
-// Copyright (c) 2026 Dominic Masters
+/**
-//
+ * Copyright (c) 2026 Dominic Masters
-// This software is released under the MIT License.
+ *
-// https://opensource.org/licenses/MIT
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
 
 #pragma once
 #include "easing.h"

src/dusk/asset/asset.c

@@ -25,9 +25,11 @@ errorret_t assetInit(void) {
     threadMutexInit(&ASSET.loading[i].mutex);
   }
 
-  // assetInitPlatform must either define ASSET.zip or throw an error.
+  // assetInitPlatform must either define both ASSET.zip/ASSET.zipStored or
+  // throw an error.
   errorChain(assetInitPlatform());
-  assertNotNull(ASSET.zip, "Asset zip null without error.");
+  assertNotNull(ASSET.zip, "Asset zip NULL without error.");
+  assertNotNull(ASSET.zipStored, "Asset stored zip NULL without error.");
   threadInit(&ASSET.loadThread, assetUpdateAsync);
   threadStart(&ASSET.loadThread);
 
@@ -38,7 +40,9 @@ bool_t assetFileExists(const char_t *filename) {
   assertStrLenMax(filename, ASSET_FILE_NAME_MAX, "Filename too long.");
 
   threadMutexLock(&ASSET.zipLock);
-  bool_t found = zip_name_locate(ASSET.zip, filename, 0) >= 0;
+  bool_t found =
+    zip_name_locate(ASSET.zip, filename, 0) >= 0 ||
+    zip_name_locate(ASSET.zipStored, filename, 0) >= 0;
   threadMutexUnlock(&ASSET.zipLock);
   return found;
 }
@@ -441,13 +445,19 @@ errorret_t assetDispose(void) {
 
   errorChain(assetReapUnused());
 
-  // Cleanup zip file.
+  // Cleanup zip files.
   if(ASSET.zip != NULL) {
     if(zip_close(ASSET.zip) != 0) {
-      errorThrow("Failed to close asset zip archive.");
+      errorThrow("Failed to close compressed asset zip archive.");
     }
     ASSET.zip = NULL;
   }
+  if(ASSET.zipStored != NULL) {
+    if(zip_close(ASSET.zipStored) != 0) {
+      errorThrow("Failed to close stored asset zip archive.");
+    }
+    ASSET.zipStored = NULL;
+  }
 
   errorChain(assetDisposePlatform());
   threadMutexDispose(&ASSET.zipLock);

src/dusk/asset/asset.h

@@ -29,12 +29,16 @@
 #define ASSET_BASE_DIRECTORY_MAX 256
 
 typedef struct asset_s {
-  // The dusk.dsk archive - a single uncompressed (ZIP_STORED) zip, so
+  // Compressed (DEFLATE) archive - expected to hold the bulk of a game's
-  // every entry gets the reliable repeated seeking/re-opening that
+  // binary assets. Looked up first by assetFileInit().
-  // libzip only supports reliably for uncompressed entries (locale
-  // strings, MP3 loop restarts, etc.).
   zip_t *zip;
 
+  // Stored (uncompressed) archive - expected to hold small files that need
+  // reliable repeated seeking/re-opening (e.g. locale strings), which
+  // libzip only supports reliably for uncompressed entries. Looked up by
+  // assetFileInit() only if the name isn't found in `zip`.
+  zip_t *zipStored;
+
   // Directory dusk.dsk was actually found/opened in (on PSP, the directory
   // EBOOT.PBP lives in, since dusk.dsk is embedded inside it rather than a
   // loose file) - populated by each platform's own assetInitXxx() once it
@@ -48,7 +52,7 @@ typedef struct asset_s {
 
   assetplatform_t platform;
 
-  // Guards every libzip call against ASSET.zip (zip_fopen,
+  // Guards every libzip call against ASSET.zip/ASSET.zipStored (zip_fopen,
   // zip_fread, zip_fclose, zip_fseek, zip_stat, zip_name_locate - see
   // assetfile.c/assetFileExists). libzip is documented as not thread-safe,
   // and this asset system genuinely calls it from multiple real threads at

src/dusk/asset/assetdsk.c

@@ -30,9 +30,9 @@ errorret_t assetDskParseHeader(
   // Every field is a little-endian uint32_t regardless of host - convert
   // to host order (a no-op on little-endian hosts, a real byteswap on
   // Dolphin's big-endian PowerPC).
-  uint32_t fields[3];
+  uint32_t fields[7];
   memoryCopy(fields, bytes + ASSET_DSK_MAGIC_SIZE, sizeof(fields));
-  for(uint8_t i = 0; i < 3; i++) {
+  for(uint8_t i = 0; i < 7; i++) {
     fields[i] = endianLittleToHost32(fields[i]);
   }
 
@@ -41,17 +41,24 @@ errorret_t assetDskParseHeader(
     errorThrow("dusk.dsk has an unsupported version: %u", version);
   }
 
-  outHeader->size = fields[1];
+  outHeader->compressedOffset = fields[1];
-  outHeader->checksum = fields[2];
+  outHeader->compressedSize = fields[2];
+  outHeader->compressedChecksum = fields[3];
+  outHeader->storedOffset = fields[4];
+  outHeader->storedSize = fields[5];
+  outHeader->storedChecksum = fields[6];
 
   errorOk();
 }
 
 errorret_t assetDskOpenFromPath(
   const char_t *path,
-  zip_t **outZip
+  zip_t **outCompressed,
+  zip_t **outStored
 ) {
-  errorChain(assetDskOpenFromPathRange(path, 0, SIZE_MAX, outZip));
+  errorChain(assetDskOpenFromPathRange(
+    path, 0, SIZE_MAX, outCompressed, outStored
+  ));
   errorOk();
 }
 
@@ -59,12 +66,15 @@ errorret_t assetDskOpenFromPathRange(
   const char_t *path,
   const size_t baseOffset,
   const size_t baseSize,
-  zip_t **outZip
+  zip_t **outCompressed,
+  zip_t **outStored
 ) {
   assertNotNull(path, "Path cannot be NULL.");
-  assertNotNull(outZip, "Out zip cannot be NULL.");
+  assertNotNull(outCompressed, "Out compressed cannot be NULL.");
+  assertNotNull(outStored, "Out stored cannot be NULL.");
 
-  *outZip = NULL;
+  *outCompressed = NULL;
+  *outStored = NULL;
 
   FILE *headerFile = fopen(path, "rb");
   if(headerFile == NULL) {
@@ -86,30 +96,104 @@ errorret_t assetDskOpenFromPathRange(
   assetdskheader_t header;
   errorChain(assetDskParseHeader(headerBytes, sizeof(headerBytes), &header));
 
-  if((size_t) ASSET_DSK_HEADER_SIZE + header.size > baseSize) {
+  if(
-    errorThrow("dusk.dsk header describes a range beyond its containing file.");
+    (size_t) header.compressedOffset + header.compressedSize > baseSize ||
+    (size_t) header.storedOffset + header.storedSize > baseSize
+  ) {
+    errorThrow("dusk.dsk header describes ranges beyond its containing file.");
   }
 
   zip_error_t zipError;
   zip_error_init(&zipError);
 
-  zip_source_t *source = zip_source_file_create(
+  zip_source_t *compressedSource = zip_source_file_create(
     path,
-    (zip_uint64_t) (baseOffset + ASSET_DSK_HEADER_SIZE),
+    (zip_uint64_t) (baseOffset + header.compressedOffset),
-    (zip_int64_t) header.size,
+    (zip_int64_t) header.compressedSize,
     &zipError
   );
-  if(source == NULL) {
+  if(compressedSource == NULL) {
     errorThrow(
-      "Failed to create dusk.dsk source: %s", zip_error_strerror(&zipError)
+      "Failed to create compressed dusk.dsk source: %s",
+      zip_error_strerror(&zipError)
     );
   }
 
-  *outZip = zip_open_from_source(source, ZIP_RDONLY, &zipError);
+  *outCompressed =
-  if(*outZip == NULL) {
+    zip_open_from_source(compressedSource, ZIP_RDONLY, &zipError);
-    zip_source_free(source);
+  if(*outCompressed == NULL) {
+    zip_source_free(compressedSource);
     errorThrow(
-      "Failed to open dusk.dsk archive: %s", zip_error_strerror(&zipError)
+      "Failed to open compressed dusk.dsk archive: %s",
+      zip_error_strerror(&zipError)
+    );
+  }
+
+  zip_source_t *storedSource = zip_source_file_create(
+    path,
+    (zip_uint64_t) (baseOffset + header.storedOffset),
+    (zip_int64_t) header.storedSize,
+    &zipError
+  );
+  if(storedSource == NULL) {
+    zip_close(*outCompressed);
+    *outCompressed = NULL;
+    errorThrow(
+      "Failed to create stored dusk.dsk source: %s",
+      zip_error_strerror(&zipError)
+    );
+  }
+
+  *outStored = zip_open_from_source(storedSource, ZIP_RDONLY, &zipError);
+  if(*outStored == NULL) {
+    zip_source_free(storedSource);
+    zip_close(*outCompressed);
+    *outCompressed = NULL;
+    errorThrow(
+      "Failed to open stored dusk.dsk archive: %s",
+      zip_error_strerror(&zipError)
+    );
+  }
+
+  // The stored archive is small by convention, so verifying its checksum
+  // here (one extra small read) is cheap; the compressed archive isn't
+  // checked since it's meant to be read lazily/on-demand from here on.
+  uint8_t *storedBytes = (uint8_t *) memoryAllocate(header.storedSize);
+  FILE *storedFile = fopen(path, "rb");
+  if(storedFile == NULL) {
+    memoryFree(storedBytes);
+    zip_close(*outStored);
+    zip_close(*outCompressed);
+    *outStored = NULL;
+    *outCompressed = NULL;
+    errorThrow(
+      "Failed to re-open dusk.dsk to verify stored checksum: %s", path
+    );
+  }
+  fseek(storedFile, (long) (baseOffset + header.storedOffset), SEEK_SET);
+  size_t storedRead = fread(storedBytes, 1, header.storedSize, storedFile);
+  fclose(storedFile);
+  if(storedRead != header.storedSize) {
+    memoryFree(storedBytes);
+    zip_close(*outStored);
+    zip_close(*outCompressed);
+    *outStored = NULL;
+    *outCompressed = NULL;
+    errorThrow(
+      "Failed to read dusk.dsk stored archive to verify checksum: %s", path
+    );
+  }
+
+  uint32_t checksum =
+    (uint32_t) crc32(0L, storedBytes, (uInt) header.storedSize);
+  memoryFree(storedBytes);
+  if(checksum != header.storedChecksum) {
+    zip_close(*outStored);
+    zip_close(*outCompressed);
+    *outStored = NULL;
+    *outCompressed = NULL;
+    errorThrow(
+      "dusk.dsk stored archive failed checksum verification: %s", path
     );
   }
 
@@ -119,45 +203,85 @@ errorret_t assetDskOpenFromPathRange(
 errorret_t assetDskOpenFromBuffer(
   uint8_t *buffer,
   const size_t bufferSize,
-  zip_t **outZip
+  zip_t **outCompressed,
+  zip_t **outStored
 ) {
   assertNotNull(buffer, "Buffer cannot be NULL.");
-  assertNotNull(outZip, "Out zip cannot be NULL.");
+  assertNotNull(outCompressed, "Out compressed cannot be NULL.");
+  assertNotNull(outStored, "Out stored cannot be NULL.");
 
-  *outZip = NULL;
+  *outCompressed = NULL;
+  *outStored = NULL;
 
   assetdskheader_t header;
   errorChain(assetDskParseHeader(buffer, bufferSize, &header));
 
-  if((size_t) ASSET_DSK_HEADER_SIZE + header.size > bufferSize) {
+  if(
-    errorThrow("dusk.dsk header describes a range beyond the buffer.");
+    (size_t) header.compressedOffset + header.compressedSize > bufferSize ||
+    (size_t) header.storedOffset + header.storedSize > bufferSize
+  ) {
+    errorThrow("dusk.dsk header describes ranges beyond the buffer.");
   }
 
-  uint8_t *data = buffer + ASSET_DSK_HEADER_SIZE;
+  uint32_t compressedChecksum = (uint32_t) crc32(
-  uint32_t checksum = (uint32_t) crc32(0L, data, (uInt) header.size);
+    0L, buffer + header.compressedOffset, (uInt) header.compressedSize
-  if(checksum != header.checksum) {
+  );
-    errorThrow("dusk.dsk archive failed checksum verification.");
+  if(compressedChecksum != header.compressedChecksum) {
+    errorThrow("dusk.dsk compressed archive failed checksum verification.");
+  }
+
+  uint32_t storedChecksum = (uint32_t) crc32(
+    0L, buffer + header.storedOffset, (uInt) header.storedSize
+  );
+  if(storedChecksum != header.storedChecksum) {
+    errorThrow("dusk.dsk stored archive failed checksum verification.");
   }
 
   zip_error_t zipError;
   zip_error_init(&zipError);
 
-  // freep=0 - this is a non-owning window into the same caller-owned
+  // freep=0 for both - they're non-owning windows into the same caller-owned
-  // buffer, not an independent allocation libzip should free.
+  // buffer, not independent allocations libzip should free.
-  zip_source_t *source = zip_source_buffer_create(
+  zip_source_t *compressedSource = zip_source_buffer_create(
-    data, header.size, 0, &zipError
+    buffer + header.compressedOffset, header.compressedSize, 0, &zipError
   );
-  if(source == NULL) {
+  if(compressedSource == NULL) {
     errorThrow(
-      "Failed to create dusk.dsk source: %s", zip_error_strerror(&zipError)
+      "Failed to create compressed dusk.dsk source: %s",
+      zip_error_strerror(&zipError)
     );
   }
 
-  *outZip = zip_open_from_source(source, ZIP_RDONLY, &zipError);
+  *outCompressed =
-  if(*outZip == NULL) {
+    zip_open_from_source(compressedSource, ZIP_RDONLY, &zipError);
-    zip_source_free(source);
+  if(*outCompressed == NULL) {
+    zip_source_free(compressedSource);
     errorThrow(
-      "Failed to open dusk.dsk archive: %s", zip_error_strerror(&zipError)
+      "Failed to open compressed dusk.dsk archive: %s",
+      zip_error_strerror(&zipError)
+    );
+  }
+
+  zip_source_t *storedSource = zip_source_buffer_create(
+    buffer + header.storedOffset, header.storedSize, 0, &zipError
+  );
+  if(storedSource == NULL) {
+    zip_close(*outCompressed);
+    *outCompressed = NULL;
+    errorThrow(
+      "Failed to create stored dusk.dsk source: %s",
+      zip_error_strerror(&zipError)
+    );
+  }
+
+  *outStored = zip_open_from_source(storedSource, ZIP_RDONLY, &zipError);
+  if(*outStored == NULL) {
+    zip_source_free(storedSource);
+    zip_close(*outCompressed);
+    *outCompressed = NULL;
+    errorThrow(
+      "Failed to open stored dusk.dsk archive: %s",
+      zip_error_strerror(&zipError)
     );
   }
 

src/dusk/asset/assetdsk.h

@@ -12,30 +12,31 @@
 // "DSK2" - distinct from a plain zip's "PK\x03\x04" so a stray plain zip
 // never gets misread as a valid dusk.dsk.
 #define ASSET_DSK_MAGIC_SIZE 4
-#define ASSET_DSK_MAGIC "DSK"
+#define ASSET_DSK_MAGIC "DSK2"
-#define ASSET_DSK_VERSION 2
+#define ASSET_DSK_VERSION 1
 
-// Magic + version + size + checksum
+// magic(4) + version(4) + compressedOffset(4) + compressedSize(4) +
-#define ASSET_DSK_HEADER_SIZE ( \
+// compressedChecksum(4) + storedOffset(4) + storedSize(4) +
-  ASSET_DSK_MAGIC_SIZE + \
+// storedChecksum(4), all little-endian regardless of host - see
-  sizeof(uint32_t) + \
+// assetDskParseHeader.
-  sizeof(uint32_t) + \
+#define ASSET_DSK_HEADER_SIZE 32
-  sizeof(uint32_t) \
-)
 
 /**
- * Parsed dusk.dsk (DSK2 format) header. dusk.dsk is a single uncompressed
+ * Parsed dusk.dsk (DSK2 format) header. dusk.dsk is two independent, back
- * (ZIP_STORED) zip archive (see tools/asset/pack) rather than DEFLATEd -
+ * to back zip archives (see tools/asset/pack) rather than a single plain
- * the bulk of what's packed (audio, images) is already compressed at the
+ * zip: a "compressed" one (DEFLATE, expected to hold the bulk of a game's
- * file level, so DEFLATE-ing the whole archive on top buys negligible
+ * binary assets, opened lazily/on-demand) and a "stored" one (uncompressed,
- * space for real CPU cost, and every entry gets the reliable repeated
+ * expected to hold small files - locale strings, config - that need
- * seeking/re-opening that libzip only supports for uncompressed entries
+ * reliable repeated seeking/re-opening, which libzip only supports for
- * (locale line-by-line reads, MP3 loop restarts, etc.) instead of just a
+ * uncompressed entries).
- * hand-picked subset of files.
  */
 typedef struct {
-  uint32_t size;
+  uint32_t compressedOffset;
-  uint32_t checksum;
+  uint32_t compressedSize;
+  uint32_t compressedChecksum;
+  uint32_t storedOffset;
+  uint32_t storedSize;
+  uint32_t storedChecksum;
 } assetdskheader_t;
 
 /**
@@ -55,24 +56,27 @@ errorret_t assetDskParseHeader(
 );
 
 /**
- * Opens the dusk.dsk archive given a filesystem path, using a lazy/
+ * Opens both archives of a dusk.dsk file given a filesystem path, using
- * windowed file-backed zip source - no more memory used than the
+ * lazy/windowed file-backed zip sources - no more memory used than the
  * existing per-platform small read buffers, matching the memory
- * characteristics of a plain zip_open() on the whole file. The checksum
+ * characteristics of a plain zip_open() on the whole file. Verifies the
- * is intentionally not verified here since doing so would require
+ * (small, by convention) stored archive's checksum; the compressed
- * reading the whole (potentially large) archive just to compute it.
+ * archive's checksum is intentionally not verified here since doing so
+ * would require reading the bulk of the game's assets just to compute it.
  *
  * See assetDskOpenFromPathRange() for the case where the DSK2 blob isn't
  * the whole file (e.g. embedded inside another container).
  *
  * @param path Filesystem path to the dusk.dsk file.
- * @param outZip Set to the opened archive on success.
+ * @param outCompressed Set to the opened compressed archive on success.
+ * @param outStored Set to the opened stored archive on success.
  * @return OK on success, error if the file is missing, too short, has a
- *         bad header, or the archive fails to open.
+ *         bad header, or either archive fails to open/verify.
  */
 errorret_t assetDskOpenFromPath(
   const char_t *path,
-  zip_t **outZip
+  zip_t **outCompressed,
+  zip_t **outStored
 );
 
 /**
@@ -86,35 +90,39 @@ errorret_t assetDskOpenFromPath(
  * @param path Filesystem path to the container file.
  * @param baseOffset Byte offset within `path` where the DSK2 blob starts.
  * @param baseSize Number of bytes available at `baseOffset`.
- * @param outZip Set to the opened archive on success.
+ * @param outCompressed Set to the opened compressed archive on success.
+ * @param outStored Set to the opened stored archive on success.
  * @return OK on success, error if the file is missing, too short, has a
- *         bad header, or the archive fails to open.
+ *         bad header, or either archive fails to open/verify.
  */
 errorret_t assetDskOpenFromPathRange(
   const char_t *path,
   const size_t baseOffset,
   const size_t baseSize,
-  zip_t **outZip
+  zip_t **outCompressed,
+  zip_t **outStored
 );
 
 /**
- * Opens the dusk.dsk archive already fully resident in memory (e.g. a
+ * Opens both archives of a dusk.dsk file already fully resident in memory
- * PSAR embedded in an EBOOT.PBP, or an ISO-embedded file already read via
+ * (e.g. a PSAR embedded in an EBOOT.PBP, or an ISO-embedded file already
- * DVD_ReadAbs - platforms that already buffer the whole file for reasons
+ * read via DVD_ReadAbs - platforms that already buffer the whole file for
- * unrelated to this format). The returned archive doesn't take ownership
+ * reasons unrelated to this format). Neither archive takes ownership of
- * of `buffer` (it's opened as a non-owning sub-range of it) - the caller
+ * `buffer` (both are opened as non-owning sub-ranges of it) - the caller
  * remains responsible for freeing it, and must keep it alive for as long
- * as the archive stays open. Verifies the checksum, since the bytes are
+ * as either archive stays open. Verifies both archives' checksums, since
- * already resident.
+ * the bytes are already resident.
  *
  * @param buffer The whole dusk.dsk file's bytes.
  * @param bufferSize Number of bytes at `buffer`.
- * @param outZip Set to the opened archive on success.
+ * @param outCompressed Set to the opened compressed archive on success.
+ * @param outStored Set to the opened stored archive on success.
  * @return OK on success, error if too short, has a bad header/checksum, or
- *         the archive fails to open.
+ *         either archive fails to open.
  */
 errorret_t assetDskOpenFromBuffer(
   uint8_t *buffer,
   const size_t bufferSize,
-  zip_t **outZip
+  zip_t **outCompressed,
+  zip_t **outStored
 );

src/dusk/asset/assetfile.c

@@ -24,11 +24,20 @@ errorret_t assetFileInit(
   file->params = params;
   file->output = output;
 
+  // Stat the file, trying the compressed archive first and falling back to
+  // the stored one - remember which matched so assetFileOpen opens it from
+  // the right archive.
   zip_stat_init(&file->stat);
   threadMutexLock(&ASSET.zipLock);
-  int statResult = zip_stat(ASSET.zip, filename, 0, &file->stat);
+  if(zip_stat(ASSET.zip, filename, 0, &file->stat) == 0) {
+    file->sourceZip = ASSET.zip;
+  } else if(zip_stat(ASSET.zipStored, filename, 0, &file->stat) == 0) {
+    file->sourceZip = ASSET.zipStored;
+  } else {
+    file->sourceZip = NULL;
+  }
   threadMutexUnlock(&ASSET.zipLock);
-  if(statResult != 0) {
+  if(file->sourceZip == NULL) {
     errorThrow("Failed to stat asset file: %s", filename);
   }
 
@@ -76,10 +85,11 @@ errorret_t assetFileRewind(assetfile_t *file) {
 errorret_t assetFileOpen(assetfile_t *file) {
   assertNotNull(file, "Asset file cannot be NULL.");
   assertNotNull(file->filename, "Asset file filename cannot be NULL.");
+  assertNotNull(file->sourceZip, "Asset file must be inited before opening.");
   assertNull(file->zipFile, "Asset file already open.");
 
   threadMutexLock(&ASSET.zipLock);
-  file->zipFile = zip_fopen(ASSET.zip, file->filename, 0);
+  file->zipFile = zip_fopen(file->sourceZip, file->filename, 0);
   threadMutexUnlock(&ASSET.zipLock);
   if(file->zipFile == NULL) {
     errorThrow("Failed to open asset file: %s", file->filename);
@@ -269,7 +279,7 @@ errorret_t assetFileLineReaderAppend(
     errorOk();
   }
 
-  /* reserve room for optional NUL terminator */
+  // reserve room for optional NUL terminator
   if(reader->lineLength + srcLength >= reader->outBufferSize) {
     errorThrow("Line length exceeds output buffer size.");
   }
@@ -318,7 +328,7 @@ errorret_t assetFileLineReaderFill(assetfilelinereader_t *reader) {
 
   size_t unreadBytes = assetFileLineReaderUnreadBytes(reader);
 
-  /* If buffer is fully consumed, refill from start. */
+  // If buffer is fully consumed, refill from start.
   if(unreadBytes == 0) {
     reader->bufferStart = 0;
     reader->bufferEnd = 0;
@@ -339,18 +349,14 @@ errorret_t assetFileLineReaderFill(assetfilelinereader_t *reader) {
     errorOk();
   }
 
-  /*
+  // There are unread bytes left but no newline in them.
-   * There are unread bytes left but no newline in them.
+  // If bufferStart > 0, slide unread bytes to front so we can read more.
-   * If bufferStart > 0, slide unread bytes to front so we can read more.
+  // This only happens when necessary to make space.
-   * This only happens when necessary to make space.
-   */
   if(reader->bufferEnd == reader->readBufferSize) {
     if(reader->bufferStart == 0) {
-      /*
+      // Entire read buffer is unread and contains no newline.
-       * Entire read buffer is unread and contains no newline.
+      // Caller must have a large enough outBuffer to accumulate across fills,
-       * Caller must have a large enough outBuffer to accumulate across fills,
+      // so we consume these bytes into outBuffer before refilling.
-       * so we consume these bytes into outBuffer before refilling.
-       */
       errorOk();
     }
 
@@ -393,7 +399,7 @@ errorret_t assetFileLineReaderNext(assetfilelinereader_t *reader) {
       size_t chunkLength = (size_t)newlineIndex - reader->bufferStart;
       errorret_t ret;
 
-      /* strip CR in CRLF */
+      // strip CR in CRLF
       if(
         chunkLength > 0 &&
         reader->readBuffer[(size_t)newlineIndex - 1] == '\r'

src/dusk/asset/assetfile.h

@@ -9,7 +9,7 @@
 #include "error/error.h"
 #include <zip.h>
 
-#define ASSET_FILE_NAME_MAX 128
+#define ASSET_FILE_NAME_MAX 48
 
 // Max bytes requested per zip_fread() call in assetFileRead(). Some
 // zip_fread() implementations (seen on PSP) reject a single call asking
@@ -32,6 +32,11 @@ typedef struct assetfile_s {
   zip_int64_t position;
   zip_int64_t lastRead;
   zip_file_t *zipFile;
+
+  // The archive this file was found in (ASSET.zip or ASSET.zipStored),
+  // set by assetFileInit and used by assetFileOpen so lookups fall back
+  // correctly between the two dusk.dsk archives.
+  zip_t *sourceZip;
 } assetfile_t;
 
 /**

src/dusk/asset/loader/CMakeLists.txt

@@ -17,5 +17,6 @@ add_subdirectory(locale)
 add_subdirectory(json)
 add_subdirectory(chunk)
 add_subdirectory(dmf)
+add_subdirectory(cutscene)
 add_subdirectory(wav)
 add_subdirectory(mp3)

src/dusk/asset/loader/assetloader.c

@@ -52,6 +52,12 @@ assetloadercallbacks_t ASSET_LOADER_CALLBACKS[ASSET_LOADER_TYPE_COUNT] = {
     .dispose = assetChunkDispose
   },
 
+  [ASSET_LOADER_TYPE_CUTSCENE] = {
+    .loadSync = assetCutsceneLoaderSync,
+    .loadAsync = assetCutsceneLoaderAsync,
+    .dispose = assetCutsceneDispose
+  },
+
   [ASSET_LOADER_TYPE_WAV] = {
     .loadSync = assetWavLoaderSync,
     .loadAsync = assetWavLoaderAsync,

src/dusk/asset/loader/assetloader.h

@@ -13,6 +13,7 @@
 #include "asset/loader/locale/assetlocaleloader.h"
 #include "asset/loader/json/assetjsonloader.h"
 #include "asset/loader/chunk/assetchunkloader.h"
+#include "asset/loader/cutscene/assetcutsceneloader.h"
 #include "asset/loader/wav/assetwavloader.h"
 #include "asset/loader/mp3/assetmp3loader.h"
 
@@ -26,6 +27,7 @@ typedef enum {
   ASSET_LOADER_TYPE_LOCALE,
   ASSET_LOADER_TYPE_JSON,
   ASSET_LOADER_TYPE_CHUNK,
+  ASSET_LOADER_TYPE_CUTSCENE,
   ASSET_LOADER_TYPE_WAV,
   ASSET_LOADER_TYPE_MP3,
 
@@ -40,6 +42,7 @@ typedef union {
   assetlocaleloaderloading_t locale;
   assetjsonloaderloading_t json;
   assetchunkloaderloading_t chunk;
+  assetcutsceneloaderloading_t cutscene;
   assetwavloaderloading_t wav;
   assetmp3loaderloading_t mp3;
 } assetloaderloading_t;
@@ -52,6 +55,7 @@ typedef union {
   assetlocaleoutput_t locale;
   assetjsonoutput_t json;
   assetchunkoutput_t chunk;
+  assetcutsceneoutput_t cutscene;
   assetwavoutput_t wav;
   assetmp3output_t mp3;
 } assetloaderoutput_t;
@@ -62,6 +66,7 @@ typedef union {
   assetlocaleloaderinput_t locale;
   assetjsonloaderinput_t json;
   assetchunkloaderinput_t chunk;
+  assetcutsceneloaderinput_t cutscene;
   assetwavloaderinput_t wav;
   assetmp3loaderinput_t mp3;
 } assetloaderinput_t;

src/dusk/asset/loader/chunk/assetchunkloader.c

@@ -8,284 +8,41 @@
 #include "assetchunkloader.h"
 #include "assert/assert.h"
 #include "util/memory.h"
-#include "util/string.h"
+#include "util/endian.h"
-#include "asset/asset.h"
 #include "asset/loader/assetloading.h"
 #include "asset/loader/assetentry.h"
 #include "asset/loader/assetloader.h"
-#include "asset/loader/json/assetjsonloader.h"
+#include "asset/asset.h"
-#include "display/color.h"
-#include "display/texture/texture.h"
 #include "rpg/overworld/worldpos.h"
-#include "yyjson.h"
-
-#define ASSET_CHUNK_TERRAIN_TEXTURE "tiles.png"
-
-// Per-shape corner Z offsets (sw, se, ne, nw) as offsets from a tile's own
-// base Z, ported 1:1 from tools/asset/chunk/__main__.py's _RAMP_CORNERS.
-// TILE_SHAPE_NULL's row is never read - assetChunkTilesHaveTerrain/
-// assetChunkBuildTerrain skip those tiles outright.
-static const float_t CHUNK_RAMP_CORNERS[TILE_SHAPE_COUNT][4] = {
-  [TILE_SHAPE_GROUND]               = {0.0f, 0.0f, 0.0f, 0.0f},
-  [TILE_SHAPE_RAMP_NORTH]           = {0.0f, 0.0f, 1.0f, 1.0f},
-  [TILE_SHAPE_RAMP_SOUTH]           = {1.0f, 1.0f, 0.0f, 0.0f},
-  [TILE_SHAPE_RAMP_EAST]            = {0.0f, 1.0f, 1.0f, 0.0f},
-  [TILE_SHAPE_RAMP_WEST]            = {1.0f, 0.0f, 0.0f, 1.0f},
-  [TILE_SHAPE_RAMP_NORTHEAST]       = {0.0f, 0.0f, 1.0f, 0.0f},
-  [TILE_SHAPE_RAMP_NORTHWEST]       = {0.0f, 0.0f, 0.0f, 1.0f},
-  [TILE_SHAPE_RAMP_SOUTHEAST]       = {0.0f, 1.0f, 0.0f, 0.0f},
-  [TILE_SHAPE_RAMP_SOUTHWEST]       = {1.0f, 0.0f, 0.0f, 0.0f},
-  [TILE_SHAPE_RAMP_NORTHEAST_INNER] = {0.0f, 1.0f, 1.0f, 1.0f},
-  [TILE_SHAPE_RAMP_NORTHWEST_INNER] = {1.0f, 0.0f, 1.0f, 1.0f},
-  [TILE_SHAPE_RAMP_SOUTHEAST_INNER] = {1.0f, 1.0f, 1.0f, 0.0f},
-  [TILE_SHAPE_RAMP_SOUTHWEST_INNER] = {1.0f, 1.0f, 0.0f, 1.0f},
-};
 
 errorret_t assetChunkLoaderAsync(assetloading_t *loading) {
   assertNotNull(loading, "Loading cannot be NULL");
   assertNotMainThread("Should be called from an async thread.");
+
+  if(loading->loading.chunk.state != ASSET_CHUNK_LOADING_STATE_READ_FILE) {
     errorOk();
-}
-
-static bool_t assetChunkTilesHaveTerrain(const tile_t *tiles) {
-  for(uint32_t i = 0; i < CHUNK_TILE_COUNT; i++) {
-    if(tiles[i].shape != TILE_SHAPE_NULL) return true;
   }
-  return false;
-}
 
-// Reads the "tiles" array - a dense, fixed-size CHUNK_TILE_COUNT grid,
+  assertNull(loading->loading.chunk.data, "Data already defined?");
-// one slot per (x, y) column at index x + y * CHUNK_WIDTH (position is
-// implicit in the index, not stored). Each slot is either `null` (empty
-// column, already zeroed = TILE_SHAPE_NULL) or a 2-element [type, z]
-// array.
-static void assetChunkParseTiles(yyjson_val *root, tile_t *tiles) {
-  memoryZero(tiles, CHUNK_TILE_COUNT * sizeof(tile_t));
 
-  yyjson_val *tilesArr = yyjson_obj_get(root, "tiles");
+  assetfile_t *file = &loading->loading.chunk.file;
-  if(!yyjson_is_arr(tilesArr)) return;
+  assetLoaderErrorChain(loading,
-
+    assetFileInit(file, loading->entry->name, NULL, NULL)
-  size_t idx, len;
-  yyjson_val *tileVal;
-  yyjson_arr_foreach(tilesArr, idx, len, tileVal) {
-    if(idx >= CHUNK_TILE_COUNT) break;
-    if(!yyjson_is_arr(tileVal) || yyjson_arr_size(tileVal) < 2) continue;
-
-    int32_t type = (int32_t)yyjson_get_int(yyjson_arr_get(tileVal, 0));
-    int32_t z = (int32_t)yyjson_get_int(yyjson_arr_get(tileVal, 1));
-    tiles[idx] = (tile_t){ .shape = (tileshape_t)type, .z = (uint8_t)z };
-  }
-}
-
-// Resolves "meshes" (external building references, by bare filename) into
-// out->modelNames/meshOffsets starting at *ioIndex, advancing it as
-// entries are written. Filenames are resolved as
-// "models/buildings/<basename>.json" - a hardcoded stand-in for
-// tools/asset/chunk/__main__.py's find_model() recursive search, valid
-// as long as every building model lives flat under that one directory
-// (true today - see the raw-json-maps plan notes for the tradeoff).
-static void assetChunkParseMeshes(
-  yyjson_val *root, assetchunkoutput_t *out, uint8_t *ioIndex
-) {
-  yyjson_val *meshesArr = yyjson_obj_get(root, "meshes");
-  if(!yyjson_is_arr(meshesArr)) return;
-
-  size_t idx, len;
-  yyjson_val *meshVal;
-  yyjson_arr_foreach(meshesArr, idx, len, meshVal) {
-    if(*ioIndex >= CHUNK_MESH_COUNT_MAX) break;
-
-    yyjson_val *fileVal = yyjson_obj_get(meshVal, "file");
-    if(!fileVal || !yyjson_is_str(fileVal)) continue;
-
-    char_t baseName[CHUNK_MESH_NAME_MAX];
-    stringCopy(baseName, yyjson_get_str(fileVal), sizeof(baseName));
-    char_t *dot = stringFindLastChar(baseName, '.');
-    if(dot != NULL) *dot = '\0';
-
-    uint8_t m = *ioIndex;
-    stringFormat(
-      out->modelNames[m], CHUNK_MESH_NAME_MAX,
-      "models/buildings/%s.json", baseName
   );
 
-    vec3 offset = {0.0f, 0.0f, 0.0f};
+  uint8_t *data = memoryAllocate(file->size);
-    yyjson_val *posArr = yyjson_obj_get(meshVal, "pos");
+  assetLoaderErrorChain(loading, assetFileOpen(file));
-    if(yyjson_is_arr(posArr) && yyjson_arr_size(posArr) >= 3) {
+  assetLoaderErrorChain(loading, assetFileRead(file, data, file->size));
-      offset[0] = (float_t)yyjson_get_num(yyjson_arr_get(posArr, 0));
+  assetLoaderErrorChain(loading, assetFileClose(file));
-      offset[1] = (float_t)yyjson_get_num(yyjson_arr_get(posArr, 1));
+  assetLoaderErrorChain(loading, assetFileDispose(file));
-      offset[2] = (float_t)yyjson_get_num(yyjson_arr_get(posArr, 2));
+  assertTrue(
-    }
+    file->lastRead == file->size,
-    memoryCopy(out->meshOffsets[m], offset, sizeof(vec3));
+    "Failed to read entire chunk file."
-
-    (*ioIndex)++;
-  }
-}
-
-static void assetChunkParseEntities(yyjson_val *root, assetchunkoutput_t *out) {
-  out->entitySpawnCount = 0;
-
-  yyjson_val *arr = yyjson_obj_get(root, "entities");
-  if(!yyjson_is_arr(arr)) return;
-
-  size_t idx, len;
-  yyjson_val *val;
-  yyjson_arr_foreach(arr, idx, len, val) {
-    if(out->entitySpawnCount >= CHUNK_ENTITY_SPAWN_COUNT_MAX) break;
-
-    const char_t *type = yyjson_get_str(yyjson_obj_get(val, "type"));
-    yyjson_val *posArr = yyjson_obj_get(val, "pos");
-    if(type == NULL || !yyjson_is_arr(posArr) || yyjson_arr_size(posArr) < 3) {
-      continue;
-    }
-    worldpos_t pos = {
-      .x = (worldunit_t)yyjson_get_int(yyjson_arr_get(posArr, 0)),
-      .y = (worldunit_t)yyjson_get_int(yyjson_arr_get(posArr, 1)),
-      .z = (worldunit_t)yyjson_get_int(yyjson_arr_get(posArr, 2)),
-    };
-
-    chunkentityspawn_t *spawn = &out->entitySpawns[out->entitySpawnCount];
-    if(stringEquals(type, "global")) {
-      spawn->kind = CHUNK_ENTITY_SPAWN_KIND_GLOBAL;
-      spawn->globalId =
-        (uint16_t)yyjson_get_int(yyjson_obj_get(val, "globalId"));
-      spawn->itemId = 0;
-      spawn->itemQuantity = 0;
-    } else if(stringEquals(type, "item")) {
-      spawn->kind = CHUNK_ENTITY_SPAWN_KIND_ITEM;
-      spawn->globalId = 0;
-      spawn->itemId = (uint16_t)yyjson_get_int(yyjson_obj_get(val, "itemId"));
-      spawn->itemQuantity =
-        (uint8_t)yyjson_get_int(yyjson_obj_get(val, "quantity"));
-    } else {
-      continue;
-    }
-    spawn->position = pos;
-    out->entitySpawnCount++;
-  }
-}
-
-static void assetChunkParseAreas(yyjson_val *root, assetchunkoutput_t *out) {
-  out->areaSpawnCount = 0;
-
-  yyjson_val *arr = yyjson_obj_get(root, "areas");
-  if(!yyjson_is_arr(arr)) return;
-
-  size_t idx, len;
-  yyjson_val *val;
-  yyjson_arr_foreach(arr, idx, len, val) {
-    if(out->areaSpawnCount >= CHUNK_AREA_COUNT_MAX) break;
-
-    yyjson_val *minArr = yyjson_obj_get(val, "min");
-    yyjson_val *maxArr = yyjson_obj_get(val, "max");
-    if(
-      !yyjson_is_arr(minArr) || yyjson_arr_size(minArr) < 3 ||
-      !yyjson_is_arr(maxArr) || yyjson_arr_size(maxArr) < 3
-    ) continue;
-
-    chunkareaspawn_t *area = &out->areaSpawns[out->areaSpawnCount];
-    area->min = (worldpos_t){
-      .x = (worldunit_t)yyjson_get_int(yyjson_arr_get(minArr, 0)),
-      .y = (worldunit_t)yyjson_get_int(yyjson_arr_get(minArr, 1)),
-      .z = (worldunit_t)yyjson_get_int(yyjson_arr_get(minArr, 2)),
-    };
-    area->max = (worldpos_t){
-      .x = (worldunit_t)yyjson_get_int(yyjson_arr_get(maxArr, 0)),
-      .y = (worldunit_t)yyjson_get_int(yyjson_arr_get(maxArr, 1)),
-      .z = (worldunit_t)yyjson_get_int(yyjson_arr_get(maxArr, 2)),
-    };
-    area->callbackId =
-      (uint16_t)yyjson_get_int(yyjson_obj_get(val, "callbackId"));
-    area->notify = (uint8_t)yyjson_get_int(yyjson_obj_get(val, "notify"));
-    area->trigger = (uint8_t)yyjson_get_int(yyjson_obj_get(val, "trigger"));
-    out->areaSpawnCount++;
-  }
-}
-
-// Six vertices (2 CCW triangles) for one tile's quad, matching
-// tools/asset/chunk/__main__.py's _tile_quad. Corner order: SW=(x,y),
-// SE=(x+1,y), NE=(x+1,y+1), NW=(x,y+1). NORTH=+Y, EAST=+X.
-static void assetChunkAppendTileQuad(
-  meshvertex_t *verts, uint32_t *vertCount,
-  const uint32_t x, const uint32_t y,
-  const float_t sw, const float_t se, const float_t ne, const float_t nw
-) {
-  const float_t u0 = (float_t)x / (float_t)CHUNK_WIDTH;
-  const float_t u1 = (float_t)(x + 1) / (float_t)CHUNK_WIDTH;
-  const float_t v0 = (float_t)y / (float_t)CHUNK_HEIGHT;
-  const float_t v1 = (float_t)(y + 1) / (float_t)CHUNK_HEIGHT;
-  const float_t fx = (float_t)x;
-  const float_t fy = (float_t)y;
-
-  meshvertex_t *v = verts + *vertCount;
-  v[0] = (meshvertex_t){ .uv = {u0, v0}, .pos = {fx,     fy,     sw} };
-  v[1] = (meshvertex_t){ .uv = {u1, v0}, .pos = {fx + 1, fy,     se} };
-  v[2] = (meshvertex_t){ .uv = {u1, v1}, .pos = {fx + 1, fy + 1, ne} };
-  v[3] = (meshvertex_t){ .uv = {u0, v0}, .pos = {fx,     fy,     sw} };
-  v[4] = (meshvertex_t){ .uv = {u1, v1}, .pos = {fx + 1, fy + 1, ne} };
-  v[5] = (meshvertex_t){ .uv = {u0, v1}, .pos = {fx,     fy + 1, nw} };
-  *vertCount += 6;
-}
-
-// Builds a mesh_t straight from the tile grid - one quad per non-null
-// tile column, shaped by CHUNK_RAMP_CORNERS - the runtime equivalent of
-// tools/asset/chunk/__main__.py's build_terrain_verts. Only called once
-// assetChunkTilesHaveTerrain has confirmed at least one real tile exists.
-// Mirrors assetMeshLoaderSync's meshInit/meshFlush/free-after-upload
-// sequence (assetmeshloader.c) since this produces the same
-// assetmeshoutput_t shape, just from generated verts instead of a file.
-static errorret_t assetChunkBuildTerrain(
-  const tile_t *tiles, assetmeshoutput_t *out
-) {
-  meshvertex_t *verts = memoryAllocate(
-    CHUNK_TILE_COUNT * 6 * sizeof(meshvertex_t)
   );
-  uint32_t vertCount = 0;
-
-  for(uint32_t y = 0; y < CHUNK_HEIGHT; y++) {
-    for(uint32_t x = 0; x < CHUNK_WIDTH; x++) {
-      const tile_t *tile = &tiles[x + y * CHUNK_WIDTH];
-      if(tile->shape == TILE_SHAPE_NULL) continue;
-
-      const float_t *corners = CHUNK_RAMP_CORNERS[tile->shape];
-      const float_t fz = (float_t)tile->z;
-      assetChunkAppendTileQuad(
-        verts, &vertCount, x, y,
-        (fz + corners[0]) * WORLD_LAYER_HEIGHT,
-        (fz + corners[1]) * WORLD_LAYER_HEIGHT,
-        (fz + corners[2]) * WORLD_LAYER_HEIGHT,
-        (fz + corners[3]) * WORLD_LAYER_HEIGHT
-      );
-    }
-  }
-
-  assertTrue(vertCount > 0, "Terrain build called with no terrain tiles.");
-
-  out->vertices = verts;
-  errorret_t ret = meshInit(
-    &out->mesh, MESH_PRIMITIVE_TYPE_TRIANGLES, (int32_t)vertCount, verts
-  );
-  if(errorIsNotOk(ret)) {
-    memoryFree(out->vertices);
-    out->vertices = NULL;
-    errorChain(ret);
-  }
-  out->meshInitialized = true;
-
-  ret = meshFlush(&out->mesh, 0, (int32_t)vertCount);
-  if(errorIsNotOk(ret)) {
-    meshDispose(&out->mesh);
-    out->meshInitialized = false;
-    memoryFree(out->vertices);
-    out->vertices = NULL;
-    errorChain(ret);
-  }
-
-  #if defined(DUSK_OPENGL) && !defined(DUSK_OPENGL_LEGACY)
-    memoryFree(out->vertices);
-    out->vertices = NULL;
-  #endif
 
+  loading->loading.chunk.data = data;
+  loading->loading.chunk.state = ASSET_CHUNK_LOADING_STATE_PARSE;
+  loading->entry->state = ASSET_ENTRY_STATE_PENDING_SYNC;
   errorOk();
 }
 
@@ -298,8 +55,8 @@ errorret_t assetChunkLoaderSync(assetloading_t *loading) {
 
   switch(loading->loading.chunk.state) {
     case ASSET_CHUNK_LOADING_STATE_INITIAL:
-      loading->loading.chunk.state = ASSET_CHUNK_LOADING_STATE_PARSE;
+      loading->loading.chunk.state = ASSET_CHUNK_LOADING_STATE_READ_FILE;
-      loading->entry->state = ASSET_ENTRY_STATE_PENDING_SYNC;
+      loading->entry->state = ASSET_ENTRY_STATE_PENDING_ASYNC;
       errorOk();
 
     case ASSET_CHUNK_LOADING_STATE_PARSE:
@@ -312,7 +69,9 @@ errorret_t assetChunkLoaderSync(assetloading_t *loading) {
           out->modelEntries[m] = assetLock(
             out->modelNames[m], ASSET_LOADER_TYPE_MODEL, NULL
           );
-          assertNotNull(out->modelEntries[m], "Failed to lock model.");
+          assertNotNull(
+            out->modelEntries[m], "Failed to lock model."
+          );
           loading->entry->state = ASSET_ENTRY_STATE_PENDING_SYNC;
           errorOk();
         }
@@ -334,103 +93,126 @@ errorret_t assetChunkLoaderSync(assetloading_t *loading) {
       errorOk();
   }
 
-  // --- PARSE: lock+require the chunk's own JSON as a sub-asset, exactly
+  uint8_t *data = loading->loading.chunk.data;
-  // like assetmodelloader.c's ASSET_MODEL_LOADING_STATE_LOCK_ASSETS does
+  assertNotNull(data, "Chunk data should have been loaded by now.");
-  // for its model descriptor, then read everything out of it before
+
-  // unlocking (the yyjson_doc/vals only stay valid while jsonEntry does).
+  if(data[0] != 'D' || data[1] != 'C' || data[2] != 'F') {
-  char_t jsonKey[ASSET_FILE_NAME_MAX];
+    memoryFree(data);
-  stringFormat(jsonKey, sizeof(jsonKey), "json:%s", loading->entry->name);
+    assetLoaderErrorThrow(loading, "Invalid chunk file header");
-  assetloaderinput_t jsonInput;
+  }
-  memoryZero(&jsonInput, sizeof(jsonInput));
+
-  stringCopy(
+  uint32_t version = endianLittleToHost32(*(uint32_t *)(data + 4));
-    jsonInput.json.path, loading->entry->name, ASSET_FILE_NAME_MAX
+  if(version != ASSET_CHUNK_FILE_VERSION) {
-  );
+    memoryFree(data);
-  assetentry_t *jsonEntry =
-    assetLock(jsonKey, ASSET_LOADER_TYPE_JSON, &jsonInput);
-  errorret_t jsonRet = assetRequireLoaded(jsonEntry);
-  if(errorIsNotOk(jsonRet)) {
-    assetUnlockEntry(jsonEntry);
     assetLoaderErrorThrow(
-      loading, "Failed to load chunk JSON: %s", loading->entry->name
+      loading, "Unsupported chunk file version %u", version
     );
   }
 
-  yyjson_val *root = yyjson_doc_get_root(jsonEntry->data.json);
+  size_t offset = 8;
 
-  tile_t tiles[CHUNK_TILE_COUNT];
+  size_t tileSize = CHUNK_TILE_COUNT * sizeof(tile_t);
-  assetChunkParseTiles(root, tiles);
+  out->tiles = memoryAllocate(tileSize);
-  out->hasTerrain = assetChunkTilesHaveTerrain(tiles);
+  memoryCopy(out->tiles, data + offset, tileSize);
+  offset += tileSize;
 
-  uint8_t meshIndex = out->hasTerrain ? 1 : 0;
+  for(size_t t = 0; t < CHUNK_TILE_COUNT; t++) {
-  assetChunkParseMeshes(root, out, &meshIndex);
+    uint32_t *shape = (uint32_t *)&out->tiles[t].shape;
-  out->meshCount = meshIndex;
+    *shape = endianLittleToHost32(*shape);
-
-  assetChunkParseEntities(root, out);
-  assetChunkParseAreas(root, out);
-
-  assetUnlockEntry(jsonEntry);
-
-  out->tiles = memoryAllocate(CHUNK_TILE_COUNT * sizeof(tile_t));
-  memoryCopy(out->tiles, tiles, CHUNK_TILE_COUNT * sizeof(tile_t));
-
-  // Terrain: build the mesh, then wrap it in synthetic (non-cache,
-  // non-refcounted) mesh/model entries so modelEntries[0] behaves exactly
-  // like a real file-backed model entry for every downstream consumer -
-  // see the header's doc comment on hasTerrain/terrainMeshEntry.
-  if(out->hasTerrain) {
-    assetmeshoutput_t terrainMesh;
-    memoryZero(&terrainMesh, sizeof(terrainMesh));
-    errorret_t terrainRet = assetChunkBuildTerrain(out->tiles, &terrainMesh);
-    if(errorIsNotOk(terrainRet)) {
-      memoryFree(out->tiles);
-      out->tiles = NULL;
-      assetLoaderErrorThrow(
-        loading, "Failed to build chunk terrain mesh: %s",
-        loading->entry->name
-      );
   }
 
-    assetloaderinput_t texInput = { .texture = TEXTURE_FORMAT_RGBA };
+  out->meshCount = data[offset];
-    assetentry_t *texEntry = assetLock(
+  offset += sizeof(uint8_t);
-      ASSET_CHUNK_TERRAIN_TEXTURE, ASSET_LOADER_TYPE_TEXTURE, &texInput
+  assertTrue(
+    out->meshCount <= CHUNK_MESH_COUNT_MAX,
+    "Chunk mesh count exceeds maximum."
   );
-    errorret_t texRet = assetRequireLoaded(texEntry);
+
-    if(errorIsNotOk(texRet)) {
+  for(uint8_t m = 0; m < out->meshCount; m++) {
-      assetUnlockEntry(texEntry);
+    uint8_t nameLen = 0;
-      meshDispose(&terrainMesh.mesh);
+    while(
-      memoryFree(out->tiles);
+      data[offset + nameLen] != '\0' &&
-      out->tiles = NULL;
+      nameLen < CHUNK_MESH_NAME_MAX - 1
-      assetLoaderErrorThrow(
+    ) {
-        loading, "Failed to load chunk terrain texture: %s",
+      nameLen++;
-        loading->entry->name
+    }
+    memoryCopy(out->modelNames[m], data + offset, nameLen);
+    out->modelNames[m][nameLen] = '\0';
+    offset += nameLen + 1;
+
+    memoryCopy(out->meshOffsets[m], data + offset, sizeof(vec3));
+    offset += sizeof(vec3);
+    out->meshOffsets[m][0] = endianLittleToHostFloat(out->meshOffsets[m][0]);
+    out->meshOffsets[m][1] = endianLittleToHostFloat(out->meshOffsets[m][1]);
+    out->meshOffsets[m][2] = endianLittleToHostFloat(out->meshOffsets[m][2]);
+  }
+
+  out->entitySpawnCount = data[offset];
+  offset += sizeof(uint8_t);
+  assertTrue(
+    out->entitySpawnCount <= CHUNK_ENTITY_SPAWN_COUNT_MAX,
+    "Chunk entity spawn count exceeds maximum."
   );
+
+  for(uint8_t s = 0; s < out->entitySpawnCount; s++) {
+    chunkentityspawn_t *spawn = &out->entitySpawns[s];
+    spawn->kind = (chunkentityspawnkind_t)data[offset];
+    offset += sizeof(uint8_t);
+
+    uint16_t a;
+    memoryCopy(&a, data + offset, sizeof(uint16_t));
+    a = endianLittleToHost16(a);
+    offset += sizeof(uint16_t);
+
+    uint8_t b = data[offset];
+    offset += sizeof(uint8_t);
+
+    if(spawn->kind == CHUNK_ENTITY_SPAWN_KIND_ITEM) {
+      spawn->globalId = 0;
+      spawn->itemId = a;
+      spawn->itemQuantity = b;
+    } else {
+      spawn->globalId = a;
+      spawn->itemId = 0;
+      spawn->itemQuantity = 0;
     }
-    out->terrainTexEntry = texEntry;
 
-    out->terrainMeshEntry = memoryAllocate(sizeof(assetentry_t));
+    spawn->position = worldPosReadLE(data, &offset);
-    memoryZero(out->terrainMeshEntry, sizeof(assetentry_t));
-    out->terrainMeshEntry->type = ASSET_LOADER_TYPE_MESH;
-    out->terrainMeshEntry->state = ASSET_ENTRY_STATE_LOADED;
-    out->terrainMeshEntry->data.mesh = terrainMesh;
-
-    out->terrainModelEntry = memoryAllocate(sizeof(assetentry_t));
-    memoryZero(out->terrainModelEntry, sizeof(assetentry_t));
-    out->terrainModelEntry->type = ASSET_LOADER_TYPE_MODEL;
-    out->terrainModelEntry->state = ASSET_ENTRY_STATE_LOADED;
-    out->terrainModelEntry->data.model.meshEntry = out->terrainMeshEntry;
-    out->terrainModelEntry->data.model.texEntry = out->terrainTexEntry;
-    out->terrainModelEntry->data.model.color = COLOR_WHITE;
-
-    out->modelEntries[0] = out->terrainModelEntry;
   }
 
+  out->areaSpawnCount = data[offset];
+  offset += sizeof(uint8_t);
+  assertTrue(
+    out->areaSpawnCount <= CHUNK_AREA_COUNT_MAX,
+    "Chunk area spawn count exceeds maximum."
+  );
+
+  for(uint8_t s = 0; s < out->areaSpawnCount; s++) {
+    chunkareaspawn_t *area = &out->areaSpawns[s];
+    area->min = worldPosReadLE(data, &offset);
+    area->max = worldPosReadLE(data, &offset);
+
+    uint16_t callbackId;
+    memoryCopy(&callbackId, data + offset, sizeof(uint16_t));
+    area->callbackId = endianLittleToHost16(callbackId);
+    offset += sizeof(uint16_t);
+
+    area->notify = data[offset];
+    offset += sizeof(uint8_t);
+    area->trigger = data[offset];
+    offset += sizeof(uint8_t);
+  }
+
+  memoryFree(data);
+  loading->loading.chunk.data = NULL;
+
   if(out->meshCount == 0) {
     loading->entry->state = ASSET_ENTRY_STATE_LOADED;
     errorOk();
   }
 
   loading->loading.chunk.state = ASSET_CHUNK_LOADING_STATE_LOAD_MODELS;
-  loading->loading.chunk.modelIndex = out->hasTerrain ? 1 : 0;
+  loading->loading.chunk.modelIndex = 0;
   loading->entry->state = ASSET_ENTRY_STATE_PENDING_SYNC;
   errorOk();
 }
@@ -449,36 +231,8 @@ errorret_t assetChunkDispose(assetentry_t *entry) {
 
   for(uint8_t m = 0; m < out->meshCount; m++) {
     if(out->modelEntries[m] == NULL) continue;
-    if(out->hasTerrain && m == 0) continue; // synthetic - freed below.
     assetUnlockEntry(out->modelEntries[m]);
     out->modelEntries[m] = NULL;
   }
-
-  if(out->hasTerrain) {
-    if(out->terrainMeshEntry != NULL) {
-      assetmeshoutput_t *meshOut = &out->terrainMeshEntry->data.mesh;
-      if(meshOut->meshInitialized) {
-        meshDispose(&meshOut->mesh);
-        meshOut->meshInitialized = false;
-      }
-      if(meshOut->vertices != NULL) {
-        memoryFree(meshOut->vertices);
-        meshOut->vertices = NULL;
-      }
-      memoryFree(out->terrainMeshEntry);
-      out->terrainMeshEntry = NULL;
-    }
-    if(out->terrainModelEntry != NULL) {
-      memoryFree(out->terrainModelEntry);
-      out->terrainModelEntry = NULL;
-    }
-    if(out->terrainTexEntry != NULL) {
-      assetUnlockEntry(out->terrainTexEntry);
-      out->terrainTexEntry = NULL;
-    }
-    out->modelEntries[0] = NULL;
-    out->hasTerrain = false;
-  }
-
   errorOk();
 }

src/dusk/asset/loader/chunk/assetchunkloader.h

@@ -9,6 +9,8 @@
 #include "asset/assetfile.h"
 #include "rpg/overworld/chunk.h"
 
+#define ASSET_CHUNK_FILE_VERSION 5
+
 typedef struct assetloading_s assetloading_t;
 typedef struct assetentry_s assetentry_t;
 
@@ -18,17 +20,16 @@ typedef struct {
 
 typedef enum {
   ASSET_CHUNK_LOADING_STATE_INITIAL,
+  ASSET_CHUNK_LOADING_STATE_READ_FILE,
   ASSET_CHUNK_LOADING_STATE_PARSE,
   ASSET_CHUNK_LOADING_STATE_LOAD_MODELS,
   ASSET_CHUNK_LOADING_STATE_DONE
 } assetchunkloadingstate_t;
 
 typedef struct {
+  assetfile_t file;
   assetchunkloadingstate_t state;
-
+  uint8_t *data;
-  // Index into assetchunkoutput_t.modelNames/modelEntries the external
-  // (non-terrain) model polling loop has reached - see
-  // ASSET_CHUNK_LOADING_STATE_LOAD_MODELS.
   uint8_t modelIndex;
 } assetchunkloaderloading_t;
 
@@ -60,27 +61,6 @@ typedef struct {
   vec3 meshOffsets[CHUNK_MESH_COUNT_MAX];
   assetentry_t *modelEntries[CHUNK_MESH_COUNT_MAX];
 
-  // Terrain mesh generated at load time from the tile grid (no baked
-  // .dmf/.json - see assetChunkBuildTerrain in assetchunkloader.c). NULL
-  // (with hasTerrain false) for a chunk with no non-null tiles, in which
-  // case modelEntries[0] (if meshCount > 0) is the first external mesh
-  // instead - matches the old baked pipeline's "only write a terrain
-  // model if it has vertices" behavior.
-  //
-  // terrainMeshEntry/terrainModelEntry are heap-allocated, plain
-  // assetentry_t values that are never passed to assetLock/assetGetEntry/
-  // assetUnlockEntry (only a real, name-keyed, ref-counted entry may be)
-  // - they exist purely so modelEntries[0] can point at something with
-  // the same ->state/->data.model/->data.mesh.mesh shape every other
-  // model/mesh entry has, so chunk.c/map.c/sceneoverworld.c don't need to
-  // know terrain isn't file-backed. Freed directly (not assetUnlockEntry)
-  // in assetChunkDispose. terrainTexEntry is a real, ref-counted texture
-  // entry (the shared "tiles.png") and must be assetUnlockEntry'd there.
-  bool_t hasTerrain;
-  assetentry_t *terrainMeshEntry;
-  assetentry_t *terrainModelEntry;
-  assetentry_t *terrainTexEntry;
-
   uint8_t entitySpawnCount;
   chunkentityspawn_t entitySpawns[CHUNK_ENTITY_SPAWN_COUNT_MAX];
 
@@ -89,10 +69,9 @@ typedef struct {
 } assetchunkoutput_t;
 
 /**
- * Async loader stub for chunk assets. Chunk loading is performed entirely
+ * Asynchronous loader for chunk assets. Reads the raw DCF file bytes into
- * on the main thread (it delegates to the JSON asset loader and to
+ * the loading buffer so the sync phase can parse without blocking the
- * meshInit/meshFlush, both main-thread-only); this callback is never
+ * main thread on I/O.
- * reached.
  *
  * @param loading Loading information for the asset being loaded.
  * @return Error code indicating success or failure of the load operation.
@@ -100,11 +79,9 @@ typedef struct {
 errorret_t assetChunkLoaderAsync(assetloading_t *loading);
 
 /**
- * Synchronous loader for chunk assets. Locks the chunk's JSON descriptor
+ * Synchronous loader for chunk assets. Validates the DCF binary previously
- * as a sub-asset, parses tiles/external mesh references/entity spawns/
+ * read by the async phase and populates the output assetchunkoutput_t with
- * area spawns, generates the terrain mesh directly from the tile grid,
+ * tile data and model paths.
- * and locks/waits for every referenced model (and the terrain's shared
- * tileset texture) to finish loading.
  *
  * @param loading Loading information for the asset being loaded.
  * @return Error code indicating success or failure of the load operation.

src/dusk/asset/loader/cutscene/CMakeLists.txt

@@ -3,8 +3,7 @@
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
 
-# Sources
 target_sources(${DUSK_LIBRARY_TARGET_NAME}
   PUBLIC
-    perf.c
+    assetcutsceneloader.c
 )

src/dusk/asset/loader/cutscene/assetcutsceneloader.c

@@ -0,0 +1,225 @@
+/**
+ * Copyright (c) 2026 Dominic Masters
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+#include "assetcutsceneloader.h"
+#include "assert/assert.h"
+#include "util/memory.h"
+#include "util/string.h"
+#include "asset/loader/assetloading.h"
+#include "asset/loader/assetentry.h"
+#include "asset/loader/assetloader.h"
+#include "asset/asset.h"
+#include "rpg/cutscene/item/json/cutscenejsonpauseflags.h"
+
+errorret_t assetCutsceneParseItem(
+  assetloading_t *loading,
+  yyjson_val *itemObj,
+  cutsceneitem_t *item,
+  uint8_t *pool,
+  size_t *poolOffset,
+  const uint8_t index
+) {
+  if(!yyjson_is_obj(itemObj)) {
+    assetLoaderErrorThrow(
+      loading,
+      "Cutscene item %u is not an object",
+      (uint32_t)index
+    );
+  }
+
+  const char_t *typeName = yyjson_get_str(yyjson_obj_get(itemObj, "type"));
+  if(!cutsceneItemLookupType(typeName, &item->type)) {
+    assetLoaderErrorThrow(
+      loading,
+      "Cutscene item %u: missing/unsupported item type %s",
+      (uint32_t)index,
+      typeName
+    );
+  }
+
+  cutsceneitemloadcallback_t *load = CUTSCENE_ITEM_CALLBACKS[item->type].load;
+  if(load == NULL) {
+    assetLoaderErrorThrow(
+      loading, "Cutscene item %u: unhandled item type %u", (uint32_t)index,
+      (uint32_t)item->type
+    );
+  }
+
+  errorret_t result = load(itemObj, item, pool, poolOffset);
+  if(errorIsNotOk(result)) {
+    loading->entry->state = ASSET_ENTRY_STATE_ERROR;
+    errorChain(result);
+  }
+
+  errorOk();
+}
+
+size_t assetCutsceneComputePoolSize(yyjson_val *itemsArr) {
+  size_t size = 0;
+  yyjson_arr_iter iter = yyjson_arr_iter_with(itemsArr);
+  yyjson_val *itemVal;
+  while((itemVal = yyjson_arr_iter_next(&iter)) != NULL) {
+    const char_t *typeName = yyjson_get_str(yyjson_obj_get(itemVal, "type"));
+    cutsceneitemtype_t type;
+    if(!cutsceneItemLookupType(typeName, &type)) continue;
+
+    cutsceneitempoolsizecallback_t *poolSize =
+      CUTSCENE_ITEM_CALLBACKS[type].poolSize;
+    if(poolSize == NULL) continue;
+
+    size = cutsceneJsonPoolAlign(size) + poolSize(itemVal);
+  }
+  return size;
+}
+
+void assetCutsceneFreeParsed(assetcutsceneoutput_t *out) {
+  if(out->items != NULL) {
+    memoryFree(out->items);
+    out->items = NULL;
+  }
+  if(out->pool != NULL) {
+    memoryFree(out->pool);
+    out->pool = NULL;
+  }
+  if(out->doc != NULL) {
+    yyjson_doc_free(out->doc);
+    out->doc = NULL;
+  }
+}
+
+errorret_t assetCutsceneLoaderAsync(assetloading_t *loading) {
+  assertNotNull(loading, "Loading cannot be NULL");
+  assertNotMainThread("Should be called from an async thread.");
+
+  if(
+    loading->loading.cutscene.state != ASSET_CUTSCENE_LOADING_STATE_READ_FILE
+  ) {
+    errorOk();
+  }
+
+  assertNull(loading->loading.cutscene.buffer, "Buffer already defined?");
+
+  assetfile_t *file = &loading->loading.cutscene.file;
+  assetLoaderErrorChain(loading,
+    assetFileInit(file, loading->entry->name, NULL, NULL)
+  );
+
+  if(file->size > ASSET_CUTSCENE_FILE_SIZE_MAX) {
+    assetLoaderErrorThrow(
+      loading, "Cutscene JSON exceeds maximum allowed size"
+    );
+  }
+
+  size_t fileSize = (size_t)file->size;
+  uint8_t *buffer = memoryAllocate(fileSize);
+  assetLoaderErrorChain(loading, assetFileOpen(file));
+  assetLoaderErrorChain(loading, assetFileRead(file, buffer, fileSize));
+  assertTrue(
+    file->lastRead == file->size,
+    "Failed to read entire cutscene file."
+  );
+  assetLoaderErrorChain(loading, assetFileClose(file));
+  assetLoaderErrorChain(loading, assetFileDispose(file));
+
+  loading->loading.cutscene.buffer = buffer;
+  loading->loading.cutscene.size = fileSize;
+  loading->loading.cutscene.state = ASSET_CUTSCENE_LOADING_STATE_PARSE;
+  loading->entry->state = ASSET_ENTRY_STATE_PENDING_SYNC;
+  errorOk();
+}
+
+errorret_t assetCutsceneLoaderSync(assetloading_t *loading) {
+  assertNotNull(loading, "Loading cannot be NULL");
+  assertTrue(loading->type == ASSET_LOADER_TYPE_CUTSCENE, "Invalid type.");
+  assertIsMainThread("Must be called from the main thread.");
+
+  if(loading->loading.cutscene.state == ASSET_CUTSCENE_LOADING_STATE_INITIAL) {
+    loading->loading.cutscene.state = ASSET_CUTSCENE_LOADING_STATE_READ_FILE;
+    loading->entry->state = ASSET_ENTRY_STATE_PENDING_ASYNC;
+    errorOk();
+  }
+
+  assetcutsceneoutput_t *out = &loading->entry->data.cutscene;
+  uint8_t *buffer = loading->loading.cutscene.buffer;
+  assertNotNull(buffer, "Cutscene data should have been loaded by now.");
+  size_t bufferSize = loading->loading.cutscene.size;
+
+  yyjson_doc *doc = yyjson_read(
+    (char *)buffer, bufferSize,
+    YYJSON_READ_ALLOW_COMMENTS | YYJSON_READ_ALLOW_TRAILING_COMMAS
+  );
+  memoryFree(buffer);
+  loading->loading.cutscene.buffer = NULL;
+
+  if(doc == NULL) {
+    assetLoaderErrorThrow(loading, "Failed to parse cutscene JSON");
+  }
+  out->doc = doc;
+
+  yyjson_val *root = yyjson_doc_get_root(doc);
+  yyjson_val *itemsArr = yyjson_obj_get(root, "items");
+  if(!yyjson_is_arr(itemsArr)) {
+    assetCutsceneFreeParsed(out);
+    assetLoaderErrorThrow(loading, "Cutscene JSON is missing an 'items' array");
+  }
+
+  size_t itemCount = yyjson_arr_size(itemsArr);
+  if(itemCount > UINT8_MAX) {
+    assetCutsceneFreeParsed(out);
+    assetLoaderErrorThrow(loading, "Cutscene has more than 255 items");
+  }
+
+  cutscenepause_t pause = CUTSCENE_PAUSE_DEFAULT;
+  yyjson_val *pauseArr = yyjson_obj_get(root, "pause");
+  if(yyjson_is_arr(pauseArr)) {
+    if(!cutsceneJsonParsePauseFlags(pauseArr, &pause)) {
+      assetCutsceneFreeParsed(out);
+      assetLoaderErrorThrow(
+        loading, "Cutscene JSON has an invalid 'pause' flag"
+      );
+    }
+  }
+
+  out->items = memoryAllocate(itemCount * sizeof(cutsceneitem_t));
+  memoryZero(out->items, itemCount * sizeof(cutsceneitem_t));
+
+  size_t poolSize = assetCutsceneComputePoolSize(itemsArr);
+  out->pool = poolSize > 0 ? memoryAllocate(poolSize) : NULL;
+
+  size_t poolOffset = 0;
+  yyjson_arr_iter itemIter = yyjson_arr_iter_with(itemsArr);
+  yyjson_val *itemVal;
+  uint8_t index = 0;
+  while((itemVal = yyjson_arr_iter_next(&itemIter)) != NULL) {
+    errorret_t itemResult = assetCutsceneParseItem(
+      loading, itemVal, &out->items[index], out->pool, &poolOffset, index
+    );
+    if(errorIsNotOk(itemResult)) {
+      assetCutsceneFreeParsed(out);
+      errorChain(itemResult);
+    }
+    index++;
+  }
+
+  out->cutscene.items = out->items;
+  out->cutscene.itemCount = (uint8_t)itemCount;
+  out->cutscene.pause = pause;
+  out->cutscene.dataSize = 0;
+
+  loading->entry->state = ASSET_ENTRY_STATE_LOADED;
+  errorOk();
+}
+
+errorret_t assetCutsceneDispose(assetentry_t *entry) {
+  assertNotNull(entry, "Entry cannot be NULL");
+  assertTrue(entry->type == ASSET_LOADER_TYPE_CUTSCENE, "Invalid type.");
+  assertIsMainThread("Must be called from the main thread.");
+
+  assetCutsceneFreeParsed(&entry->data.cutscene);
+
+  errorOk();
+}

src/dusk/asset/loader/cutscene/assetcutsceneloader.h

@@ -0,0 +1,106 @@
+/**
+ * Copyright (c) 2026 Dominic Masters
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+#pragma once
+#include "asset/assetfile.h"
+#include "rpg/cutscene/cutscene.h"
+#include "rpg/cutscene/item/cutsceneitem.h"
+#include "rpg/cutscene/item/json/cutscenejsonpool.h"
+#include "yyjson.h"
+
+#define ASSET_CUTSCENE_FILE_SIZE_MAX (1024 * 64)
+
+typedef struct assetloading_s assetloading_t;
+typedef struct assetentry_s assetentry_t;
+
+typedef struct {
+  void *nothing;
+} assetcutsceneloaderinput_t;
+
+typedef enum {
+  ASSET_CUTSCENE_LOADING_STATE_INITIAL,
+  ASSET_CUTSCENE_LOADING_STATE_READ_FILE,
+  ASSET_CUTSCENE_LOADING_STATE_PARSE
+} assetcutsceneloadingstate_t;
+
+typedef struct {
+  assetfile_t file;
+  assetcutsceneloadingstate_t state;
+  uint8_t *buffer;
+  size_t size;
+} assetcutsceneloaderloading_t;
+
+typedef struct {
+  cutscene_t cutscene;
+  cutsceneitem_t *items;
+  uint8_t *pool;
+  yyjson_doc *doc;
+} assetcutsceneoutput_t;
+
+/**
+ * Parses one cutscene item object into item, writing any pool-backed
+ * array data (entityWalkTo positions, mapAreaWait areaIds) into pool at
+ * *poolOffset and advancing it. Every field/enum name is validated as
+ * real (untrusted, authored) file content - failures are real errors, not
+ * asserts. Dispatches to the matching type's Load callback (see
+ * CUTSCENE_ITEM_CALLBACKS in rpg/cutscene/item/cutsceneitem.h) - the
+ * per-type parsing logic itself lives there now, colocated with that
+ * type's runtime behavior.
+ *
+ * @param loading Loading information for the asset being loaded.
+ * @param itemObj The item's JSON object.
+ * @param item Destination item, already zeroed by the caller.
+ * @param pool Base pointer of the entry's pool allocation (may be NULL if
+ * assetCutsceneComputePoolSize returned 0).
+ * @param poolOffset In/out cursor into pool.
+ * @param index Index of this item within the cutscene, for error messages.
+ * @return Error code indicating success or failure of the parse.
+ */
+errorret_t assetCutsceneParseItem(
+  assetloading_t *loading,
+  yyjson_val *itemObj,
+  cutsceneitem_t *item,
+  uint8_t *pool,
+  size_t *poolOffset,
+  const uint8_t index
+);
+
+/**
+ * Frees whatever of out->items/out->pool/out->doc is currently non-NULL
+ * and clears them - shared by both the normal disposer and every parse
+ * failure path's cleanup.
+ *
+ * @param out The output to free.
+ */
+void assetCutsceneFreeParsed(assetcutsceneoutput_t *out);
+
+/**
+ * Asynchronous loader for cutscene assets. Reads the raw JSONC file bytes
+ * into the loading buffer so the sync phase can parse without blocking the
+ * main thread on I/O.
+ *
+ * @param loading Loading information for the asset being loaded.
+ * @return Error code indicating success or failure of the load operation.
+ */
+errorret_t assetCutsceneLoaderAsync(assetloading_t *loading);
+
+/**
+ * Synchronous loader for cutscene assets. Parses the JSONC previously read
+ * by the async phase into a heap-allocated cutsceneitem_t array + pool.
+ *
+ * @param loading Loading information for the asset being loaded.
+ * @return Error code indicating success or failure of the load operation.
+ */
+errorret_t assetCutsceneLoaderSync(assetloading_t *loading);
+
+/**
+ * Disposer for cutscene assets.
+ *
+ * @param entry Asset entry containing the cutscene data to dispose.
+ * @return Error code indicating success or failure of the dispose operation.
+ */
+errorret_t assetCutsceneDispose(assetentry_t *entry);

src/dusk/asset/loader/dmf/assetmodelloader.c

@@ -62,7 +62,7 @@ errorret_t assetModelLoaderSync(assetloading_t *loading) {
 
       // Parse required mesh path.
       yyjson_val *meshVal = yyjson_obj_get(root, "mesh");
-      if(!meshVal || !yyjson_is_str(meshVal)) {
+      if(meshVal == NULL || !yyjson_is_str(meshVal)) {
         assetUnlockEntry(jsonEntry);
         loading->entry->state = ASSET_ENTRY_STATE_ERROR;
         errorThrow("Model JSON missing 'mesh' string");

src/dusk/asset/loader/dmf/assetmodelloader.h

@@ -32,7 +32,7 @@ typedef struct {
  * on the main thread; this callback is never reached.
  *
  * @param loading Loading information for the asset being loaded.
- * @returns Always success.
+ * @return Always success.
  */
 errorret_t assetModelLoaderAsync(assetloading_t *loading);
 
@@ -44,7 +44,7 @@ errorret_t assetModelLoaderAsync(assetloading_t *loading);
  * within ASSET_LOADING_COUNT_MAX slot limits.
  *
  * @param loading Loading information for the asset being loaded.
- * @returns Error code indicating success or failure.
+ * @return Error code indicating success or failure.
  */
 errorret_t assetModelLoaderSync(assetloading_t *loading);
 
@@ -53,6 +53,6 @@ errorret_t assetModelLoaderSync(assetloading_t *loading);
  * sub-asset entries.
  *
  * @param entry Asset entry containing the model to dispose.
- * @returns Error code indicating success or failure.
+ * @return Error code indicating success or failure.
  */
 errorret_t assetModelDispose(assetentry_t *entry);

src/dusk/asset/loader/json/assetjsonloader.c

@@ -77,7 +77,7 @@ errorret_t assetJsonLoaderSync(assetloading_t *loading) {
   memoryFree(buffer);
   loading->loading.json.buffer = NULL;
 
-  if(!loading->entry->data.json) {
+  if(loading->entry->data.json == NULL) {
     assetLoaderErrorThrow(loading, "Failed to parse JSON");
   }
 

src/dusk/asset/loader/json/assetjsonloader.h

@@ -41,6 +41,32 @@ typedef struct {
 
 typedef yyjson_doc * assetjsonoutput_t;
 
+/**
+ * Asynchronous loader callback. Opens the JSON file and reads the whole of
+ * it into a heap buffer, so the main thread is not blocked on I/O. The
+ * buffer is parsed later, on the main thread, by assetJsonLoaderSync. Sets
+ * the entry state to `ASSET_ENTRY_STATE_PENDING_SYNC` on success.
+ *
+ * @param loading The loading slot for this asset entry.
+ * @return OK on success, error otherwise.
+ */
 errorret_t assetJsonLoaderAsync(assetloading_t *loading);
+
+/**
+ * Synchronous loader callback. Drives the load state machine: on the first
+ * call it queues the async read, and once that has completed it parses the
+ * buffer into a `yyjson_doc` (comments and trailing commas allowed), frees
+ * the buffer and marks the entry `ASSET_ENTRY_STATE_LOADED`.
+ *
+ * @param loading The loading slot for this asset entry.
+ * @return OK on success, error otherwise.
+ */
 errorret_t assetJsonLoaderSync(assetloading_t *loading);
+
+/**
+ * Dispose callback. Frees the parsed `yyjson_doc` held by the entry.
+ *
+ * @param entry The asset entry to dispose.
+ * @return OK on success, error otherwise.
+ */
 errorret_t assetJsonDispose(assetentry_t *entry);

src/dusk/asset/loader/locale/assetlocaleloader.c

@@ -93,7 +93,7 @@ errorret_t assetLocaleParseHeader(
 
   // Find "Plural-Forms: " line and parse out plural form info
   char_t *pluralFormsLine = strstr(headerBuffer, "Plural-Forms:");
-  if(!pluralFormsLine) {
+  if(pluralFormsLine == NULL) {
     errorOk();
   }
 
@@ -101,7 +101,7 @@ errorret_t assetLocaleParseHeader(
 
   // Expect nplurals
   char_t *npluralsStr = strstr(pluralFormsLine, "nplurals=");
-  if(!npluralsStr) {
+  if(npluralsStr == NULL) {
     errorThrow("Failed to find nplurals in Plural-Forms header.");
   }
   npluralsStr += strlen("nplurals=");
@@ -120,7 +120,7 @@ errorret_t assetLocaleParseHeader(
 
   // Expect plural=
   char_t *pluralStr = strstr(pluralFormsLine, "plural=");
-  if(!pluralStr) {
+  if(pluralStr == NULL) {
     errorThrow("Failed to find plural in Plural-Forms header.");
   }
   pluralStr += strlen("plural=");
@@ -128,7 +128,7 @@ errorret_t assetLocaleParseHeader(
   // Expect ( [expressions] )
   char_t *openParen = strchr(pluralStr, '(');
   char_t *closeParen = strrchr(pluralStr, ')');
-  if(!openParen || !closeParen || closeParen < openParen) {
+  if(openParen == NULL || closeParen == NULL || closeParen < openParen) {
     errorThrow("Failed to find plural expression in Plural-Forms header.");
   }
 
@@ -399,12 +399,12 @@ errorret_t assetLocaleLineUnbuffer(
 
   // At the point this funciton is called, we are looking for an opening quote.
   char_t *start = strchr((char_t *)lineBuffer, '"');
-  if(!start) {
+  if(start == NULL) {
     errorThrow("Expected open (0) \"");
   }
 
   char *end = strchr(start + 1, '"');
-  if(!end) {
+  if(end == NULL) {
     errorThrow("Expected close (0) \"");
   }
   *end = '\0';
@@ -690,7 +690,7 @@ errorret_t assetLocaleGetStringLookup(
 
       // Parse until ]
       char *end = strchr(ptr, ']');
-      if(!end) {
+      if(end == NULL) {
         errorThrow("Expected ] for plural form, found: %s", lineBuffer);
       }
       *end = '\0';
@@ -854,7 +854,7 @@ errorret_t assetLocaleGetStringWithArgs(
 
     inIndex++;
 
-    /* Escaped percent */
+    // Escaped percent
     if(format[inIndex] == '%') {
       if(outIndex + 1 >= bufferSize) {
         memoryFree(format);
@@ -880,7 +880,7 @@ errorret_t assetLocaleGetStringWithArgs(
 
       specBuffer[specLength++] = '%';
 
-      /* Allow flags / width / precision */
+      // Allow flags / width / precision
       while(format[inIndex] != '\0') {
         char_t ch = format[inIndex];
 

src/dusk/audio/mixer/audiomixerchannel.h

@@ -12,10 +12,11 @@
 
 // Forward-declared rather than including asset/asset.h - this header only
 // ever needs a pointer to it, and pulling in the full asset module here
-// risks an include cycle for anything that reaches this header via a
+// creates a real include cycle for anything that reaches this header via
-// cutscene item (cutscene.h -> cutsceneitem.h -> the audio cutscene items
+// asset/loader/cutscene/assetcutsceneloader.h (asset.h -> ... ->
-// -> this header -> asset/asset.h, mid-parse). audiomixerchannel.c itself
+// assetloader.h -> assetcutsceneloader.h -> cutscene.h -> cutsceneitem.h
-// still includes the full header.
+// -> the audio cutscene items -> this header -> asset/asset.h again,
+// mid-parse). audiomixerchannel.c itself still includes the full header.
 typedef struct assetentry_s assetentry_t;
 
 typedef struct audiostream_s audiostream_t;

src/dusk/audio/stream/audiostreampcm.c

@@ -87,10 +87,10 @@ errorret_t audioStreamPcmSeek(audiostream_t *stream, const size_t frame) {
 
   const size_t currentByte = (size_t) stream->pcm.file.position;
   if(targetByte < currentByte) {
-    // A rewind is needed to move the read cursor earlier once it's
+    // Only a full rewind can move a read cursor earlier once it's already
-    // already advanced past a point - assetFileRewind() takes the cheap
+    // advanced past a point - a compressed archive entry can't be decoded
-    // in-place seek path since every dusk.dsk entry is stored
+    // backward. See this function's own doc comment for the performance
-    // uncompressed.
+    // implications of a deep loopTo.
     errorChain(assetFileRewind(&stream->pcm.file));
     errorChain(assetFileRead(&stream->pcm.file, NULL, targetByte));
   } else if(targetByte > currentByte) {

src/dusk/audio/stream/audiostreampcm.h

@@ -63,8 +63,11 @@ size_t audioStreamPcmGetTotalFrames(const audiostream_t *stream);
  * (relative to the start of the PCM data - the same units as
  * audiostream_t's startFrame/loopStart/loopTo, once converted from
  * seconds). Seeking backward re-reads from the start of the underlying
- * asset file (see assetFileRewind()), which is a cheap in-place seek
+ * asset file (see assetFileRewind()) since a compressed archive entry can
- * since every dusk.dsk entry is stored uncompressed.
+ * only be decoded forward - this makes a loop with a deep loopTo more
+ * expensive to restart than one near the start, which is a real
+ * performance caveat, not just a theoretical one, for anything backed by
+ * a compressed (not stored) asset archive entry.
  *
  * @param stream The audio stream to seek. Must be AUDIO_STREAM_TYPE_PCM.
  * @param frame Frame offset to seek to, relative to the start of the PCM

src/dusk/display/mesh/capsule.c

@@ -55,8 +55,8 @@ void capsuleBuffer(
     vertices[vi].uv[1]    = (v);  \
     vi++;
 
-  /* ---- Top hemisphere ---- */
+  // ---- Top hemisphere ----
-  /* phi ranges from PI/2 (top pole) down to 0 (equator). */
+  // phi ranges from PI/2 (top pole) down to 0 (equator).
   const float_t capStep = (float_t)GLM_PI_2 / (float_t)capRings;
   for(int32_t i = 0; i < capRings; i++) {
     const float_t phi1 = (float_t)GLM_PI_2 - (float_t)i       * capStep;
@@ -67,8 +67,8 @@ void capsuleBuffer(
     const float_t lxz1 = radius * cosf(phi1);
     const float_t lxz2 = radius * cosf(phi2);
 
-    /* UV: top cap occupies v in [0.5 + halfHeightFrac .. 1.0]: we use a
+    // UV: top cap occupies v in [0.5 + halfHeightFrac .. 1.0]: we use a
-     * simple per-band normalisation against the full height. */
+    // simple per-band normalisation against the full height.
     const float_t v1 = 1.0f - (float_t)i       / (float_t)(2 * capRings + 1);
     const float_t v2 = 1.0f - (float_t)(i + 1) / (float_t)(2 * capRings + 1);
 
@@ -97,7 +97,7 @@ void capsuleBuffer(
     }
   }
 
-  /* ---- Cylindrical body ---- */
+  // ---- Cylindrical body ----
   {
     const float_t yTop = cy + halfHeight;
     const float_t yBot = cy - halfHeight;

src/dusk/display/mesh/mesh.h

@@ -1,7 +1,9 @@
-// Copyright (c) 2026 Dominic Masters
+/**
-// 
+ * Copyright (c) 2026 Dominic Masters
-// This software is released under the MIT License.
+ *
-// https://opensource.org/licenses/MIT
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
 
 #pragma once
 #include "display/display.h"

src/dusk/display/mesh/plane.c

@@ -59,7 +59,7 @@ void planeBuffer(
 
   switch(axis) {
     case PLANE_AXIS_XY: {
-      /* Flat in XY at z = min[2]; spans X and Y. */
+      // Flat in XY at z = min[2]; spans X and Y.
       const float_t z = min[2];
       PLANE_VERT(0, min[0], min[1], z, u0, v0)
       PLANE_VERT(1, max[0], min[1], z, u1, v0)
@@ -71,7 +71,7 @@ void planeBuffer(
     }
 
     case PLANE_AXIS_XZ: {
-      /* Flat in XZ at y = min[1]; spans X and Z. */
+      // Flat in XZ at y = min[1]; spans X and Z.
       const float_t y = min[1];
       PLANE_VERT(0, min[0], y, min[2], u0, v0)
       PLANE_VERT(1, max[0], y, min[2], u1, v0)
@@ -83,7 +83,7 @@ void planeBuffer(
     }
 
     case PLANE_AXIS_YZ: {
-      /* Flat in YZ at x = min[0]; spans Y and Z. */
+      // Flat in YZ at x = min[0]; spans Y and Z.
       const float_t x = min[0];
       PLANE_VERT(0, x, min[1], min[2], u0, v0)
       PLANE_VERT(1, x, max[1], min[2], u1, v0)

src/dusk/display/mesh/sphere.c

@@ -44,7 +44,7 @@ void sphereBuffer(
   int32_t vi = 0;
 
   for(int32_t i = 0; i < stacks; i++) {
-    /* Latitude angles: top of band -> bottom of band */
+    // Latitude angles: top of band -> bottom of band
     const float_t phi1 = (float_t)GLM_PI_2 - (float_t)i       * stackStep;
     const float_t phi2 = (float_t)GLM_PI_2 - (float_t)(i + 1) * stackStep;
 

src/dusk/display/mesh/triprism.c

@@ -47,17 +47,17 @@ void triPrismBuffer(
     vertices[vi].uv[1]    = (v);  \
     vi++;
 
-  /* --- Front face (z = maxZ), CCW from +Z --- */
+  // --- Front face (z = maxZ), CCW from +Z ---
   PRISM_VERT(x0, y0, maxZ,  0.0f, 0.0f)
   PRISM_VERT(x1, y1, maxZ,  1.0f, 0.0f)
   PRISM_VERT(x2, y2, maxZ,  0.5f, 1.0f)
 
-  /* --- Back face (z = minZ), CCW from -Z (reverse winding) --- */
+  // --- Back face (z = minZ), CCW from -Z (reverse winding) ---
   PRISM_VERT(x2, y2, minZ,  0.5f, 1.0f)
   PRISM_VERT(x1, y1, minZ,  1.0f, 0.0f)
   PRISM_VERT(x0, y0, minZ,  0.0f, 0.0f)
 
-  /* --- Side face 0: edge p0->p1 --- */
+  // --- Side face 0: edge p0->p1 ---
   PRISM_VERT(x0, y0, minZ,  0.0f, 0.0f)
   PRISM_VERT(x1, y1, minZ,  1.0f, 0.0f)
   PRISM_VERT(x1, y1, maxZ,  1.0f, 1.0f)
@@ -66,7 +66,7 @@ void triPrismBuffer(
   PRISM_VERT(x1, y1, maxZ,  1.0f, 1.0f)
   PRISM_VERT(x0, y0, maxZ,  0.0f, 1.0f)
 
-  /* --- Side face 1: edge p1->p2 --- */
+  // --- Side face 1: edge p1->p2 ---
   PRISM_VERT(x1, y1, minZ,  0.0f, 0.0f)
   PRISM_VERT(x2, y2, minZ,  1.0f, 0.0f)
   PRISM_VERT(x2, y2, maxZ,  1.0f, 1.0f)
@@ -75,7 +75,7 @@ void triPrismBuffer(
   PRISM_VERT(x2, y2, maxZ,  1.0f, 1.0f)
   PRISM_VERT(x1, y1, maxZ,  0.0f, 1.0f)
 
-  /* --- Side face 2: edge p2->p0 --- */
+  // --- Side face 2: edge p2->p0 ---
   PRISM_VERT(x2, y2, minZ,  0.0f, 0.0f)
   PRISM_VERT(x0, y0, minZ,  1.0f, 0.0f)
   PRISM_VERT(x0, y0, maxZ,  1.0f, 1.0f)

src/dusk/display/shader/shader.c

@@ -13,14 +13,14 @@
 shader_t *bound = NULL;
 
 errorret_t shaderInit(shader_t *shader, const shaderdefinition_t *def) {
-  assertNotNull(shader, "Shader cannot be null");
+  assertNotNull(shader, "Shader cannot be NULL");
   errorChain(shaderInitPlatform(shader, def));
   bound = NULL;
   errorOk();
 }
 
 errorret_t shaderBind(shader_t *shader) {
-  assertNotNull(shader, "Shader cannot be null");
+  assertNotNull(shader, "Shader cannot be NULL");
   errorChain(shaderBindPlatform(shader));
   bound = shader;
   errorOk();
@@ -31,9 +31,9 @@ errorret_t shaderSetMatrix(
   const char_t *name,
   mat4 matrix
 ) {
-  assertNotNull(shader, "Shader cannot be null");
+  assertNotNull(shader, "Shader cannot be NULL");
   assertStrLenMin(name, 1, "Uniform name cannot be empty");
-  assertNotNull(matrix, "Matrix cannot be null");
+  assertNotNull(matrix, "Matrix cannot be NULL");
   assertTrue(bound == shader, "Shader must be bound.");
   errorChain(shaderSetMatrixPlatform(shader, name, matrix));
   errorOk();
@@ -44,7 +44,7 @@ errorret_t shaderSetTexture(
   const char_t *name,
   texture_t *texture
 ) {
-  assertNotNull(shader, "Shader cannot be null");
+  assertNotNull(shader, "Shader cannot be NULL");
   assertStrLenMin(name, 1, "Uniform name cannot be empty");
   assertTrue(bound == shader, "Shader must be bound.");
   errorChain(shaderSetTexturePlatform(shader, name, texture));
@@ -56,7 +56,7 @@ errorret_t shaderSetColor(
   const char_t *name,
   color_t color
 ) {
-  assertNotNull(shader, "Shader cannot be null");
+  assertNotNull(shader, "Shader cannot be NULL");
   assertStrLenMin(name, 1, "Uniform name cannot be empty");
   assertTrue(bound == shader, "Shader must be bound.");
   errorChain(shaderSetColorPlatform(shader, name, color));
@@ -67,16 +67,16 @@ errorret_t shaderSetMaterial(
   shader_t *shader,
   const shadermaterial_t *material
 ) {
-  assertNotNull(shader, "Shader cannot be null");
+  assertNotNull(shader, "Shader cannot be NULL");
-  assertNotNull(material, "Material cannot be null");
+  assertNotNull(material, "Material cannot be NULL");
   assertTrue(bound == shader, "Shader must be bound.");
-  assertNotNull(shader->definition, "Shader definition cannot be null");
+  assertNotNull(shader->definition, "Shader definition cannot be NULL");
   assertNotNull(shader->definition->setMaterial, "Def lacks setMaterial");
   return shader->definition->setMaterial(shader, material);
 }
 
 errorret_t shaderDispose(shader_t *shader) {
-  assertNotNull(shader, "Shader cannot be null");
+  assertNotNull(shader, "Shader cannot be NULL");
   bound = NULL;
   errorChain(shaderDisposePlatform(shader));
   errorOk();

src/dusk/display/shader/shaderlist.c

@@ -41,10 +41,10 @@ errorret_t shaderListInit() {
     }
 
     assertNotNull(
-      SHADER_LIST_DEFS[i].shader, "Shader cannot be null"
+      SHADER_LIST_DEFS[i].shader, "Shader cannot be NULL"
     );
     assertNotNull(
-      SHADER_LIST_DEFS[i].definition, "Shader definition cannot be null"
+      SHADER_LIST_DEFS[i].definition, "Shader definition cannot be NULL"
     );
 
     errorChain(shaderInit(
@@ -78,7 +78,7 @@ errorret_t shaderListDispose(void) {
     }
 
     assertNotNull(
-      SHADER_LIST_DEFS[i].shader, "Shader cannot be null"
+      SHADER_LIST_DEFS[i].shader, "Shader cannot be NULL"
     );
 
     errorChain(shaderDispose(SHADER_LIST_DEFS[i].shader));

src/dusk/display/spritebatch/spritebatch.c

@@ -31,9 +31,9 @@ errorret_t spriteBatchBuffer(
   shader_t *shader,
   const shadermaterial_t material
 ) {
-  assertNotNull(sprites, "Sprites cannot be null");
+  assertNotNull(sprites, "Sprites cannot be NULL");
   assertTrue(count > 0, "Count must be greater than zero");
-  assertNotNull(shader, "Shader cannot be null");
+  assertNotNull(shader, "Shader cannot be NULL");
 
   // Did the shader or material data change?
   if(shader != SPRITEBATCH.shader) {
@@ -92,9 +92,9 @@ void spriteBatchBufferToMesh(
   meshvertex_t *vertices,
   const uint32_t verticesSize
 ) {
-  assertNotNull(sprites, "Sprites cannot be null");
+  assertNotNull(sprites, "Sprites cannot be NULL");
   assertTrue(count > 0, "Count must be greater than zero");
-  assertNotNull(vertices, "Vertices cannot be null");
+  assertNotNull(vertices, "Vertices cannot be NULL");
   assertTrue(
     verticesSize >= count * QUAD_VERTEX_COUNT, "Vertices array too small"
   );

src/dusk/display/spritebatch/spritebatchsprite.h

@@ -27,7 +27,7 @@ typedef struct {
  * @param y Screen y position of the sprite's top-left corner.
  * @param width Width of the sprite in screen space.
  * @param height Height of the sprite in screen space.
- * @returns The populated sprite.
+ * @return The populated sprite.
  */
 spritebatchsprite_t spriteBatchSpriteTilesetPosition(
   const tileset_t *tileset,

src/dusk/engine/engine.c

@@ -7,7 +7,6 @@
 
 #include "engine.h"
 #include "util/memory.h"
-#include "perf/perf.h"
 #include "time/time.h"
 #include "input/input.h"
 #include "locale/localemanager.h"
@@ -37,7 +36,6 @@ errorret_t engineInit(const int32_t argc, const char_t **argv) {
   ENGINE.version = DUSK_VERSION;
 
   // Init systems. Order is important.
-  perfInit();
   timeInit();
   consoleInit();
   errorChain(systemInit());
@@ -47,8 +45,8 @@ errorret_t engineInit(const int32_t argc, const char_t **argv) {
   errorChain(localeManagerInit());
   errorChain(displayInit());
   errorChain(audioInit());
-  errorChain(rpgInit());
   errorChain(uiInit());
+  errorChain(rpgInit());
   #ifdef DUSK_NETWORK
     errorChain(networkInit());
   #endif
@@ -106,9 +104,6 @@ errorret_t engineDispose(void) {
   errorChain(displayDispose());
   errorChain(saveDispose());
   errorChain(assetDispose());
-  perfDispose();
-
-  memoryCheckUnfreed();
 
   errorOk();
 }

src/dusk/input/input.c

@@ -152,7 +152,7 @@ float_t inputGetLastValue(const inputaction_t action) {
     const inputaction_t negY, const inputaction_t posY,
     vec2 result
   ) {
-    assertNotNull(result, "Result vector cannot be null");
+    assertNotNull(result, "Result vector cannot be NULL");
     result[0] = inputAxisDynamic(negX, posX);
     result[1] = inputAxisDynamic(negY, posY);
   }
@@ -162,7 +162,7 @@ float_t inputGetLastValue(const inputaction_t action) {
     const inputaction_t negY, const inputaction_t posY,
     vec2 result
   ) {
-    assertNotNull(result, "Result vector cannot be null");
+    assertNotNull(result, "Result vector cannot be NULL");
     float_t x = inputAxisDynamic(negX, posX);
     float_t y = inputAxisDynamic(negY, posY);
     float_t mag = sqrtf(x * x + y * y);
@@ -208,7 +208,7 @@ void inputAxis2D(
   const inputaction_t negY, const inputaction_t posY,
   vec2 result
 ) {
-  assertNotNull(result, "Result vector cannot be null");
+  assertNotNull(result, "Result vector cannot be NULL");
   result[0] = inputAxis(negX, posX);
   result[1] = inputAxis(negY, posY);
 }
@@ -218,7 +218,7 @@ void inputAngle2D(
   const inputaction_t negY, const inputaction_t posY,
   vec2 result
 ) {
-  assertNotNull(result, "Result vector cannot be null");
+  assertNotNull(result, "Result vector cannot be NULL");
   float_t x = inputAxis(negX, posX);
   float_t y = inputAxis(negY, posY);
   float_t mag = sqrtf(x * x + y * y);

src/dusk/perf/perf.c

@@ -1,88 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "perf.h"
-#include "assert/assert.h"
-#include "util/memory.h"
-#include "console/console.h"
-
-#if defined(DUSK_LINUX)
-  #include <time.h>
-#elif defined(DUSK_PSP)
-  #include <pspthreadman.h>
-#endif
-
-perf_t PERF;
-
-void perfInit(void) {
-  assertIsMainThread("Must be called from the main thread.");
-  memoryZero(&PERF, sizeof(perf_t));
-}
-
-void perfDispose(void) {
-  assertIsMainThread("Must be called from the main thread.");
-}
-
-uint64_t perfGetTick(void) {
-  assertIsMainThread("Must be called from the main thread.");
-
-  #if defined(DUSK_LINUX)
-    // TEST - CLOCK_MONOTONIC via clock_gettime(), Linux desktop only for
-    // now. Not a cross-platform answer yet (see perfGetTick's doc
-    // comment in perf.h) - just something real to look at while that
-    // gets settled. Returns nanoseconds since some unspecified starting
-    // point, so only differences between two calls are meaningful.
-    struct timespec ts;
-    clock_gettime(CLOCK_MONOTONIC, &ts);
-    return (uint64_t)ts.tv_sec * 1000000000ull + (uint64_t)ts.tv_nsec;
-  #elif defined(DUSK_PSP)
-    // TEST - sceKernelGetSystemTimeWide(), microseconds since boot at
-    // ~1us resolution (the standard PSP homebrew idiom for elapsed-time
-    // measurement - psprtc.h's sceRtcGetCurrentTick is for wall-clock
-    // date/time instead, already used by timepsp.c for that purpose).
-    // Scaled to nanoseconds to match every other platform's tick unit.
-    return (uint64_t)sceKernelGetSystemTimeWide() * 1000ull;
-  #else
-    return 0;
-  #endif
-}
-
-void perfPushItem(
-  const char_t *label, const char_t *file, const int32_t line
-) {
-  assertIsMainThread("Must be called from the main thread.");
-  assertNotNull(label, "Perf item label cannot be NULL.");
-  assertNotNull(file, "Perf item file cannot be NULL.");
-  assertTrue(PERF.stackSize < PERF_STACK_SIZE, "Perf stack overflow.");
-
-  PERF.stack[PERF.stackSize++] = (perfitem_t){
-    .label = label,
-    .file = file,
-    .line = line,
-    .tick = perfGetTick()
-  };
-}
-
-void perfPopItem(void) {
-  assertIsMainThread("Must be called from the main thread.");
-  assertTrue(PERF.stackSize > 0, "Perf stack underflow.");
-  PERF.stackSize--;
-}
-
-void perfReport(void) {
-  assertIsMainThread("Must be called from the main thread.");
-
-  if(PERF.stackSize == 0) return;
-
-  const perfitem_t *item = &PERF.stack[PERF.stackSize - 1];
-  uint64_t elapsedNs = perfGetTick() - item->tick;
-  double_t elapsedMs = (double_t)elapsedNs / 1000000.0;
-  consolePrint(
-    "perf: %s (%s:%d, %.4fms)",
-    item->label, item->file, item->line, elapsedMs
-  );
-}

src/dusk/perf/perf.h

@@ -1,89 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "perfitem.h"
-
-#define PERF_STACK_SIZE 256
-
-typedef struct {
-  perfitem_t stack[PERF_STACK_SIZE];
-  uint32_t stackSize;
-} perf_t;
-
-extern perf_t PERF;
-
-/**
- * Initializes the perf system.
- */
-void perfInit(void);
-
-/**
- * Disposes/cleans up the perf system. Currently a no-op - here so
- * engine.c has a symmetric call to make once this needs real cleanup.
- */
-void perfDispose(void);
-
-/**
- * Returns a tick value representing "now", for measuring the duration
- * between a perfPush/perfPushItem and its matching perfPopItem. Always
- * nanoseconds since some unspecified starting point, on every platform
- * that implements it, so perfReport's ms conversion stays correct
- * everywhere without per-platform special-casing.
- *
- * PLACEHOLDER - currently only reads a real value on DUSK_LINUX desktop
- * builds (via clock_gettime(CLOCK_MONOTONIC)) and DUSK_PSP (via
- * sceKernelGetSystemTimeWide(), scaled from microseconds), as a test;
- * every other platform still gets a meaningless 0. A common,
- * cross-platform way of reading CPU cycles/time hasn't been settled on
- * yet - don't treat results as comparable across platforms until this is
- * replaced with a real per-platform implementation. Only the difference
- * between two calls is meaningful, never the raw value itself.
- *
- * @return A tick value, in nanoseconds. 0 on unimplemented platforms.
- */
-uint64_t perfGetTick(void);
-
-/**
- * Pushes a new item onto the perf stack, capturing the current tick (see
- * perfGetTick) as its start time. Prefer the perfPush() macro, which
- * supplies file/line automatically.
- *
- * @param label Short caller-supplied memo of what this item represents
- *   (e.g. "frame start") - stored by pointer, not copied, so pass a
- *   string literal or something that otherwise outlives the push.
- * @param file Source file the push originated from (e.g. __FILE__).
- * @param line Source line the push originated from (e.g. __LINE__).
- */
-void perfPushItem(
-  const char_t *label, const char_t *file, const int32_t line
-);
-
-/**
- * Pops the most recently pushed perf item off the stack.
- */
-void perfPopItem(void);
-
-/**
- * Reports on the item currently at the top of the perf stack (the most
- * recently pushed one still awaiting its perfPopItem), if any.
- */
-void perfReport(void);
-
-/**
- * Pushes a new perf item onto the stack, tagged with the call site this
- * macro is expanded at.
- *
- * @param label Short memo of what this item represents (e.g. "frame
- *   start") - see perfPushItem.
- */
-#define perfPush(label) perfPushItem(label, __FILE__, __LINE__)
-
-/**
- * Pops the most recently pushed perf item off the stack.
- */
-#define perfPop() perfPopItem()

src/dusk/rpg/battle/CMakeLists.txt

@@ -7,9 +7,9 @@
 target_sources(${DUSK_LIBRARY_TARGET_NAME}
   PUBLIC
     battle.c
+    battlefighter.c
     party.c
 )
 
-add_subdirectory(fighter)
+# Subdirs
-add_subdirectory(move)
+add_subdirectory(testbattle)
-add_subdirectory(state)

src/dusk/rpg/battle/battle.c

@@ -9,71 +9,320 @@
 #include "assert/assert.h"
 #include "util/memory.h"
 #include "rpg/cutscene/cutscenesystem.h"
-#include "scene/scene.h"
 
 battle_t BATTLE;
 
 void battleInit(void) {
   memoryZero(&BATTLE, sizeof(battle_t));
+  for(uint8_t i = 0; i < BATTLE_FIGHTER_COUNT_MAX; i++) {
+    BATTLE.fighters[i].id = i;
+  }
+}
+
+uint8_t battleGetAvailableFighter(void) {
+  for(uint8_t i = 0; i < BATTLE_FIGHTER_COUNT_MAX; i++) {
+    if(BATTLE.fighters[i].status == BATTLE_FIGHTER_STATUS_NULL) return i;
+  }
+
+  return 0xFF;
+}
+
+battlefighter_t *battleAddFighter(
+  const battlefighterteam_t team,
+  const battlefightercontroller_t controller,
+  const battlefighterstats_t stats,
+  const uint16_t healthMax,
+  const uint16_t mpMax
+) {
+  const uint8_t index = battleGetAvailableFighter();
+  if(index == 0xFF) return NULL;
+
+  battlefighter_t *fighter = &BATTLE.fighters[index];
+  battleFighterInit(fighter, team, controller, stats, healthMax, mpMax);
+  return fighter;
 }
 
 void battleStart(
-  battlefighter_t *fighters[BATTLE_FIGHTER_POS_COUNT]
+  const battleencountertype_t encounterType,
+  const bool_t fleeAvailable
 ) {
-  assertNotNull(fighters, "Fighters cannot be NULL");
+  assertTrue(encounterType < BATTLE_ENCOUNTER_COUNT, "Invalid encounter type");
 
-  #if DUSK_ASSERTIONS
+  BATTLE.encounterType = encounterType;
-    // Must be at least two non null fighter present, may need to ensure they
+  BATTLE.fleeAvailable = fleeAvailable;
-    // are from seperate teams also.
+  BATTLE.result = BATTLE_RESULT_NONE;
-    uint8_t nonNullCount = 0;
+  BATTLE.round = 1;
-    for(uint8_t i = 0; i < BATTLE_FIGHTER_POS_COUNT; i++) {
-      if(fighters[i] != NULL) nonNullCount++;
-    }
-    assertTrue(nonNullCount >= 2, "Must have at least two fighters");
-  #endif
 
-
-  // TODO: I may not need to zero entire battle.
-  memoryZero(&BATTLE, sizeof(battle_t));
-  memoryCopy(
-    BATTLE.fighters,
-    fighters,
-    sizeof(battlefighter_t *) * BATTLE_FIGHTER_POS_COUNT
-  );
-
-  // Enter the opening state.
   battleSetState(BATTLE_STATE_OPENING);
-
-  // Change scene
-  sceneSet(SCENE_TYPE_BATTLE);
-}
-
-void battleSetState(const battlestate_t next) {
-  assertTrue(next < BATTLE_STATE_COUNT, "Invalid battle state");
-  assertNotNull(BATTLE_STATE_FUNCTIONS[next].init, "Missing state init function");
-  assertNotNull(BATTLE_STATE_FUNCTIONS[next].update, "Missing state update function");
-  assertNotNull(BATTLE_STATE_FUNCTIONS[next].dispose, "Missing state dispose function");
-
-  if(BATTLE.state != BATTLE_STATE_NULL) {
-    BATTLE_STATE_FUNCTIONS[BATTLE.state].dispose();
-  }
-  BATTLE.state = next;
-  BATTLE_STATE_FUNCTIONS[BATTLE.state].init();
-}
-
-void battleUpdate(void) {
-  if(BATTLE.state == BATTLE_STATE_NULL) return;
-  assertTrue(BATTLE.state < BATTLE_STATE_COUNT, "Invalid battle state");
-  assertNotNull(BATTLE_STATE_FUNCTIONS[BATTLE.state].update, "Missing state update function");
-
-  BATTLE_STATE_FUNCTIONS[BATTLE.state].update();
 }
 
 void battleDispose(void) {
-  if(BATTLE.state == BATTLE_STATE_NULL) return;
+  battleInit();
-  assertTrue(BATTLE.state < BATTLE_STATE_COUNT, "Invalid battle state");
+}
-  assertNotNull(BATTLE_STATE_FUNCTIONS[BATTLE.state].dispose, "Missing state dispose function");
 
-  BATTLE_STATE_FUNCTIONS[BATTLE.state].dispose();
+battlefighter_t *battleGetCurrentFighter(void) {
-  memoryZero(&BATTLE, sizeof(battle_t));
+  if(BATTLE.state != BATTLE_STATE_PLAYER_SELECTION) return NULL;
+  if(BATTLE.selectionIndex >= BATTLE.executionCount) return NULL;
+  return &BATTLE.fighters[BATTLE.executionOrder[BATTLE.selectionIndex]];
+}
+
+uint8_t battleGetAliveCount(const battlefighterteam_t team) {
+  uint8_t count = 0;
+  for(uint8_t i = 0; i < BATTLE_FIGHTER_COUNT_MAX; i++) {
+    if(BATTLE.fighters[i].team != team) continue;
+    if(!battleFighterIsAlive(&BATTLE.fighters[i])) continue;
+    count++;
+  }
+  return count;
+}
+
+void battleResolveAttack(
+  battlefighter_t *attacker,
+  battlefighter_t *defender
+) {
+  assertNotNull(attacker, "Attacker cannot be NULL");
+  assertNotNull(defender, "Defender cannot be NULL");
+
+  const int32_t rawDamage =
+    (int32_t)attacker->stats.attack - (int32_t)defender->stats.defense;
+  const uint16_t damage = rawDamage > 0 ? (uint16_t)rawDamage : 1;
+
+  defender->health = damage >= defender->health ? 0 : defender->health - damage;
+  if(defender->health == 0) defender->status = BATTLE_FIGHTER_STATUS_DEAD;
+}
+
+battleresult_t battleCheckResult(void) {
+  if(BATTLE.result != BATTLE_RESULT_NONE) return BATTLE.result;
+
+  if(battleGetAliveCount(BATTLE_FIGHTER_TEAM_ALLY) == 0) {
+    battleSetResult(BATTLE_RESULT_LOSS);
+  } else if(battleGetAliveCount(BATTLE_FIGHTER_TEAM_ENEMY) == 0) {
+    battleSetResult(BATTLE_RESULT_WIN);
+  }
+
+  return BATTLE.result;
+}
+
+void battleQueueAction(
+  const uint8_t fighterIndex,
+  const battleactiontype_t type,
+  const uint8_t targetIndex
+) {
+  battleaction_t *action = &BATTLE.actions[fighterIndex];
+  action->type = type;
+  action->targetIndex = targetIndex;
+
+  if(BATTLE.onActionDecided != NULL) {
+    BATTLE.onActionDecided(&BATTLE.fighters[fighterIndex], action);
+  }
+}
+
+void battlePlayerAttack(const uint8_t targetIndex) {
+  battlefighter_t *fighter = battleGetCurrentFighter();
+  if(fighter == NULL) return;
+  if(targetIndex >= BATTLE_FIGHTER_COUNT_MAX) return;
+  if(!battleFighterIsAlive(&BATTLE.fighters[targetIndex])) return;
+
+  battleQueueAction(fighter->id, BATTLE_ACTION_ATTACK, targetIndex);
+  BATTLE.selectionIndex++;
+  battleAdvanceSelection();
+}
+
+void battlePlayerFlee(void) {
+  battlefighter_t *fighter = battleGetCurrentFighter();
+  if(fighter == NULL) return;
+  if(!BATTLE.fleeAvailable) return;
+
+  battleSetResult(BATTLE_RESULT_FLED);
+}
+
+void battleUpdate(void) {
+  if(BATTLE.state == BATTLE_STATE_NONE) return;
+  if(BATTLE.state == BATTLE_STATE_ENDED) return;
+  if(CUTSCENE_SYSTEM.pause & CUTSCENE_PAUSE_BATTLE) return;
+
+  switch(BATTLE.state) {
+    case BATTLE_STATE_OPENING:
+      battleSetState(BATTLE_STATE_PRE_ROUND);
+      break;
+
+    case BATTLE_STATE_PRE_ROUND:
+      battleUpdatePreRound();
+      break;
+
+    case BATTLE_STATE_AI_SELECTION:
+      battleUpdateAiSelection();
+      break;
+
+    case BATTLE_STATE_MOVES_EXECUTING:
+      battleUpdateMovesExecuting();
+      break;
+
+    case BATTLE_STATE_POST_ROUND:
+      battleUpdatePostRound();
+      break;
+
+    default:
+      // BATTLE_STATE_PLAYER_SELECTION: waits on battlePlayerAttack/Flee.
+      // BATTLE_STATE_NONE/ENDED: handled above.
+      break;
+  }
+}
+
+void battleBuildExecutionOrder(const bool_t applyEncounterBias) {
+  BATTLE.executionCount = 0;
+  for(uint8_t i = 0; i < BATTLE_FIGHTER_COUNT_MAX; i++) {
+    if(!battleFighterIsAlive(&BATTLE.fighters[i])) continue;
+    BATTLE.executionOrder[BATTLE.executionCount++] = i;
+  }
+
+  // Insertion sort by speed descending -- fine for BATTLE_FIGHTER_COUNT_MAX.
+  for(uint8_t i = 1; i < BATTLE.executionCount; i++) {
+    const uint8_t key = BATTLE.executionOrder[i];
+    const uint16_t keySpeed = BATTLE.fighters[key].stats.speed;
+
+    int8_t j = (int8_t)i - 1;
+    while(
+      j >= 0 &&
+      BATTLE.fighters[BATTLE.executionOrder[j]].stats.speed < keySpeed
+    ) {
+      BATTLE.executionOrder[j + 1] = BATTLE.executionOrder[j];
+      j--;
+    }
+    BATTLE.executionOrder[j + 1] = key;
+  }
+
+  if(!applyEncounterBias) return;
+
+  if(BATTLE.encounterType == BATTLE_ENCOUNTER_PLAYER_ADVANTAGE) {
+    battleMoveTeamFirst(BATTLE_FIGHTER_TEAM_ALLY);
+  } else if(BATTLE.encounterType == BATTLE_ENCOUNTER_BACK_ATTACK) {
+    battleMoveTeamFirst(BATTLE_FIGHTER_TEAM_ENEMY);
+  }
+}
+
+void battleMoveTeamFirst(const battlefighterteam_t team) {
+  uint8_t sorted[BATTLE_FIGHTER_COUNT_MAX];
+  uint8_t count = 0;
+
+  for(uint8_t i = 0; i < BATTLE.executionCount; i++) {
+    if(BATTLE.fighters[BATTLE.executionOrder[i]].team != team) continue;
+    sorted[count++] = BATTLE.executionOrder[i];
+  }
+  for(uint8_t i = 0; i < BATTLE.executionCount; i++) {
+    if(BATTLE.fighters[BATTLE.executionOrder[i]].team == team) continue;
+    sorted[count++] = BATTLE.executionOrder[i];
+  }
+
+  memoryCopy(
+    BATTLE.executionOrder, sorted, sizeof(uint8_t) * BATTLE.executionCount
+  );
+}
+
+battlefighter_t *battleAIChooseTarget(const battlefighter_t *fighter) {
+  const battlefighterteam_t enemyTeam =
+    fighter->team == BATTLE_FIGHTER_TEAM_ALLY ?
+      BATTLE_FIGHTER_TEAM_ENEMY : BATTLE_FIGHTER_TEAM_ALLY;
+
+  battlefighter_t *weakest = NULL;
+  for(uint8_t i = 0; i < BATTLE_FIGHTER_COUNT_MAX; i++) {
+    battlefighter_t *candidate = &BATTLE.fighters[i];
+    if(candidate->team != enemyTeam) continue;
+    if(!battleFighterIsAlive(candidate)) continue;
+    if(weakest == NULL || candidate->health < weakest->health) {
+      weakest = candidate;
+    }
+  }
+
+  return weakest;
+}
+
+void battleSetState(const battlestate_t next) {
+  const battlestate_t previous = BATTLE.state;
+  BATTLE.state = next;
+  if(BATTLE.onStateChanged != NULL) BATTLE.onStateChanged(previous, next);
+}
+
+void battleSetResult(const battleresult_t result) {
+  BATTLE.result = result;
+  battleSetState(BATTLE_STATE_ENDED);
+}
+
+bool_t battleFighterNeedsDecision(
+  const uint8_t fighterIndex,
+  const battlefightercontroller_t controller
+) {
+  return battleFighterIsAlive(&BATTLE.fighters[fighterIndex])
+    && BATTLE.fighters[fighterIndex].controller == controller
+    && BATTLE.actions[fighterIndex].type == BATTLE_ACTION_NONE;
+}
+
+void battleAdvanceSelection(void) {
+  while(BATTLE.selectionIndex < BATTLE.executionCount) {
+    const uint8_t fighterIndex = BATTLE.executionOrder[BATTLE.selectionIndex];
+    if(
+      battleFighterNeedsDecision(fighterIndex, BATTLE_FIGHTER_CONTROLLER_PLAYER)
+    ) {
+      return;
+    }
+    BATTLE.selectionIndex++;
+  }
+
+  battleSetState(BATTLE_STATE_AI_SELECTION);
+}
+
+void battleUpdatePreRound(void) {
+  // No need to clear BATTLE.actions here: every living fighter's action is
+  // unconditionally reset to BATTLE_ACTION_NONE as it's processed in
+  // battleUpdateMovesExecuting, and round 1 starts pre-zeroed by
+  // battleInit(). Clearing it here would also wipe out any action a
+  // cutscene force-queued while parked at BATTLE_STATE_PRE_ROUND.
+  battleBuildExecutionOrder(BATTLE.round == 1);
+
+  BATTLE.selectionIndex = 0;
+  battleSetState(BATTLE_STATE_PLAYER_SELECTION);
+  battleAdvanceSelection();
+}
+
+void battleUpdateAiSelection(void) {
+  for(uint8_t i = 0; i < BATTLE.executionCount; i++) {
+    const uint8_t fighterIndex = BATTLE.executionOrder[i];
+    if(
+      !battleFighterNeedsDecision(fighterIndex, BATTLE_FIGHTER_CONTROLLER_AI)
+    ) continue;
+
+    battlefighter_t *target =
+      battleAIChooseTarget(&BATTLE.fighters[fighterIndex]);
+    if(target == NULL) continue;
+
+    battleQueueAction(fighterIndex, BATTLE_ACTION_ATTACK, target->id);
+  }
+
+  BATTLE.executionIndex = 0;
+  battleSetState(BATTLE_STATE_MOVES_EXECUTING);
+}
+
+void battleUpdateMovesExecuting(void) {
+  if(BATTLE.executionIndex >= BATTLE.executionCount) {
+    battleSetState(BATTLE_STATE_POST_ROUND);
+    return;
+  }
+
+  const uint8_t fighterIndex = BATTLE.executionOrder[BATTLE.executionIndex++];
+  battlefighter_t *fighter = &BATTLE.fighters[fighterIndex];
+  if(!battleFighterIsAlive(fighter)) return;
+
+  battleaction_t *action = &BATTLE.actions[fighterIndex];
+  if(action->type == BATTLE_ACTION_ATTACK) {
+    battlefighter_t *target = &BATTLE.fighters[action->targetIndex];
+    if(battleFighterIsAlive(target)) battleResolveAttack(fighter, target);
+  }
+  action->type = BATTLE_ACTION_NONE;
+
+  battleCheckResult();
+}
+
+void battleUpdatePostRound(void) {
+  BATTLE.round++;
+  battleSetState(BATTLE_STATE_PRE_ROUND);
 }

src/dusk/rpg/battle/battle.h

@@ -6,38 +6,89 @@
  */
 
 #pragma once
-#include "rpg/battle/fighter/battlefighter.h"
+#include "battlefighter.h"
-#include "rpg/battle/move/battlemove.h"
+
-#include "rpg/battle/move/battlemoveaction.h"
+#define BATTLE_FIGHTER_COUNT_MAX 8
-#include "rpg/battle/fighter/battlefighterpos.h"
+
-#include "rpg/battle/state/battlestate.h"
+typedef enum {
+  BATTLE_ENCOUNTER_REGULAR,
+  BATTLE_ENCOUNTER_PLAYER_ADVANTAGE,
+  BATTLE_ENCOUNTER_BACK_ATTACK,
+
+  BATTLE_ENCOUNTER_COUNT
+} battleencountertype_t;
 
 typedef enum {
   BATTLE_RESULT_NONE,
   BATTLE_RESULT_WIN,
   BATTLE_RESULT_LOSS,
   BATTLE_RESULT_FLED,
+
   BATTLE_RESULT_COUNT
 } battleresult_t;
 
+// Where BATTLE currently is within a round. A cutscene can pause progression
+// (CUTSCENE_PAUSE_BATTLE) and use CUTSCENE_BATTLE_WAIT_STATE to synchronize
+// with any of these, or CUTSCENE_BATTLE_FORCE_ACTION to decide a fighter's
+// action ahead of PLAYER_SELECTION/AI_SELECTION reaching them.
+typedef enum {
+  BATTLE_STATE_NONE, // Battle inactive.
+
+  BATTLE_STATE_OPENING, // Entered once by battleStart().
+  BATTLE_STATE_PRE_ROUND, // Rebuilds execution order, clears the action queue.
+  BATTLE_STATE_PLAYER_SELECTION, // Waits on battlePlayerAttack/Flee.
+  BATTLE_STATE_AI_SELECTION, // Auto-queues every undecided AI fighter.
+  BATTLE_STATE_MOVES_EXECUTING, // Resolves one queued action per update.
+  BATTLE_STATE_POST_ROUND, // Round wrap-up; loops back to PRE_ROUND.
+
+  BATTLE_STATE_ENDED, // Terminal for WIN/LOSS/FLED alike -- see BATTLE.result.
+
+  BATTLE_STATE_COUNT
+} battlestate_t;
+
+typedef enum {
+  BATTLE_ACTION_NONE, // No action decided yet for this fighter this round.
+  BATTLE_ACTION_ATTACK,
+
+  BATTLE_ACTION_COUNT
+} battleactiontype_t;
+
 typedef struct {
-  battlefighter_t *fighters[BATTLE_FIGHTER_POS_COUNT];
+  battleactiontype_t type;
+  uint8_t targetIndex; // Meaningful for BATTLE_ACTION_ATTACK.
+} battleaction_t;
 
-  // Order of who gets to act.
+typedef void (*battlestatechangedcallback_t)(
-  uint8_t fighterOrder[BATTLE_FIGHTER_POS_COUNT];
+  const battlestate_t previous,
-  uint8_t fighterOrderCount;
+  const battlestate_t next
+);
 
-  // Actions to be executed.
+typedef void (*battleactiondecidedcallback_t)(
-  battlemoveaction_t actionsPending[BATTLE_FIGHTER_POS_COUNT];
+  const battlefighter_t *fighter,
-  uint8_t actionsPendingCount;
+  const battleaction_t *action
+);
 
+typedef struct {
   battlestate_t state;
-  battlestatedata_t stateData;
+  battlefighter_t fighters[BATTLE_FIGHTER_COUNT_MAX];
+  battleaction_t actions[BATTLE_FIGHTER_COUNT_MAX];
 
-  // Set once a side has been wiped out (see cutsceneBattlePostMoveStart)
+  battleencountertype_t encounterType;
-  // or the player has fled (see battleStateSelectionPlayerFlee). Stays
+  bool_t fleeAvailable;
-  // BATTLE_RESULT_NONE for the rest of the battle otherwise.
   battleresult_t result;
+
+  // Fighter indices (into fighters[]), sorted for the current round.
+  uint8_t executionOrder[BATTLE_FIGHTER_COUNT_MAX];
+  uint8_t executionCount;
+  uint8_t executionIndex;
+  uint16_t round;
+
+  // Cursor into executionOrder used by BATTLE_STATE_PLAYER_SELECTION to find
+  // the next player-controlled fighter that still needs a decision.
+  uint8_t selectionIndex;
+
+  battlestatechangedcallback_t onStateChanged;
+  battleactiondecidedcallback_t onActionDecided;
 } battle_t;
 
 extern battle_t BATTLE;
@@ -48,28 +99,215 @@ extern battle_t BATTLE;
 void battleInit(void);
 
 /**
- * Starts a battle.
+ * Gets an available (unused) fighter slot index.
  *
- * @param fighters Fighters in the battle.
+ * @return The index of an available fighter slot, or 0xFF if none are
+ *         available.
  */
-void battleStart(
+uint8_t battleGetAvailableFighter(void);
-  battlefighter_t *fighters[BATTLE_FIGHTER_POS_COUNT]
+
+/**
+ * Adds a fighter to the battle in the next available slot.
+ *
+ * @param team The team the fighter belongs to.
+ * @param controller Who makes decisions for the fighter.
+ * @param stats The fighter's base combat stats.
+ * @param healthMax The fighter's maximum health.
+ * @param mpMax The fighter's maximum mp.
+ * @return Pointer to the newly added fighter, or NULL if the battle is
+ *         already full.
+ */
+battlefighter_t *battleAddFighter(
+  const battlefighterteam_t team,
+  const battlefightercontroller_t controller,
+  const battlefighterstats_t stats,
+  const uint16_t healthMax,
+  const uint16_t mpMax
 );
 
 /**
- * Transitions the battle to a new state: disposes the current state (if
+ * Starts the battle: enters BATTLE_STATE_OPENING and marks the battle
- * any) and initializes next.
+ * active. Call once every fighter has been added via battleAddFighter.
+ *
+ * @param encounterType Determines the opening round's execution order.
+ * @param fleeAvailable Whether the party may attempt to flee this battle.
+ */
+void battleStart(
+  const battleencountertype_t encounterType,
+  const bool_t fleeAvailable
+);
+
+/**
+ * Disposes of the battle, clearing all fighters and marking it inactive.
+ */
+void battleDispose(void);
+
+/**
+ * Returns the fighter currently awaiting a player decision.
+ *
+ * @return Pointer to the fighter awaiting a decision, or NULL if the battle
+ *         isn't in BATTLE_STATE_PLAYER_SELECTION or every player-controlled
+ *         fighter has already decided.
+ */
+battlefighter_t *battleGetCurrentFighter(void);
+
+/**
+ * Returns the number of living fighters on a team.
+ *
+ * @param team The team to count.
+ * @return Count of living fighters on that team.
+ */
+uint8_t battleGetAliveCount(const battlefighterteam_t team);
+
+/**
+ * Resolves a physical attack from attacker onto defender: damage is the
+ * attacker's attack stat minus the defender's defense stat (minimum 1),
+ * subtracted from the defender's health. The defender is marked dead
+ * once health reaches 0.
+ *
+ * @param attacker The attacking fighter.
+ * @param defender The defending fighter.
+ */
+void battleResolveAttack(
+  battlefighter_t *attacker,
+  battlefighter_t *defender
+);
+
+/**
+ * Checks whether the battle has been won or lost, transitioning to
+ * BATTLE_STATE_ENDED and updating BATTLE.result if so. Does nothing if a
+ * result has already been set (e.g. by a successful flee).
+ *
+ * @return The battle's current result.
+ */
+battleresult_t battleCheckResult(void);
+
+/**
+ * Queues an action for a fighter to perform once BATTLE_STATE_MOVES_EXECUTING
+ * reaches them this round, overwriting any action already queued for that
+ * fighter. Fires BATTLE.onActionDecided.
+ *
+ * @param fighterIndex Index into BATTLE.fighters of the deciding fighter.
+ * @param type The type of action to perform.
+ * @param targetIndex Index into BATTLE.fighters of the target, meaningful
+ *        for BATTLE_ACTION_ATTACK.
+ */
+void battleQueueAction(
+  const uint8_t fighterIndex,
+  const battleactiontype_t type,
+  const uint8_t targetIndex
+);
+
+/**
+ * Submits the currently-selecting fighter's attack against a target, if the
+ * battle is in BATTLE_STATE_PLAYER_SELECTION and awaiting a decision.
+ * Queues the action and advances the selection cursor.
+ *
+ * @param targetIndex Index into BATTLE.fighters of the target.
+ */
+void battlePlayerAttack(const uint8_t targetIndex);
+
+/**
+ * Submits a flee attempt for the currently-selecting fighter, if the battle
+ * is in BATTLE_STATE_PLAYER_SELECTION and fleeing is available for this
+ * battle. Always succeeds, ending the battle with BATTLE_RESULT_FLED.
+ */
+void battlePlayerFlee(void);
+
+/**
+ * Updates the battle simulation for one frame, dispatching on BATTLE.state.
+ * No-op if the battle isn't active, has already ended, or
+ * CUTSCENE_PAUSE_BATTLE is set.
+ */
+void battleUpdate(void);
+
+/**
+ * Rebuilds BATTLE.executionOrder/executionCount from every currently living
+ * fighter, sorted by speed descending.
+ *
+ * @param applyEncounterBias If true, reorders the freshly speed-sorted
+ * queue so BATTLE.encounterType's favoured team goes first (used only
+ * for the opening round).
+ */
+void battleBuildExecutionOrder(const bool_t applyEncounterBias);
+
+/**
+ * Stably partitions BATTLE.executionOrder so every fighter on the given team
+ * comes first, preserving each side's relative (speed-sorted) order.
+ *
+ * @param team The team to move to the front of the execution order.
+ */
+void battleMoveTeamFirst(const battlefighterteam_t team);
+
+/**
+ * Picks an AI target for fighter: the lowest-health living fighter on
+ * the opposing team.
+ *
+ * @param fighter The AI-controlled fighter choosing a target.
+ * @return The chosen target, or NULL if the opposing team has no
+ *         living fighters.
+ */
+battlefighter_t *battleAIChooseTarget(const battlefighter_t *fighter);
+
+/**
+ * Sets BATTLE.state and fires BATTLE.onStateChanged with the previous and
+ * new state.
  *
  * @param next The state to transition to.
  */
 void battleSetState(const battlestate_t next);
 
 /**
- * Updates the battle system.
+ * Sets BATTLE.result and transitions to BATTLE_STATE_ENDED.
+ *
+ * @param result The result to end the battle with.
  */
-void battleUpdate(void);
+void battleSetResult(const battleresult_t result);
 
 /**
- * Disposes of the battle, clearing all fighters and marking it inactive.
+ * Checks whether a fighter is a live, undecided candidate for the given
+ * controller -- i.e. whether PLAYER_SELECTION or AI_SELECTION should still
+ * be deciding an action for it this round.
+ *
+ * @param fighterIndex Index into BATTLE.fighters to check.
+ * @param controller The controller PLAYER_SELECTION/AI_SELECTION is
+ *        currently deciding for.
+ * @return True if the fighter is alive, matches controller, and has no
+ *         action queued yet.
  */
-void battleDispose(void);
+bool_t battleFighterNeedsDecision(
+  const uint8_t fighterIndex,
+  const battlefightercontroller_t controller
+);
+
+/**
+ * Advances BATTLE.selectionIndex to the next player-controlled fighter that
+ * still needs a decision, or transitions to BATTLE_STATE_AI_SELECTION once
+ * none remain.
+ */
+void battleAdvanceSelection(void);
+
+/**
+ * Handles BATTLE_STATE_PRE_ROUND: rebuilds the execution order and moves on
+ * to BATTLE_STATE_PLAYER_SELECTION, positioning the selection cursor.
+ */
+void battleUpdatePreRound(void);
+
+/**
+ * Handles BATTLE_STATE_AI_SELECTION: queues an attack for every undecided
+ * AI-controlled fighter, then moves on to BATTLE_STATE_MOVES_EXECUTING.
+ */
+void battleUpdateAiSelection(void);
+
+/**
+ * Handles BATTLE_STATE_MOVES_EXECUTING: resolves one queued action from
+ * BATTLE.executionOrder per call, or transitions to BATTLE_STATE_POST_ROUND
+ * once every fighter this round has been processed.
+ */
+void battleUpdateMovesExecuting(void);
+
+/**
+ * Handles BATTLE_STATE_POST_ROUND: advances BATTLE.round and transitions
+ * back to BATTLE_STATE_PRE_ROUND.
+ */
+void battleUpdatePostRound(void);

src/dusk/rpg/battle/battlefighter.c

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) 2026 Dominic Masters
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+#include "battlefighter.h"
+#include "assert/assert.h"
+#include "util/memory.h"
+
+void battleFighterInit(
+  battlefighter_t *fighter,
+  const battlefighterteam_t team,
+  const battlefightercontroller_t controller,
+  const battlefighterstats_t stats,
+  const uint16_t healthMax,
+  const uint16_t mpMax
+) {
+  assertNotNull(fighter, "Fighter pointer cannot be NULL");
+  assertTrue(team < BATTLE_FIGHTER_TEAM_COUNT, "Invalid fighter team");
+  assertTrue(
+    controller < BATTLE_FIGHTER_CONTROLLER_COUNT,
+    "Invalid fighter controller"
+  );
+
+  const uint8_t id = fighter->id;
+  memoryZero(fighter, sizeof(battlefighter_t));
+  fighter->id = id;
+  fighter->status = BATTLE_FIGHTER_STATUS_NORMAL;
+  fighter->team = team;
+  fighter->controller = controller;
+  fighter->stats = stats;
+  fighter->healthMax = healthMax;
+  fighter->health = healthMax;
+  fighter->mpMax = mpMax;
+  fighter->mp = mpMax;
+}
+
+bool_t battleFighterIsAlive(const battlefighter_t *fighter) {
+  assertNotNull(fighter, "Fighter pointer cannot be NULL");
+  return fighter->status == BATTLE_FIGHTER_STATUS_NORMAL;
+}

src/dusk/rpg/battle/battlefighter.h

@@ -0,0 +1,87 @@
+/**
+ * Copyright (c) 2026 Dominic Masters
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+#pragma once
+#include "error/error.h"
+
+// An empty status means the slot in BATTLE.fighters is unused.
+typedef enum {
+  BATTLE_FIGHTER_STATUS_NULL,
+
+  BATTLE_FIGHTER_STATUS_NORMAL,
+  BATTLE_FIGHTER_STATUS_DEAD,
+
+  BATTLE_FIGHTER_STATUS_COUNT
+} battlefighterstatus_t;
+
+typedef enum {
+  BATTLE_FIGHTER_TEAM_ALLY,
+  BATTLE_FIGHTER_TEAM_ENEMY,
+
+  BATTLE_FIGHTER_TEAM_COUNT
+} battlefighterteam_t;
+
+typedef enum {
+  BATTLE_FIGHTER_CONTROLLER_PLAYER,
+  BATTLE_FIGHTER_CONTROLLER_AI,
+
+  BATTLE_FIGHTER_CONTROLLER_COUNT
+} battlefightercontroller_t;
+
+// Base combat stats, kept separate from the resource pools (health/mp) on
+// battlefighter_t so that equipment/buffs can later modify them without
+// touching current health/mp state.
+typedef struct {
+  uint16_t attack;
+  uint16_t defense;
+  uint16_t magic;
+  uint16_t speed;
+  uint16_t luck;
+} battlefighterstats_t;
+
+typedef struct {
+  uint8_t id;
+  battlefighterstatus_t status;
+  battlefighterteam_t team;
+  battlefightercontroller_t controller;
+
+  uint16_t health;
+  uint16_t healthMax;
+  uint16_t mp;
+  uint16_t mpMax;
+
+  battlefighterstats_t stats;
+} battlefighter_t;
+
+/**
+ * Initializes a battle fighter in place, filling health/mp to their maximum
+ * values and setting its status to normal.
+ *
+ * @param fighter Pointer to the fighter to initialize.
+ * @param team The team the fighter belongs to.
+ * @param controller Who makes decisions for the fighter.
+ * @param stats The fighter's base combat stats.
+ * @param healthMax The fighter's maximum health.
+ * @param mpMax The fighter's maximum mp.
+ */
+void battleFighterInit(
+  battlefighter_t *fighter,
+  const battlefighterteam_t team,
+  const battlefightercontroller_t controller,
+  const battlefighterstats_t stats,
+  const uint16_t healthMax,
+  const uint16_t mpMax
+);
+
+/**
+ * Returns true if the fighter is in a state where it can still act (i.e.
+ * is not dead).
+ *
+ * @param fighter Pointer to the fighter to check.
+ * @return True if the fighter can act.
+ */
+bool_t battleFighterIsAlive(const battlefighter_t *fighter);

src/dusk/rpg/battle/fighter/CMakeLists.txt

@@ -1,10 +0,0 @@
-# Copyright (c) 2026 Dominic Masters
-#
-# This software is released under the MIT License.
-# https://opensource.org/licenses/MIT
-
-# Sources
-target_sources(${DUSK_LIBRARY_TARGET_NAME}
-  PUBLIC
-    battlefighter.c
-)

src/dusk/rpg/battle/fighter/battlefighter.c

@@ -1,230 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#include "battlefighter.h"
-#include "assert/assert.h"
-#include "util/memory.h"
-
-errorret_t battleFighterParseStatField(
-  yyjson_val *obj,
-  const char_t *key,
-  uint16_t *out
-) {
-  yyjson_val *val = yyjson_obj_get(obj, key);
-  if(!yyjson_is_int(val)) {
-    errorThrow("Fighter: missing/invalid '%s'", key);
-  }
-
-  const int64_t num = yyjson_get_sint(val);
-  if(num < 0 || num > UINT16_MAX) {
-    errorThrow("Fighter: '%s' must be between 0 and %u", key, UINT16_MAX);
-  }
-
-  *out = (uint16_t)num;
-  errorOk();
-}
-
-errorret_t battleFighterParseOptionalIntField(
-  yyjson_val *obj,
-  const char_t *key,
-  const int32_t defaultValue,
-  int32_t *out
-) {
-  yyjson_val *val = yyjson_obj_get(obj, key);
-  if(val == NULL) {
-    *out = defaultValue;
-    errorOk();
-  }
-
-  if(!yyjson_is_int(val)) errorThrow("Fighter: invalid '%s'", key);
-  *out = (int32_t)yyjson_get_sint(val);
-  errorOk();
-}
-
-errorret_t battleFighterParse(battlefighter_t *fighter, yyjson_val *obj) {
-  assertNotNull(fighter, "Fighter cannot be NULL");
-  assertNotNull(obj, "JSON object cannot be NULL");
-
-  int32_t teamNum;
-  errorChain(battleFighterParseOptionalIntField(
-    obj, "team", BATTLE_FIGHTER_TEAM_ALLY, &teamNum
-  ));
-  if(teamNum < 0 || teamNum >= BATTLE_FIGHTER_TEAM_COUNT) {
-    errorThrow("Fighter: invalid 'team'");
-  }
-
-  int32_t controllerNum;
-  errorChain(battleFighterParseOptionalIntField(
-    obj, "controller", BATTLE_FIGHTER_CONTROLLER_PLAYER, &controllerNum
-  ));
-  if(controllerNum < 0 || controllerNum >= BATTLE_FIGHTER_CONTROLLER_COUNT) {
-    errorThrow("Fighter: invalid 'controller'");
-  }
-
-  battlefighterstats_t stats;
-  errorChain(battleFighterParseStatField(obj, "attack", &stats.attack));
-  errorChain(battleFighterParseStatField(obj, "defense", &stats.defense));
-  errorChain(battleFighterParseStatField(obj, "magic", &stats.magic));
-  errorChain(battleFighterParseStatField(obj, "speed", &stats.speed));
-  errorChain(battleFighterParseStatField(obj, "luck", &stats.luck));
-  errorChain(battleFighterParseStatField(obj, "healthMax", &stats.healthMax));
-  errorChain(battleFighterParseStatField(obj, "mpMax", &stats.mpMax));
-
-  battleFighterInit(
-    fighter, (battlefighterteam_t)teamNum,
-    (battlefightercontroller_t)controllerNum, stats
-  );
-
-  int32_t statusNum;
-  errorChain(battleFighterParseOptionalIntField(
-    obj, "status", BATTLE_FIGHTER_STATUS_NORMAL, &statusNum
-  ));
-  if(statusNum < 0 || statusNum >= BATTLE_FIGHTER_STATUS_COUNT) {
-    errorThrow("Fighter: invalid 'status'");
-  }
-  fighter->status = (battlefighterstatus_t)statusNum;
-
-  int32_t health;
-  errorChain(
-    battleFighterParseOptionalIntField(obj, "health", stats.healthMax, &health)
-  );
-  if(health < 0 || health > stats.healthMax) {
-    errorThrow("Fighter: 'health' out of range");
-  }
-  fighter->stats.health = (uint16_t)health;
-
-  int32_t mp;
-  errorChain(battleFighterParseOptionalIntField(obj, "mp", stats.mpMax, &mp));
-  if(mp < 0 || mp > stats.mpMax) {
-    errorThrow("Fighter: 'mp' out of range");
-  }
-  fighter->stats.mp = (uint16_t)mp;
-
-  yyjson_val *abilities = yyjson_obj_get(obj, "abilities");
-  if(abilities != NULL) {
-    if(
-      !yyjson_is_arr(abilities) ||
-      yyjson_arr_size(abilities) > BATTLE_FIGHTER_ABILITY_COUNT_MAX
-    ) {
-      errorThrow(
-        "Fighter: 'abilities' must have 0-%u entries",
-        BATTLE_FIGHTER_ABILITY_COUNT_MAX
-      );
-    }
-
-    yyjson_arr_iter iter = yyjson_arr_iter_with(abilities);
-    yyjson_val *abilityVal;
-    while((abilityVal = yyjson_arr_iter_next(&iter)) != NULL) {
-      const char_t *name = yyjson_get_str(abilityVal);
-      battlemoveid_t ability =
-        name == NULL ? BATTLE_MOVE_ID_NULL : battleMoveGetIdByName(name);
-      if(ability == BATTLE_MOVE_ID_NULL) {
-        errorThrow("Fighter: invalid entry in 'abilities'");
-      }
-      battleFighterAbilityAdd(fighter, ability);
-    }
-  }
-
-  errorOk();
-}
-
-yyjson_mut_val *battleFighterSerialize(
-  const battlefighter_t *fighter,
-  yyjson_mut_doc *doc
-) {
-  assertNotNull(fighter, "Fighter cannot be NULL");
-  assertNotNull(doc, "Doc cannot be NULL");
-
-  yyjson_mut_val *obj = yyjson_mut_obj(doc);
-
-  yyjson_mut_obj_add_uint(doc, obj, "team", fighter->team);
-  yyjson_mut_obj_add_uint(doc, obj, "controller", fighter->controller);
-  yyjson_mut_obj_add_uint(doc, obj, "status", fighter->status);
-
-  yyjson_mut_obj_add_uint(doc, obj, "attack", fighter->stats.attack);
-  yyjson_mut_obj_add_uint(doc, obj, "defense", fighter->stats.defense);
-  yyjson_mut_obj_add_uint(doc, obj, "magic", fighter->stats.magic);
-  yyjson_mut_obj_add_uint(doc, obj, "speed", fighter->stats.speed);
-  yyjson_mut_obj_add_uint(doc, obj, "luck", fighter->stats.luck);
-  yyjson_mut_obj_add_uint(doc, obj, "healthMax", fighter->stats.healthMax);
-  yyjson_mut_obj_add_uint(doc, obj, "mpMax", fighter->stats.mpMax);
-  yyjson_mut_obj_add_uint(doc, obj, "health", fighter->stats.health);
-  yyjson_mut_obj_add_uint(doc, obj, "mp", fighter->stats.mp);
-
-  yyjson_mut_val *abilities = yyjson_mut_arr(doc);
-  for(uint8_t i = 0; i < fighter->abilityCount; i++) {
-    yyjson_mut_arr_add_str(doc, abilities, BATTLE_MOVES[fighter->abilities[i]].name);
-  }
-  yyjson_mut_obj_add_val(doc, obj, "abilities", abilities);
-
-  return obj;
-}
-
-void battleFighterInit(
-  battlefighter_t *fighter,
-  const battlefighterteam_t team,
-  const battlefightercontroller_t controller,
-  const battlefighterstats_t stats
-) {
-  assertNotNull(fighter, "Fighter pointer cannot be NULL");
-  assertTrue(team < BATTLE_FIGHTER_TEAM_COUNT, "Invalid fighter team");
-  assertTrue(
-    controller < BATTLE_FIGHTER_CONTROLLER_COUNT,
-    "Invalid fighter controller"
-  );
-
-  const uint8_t id = fighter->id;
-  memoryZero(fighter, sizeof(battlefighter_t));
-  fighter->id = id;
-  fighter->status = BATTLE_FIGHTER_STATUS_NORMAL;
-  fighter->team = team;
-  fighter->controller = controller;
-  fighter->stats = stats;
-  fighter->stats.health = stats.healthMax;
-  fighter->stats.mp = stats.mpMax;
-}
-
-bool_t battleFighterIsAlive(const battlefighter_t *fighter) {
-  assertNotNull(fighter, "Fighter pointer cannot be NULL");
-  return fighter->status == BATTLE_FIGHTER_STATUS_NORMAL;
-}
-
-void battleFighterAbilityAdd(
-  battlefighter_t *fighter,
-  const battlemoveid_t ability
-) {
-  assertNotNull(fighter, "Fighter pointer cannot be NULL");
-  assertTrue(
-    fighter->abilityCount < BATTLE_FIGHTER_ABILITY_COUNT_MAX,
-    "Fighter already has the maximum number of abilities"
-  );
-
-  fighter->abilities[fighter->abilityCount++] = ability;
-}
-
-void battleFighterDamage(
-  battlefighter_t *fighter,
-  const uint16_t amount
-) {
-  assertNotNull(fighter, "Fighter pointer cannot be NULL");
-
-  fighter->stats.health =
-    amount >= fighter->stats.health ? 0 : fighter->stats.health - amount;
-  if(fighter->stats.health == 0) fighter->status = BATTLE_FIGHTER_STATUS_DEAD;
-}
-
-void battleFighterHeal(
-  battlefighter_t *fighter,
-  const uint16_t amount
-) {
-  assertNotNull(fighter, "Fighter pointer cannot be NULL");
-  if(!battleFighterIsAlive(fighter)) return;
-
-  const uint32_t healed = (uint32_t)fighter->stats.health + amount;
-  fighter->stats.health = healed > fighter->stats.healthMax
-    ? fighter->stats.healthMax : (uint16_t)healed;
-}

src/dusk/rpg/battle/fighter/battlefighter.h

@@ -1,127 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-#include "yyjson.h"
-#include "rpg/battle/move/battlemove.h"
-#include "rpg/battle/fighter/battlefighterstatus.h"
-#include "rpg/battle/fighter/battlefighterteam.h"
-#include "rpg/battle/fighter/battlefightercontroller.h"
-#include "rpg/battle/fighter/battlefighterstats.h"
-#include "rpg/battle/fighter/battlefighterpos.h"
-
-#define BATTLE_FIGHTER_ABILITY_COUNT_MAX 8
-
-typedef struct battlefighter_s {
-  uint8_t id;
-  battlefighterstatus_t status;
-  battlefighterteam_t team;
-  battlefightercontroller_t controller;
-
-
-  battlefighterstats_t stats;
-  
-  battlemoveid_t abilities[BATTLE_FIGHTER_ABILITY_COUNT_MAX];
-  battlemoveid_t abilityCount;
-} battlefighter_t;
-
-/**
- * Initializes a battle fighter in place, filling health/mp to the maximum
- * values carried on stats and setting its status to normal.
- *
- * @param fighter Pointer to the fighter to initialize.
- * @param team The team the fighter belongs to.
- * @param controller Who makes decisions for the fighter.
- * @param stats The fighter's base combat stats, including healthMax/mpMax.
- */
-void battleFighterInit(
-  battlefighter_t *fighter,
-  const battlefighterteam_t team,
-  const battlefightercontroller_t controller,
-  const battlefighterstats_t stats
-);
-
-/**
- * Generic battlefighter_t parser, shared by every place that builds a
- * fighter from JSON (party.jsonc roster members, BATTLE_START enemy
- * definitions, save-file party members) - see battleFighterSerialize for
- * the inverse. Reads 'team'/'controller'/'status' as ints (each optional,
- * defaulting to ALLY/PLAYER/NORMAL respectively - a caller that needs a
- * different team/controller, e.g. BATTLE_START's enemies, sets those
- * fields on fighter after this returns), 'attack'/'defense'/'magic'/
- * 'speed'/'luck'/'healthMax'/'mpMax' as required ints in [0, UINT16_MAX],
- * 'health'/'mp' as optional ints defaulting to healthMax/mpMax (a fresh
- * fighter), and an optional 'abilities' array of move name strings. Does
- * not touch fighter->id - set it (or leave it) before calling, same as
- * battleFighterInit.
- *
- * @param fighter Pointer to the fighter to fill in.
- * @param obj The JSON object to read fields from.
- * @return Error if a required field is missing/invalid, or an abilities
- * entry doesn't name a real move.
- */
-errorret_t battleFighterParse(battlefighter_t *fighter, yyjson_val *obj);
-
-/**
- * Inverse of battleFighterParse: builds a new JSON object (not yet
- * attached anywhere - the caller attaches it, e.g. via
- * yyjson_mut_arr_add_val/yyjson_mut_obj_add_val) with every field
- * battleFighterParse reads except id (see its doc comment for why).
- *
- * @param fighter The fighter to serialize.
- * @param doc The mutable document to allocate the object in.
- * @return The newly built object.
- */
-yyjson_mut_val *battleFighterSerialize(
-  const battlefighter_t *fighter,
-  yyjson_mut_doc *doc
-);
-
-/**
- * Returns true if the fighter is in a state where it can still act (i.e.
- * is not dead).
- *
- * @param fighter Pointer to the fighter to check.
- * @returns True if the fighter can act.
- */
-bool_t battleFighterIsAlive(const battlefighter_t *fighter);
-
-/**
- * Appends an ability to the fighter's ability list.
- *
- * @param fighter Pointer to the fighter to add the ability to.
- * @param ability The ability to add.
- */
-void battleFighterAbilityAdd(
-  battlefighter_t *fighter,
-  const battlemoveid_t ability
-);
-
-/**
- * Subtracts amount from the fighter's health (floored at 0), marking it
- * dead once health reaches 0.
- *
- * @param fighter Pointer to the fighter to damage.
- * @param amount The amount of damage to apply.
- */
-void battleFighterDamage(
-  battlefighter_t *fighter,
-  const uint16_t amount
-);
-
-/**
- * Adds amount to the fighter's health (capped at healthMax). No-op if the
- * fighter isn't alive -- healing can't revive a dead fighter.
- *
- * @param fighter Pointer to the fighter to heal.
- * @param amount The amount to heal.
- */
-void battleFighterHeal(
-  battlefighter_t *fighter,
-  const uint16_t amount
-);

src/dusk/rpg/battle/fighter/battlefightercontroller.h

@@ -1,18 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "error/error.h"
-
-typedef enum {
-  BATTLE_FIGHTER_CONTROLLER_NONE,
-  
-  BATTLE_FIGHTER_CONTROLLER_PLAYER,
-  BATTLE_FIGHTER_CONTROLLER_AI,
-
-  BATTLE_FIGHTER_CONTROLLER_COUNT
-} battlefightercontroller_t;

src/dusk/rpg/battle/fighter/battlefighterpos.h

@@ -1,35 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- * 
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "dusk.h"
-
-typedef uint8_t battlefighterpos_t;
-
-#define BATTLE_FIGHTER_POS(x) ((battlefighterpos_t)(x))
-
-// Left (Enemy side)
-#define BATTLE_FIGHTER_POS_0 BATTLE_FIGHTER_POS(0)
-#define BATTLE_FIGHTER_POS_1 BATTLE_FIGHTER_POS(1)
-#define BATTLE_FIGHTER_POS_2 BATTLE_FIGHTER_POS(2)
-#define BATTLE_FIGHTER_POS_3 BATTLE_FIGHTER_POS(3)
-
-// Right (Ally side)
-#define BATTLE_FIGHTER_POS_4 BATTLE_FIGHTER_POS(4)
-#define BATTLE_FIGHTER_POS_5 BATTLE_FIGHTER_POS(5)
-#define BATTLE_FIGHTER_POS_6 BATTLE_FIGHTER_POS(6)
-#define BATTLE_FIGHTER_POS_7 BATTLE_FIGHTER_POS(7)
-
-#define BATTLE_FIGHTER_POS_COUNT (BATTLE_FIGHTER_POS_7 + 1)
-
-// Sentinels resolved by battleStateExecutingInit against the currently
-// resolving action, for cutscene items authored inside a move's own
-// cutscene (e.g. cutscenes/battle/moves/slash.jsonc) that need to refer
-// to "whoever is being hit"/"whoever is attacking" without knowing their
-// concrete BATTLE.fighters index ahead of time.
-#define BATTLE_FIGHTER_POS_TARGET BATTLE_FIGHTER_POS(0xFE)
-#define BATTLE_FIGHTER_POS_USER BATTLE_FIGHTER_POS(0xFD)

src/dusk/rpg/battle/fighter/battlefighterspecies.h

@@ -1,22 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "dusk.h"
-#include "rpg/battle/fighter/battlefighterstats.h"
-
-#define BATTLE_FIGHTER_SPECIES_NAME_MAX 16
-#define BATTLE_FIGHTER_SPECIES_COUNT_MAX 250
-
-typedef uint8_t battlespeciesid_t;
-
-#define BATTLE_SPECIES_ID_NULL ((battlespeciesid_t)0)
-
-typedef struct {
-  char_t name[BATTLE_FIGHTER_SPECIES_NAME_MAX];
-  battlefighterstats_t baseStats;
-} battlefighterspecies_t;

src/dusk/rpg/battle/fighter/battlefighterstats.h

@@ -1,22 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "dusk.h"
-
-typedef struct {
-  uint16_t health;
-  uint16_t mp;
-  
-  uint16_t healthMax;
-  uint16_t mpMax;
-  uint16_t attack;
-  uint16_t defense;
-  uint16_t magic;
-  uint16_t speed;
-  uint16_t luck;
-} battlefighterstats_t;

src/dusk/rpg/battle/fighter/battlefighterstatus.h

@@ -1,20 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "dusk.h"
-
-typedef enum {
-  BATTLE_FIGHTER_STATUS_NULL,
-
-  BATTLE_FIGHTER_STATUS_NORMAL,
-  BATTLE_FIGHTER_STATUS_DEAD,
-
-  // Poisoned, burned, confused, etc.
-
-  BATTLE_FIGHTER_STATUS_COUNT
-} battlefighterstatus_t;

src/dusk/rpg/battle/fighter/battlefighterteam.h

@@ -1,16 +0,0 @@
-/**
- * Copyright (c) 2026 Dominic Masters
- *
- * This software is released under the MIT License.
- * https://opensource.org/licenses/MIT
- */
-
-#pragma once
-#include "dusk.h"
-
-typedef enum {
-  BATTLE_FIGHTER_TEAM_ALLY,
-  BATTLE_FIGHTER_TEAM_ENEMY,
-
-  BATTLE_FIGHTER_TEAM_COUNT
-} battlefighterteam_t;