# Bestiary
The monsters and bosses of "Kicked Out of the Hero's Party": sixteen kinds across the Crypt, the Forest Ruin and the Corrupted Code Vault, each an aiKit enemy with SecondWind health, actionCombatKit telegraphs and a rigged, cel-shaded anime body that animates from the enemy's live state on every peer. Dungeon builders and encounter code call `Bestiary.spawn` (a full synced enemy) or `Bestiary.dress` (a body for an enemy other code made); the HUD and story code listen to `Bestiary.on("phase" | "died" | "bossAppeared" | "telegraph" | "staggered")` and read `Bestiary.bossInfo` for boss bars.
```luau
local Bestiary = require("game.bestiary.Bestiary")
local warden = Bestiary.spawn("crypt_warden", { 0, 0, -12 }, { yaw = 180 })
Bestiary.on("phase", function(ev) if ev.kind == "crypt_warden" and ev.index == 2 then --[[ Software Whispering moment ]] end end)
Bestiary.dress(arpgEnemy, "skeleton_soldier")
```
## Kinds (`Bestiary.KINDS`)
| dungeon | id | name | aiKit preset | hp | role |
|---|---|---|---|---|---|
| crypt | `skeleton_soldier` | Skeleton Soldier | chaser | 60 | sword grunt (rusty shortsword) |
| crypt | `ghoul_brute` | Ghoul Brute | chaser | 240 | big slow brute, every 3rd swing unparryable |
| crypt | `crypt_cultist` | Crypt Cultist | healer | 55 | caster, heals allies (oak staff) |
| crypt | `bone_archer` | Bone Archer | ranged | 45 | kiting shooter |
| crypt | `crypt_warden` | The Crypt Warden | boss | 1400 | BOSS, greatsword, 3 phases |
| forest | `stone_sentinel` | Moss Sentinel | chaser | 180 | stone tank |
| forest | `thorn_dryad` | Thorn Dryad | healer | 60 | caster |
| forest | `wolfkin_runner` | Wolf-kin Runner | chaser | 70 | fast runner |
| forest | `mushroom_brute` | Toadstool Brute | chaser | 220 | brute |
| forest | `bridge_golem` | The Bridge Golem | boss | 1800 | BOSS, 4.2 m, 3 phases |
| vault | `glitch_phantom` | Glitch Phantom | ambusher | 50 | flickering wireframe ambusher |
| vault | `corrupted_knight` | Corrupted Knight | chaser | 200 | elite (code katana) |
| vault | `null_swarmling` | Null Swarmling | swarm | 18 | pack swarmer |
| vault | `firewall_mage` | Firewall Mage | ranged | 70 | turret-like caster |
| vault | `dorian_corrupted` | Dorian | boss | 1500 | BOSS, chapter 3 duel, cast model in the glitch material |
| vault | `seraphine_corrupted` | Seraphine | boss | 2400 | FINAL BOSS, cast model in the glitch material |
Each row also holds model, material, height, telegraph windup, damage, range, cooldown, move speeds, attack clips, gear, xp and, for bosses, `title` and `phases` ({ name, above, line }).
## API
| call | does |
|---|---|
| `Bestiary.spawn(id, pos, opts?)` | synced enemy: Brain (`bestiary_<id>` preset), SecondWind health (death style `stay`), Telegraphed, MonsterBody. opts: yaw, name, team, route, health, damageScale, warning, leash, bossBar, active |
| `Bestiary.dress(enemy, id, opts?)` | body for an existing enemy; switches its Brain to a look-less copy of its preset |
| `Bestiary.presetName(id)` | defines and returns the aiKit preset |
| `Bestiary.bossInfo(id)` | `{ name, title, label, phases = "0.6 0.3", phaseNames }` |
| `Bestiary.phaseAt(id, fraction)` | phase index and name at a health fraction |
| `Bestiary.kindOf(enemy)` | kind id of a dressed enemy |
| `Bestiary.on(evt, fn)` | events on every peer: `phase` {entity, kind, index, name, line}, `died`, `bossAppeared` {entity, kind, name, title}, `telegraph`, `staggered` |
## How the body animates
`MonsterBody.component` (synced fields `kind`, `despawnAfterDeath`, `bossBar`) builds the body on each peer as a local, unsynced entity that follows the enemy, so late joiners and every screen get it from the fields alone. Each frame it reads: speed (position change) for idle / walk / run; the Telegraphed windup (`telegraph.windup`) for a slowed attack anticipation with a hot rim glow, then the strike at full speed; health drops for a hit react and white flash; `telegraph.staggered` for a stagger; death (SecondWind) for the death clip then a dissolve. Clips are the cast's humanoid clips (`game/cast3d/anims`).
Bosses get a barsKit `boss` bar (name, title, phase marks) on every screen within 40 m, and `phase` events when aiKit's boss brain changes phase.
## Files
- `models/<id>` rigged bundles (mesh_gen from_image + rig), `refs/<id>_apose` the reference images, `materials/<id>` glitchToon materials, `shaders/glitchToon` the shader.
- `tools/gen_refs.luau`, `tools/gen_models.luau`, `tools/bake_materials.luau` rebuild them.
- `Bestiary.scene` shows every kind in a row.
# Hazards
The traps, secrets and puzzles of the three dungeons, all Trapwright (`dungeonKit`) pieces in each
dungeon's look: the crypt (`crypt` look: floor spikes on a plate, a timed pendulum, an arrow wall on a
tripwire, two hidden chests, one opened by a symbol-statue puzzle), the forest ruin (`ruins` look: saw
track, gas vent, flame jet, a broken bridge the lever combination or a rewrite repairs, a hidden chest)
and the code vault (`codeVault` look: lightning pylon, plate turret, crushing walls, frost runes, a code
terminal that opens a sealed door, a hidden chest). Pieces are placed on every peer with the same ids
(the host owns their state) on the open floor of each seeded level. Ren's Software Whispering can READ
and REWRITE every piece through rewriteKit: retarget a trap at the monsters, force a bridge SOLID, grant
a terminal's ACCESS. Secrets found are saved per player under `kohp/secrets`.
Called by `game.arpg.Dungeons` (`place` when a level is built) and `game.arpg.World` (`start`).
API: `PLAN`, `place(id, level)`, `start(rewriteApi)`, `reset()`.
# Loot
Loot and gear for the action RPG, glued from published kits. inventoryKit owns the bag, the
paper-doll equipment screen (Tab or I), items on the ground (the first player to walk over one
gets it) and chests. gearStatsKit rolls stat gear in five rarities (common to legendary) and
applies the stats of what a player wears to Clash combat. This module decides what drops where:
gold from every monster, rolled gear about half the time, two pieces and potions from a boss, and
dungeon chests that add a rolled piece on top of their loot table, better the deeper the dungeon
(crypt, forest ruin, code vault). Worn gear shows on Ren (game.cast3d gear models, by rarity) and
sets his fighting style (sword and shield, greatsword, twin daggers, staff, spear).
Called by `game.arpg.World` (`Loot.start`) and `game.arpg.Dungeons` (`Loot.placeChests`).
API: `start(opts)`, `refreshLook()`, `monsterDrop(kind, pos)`, `placeChests(id, level)`, `gold()`, `TIER`.