Log inGet started
◇
component · drop-in viewer
asset⌬ componentcomponentprimary: init.luau·originates fromworld e2fc9693-0…

Ilva

Ilva herself, beyond her body: the bell fragments she has left, the Coro, the Badajo's two swings, i-frames and knockback, the healing ring, death and the return to the last bell, and the game's signature verb — ring a bell and the room's hidden geometry shows.

by◐Catapulta33·posted 9d ago
What it does

umbral.Ilva

Ilva herself, beyond her body: the bell fragments she has left, the Coro, the Badajo's two swings, i-frames and knockback, the healing ring, death and the return to the last bell, and the game's signature verb — ring a bell and the room's hidden geometry shows.

Attaches to: the player body, beside twoDKit.Player2D. The motor on that body owns her movement; this component never replaces it, it reads state() and touches her position only to hold her during a healing ring, to shove her with a blow, and to put her back at the last bell. It reads its controls through the umbral controlsKit scheme (Combat.registerScheme).

Fields

FieldSyncWhat
healthyesBell fragments left. The HUD draws this.
healthMaxyesBell fragments she can hold.
coroyesThe Coro: filled by a landed strike, spent by the healing ring.
coroMaxyesHow much Coro she can hold.
deadyesDown, and walking back to the last bell.
swingyeslight, heavy, or empty.
chainyesWhere she is in the three-strike chain.
healingyesHolding the healing ring: held still until it lands or she lets go.
revealedyesThe room's hidden geometry is lit by the last echo.
lastBellyesThe last bell she rang, bare name. Respawn goes there.
invulnnoSeconds of i-frames left after a blow.

Verbs

  • Toque ligero — tap attack. Three chainable strikes; the third reaches further and recovers slower. A press inside chainFrom queues the next one.
  • Toque pesado — hold attack past the light swing. Descending, heavier, anchors her.
  • Campanada — hold heal standing on the ground with Coro to spare. She is pinned to the spot for healTime, pays coroPerHeal, gains healAmount.
  • Eco — press echo. Rings the nearest bell_ in ecoRadius and shows every hidden_ entity for ecoTime seconds. A swing that touches a bell does the same.

Methods

takeHit(damage, dirX) — a blow from anything that wants to hurt her. kill(), addCoro(amount), status().

Interface

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

conforms to

zero/source-extract/v2

UMBRAL · Ilva, the hollow bell-ringer. She wakes in the tower with a clapper on a chain and nothing else. This component is everything she is beyond her body: the bell fragments she has left, the Coro that landing strikes fill and healing spends, the Badajo's light and heavy swings with their chainable recovery, the i-frames and the shove of taking a blow, the healing ring that holds her still, death and the walk back to the last bell — and the verb the whole game is built on: ring a bell and the room's hidden geometry shows. The motor is `twoDKit.Player2D` on this same body and this never replaces it. It reads `state()` for where and how fast she is, and touches her position only in the three moments the bible describes: the healing ring pins her to where she started it, a blow shoves her, and dying puts her back at the last bell. Controls come from `umbral.input` (see `umbral/input/umbral.inputMap`), which this activates: keyboard, gamepad and touch, and every verb on all three. Movement stays the motor's own; this reads the three combat verbs. The HUD reads `health`, `healthMax`, `coro` and `coroMax` — all synced.

playerState( ) → void

activateMap( ) → void

bindControls( ) → void

applyAbilities(_id: string?) → void

argtypedescription
_idstring?

startSwing(kind: string) → void

argtypedescription
kindstring

resolveSwing(st: any) → void

argtypedescription
stany

updateAttack(dt: number, st: any) → void

argtypedescription
dtnumber
stany

onHerFeet(st: any) → boolean

She must be on her feet: grounded, or standing still enough that the motor reports no fall. A ring begun in mid-air is not the verb.

argtypedescription
stany

updateHeal(dt: number, st: any) → void

argtypedescription
dtnumber
stany

ringEcho(st: any) → void

argtypedescription
stany

die( ) → void

respawn( ) → void

awake( ) → void

onDestroy( ) → void

update(dt: number) → void

argtypedescription
dtnumber

takeHit(damage: number, dirX: number?) → boolean

Take a blow: damage, i-frames and a shove away along `dirX`.

argtypedescription
damagenumber
dirXnumber?

addCoro(amount: number) → void

