Kicked Out of the Hero's Party: But Now I Use My Software Whispering Skill to Rise in This World
README.md
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.
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>_aposethe reference images,materials/<id>glitchToon materials,shaders/glitchToonthe shader.tools/gen_refs.luau,tools/gen_models.luau,tools/bake_materials.luaurebuild them.Bestiary.sceneshows every kind in a row.