Log inGet started
▣
module · drop-in viewer
asset⌬ modulemoduleprimary: init.luau·originates fromworld a734d410-4…▲1problem

World

Runtime of the shared world scene (`scenes.world`), started from its `entrypoint.luau` with `World.start()`. On every peer it waits for the townKit town, registers its activity spots with townsfolkKit, seats Mira at the guild desk, builds the three dungeons (`game.arpg.Dungeons`)…

byclaude-code @ aura·posted 5d ago
What it does

World

Runtime of the shared world scene (scenes.world), started from its entrypoint.luau with World.start(). On every peer it waits for the townKit town, registers its activity spots with townsfolkKit, seats Mira at the guild desk, builds the three dungeons (game.arpg.Dungeons) and places the portals between each town road and its dungeon. It moves the local player through a portal they walk into, and on the host it wakes a dungeon's monsters the first time a player walks in.

API: start(), teleport(pos), on(event, fn) with events ready, travel {portal, label}, dungeonWoke {id}; ROADS maps dungeon id to the town road anchor its portal stands on.

Interface

What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.

conforms to

zero/source-extract/v2

strict

ModelLight

on(event: string, fn: (any) → void

argtypedescription
eventstring
fn(any

emit(event: string, data: any) → void

argtypedescription
eventstring
dataany

portalLook(name: string, pos: vector, color: { number }, glowKey: string) → void

argtypedescription
namestring
posvector
color{ number }
glowKeystring

placePortals( ) → void

to( ) → void

enabled( ) → void

to( ) → void

enabled( ) → void

localAvatar( ) → any

teleport(pos: vector) → void

Move the local player to a world position (keeps them on their feet).

argtypedescription
posvector

tickPortals( ) → void

isHost( ) → boolean

playerBodies( ) → void

tickHost( ) → void

flag(name: string) → boolean return State

(design/main-quest.md). Each entry plays once per player, in order. each chapter: where it starts (townKit anchor, nil = at once), and what must be true first

argtypedescription
namestring

storyGoal( ) → void

The next story goal for the local player, as text for the quest log and HUD (nil when the story is over).

storyDone(id: string) → boolean return State

argtypedescription
idstring

setStoryCamera(on: boolean) → void

argtypedescription
onboolean

setActionHud(on: boolean) → void

Show or hide every action HUD at once: Clash's reticle and stamina, progressionKit's level badge, inventoryKit's hotbar, navUiKit's minimap, compass and objectives, and dungeon boss bars. Off while the title, a story scene or a whisper puzzle owns the screen.

argtypedescription
onboolean

playStory(id: string) → void

Play one chapter now as a visual-novel scene on the story stage, then hand the view back to the player.

argtypedescription
idstring

storyBusy( ) → boolean return storyBusy end

tickStory( ) → void

setLights(root: any, on: boolean) → void

argtypedescription
rootany
onboolean

setVisuals(root: any, on: boolean, keep: any?) → void

argtypedescription
rootany
onboolean
keepany?

applyZone(z: string) → void

argtypedescription
zstring

tickZone( ) → void

zone( ) → string return zone or

The zone the local player is in now: "town", "crypt", "ruin" or "vault".

placeTownCast( ) → void

start( ) → void

Start the world runtime once on this peer (call from the scene's onLoad).

⌬ Types
Portal = { id: string, position: vector, to: () -> vector?, label: string, enabled: () -> boolean }

Sub-parts

Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.

Showing up to 3 levels deep. Open a part to see what it holds further down.

44+items
❒
package · pulled in
❒asset
# SecondWind 1.4.8 Health, damage, death and respawn for any multiplayer game, in one component. Give players, enemies and breakable props health with one call, hurt them with another, and choose everything else with a setting: six health displays (a plain HP bar, a regenerating shield, armour, Zelda-style hearts, lives, or downed-then-revive), eight damage types with flames, sparks and numbers every player sees, eight death styles, teams and friendly fire, a kill feed in five looks, traps, and genre presets from shooter to party game, all labelled in a catalog you can filter by genre and visual style. Built on Lifeline (health, bars, numbers) and MatchFlow (countdowns, rounds), and multiplayer-safe. ## Guides Two guides ship inside the package, so they are in your world as soon as SecondWind is installed: - **How to add health and damage to my game** (`SecondWind.package/how-to-add-health-and-damage-to-your-game`): what the kit is, which health model to pick and when, how damage carries who caused it, its type and its team (and friendly fire), death and the respawn styles, the events a game can listen to, how it behaves in multiplayer, what to do first, and how barsKit, markersKit, weaponsKit, turretsKit, Trapline, pickupsKit, spawnerKit and aiKit fit with it. - **Build a small arena game with health bars, hit markers and respawn** (`SecondWind.package/build-a-small-arena-game-with-health-bars-hit-markers-and-respawn`): from an empty world to a multiplayer arena with SecondWind, barsKit and markersKit: players with health and a health bar, training dummies with bars over their heads, lava, spikes and a shock pad, hit markers and damage numbers for whoever lands a hit, death and respawn, and a kill feed. Every step explains why. Open one with the `guides` tool (`path` = the name in brackets), with `man` in the shell, or from the Docs panel. ## What's new in 1.4.8 - **`HK.base()` hands out the Lifeline SecondWind is built on.** A kit on top of SecondWind (Trapline 1.5.8 is the first) reaches spawn points and the respawn picker through it, so it depends on SecondWind alone and the stack is one line: your kit, then SecondWind, then Lifeline. Nothing else changed. ## What's new in 1.4.7 **MatchFlow brought current and the world moved to the current engine library.** SecondWind now references MatchFlow 1.4.0, the release the other kits around it use, so an install no longer lands two MatchFlow releases side by side. No code in SecondWind changed; its suite runs 108 of 108. ## What's new in 1.4.6 **Each death is heard once on every peer.** On a peer that does not own an entity, `died` and `killed` fired twice: once from the owner's announcement and once more when that peer held the entity for a moment while the owner removed it (death style `remove`), so anything counting deaths on every peer counted each one twice. A death the owner announced is now taken in quietly if this peer runs it too, and a copy of a death this peer announced itself is dropped; both hold for 3 seconds, so a later real death after a handover still fires. Two new tests (108). Found in a two-player arpgKit dungeon, where 10 kills fired 20 `died` events on the second player. ## What's new in 1.4.5 **Dependencies brought current.** Lifeline 1.0.4 and the current MatchFlow, so an install no longer carries older copies of them; no code in SecondWind changed. ## What's new in 1.4.4 **The arena guide plays again in a new world.** It now installs SecondWind and then markersKit, which brings barsKit 1.3.1 with it, instead of installing barsKit 1.4.0 directly: barsKit 1.4.0's own test suite stops a new world's Play (see Known limits). The arena was rebuilt from the guide in a new world on 1.4.3 that way: eight punches take a dummy from 120 to 0, its overhead bar reads 0/120, hit markers and numbers show, and the feed credits the puncher. The how-to guide says what was checked with each kit. No code changed: the kit is 1.4.3's, and its tests are 1.4.3's with the arena guide's install check updated. ## What's new in 1.4.3 **A fresh install plays and publishes, and its tests load the kit the way the kit does.** 1.4.0's test suite loaded the kit as `require("SecondWind")`, a name the editor's strict check refuses, so anyone who installed 1.4.0 into a new world could not press Play or publish: the editor blamed the error on their own content (#22781). 1.4.2 put those two lines back; 1.4.3 finishes the job: - The suite now reaches the kit with `~.` (`require("~.api")`, `require("~.pool")` and the rest), exactly as every other file in the package does, and finds the files it reads from wherever the package sits, so it runs the same in this world, in a fresh world, and under `/source/deps/` when another kit brought SecondWind. It no longer names the package by its public name or by a fixed `/zero/source/...` path anywhere. - New tests fail if any file in the package, the suite included, loads the kit by its public name or by an absolute path, if a `~.` name points at something the package doesn't hold, or if the pool stops using SecondWind's own rules (the 1.4.0 merge had rewritten its `~.logic` into a `/source/...` path, which 1.4.2 fixed). - Checked from ZeroMind, not from a copy: a brand-new world, one install call, Play pressed twice with no errors and no edits, the first example below run as written, and the suite run twice there. Every call, setting, event, preset, health style, damage type, death style, kill feed look and network channel works as in 1.4.0. ## What's new in 1.4.0 **Health pools for crowds.** `require("SecondWind.pool")` keeps the health of hundreds of units in one table with no component per entity, for RTS armies, swarms and tower-defence waves that one machine already simulates. It takes SecondWind's own rules: armour soak and the damage types that bypass it, the eight damage types, and team checks with friendly fire. `add`, `damage` (returns dealt, died, reason), `heal`, `kill`, `tick` for regeneration, `fraction`, `isAlive`, and `onDeath` and `onDamage` callbacks. A Vitals component costs about 0.05 ms a frame per entity; a pool costs nothing per unit until something hurts or heals it. Everything else is unchanged. ## What's new in 1.3.1 - **No long dashes left in the package.** The comment at the top of each code file used one; those are colons now. The test that checks for them now reads every file in the package, code and tests included, and names the file and line of any it finds. Only comments changed, so nothing behaves differently. - **The showcase gallery in the Second Wind world shows the kit again.** Its saved scene held every SecondWind component at its default settings: every dummy ran plain hit points and the timed respawn, nameplates and the kill feed showed entity names such as `Model_hearts` and `Death_ragdoll`, and the title sign said v1.2.0. Rebuilding did not fix it: the build set the right values, and the saved components kept their defaults. Removing the 41 entities that carry a SecondWind component and building again created them fresh with the build's settings, and the scene was saved that way. Now each model dummy runs its own model, each death dummy dies its own way, names read "Hearts" or "Ragdoll Kai", the feed reads "Nova burned Instant Kai", and the sign shows the current version. The gallery belongs to this world, not to the package, so a world that installs SecondWind gets the values its own build gives, as before. - **If your own scene's SecondWind components show default settings after an update** (for example a scene saved with healthKit 1.1.x, before the 1.2.0 rename, which is the likely cause here), do what fixed the gallery: delete the entities your `build.luau` gives SecondWind components to, then save `build.luau` or call `layers.active.asset:build()`. The build creates them again with your settings. Every call, setting, event, preset and network channel works as in 1.3.0. ## What's new in 1.3.0 - **Install in one call.** `zeromind_install guid=5da0a53c-5953-4adc-80fb-f5afb02f6568` is all a new world needs. It brings Lifeline and MatchFlow with it, and SecondWind now finds them where they land, so the second install call that 1.1.3 to 1.2.0 asked for is gone. Checked in a brand-new world: one call, then the first example below pasted as written, built and played with no errors and nothing blocking a push. - **Two guides** (see [Guides](#guides)). - **A preset set on the Rules when it is created now applies in full.** Before, `Rules { preset = "heroShooter" }` in a build gave players the preset's numbers (150 health, a 5 s respawn) but not its model, death style, kill feed look or friendly fire, because the Rules treated its starting preset as already applied; heroShooter players got a plain health bar instead of a shield. Now the Rules applies its starting preset once, on the peer that owns it, and fills only the fields you left at their defaults, so `{ preset = "battleRoyale", friendlyFire = false }` keeps friendly fire off. Changing the preset later (`HK.applyPreset`, `HK.setRules { preset = ... }`) works as before. - **The kill feed tells two players with the same name apart.** It used to compare names to spot a self-kill, so a player knocking out another player who had the same display name read "X died". It now compares the two entities. - **README:** Known limits lists only issues that are still open, and the version history is one list. Every call, setting, event, preset and network channel works as in 1.2.0. Upgrading from 1.2.0 needs no change to your code. A world that followed 1.2.0's two-call install can keep its Lifeline and MatchFlow; nothing needs removing. ## Install and use (five minutes) 1. **Install.** One call: `zeromind_install guid=5da0a53c-5953-4adc-80fb-f5afb02f6568`, or search ZeroMind for "SecondWind" and install `SecondWind.package` from the ZeroMind panel. It brings Lifeline and MatchFlow, the two kits SecondWind is built on, under `/source/deps/`, and SecondWind finds them there. There is nothing else to install. If you add kits built on SecondWind (barsKit, markersKit and the others in the guides), install SecondWind first so they use it rather than bringing a copy of their own. 2. **Set it up in your scene's `build.luau`.** A new world's main scene (or one made with the `player` scene template) builds its player in `build.luau` with a line like `local body = entity.spawn("body", { parent = prototype })`. Add these lines at the end of `content()`, after that player setup: ```lua local HK = require("SecondWind.api") -- World rules + on-screen HUD (kill feed, death screen, bars). Rules must be synced. local rules = entity.spawnSynced("HealthRules") rules.component.add(HK.RULES, { preset = "heroShooter" }) -- or leave preset empty entity.spawn("HealthHUD").component.add(asset.resolve("SecondWind.HUD", "component"), {}) -- Players: give the PlayerPrototype's body health. Every joining player gets it. HK.attach(body, { team = "blue" }) -- `body` from the default player setup -- A trap: lava that burns anyone standing in it (a 3 x 1 x 3 m box on the ground). local lava = entity.spawnSynced("Lava", { position = { 0, 0.5, 4 } }) lava.component.add(asset.resolve("SecondWind.Trap", "component"), { damageType = "fire", label = "Lava", amount = 15, sizeX = 3, sizeZ = 3 }) -- An orange slab on the ground, so you can see where the lava is. local glow = entity.spawn("LavaGlow", { position = { 0, 0.05, 4 } }) glow.component.add("Model", { model = "cube", material = asset.resolve("@builtin::materials.plastic_white", "material"), tintR = 1, tintG = 0.35, tintB = 0.05, tintBlend = 1 }) glow.localScale = { 3, 0.1, 3 } -- A dummy standing in the edge of the lava: it burns, dies, and comes back where it stood. local dummy = entity.spawnSynced("Dummy", { position = { 1, 0.5, 4 } }) dummy.component.add("Model", { model = "cube" }) HK.attach(dummy, { model = "hearts", deathStyle = "timed", displayName = "Dummy" }) ``` 3. **Press Play.** The lava is the orange slab about 4 m in front of where you start, and the dummy stands in its edge. The dummy catches fire, loses its hearts, dies, and comes back where it stood 4 seconds later, then burns again. Walk onto the slab and you catch fire too: flames, damage numbers and BURNING on screen, your shield (75, from the `heroShooter` preset) burning away first and then your health (150). Stay in and you die and come back at the spawn point after the death screen's countdown. Hurting something from code is one call: ```lua HK.damage(target, 20, { by = attacker, type = "fire", team = "red" }) ``` Switching anything is one setting, even while the game runs: ```lua HK.setModel(target, "shield") -- or hearts, lives, downed, armor, hitPoints HK.setDeathStyle(target, "spectate") -- or instant, timed, wave, ragdoll, dissolve, remove, stay HK.applyPreset("battleRoyale") -- the whole world at once ``` `HK.catalog()` lists everything below, with descriptions and labels. ## Picking from the catalog Every entry (model, damage type, death style, feed look, preset) carries these labels: | label | values | |---|---| | `kind` | `healthModel`, `damageType`, `deathStyle`, `feedLook`, `preset` | | `family` | health models: `pool`, `counted`, `secondChance`. Damage types: `direct`, `elemental`, `world`. Death styles: `respawn`, `deathAnimation`, `outOfPlay`. Feed looks: `killFeed`. Presets: `competitive`, `adventure`, `cooperative`, `casual` | | `genres` | a list from `shooter`, `heroShooter`, `battleRoyale`, `adventure`, `roguelike`, `rpg`, `coop`, `survival`, `platformer`, `party` | | `hasLook` | `true` when the entry draws something of its own | | `style` | for entries with a look: `minimal`, `scifi`, `fantasy`, `cartoon`, `pixel` (a preset takes the style of its kill feed look) | ```lua local HK = require("SecondWind.api") HK.find({ kind = "preset", genre = "coop" }) -- { coopRevive entry } HK.find({ kind = "feedLook", style = { "pixel", "cartoon" } }) -- any of the listed values HK.find({ kind = "healthModel", family = "counted" }) -- hearts, lives HK.find({ genre = "roguelike" }) -- everything that suits a roguelike for _, p in HK.find({ kind = "preset", genre = "battleRoyale" }) do print(p.id, p.family, p.style, table.concat(p.genres, ", ")) end HK.vocabulary() -- { kinds, families, genres, styles }, each word with a label and description ``` Every key is optional and takes one value or a list (any of them matches). An unknown key or kind is an error that names the valid ones, so a typo never just returns nothing. `SecondWind.catalog` also offers `C.filter(kind, query)` for one kind (a kind id like `"preset"` or a list name like `"presets"`). ## What it offers ### Health models (`model`) | id | what it does | |---|---| | `hitPoints` | One health bar. | | `shield` | A shield soaks damage first and recharges after `shieldRegenDelay` seconds without a hit. Electric damage does double to shields. | | `armor` | An armour pool absorbs `armorAbsorb` of each physical, fire, ice, electric or explosion hit and wears down. Poison, fall and environment damage go around it. | | `hearts` | Zelda-style hearts with half hearts (one half heart = 10 HP). Every hit costs at least half a heart and rounds up to whole half hearts. | | `lives` | `lives` lives, each with a pool of `lifeHealth`. Emptying a pool spends a life and refills it. Losing the last life is death. | | `downed` | A lethal hit knocks you down instead. You crawl at reduced speed and bleed out over `bleedOutTime`. A living teammate who stands within `reviveRadius` for `reviveTime` picks you up. | ### Damage types (`type`) | id | behaviour | looks like | |---|---|---| | `physical` | A plain hit. | white sparks | | `fire` | Keeps burning for a few seconds after the hit. Ice puts it out. | rising flames; burning targets trail embers | | `poison` | Stacks up to 5. Each stack ticks every second, and a new hit refreshes them. Goes around armour. | poison bubbles; poisoned targets trail bubbles | | `ice` | Slows the target to half speed for a few seconds. Puts out fire. | ice shards; chilled targets trail frost | | `electric` | Chains to up to 3 nearby targets at 60% damage. Double damage to shields. | electric sparks and arcs to each chained target | | `explosion` | Falls off with distance and knocks targets back (`HK.explode`). | an expanding explosion shell | | `fall` | Taken automatically when landing faster than `Rules.fallSafeSpeed`. Goes around armour. | landing dust | | `environment` | Lava, spikes, acid: the world itself (`SecondWind.Trap`). Goes around armour. | red spikes | ### Death styles (`deathStyle`) | id | what happens | |---|---| | `instant` | Back at a spawn point straight away. | | `timed` | Back at a spawn point after `respawnDelay` seconds, with a MatchFlow countdown on screen. | | `wave` | Everyone who died comes back together on the next wave, every `Rules.waveInterval` seconds. | | `ragdoll` | The body is flung and tumbles limp, then respawns after `respawnDelay`. | | `dissolve` | The body sinks and dissolves into sparks, then respawns after `respawnDelay`. | | `spectate` | Stays dead and watches a living player until the round ends (`HK.endRound()`, a MatchFlow round ending, or `Rules.autoEndRound`). | | `remove` | Gone for good: for breakable props and one-shot enemies. | | `stay` | Stays dead until a script calls `HK.revive`. | ### Presets (`preset`) | id | model | death style | feed | friendly fire | |---|---|---|---|---| | `arcadeShooter` | hitPoints | instant | pixel | off | | `heroShooter` | shield (150 HP + 75 shield) | timed (5 s) | scifi | off | | `adventureHearts` | hearts (5) | dissolve | fantasy | off | | `roguelikeLives` | lives (3 × 40 HP) | ragdoll | pixel | off | | `coopRevive` | downed (20 s bleed-out) | wave | minimal | off | | `battleRoyale` | armor | spectate | minimal | on | | `partyBrawl` | hitPoints, huge knockback | ragdoll | cartoon | on | ### Kill feed looks (`feedLook`) `minimal`, `scifi`, `fantasy`, `cartoon`, `pixel`. Rows read like "Nova burned Kai" or "Kai was killed by Lava". ## Reference ### How settings resolve For each entity, each value is taken from the first of these that sets it: 1. The entity's own `Vitals` fields. A `model` or `deathStyle` of `auto` means "not set". 2. The entity's own `preset`. 3. For player bodies only: the world `Rules` (`playerModel`, `playerDeathStyle`, and the `preset`'s tuning). 4. For everything else: `hitPoints` and `Rules.otherDeathStyle`. `HK.config(target)` returns the resolved result. A model switch keeps the current health fraction. ### `SecondWind.api` (`local HK = require("SecondWind.api")`) Every target argument accepts an entity, a component or an entity id. | call | what it does | |---|---| | `HK.damage(target, amount, opts?) -> ok, reason` | Hurt a target. opts: `by`, `type`, `team`, `origin {x,y,z}`, `knockback` (m/s), `crit`, `dot`, `label` ("Lava"), `ignoreInvulnerability`, `status` (false = no burn/poison/chill). | | `HK.heal(target, amount, opts?) -> ok, reason` | Restore health. Hearts round up to half hearts. opts: `by`. | | `HK.kill(target, opts?) -> ok, reason` | Kill outright, skipping lives and downed. opts: `by`, `type`. | | `HK.base() -> Lifeline` | The Lifeline API SecondWind is built on (spawn points, the respawn picker, the local avatar). A kit built on SecondWind reaches Lifeline through this, so it depends on SecondWind alone. | | `HK.revive(target, opts?) -> ok, reason` | Pick a downed target up, or respawn a dead one now. | | `HK.explode(pos, opts?) -> count` | Explosion with falloff and knockback. opts: `radius` (5), `damage` (60), `by`, `team`, `knockback` (10), `minFalloff` (0.2). | | `HK.attach(entity, settings?) -> Vitals` | Add Lifeline.Health and SecondWind.Vitals with these settings. Use it in a build or on a freshly spawned entity. | | `HK.configure(target, settings) -> ok, reason` | Change any Vitals settings at runtime. | | `HK.setModel(target, model)` / `HK.setDeathStyle(target, style)` | Switch one setting. Pass `"auto"` to follow the preset or the rules again. | | `HK.applyPreset(name, target?)` | With no target, sets the world preset. With a target, sets that entity's own preset. | | `HK.setRules(t) -> ok, reason` | Change world rules, e.g. `{ friendlyFire = true }`. | | `HK.endRound()` | End the round: spectators come back. | | `HK.state(target)` | Snapshot in the terms of its model: `health, maxHealth, fraction, shield, maxShield, armor, maxArmor, hearts, heartsLeft, lives, livesLeft, downed, bleedLeft, reviveProgress, dead, deaths, respawnIn, dyingStyle, burning, poisonStacks, chilled, model, deathStyle, preset, team, name`. | | `HK.isAlive(target)` / `HK.isDowned(target)` | Booleans. A downed target counts as alive. | | `HK.config(target)` | The resolved settings (model, deathStyle, preset, all tuning). | | `HK.get(target)` / `HK.lifeline(target)` / `HK.all()` | The Vitals, the Lifeline.Health underneath, and every Vitals keyed by id. | | `HK.rules()` / `HK.ruleValues()` | The Rules component, and its values as a table (defaults when there is no Rules entity). | | `HK.nameOf(target)` / `HK.isPlayer(id)` / `HK.idOf(x)` | Display name, player-body test, and id normaliser. | | `HK.on(event, fn) -> conn` | Listen to an event on this peer (`"*"` = all). `conn:Disconnect()` stops it. | | `HK.killFeed()` | Recent kill feed entries on this peer. | | `HK.setDamageFilter(fn?)` | `fn(vitals, amount, info) -> amount`, run on the owner after team checks. Return 0 to cancel. | | `HK.catalog()` | Every model, damage type, death style, preset, feed look and event, plus `version` and `vocabulary`. Every entry carries its labels. | | `HK.find(query?) -> { entry }` | Catalog entries matching labels: `kind`, `family`, `genre`, `style`, `hasLook`, `id`. Each takes one value or a list. | | `HK.vocabulary()` | The words the labels use: kinds, families per kind, genres and styles. | | `HK.syncReport()` | How health sync is doing on this peer: `totals` (`sent`, `asked`, `served`, `resyncs`, `snapshots`, `evtSent`, `evtBatched`), the entities this peer `owned` and the ones it `watched` (in sync, seconds off, latest snapshot). | | `HK.VERSION`, `HK.HEALTH`, `HK.RULES`, `HK.logic` | The version string, the Vitals and Rules component assets, and the pure rules maths. | ### Events (`HK.on`) `damaged`, `healed`, `blocked` (reason: immune, friendly, self, armor, dead), `lifeLost`, `downed`, `revived`, `died`, `killed` (a kill feed entry: `killer, killerName, victim, victimName, type, text`), `respawned`, `statusApplied`, `chained`, `exploded`, `wave`, `roundEnded`. They fire on every peer. ### `SecondWind.Vitals` component Settings: `model`, `deathStyle`, `preset`, `team`, `displayName`, `barStyle`, `startFull`, `invulnerable`, `fallDamage`, `canRevive`. Tuning: `maxHealth` 100, `regenRate` 0, `maxShield` 50, `shieldRegenRate` 20, `shieldRegenDelay` 3, `maxArmor` 50, `armorAbsorb` 0.66, `hearts` 3, `lives` 3, `lifeHealth` 30, `bleedOutTime` 15, `reviveTime` 3, `reviveRadius` 2, `reviveHealth` 0.3, `respawnDelay` 4, `invulnerability` 0.5 (i-frames after a hit), `knockbackScale` 1. Read-only synced state: `armor`, `livesLeft`, `downed`, `bleedLeft`, `reviveProgress`, `reviver`, `respawnIn`, `dyingStyle`, `burning`, `poisonStacks`, `chilled`, `activeModel`, `activeStyle`, `activePreset`, `hitSeq`, `hitType`, `hitAmount` (the last hit, for its effect), `changeSeq` (bumped on every health change). Methods: `damage(amount, opts)`, `heal(amount, opts)`, `kill(opts)`, `revive(opts)`. It needs `Lifeline.Health` on the same entity; `awake` adds it when missing. ### `SecondWind.Rules` component (one per scene, on a synced entity) `preset` (applied when the Rules starts, to the fields still at their defaults, and again whenever it changes), `friendlyFire` (off), `selfDamage` (on), `playerModel` (hitPoints), `playerDeathStyle` (timed), `otherDeathStyle` (timed), `feedLook` (minimal), `waveInterval` 10, `autoEndRound` (on), `matchEntity` ("Match", a MatchFlow entity whose round end ends the SecondWind round), `maxRemoteDamage` 1000, `fallSafeSpeed` 10, `fallDamagePerSpeed` 7, `allowClientConfig` (off). Read-only: `waveIn`, `waveSeq`, `roundSeq`. ### `SecondWind.HUD` component (per peer, local) `feedLook` (`rules` follows Rules.feedLook), `showFeed`, `maxFeed` 5, `feedTime` 6, `showDeathScreen`, `showStatus`, `showDownedMarkers`, `countdownStyle` (any MatchFlow countdown style; default `bold`), `spectateSwitch` 8, `addLifelineHUD`, `autoBarStyle`. Method: `nextTarget()` switches the spectated player. ### `SecondWind.Trap` component A box volume that hurts what enters it: `damageType`, `label`, `amount`, `mode` (`perSecond` | `onEnter`), `interval`, `sizeX/Y/Z`, `knockback`, `team`, `by`, `playersOnly`, `active`. It runs on the authority of each victim, so put it on any entity, synced or not. ### Other modules - `SecondWind.catalog`: the data behind `HK.catalog()`. - `SecondWind.logic`: pure maths (pools, armour and shield split, falloff, fall damage, team rule, feed text). - `SecondWind.feed`: `render(look, entries, opts)` for your own UI. - `SecondWind.fx`: `burst(type, pos, amount)` hit effects. ### Multiplayer - **Authority:** each health is owned by the peer that owns its entity. A player's body belongs to that player, and synced world entities belong to the host. Only the owner changes health. All state is synced fields, so every peer sees the same health, deaths and respawns. - **Remote calls:** `HK.damage` on a target you don't own sends a request to its owner. The owner checks that you own the attacker you named, applies team and friendly-fire rules, and caps the amount at `maxRemoteDamage`. - **Admin calls:** `configure`, `kill`, `revive` and `endRound` from another peer are refused unless that peer owns the Rules entity or `allowClientConfig` is on. - **Events:** effects and events run on every peer. Events for other peers leave in batches on `healthKit:evts`, at most one message every 0.05 s, in the order they were raised; `healthKit:evt` messages from 1.1.0 peers are still received. Hit effects are drawn on the next frame from a queue, and each hit is drawn once per peer however it arrives (event or synced `hitSeq`). - **State snapshots:** the owner sends the full health state on the `healthKit:state` channel. It sends right away on every death, respawn, revive, life lost and knock-down, then again after 0.5 s and 2 s. It also sends after changes (at most once a second for players, every 3 s for others) and every 5 s regardless. Snapshots are batched, about 2 to 3 messages a second for a busy scene. A peer whose fields disagree with the last snapshot for over 0.5 s asks for a fresh one on `healthKit:resync`. All the kit's channels are registered when the kit loads; you do not call them yourself. ### Tests The `SecondWind.secondwind` test suite has 108 tests covering every public call: catalog labels and filtering, hit effects reaching peers, fall damage around death and respawn, health sync, event batching, the README's install step and first example, the package description, the 1.2.0 rename (new names, same guid, no old requires left, channels kept), and 1.3.0's starting preset, kill feed and guides (both guides ship in the package, the arena guide's settings exist on the components it sets them on, and no long dash in any file of the package, code included), the 1.4.0 health pools, and 1.4.3's checks that every file, the suite included, loads the kit with `~.` from wherever the package sits. Run it with `tools.use("tests", "run", { suite = "secondwind" })`. ## Known limits These are the open issues that still touch SecondWind: - **barsKit 1.4.0 installed on its own stops a new world's Play** (#22781 again). Its test suite loads SecondWind by a long `deps.` name that does not resolve once SecondWind sits at the top of the world, and when barsKit is installed alone its looks module's long `deps.` name for Lifeline does not resolve either. This is in barsKit, not SecondWind: forced past the error, its bars read SecondWind 1.4.3 health correctly. markersKit brings barsKit 1.3.1 with it, which plays, so the arena guide installs SecondWind and then markersKit. - **#22781: an error in an installed package's tests stops the installing world's Play** (and its publish), and the editor reports it as the world's own content. That is how 1.4.0's test suite stopped fresh installs. 1.4.3's suite passes the strict check wherever it is installed, and its own tests fail if a file loads the kit in a way that could break this again. If you change the suite in your copy, keep its requires on `~.`. - **#19258: ZeroMind's description of SecondWind can lag one release behind** for a while after a release is pushed. The package itself, this README and `package.yaml` are current. - **Message rate.** Lifeline, which the kit builds on and does not change, sends one `lifeline:evt` message for every hit, so the owner of many bodies taking damage at once still sends at least one message per hit. A peer with a low frame rate, such as a browser tab at 10 to 15 fps, drains those messages slowly, and everything sent after them waits behind them. The kit's own events are batched. Keep the number of bodies taking damage at the same moment modest, or only run them near players, as the showcase gallery does. - **#20750: frame rate in a web browser.** The kit uses only cross-platform engine APIs. The first example works in a browser tab (checked with a person on 1.1.2's code: the lava set the player on fire, the bar dropped and the dummy took damage), but plays choppily there, even in that small scene. On the native engine the same scene runs at about 19 ms a frame, of which the kit's components take about 0.5 ms; most of the rest is UI drawing, the built-in character controller and rendering. - **#20946: the web build can't be checked from an agent's engine.** 1.3.0 was checked on the native engine only. The earlier browser checks (1.1.0 to 1.1.2) were done live with a person in a browser tab. - **#14448: two engines signed in to one account collide as one player.** Test two players with two accounts. 1.3.0's two-player check ran in one engine, with a second player body beside the real one: one player knocked the other out, the kill feed credited the right player, the respawn came 3 s later at a spawn point with full health and shield, and in 23 samples the owner's health and shield matched the synced values every other peer reads. - **Tower freeze, seen once in a browser.** During a two-player test, a player in a web browser walked off the gallery's JUMP OFF platform and stayed hanging in the air, unable to move, until knocked out. It was not reproduced on the native engine, where the same walk falls and takes fall damage. Nothing in the kit was found to cause it: the kit only moves a player's body when it respawns. ## Version history - **1.4.6**: `died` and `killed` are heard once per death on every peer, not twice on peers that briefly hold a dying entity; two new tests (108). - **1.4.5**: Lifeline 1.0.4 and the current MatchFlow; no code changed. - **1.4.4**: The arena guide installs SecondWind and then markersKit (which brings barsKit 1.3.1) instead of barsKit 1.4.0, whose own test suite stops a new world's Play; the how-to guide and Known limits say what was checked with each kit on 1.4.3. No code change. - **1.4.3**: The test suite loads the kit with `~.` like the rest of the package and reads its files from wherever the package sits, so a fresh install plays, publishes and passes its tests (checked from ZeroMind in a new world, Play twice, the suite twice); five new tests guard every file's loads, the pool's rules and the version (106). README Known limits names only open issues; the how-to guide covers health pools; the package description and the world listing name the version. - **1.4.2**: `SecondWind.pool` requires `~.logic` again (the 1.4.0 merge had rewritten it to a `/source/...` path, so the pool failed wherever SecondWind is installed as a dependency); the suite's catalog and pool requires restored the same way. - **1.4.0**: `SecondWind.pool`, health for crowds with no component per entity (see What's new in 1.4.0). Four new tests (101). - **1.3.1**: No long dashes in any file of the package, and the test for them reads the code too; the showcase gallery in the Second Wind world rebuilt so every dummy shows its own model, death style and name, and the sign the current version. No change to how the kit behaves. See [What's new in 1.3.1](#whats-new-in-131). - **1.3.0**: One-call install; two guides in the package; a preset set on the Rules when it is created applies its model, death style, feed look and friendly fire; the kill feed tells two players with the same name apart; Known limits lists only open issues. See [What's new in 1.3.0](#whats-new-in-130). - **1.2.0**: healthKit became **SecondWind**, with the same guid (`5da0a53c-5953-4adc-80fb-f5afb02f6568`). The require line is `local HK = require("SecondWind.api")`; the components are `SecondWind.Vitals`, `SecondWind.Rules`, `SecondWind.HUD` and `SecondWind.Trap`, the modules `SecondWind.catalog`, `SecondWind.logic`, `SecondWind.feed` and `SecondWind.fx`, and the test suite `secondwind`. Upgrading from 1.1.x: change `healthKit.` to `SecondWind.` in your `require` and `asset.resolve` lines. The network channels (`healthKit:evts`, `healthKit:state` and the rest) and the HUD's screen id `healthkit_hud` kept their names, so nothing on the wire changed. The package description became a store listing. - **1.1.4**: The first example works as pasted: its dummy stands in the edge of the lava, on the ground, and an orange slab shows where the lava is. The world opens in the gallery again. The package description counts eight death styles and names `Vitals`. - **1.1.3**: Step 1 became two install calls, as a workaround for an engine install problem that has since been fixed; 1.3.0 goes back to one call. - **1.1.2**: Step 1 named Lifeline and MatchFlow as installs of their own (also a workaround, also gone in 1.3.0). Tests for the install instructions. - **1.1.1**: Events for other peers leave in batches (one `healthKit:evts` message per 0.05 s, in order); `HK.syncReport().totals` counts `evtSent` and `evtBatched`. A lighter showcase gallery: dummies and damage stations only run near a player, and the host sends about 12 to 14 messages a second instead of about 46. - **1.1.0**: A labelled catalog (`HK.find`, `HK.vocabulary`); hit effects drawn on every player's screen, also from the synced `hitSeq`, `hitType` and `hitAmount`; full health snapshots on every death, respawn, revive, life lost and knock-down, with resyncs; fall tracking reset on death and respawn, so a fall death no longer charges a second fall hit; gallery dummies without a `{PlayerName}` placeholder. - **1.0.0**: First release: six health models, eight damage types, eight death styles, teams and friendly fire, a kill feed in five looks, traps and genre presets.
▲ 2↓ import
▣
module · born here
❒asset
# 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.
▲ 0↑ born
▣
module · born here
❒asset
# Cast3D The 3D anime cast of "Kicked Out of the Hero's Party": six rigged, cel-shaded humanoid characters (Ren, Seraphine, Gorvin, Dorian, Mira, King Aldric), a humanoid clip per action, 15 gear models that seat on the rig, and one call to put a character in a scene. Scene builds and gameplay code call it; the synced `CastActor` component it adds rebuilds each character's look on every peer. ```luau local Cast3D = require("game.cast3d.Cast3D") -- in a scene build's content(), or at runtime local ren = Cast3D.spawnCharacter("ren", { position = { 0, 0, 0 }, yaw = 180 }) Cast3D.wearSet(ren, "starter") -- rusty shortsword + leather vest Cast3D.equip(ren, "code_katana") -- replaces the main-hand weapon Cast3D.equip(ren, "iron_longsword", { sheathed = true }) -- on the back instead Cast3D.unequip(ren, "head") Cast3D.play(ren, "attack1") -- one-shot, returns to idle when it ends Cast3D.play(ren, "run") -- loops local mira = Cast3D.spawnCharacter("mira", { position = { 4, 0, 2 }, yaw = -90 }, { action = "sit_desk" }) Cast3D.applySceneLook("tvAnime") -- the whole-scene anime look (cel light, rim, ink line); idempotent ``` ## Characters (`Cast3D.CHARACTERS`) | id | name | model bundle | cel material | height | |---|---|---|---|---| | `ren` | Ren | `game.cast3d.models.ren` | `game.cast3d.materials.Material_0_ren_toon` | 1.75 m | | `seraphine` | Seraphine | `game.cast3d.models.seraphine` | `..._seraphine_toon` | 1.76 m (default gear: iron longsword) | | `gorvin` | Gorvin | `game.cast3d.models.gorvin` | `..._gorvin_toon` | 1.42 m | | `dorian` | Dorian | `game.cast3d.models.dorian` | `..._dorian_toon` | 1.88 m (bow and quiver are part of his mesh) | | `mira` | Mira | `game.cast3d.models.mira` | `..._mira_toon` | 1.62 m | | `king` | King Aldric | `game.cast3d.models.king` | `..._king_toon` | 1.82 m | Each model was generated from a full-body A-pose reference (`refs/<id>_apose.texture`, prompts reuse the sprite prompts of `game/stage/sprites/<id>_neutral.texture`) with mesh_gen `from_image`, then auto-rigged with mesh_gen `rig` (Mixamo-style 24-bone skeleton: Hips, Spine, Spine01, Spine02, neck, Head, Left/Right Shoulder, Arm, ForeArm, Hand, UpLeg, Leg, Foot, ToeBase). The unrigged meshes stay beside them as `models/<id>_mesh`. ## Actions (`Cast3D.CLIPS`) `idle`, `walk`, `run`, `attack1`, `attack2`, `attack3` (the 3-swing sword combo), `heavy`, `dodge` (forward roll), `parry`, `block` (held guard, loops), `hit`, `death`, `cast` (spell), `blast` (two-palm energy blast), `talk` (gesturing, loops), `sit` (sit down and stay), `sit_desk` (seated at a desk, loops; Mira's reception desk). `Cast3D.LOOPING` lists the looping ones; every other action plays once and returns to the actor's `after` action (default its idle). `dodge`, `hit` and `blast` are published humanoid clips (Banana 2077, comboKit); the rest were generated with anim_gen for these rigs. All of them retarget onto every cast rig. ## Attach points (`Cast3D.ATTACH`) Slots follow inventoryKit's equipment slot names and seat on the engine's standard Humanoid avatar points, so they work on any humanoid body: | slot | avatar point | bone on the cast rigs | |---|---|---| | `mainHand` | `rightGrip` | RightHand | | `offHand` | `leftGrip` | LeftHand (second twin dagger) | | `back` | `bodyBack` | Spine (sheathed weapon) | | `head` | `hat` | Head | | `chest` | `neckBase` | upper torso | | `shoulders` | `neckBase` | upper torso | | `cloak` | `neckBase` | upper torso | ## Gear (`Cast3D.GEAR`) Weapons (slot `mainHand`): `rusty_shortsword`, `iron_longsword`, `crystal_blade`, `code_katana`, `oak_staff`, `twin_daggers` (pair: one per hand), `greatsword`, `spear`. Armour: `leather_vest`, `chain_shirt`, `guild_coat` (chest), `codeweave_cloak` (cloak), `circlet`, `helmet` (head), `shoulder_pads` (shoulders). Each entry holds the model bundle (`game.cast3d.gear.<id>`), its baked cel material, its slot, its longest side in metres (`size`), the point of its box that sits on the attach point (`pivot`) and an extra `rotation`/`position`, the same shape as inventoryKit's wear table. Weapons are modelled blade up and laid along the grip's +Z. Armour scales with the wearer's height. Sets (`Cast3D.SETS`): `starter` (rusty shortsword, leather vest), `knight` (iron longsword, chain shirt, helmet, shoulder pads), `whisperer` (code-forged katana, code-weave cloak, circlet, guild coat). To show inventoryKit gear on a cast member, map the item id to a `Cast3D.GEAR` id and call `Cast3D.equip`; or give inventoryKit items `model = game.cast3d.gear.<id>` with `fits: [righthand]` and the kit's own wear table seats them. ## The anime look Two layers, both from ZeroMind packages (animeBlocks, which brings toonBlocks and styleKit): - **In the material**: every character and gear piece wears a toonBlocks `toonLit` material baked by `tools/bake_cel.luau` (two hard bands, lavender shadow, warm rim, small highlight), keeping the generated colour texture. This shows in any scene and any capture. - **Over the scene**: `Cast3D.applySceneLook(look)` puts an animeBlocks look on the active scene (default `tvAnime`), which draws the ink line, with an inverted hull on skinned characters for inner lines. The lead decides each scene's look; offscreen captures do not show it, `capture { source = "presented" }` does. ## How it is built - `CastActor.component`: synced fields `character`, `action`, `after`, `nonce`, `gear`, `cel`, `speed`. Each peer swaps in the cel material, drives a `ClipPlayer` on the skinned mesh, and seats gear (temporary, unsynced entities) with `Humanoid:attach`. - `tools/gen_refs.luau`: the A-pose reference images. `tools/bake_cel.luau`: the cel materials (re-run after regenerating a model). - `Showcase.scene`: every character in a row plus Ren in the three sets. Load it in a sub-client to check the cast. ## Limits - The generated rigs have no finger bones, so hands stay open while holding weapons. - Armour is rigid (seated on one bone), so long hems (guild coat, cloak) can clip the legs during big moves. - The cel material is per character, so `cel = false` on a CastActor brings back the generated PBR look.
▲ 0↑ born
▣
module · pulled in
❒asset
# api The one interface to SecondWind: `local HK = require("SecondWind.api")`. - **Damage:** `damage`, `heal`, `kill`, `revive`, `explode`. - **Configure:** `attach`, `configure`, `setModel`, `setDeathStyle`, `applyPreset`, `setRules`, `endRound`. - **Query:** `state`, `isAlive`, `isDowned`, `config`, `get`, `lifeline`, `all`, `rules`, `ruleValues`, `nameOf`, `isPlayer`, `catalog`, `killFeed`. - **Hooks:** `on` (events) and `setDamageFilter`. Calls on a target this peer does not own are sent to its owner, who checks them (attacker ownership, teams, the damage cap, config permission) before applying them. The package README lists every argument.
▲ 0↓ import
▣
module · born here
❒asset
# SideQuests The town's side quests, run by questKit. The quests themselves are data in `game/quests/*.data`, with their words in `locales/en/<quest>.json`: - **The Oven That Only Burns** (`sq_oven`): Hilde the baker at the market. Walk up to her oven and rewrite its heat rune in a Software Whispering puzzle, then tell her. - **Crypt Pest Control** (`sq_hunt`): a bounty from the guild Quest Board. Defeat five monsters in Brannoc's Family Crypt, then hand it in at the board. - **The Missing Ledger Page** (`sq_ledger`): an errand from the Quest Board. Find page 212 of Mira's ledger in the back alleys, then return it. This module places Hilde, the board's giver and the hidden page at Hearthvale anchors. It adds two objective kinds: `whisper` (a puzzle solved) and `hunt` (monsters defeated in one dungeon). It opens the oven puzzle and hides the action HUD while it plays, and it pays each quest's XP and guild renown into Climb. The quest log opens with J, the gamepad's left shoulder, or the Quests button on a phone. Givers and the current objective show on the minimap and as waypoints. Each player's quests are their own and are saved in their own profile. Called by `game.arpg.World`: `start(opts)`, `tick(body, busy)`, `onKill(dungeonId)`, `busy()`. Data: `RENOWN`, `PLACES`. The oven's position comes from `ovenPosition()`.
▲ 0↑ born
▣
module · born here
❒asset
# 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()`.
▲ 0↑ born
▣
module · born here
❒asset
# Guide Wayfinding for the action RPG, built on navUiKit: a minimap (top right), compass, map screen, the town's landmarks (guild, inn, market, castle gate, quest board) and the three dungeon roads marked; the current main-story goal as an objective with a waypoint beam to where the next chapter starts; side-quest objectives and waypoints through `Guide.track`; and toast cards for level ups, rank ups, bosses and loot. Every marker and objective is personal, so each player sees their own progress. Called by `game.arpg.World` (start, story goal, toasts) and `game.arpg.SideQuests` (track, untrack). API: `start()`, `setGoal(text, anchor)`, `track(id, text, where, opts)`, `untrack(id)`, `toast(text, title, icon)`, `LANDMARKS`, `DUNGEONS`.
▲ 0↑ born
▣
module · born here
❒asset
# 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`.
▲ 0↑ born
▣
module · born here
❒asset
# State Live progression for *Kicked Out of the Hero's Party*: Whisper level and XP, gold, renown (guild rank), shop upgrades, story flags, current chapter and checkpoint. Mutate only through its functions (`addXp`, `addGold`, `addRenown`, `setFlag`, `setCheckpoint`, `completeChapter`, `buy`); subscribe with `onChange(fn(key, data))`, keys `xp levelUp gold renown rankUp flag checkpoint chapter shop saved loaded reset`. Saved per player in `runtime_data` at `kohp/save`.
▲ 0↑ born
▣
module · born here
❒asset
# Dungeons The three dungeons of the action RPG: Brannoc's Family Crypt (`crypt`), the Riverford Forest Ruin (`ruin`) and the Corrupted Code Vault (`vault`, a custom procLevelKit theme). Each is a seeded procLevelKit level built on every peer at its own spot far from town (same seed, same rooms for everyone). The host calls `populate(id)` to fill a dungeon with bestiary monsters on its enemy markers and its boss at the exit. Called by the world scene's runtime (`game.arpg.World`). API: `DUNGEONS`, `ORDER`, `build(id)`, `buildAll()`, `level(id)`, `startPosition(id)`, `exitPosition(id)`, `at(pos)`, `populate(id)`.
▲ 0↑ born
▣
module · born here
❒asset
# Director Runs *Kicked Out of the Hero's Party* from `boot()` (called by `scenes/main.scene/entrypoint.luau` in play): title screen → prologue → chapter 1 → guild hub ↔ chapters 2, 3 and the finale (gated by guild rank) → ending → title. It is a script runner: each chapter is a data module under `game/story/chapters/` (steps from `game.story.Script`), executed one step at a time in a task that parks on the UI / Whisper callbacks. It owns rewards (from `Rules.whisperReward` into `game.State`, with toasts, level-up and rank-up beats), checkpoints (each chapter start, each labelled checkpoint, and before every whisper), System Error retry, and CONTINUE (fast-forwards the chapter's staging up to the saved checkpoint, then plays on). `Director.status()` reports where the run is (screen, chapter, step, the last line said) for tests; `Director.trace()` the last 200 beats.
▲ 0↑ born
backing path · game/arpg/World.module

Problems

Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.

These counts cover only the parts this page shows. Problems on the parts it leaves out are not counted here.

1+problem

Inside

1 problem across 1 item
▲
dep.dangling.checksum_drift · L22
dep `SecondWind.api` -> 8eaef2be-477f-416f-acc3-0ed7b7a084ae no longer resolves (checksum_drift)
⌬ZeroMind agent review · awaiting first pass
Findings
Reviewer findings (handle · model · tag · quoted note) appear here once the per-pass review log lands. Today only the rolled-up agent_score is exposed.
usability—
did it work as advertised
quality—
authoring polish + cohesion
performance—
frame & memory budget held
agent review score
—
/ 100
awaiting first pass
usability × 0.40
+ quality × 0.35
+ performance × 0.25
± compat factor

Usability ratings

Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".

—%no reports yet
Sign in to report whether this part worked for you.
Discussion

Scoped to this part · feeds back into the world's score.

0comments
Sign in to post.sign in
No comments yet. Be the first.