Put Coro back (a bell rung, a strike landed) without a swing.

argtypedescription
amountnumber

kill( ) → void

Kill her now (a fall, a scripted moment). She returns to the last bell.

status( ) → void

The full state the HUD and the checks read.

Sub-parts

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

11items
▣
module · born here
❒asset
# umbral.Config The one shared module. Every number UMBRAL obeys and every table it reads lives here so a system never invents its own copy. **Read by:** `scenes/main.scene/build.luau` (which builds the map from `MAP`), `umbral.Art` (region palettes and backdrop depths), `umbral.Ilva` (the `PLAYER` tuning table), `umbral.Enemies` and `umbral.Hud`. ## What it holds | Table | What it is | |---|---| | `PALETTE` | The seven colours the whole game is drawn in, as linear rgb. Void, stone, bronze, turquoise, amber, bone, blood. | | `PLAYER` | Ilva's tuning: health, the Coro's maximum and what fills and spends it, the healing ring, i-frames, the two swings' damage and timing, the Badajo's reach, the echo's radius and duration. | | `REGIONS` | The nine regions: id, display name, the palette tint it leans on, its musical bordón, and the depth band its backdrop sits at. | | `MAP` | The geometry: `solids` (solid rectangles), `oneWay` (jumped up through), `braziers`, `bells`, and the spawn point. | ## Conventions A tile is **one world unit** and the grid is whole units. Gameplay is the plane `z = 0`. Rectangles are `{ x, y, w, h }` with `x, y` the bottom-left corner. Ilva's collision box is `0.625 × 1.25`, so a corridor is at least 3 units high and a doorway at least 2. A bell is named `bell_<name>`; hidden geometry is named `hidden_<anything>`. Those two names are the only contract between the art pass and the echo mechanic. `Config.colour(name)` returns the three channels of a palette entry so a light can be built from a name rather than from numbers repeated in five files.
▲ 0↑ born
▣
module · born here
❒asset
# umbral.Combat The combat core: everything the Badajo obeys, in one place, so the enemy, HUD and progression slices read the same numbers instead of three copies of them. **Called by:** `umbral.Ilva` (the swings, the echo, the ladder). Read by the enemies slice for `takeHit` and the HUD slice for nothing at all — the HUD reads `umbral.Ilva`'s public fields. ## What it exports | Name | What | |---|---| | `Combat.SWING` | `light` and `heavy`: damage, whole-swing time, `chainFrom`, `hitAt`, reach, height, all from `Config.PLAYER`. | | `Combat.CORO_PER_HIT` / `CORO_PER_HEAL` / `HEAL_AMOUNT` / `HEAL_TIME` / `INVULN` / `KNOCKBACK` | The Coro economy and the feel of taking a blow. | | `Combat.ECHO_TIME` / `ECHO_RADIUS` | How long hidden geometry stays lit, and how far a bell's echo reaches. | | `Combat.ABILITIES`, `Combat.LADDER` | The movement verbs as data: `dash`, `doubleJump`, `wallJump`, `glide`, all locked at the start. | | `Combat.unlock(id)` / `Combat.lock(id)` / `Combat.unlocked(id)` / `Combat.onUnlock(fn)` | The ladder. `umbral.Ilva` mirrors it onto the motor, so a region handing her a verb is one call. | | `Combat.strike(cx, cy, hw, hh, damage, dirX, skip)` | Resolve a hit box. Returns `landed, rung`. | | `Combat.ringNearest(x, y, radius)` | Ring the closest `bell_` entity in reach. Returns its bare name. | | `Combat.setHiddenVisible(on)` | Show or hide every `hidden_` entity. | | `Combat.registerScheme()` | Register controlsKit's `umbral` scheme: platformer + attack / echo / heal, on keyboard, gamepad and touch. | ## The two conventions other slices use - **Anything a swing can hurt** carries a component with a `takeHit` method, called as `comp:takeHit(damage, dirX)`. Nothing registers and nothing is listed: `strike` finds it by reflection over the scene, so an enemy written tomorrow is hittable the moment it exists. - **Hidden geometry** is any entity named `hidden_<anything>`; **a bell** is any entity named `bell_<name>`. These are the spec's words, not a list this module holds.
▲ 0↑ born
backing path · umbral/Ilva.component

Problems

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

0problems
No problems reported. This asset, its contents, and its direct deps are clean as of the latest commit.
⌬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.