# Art
The architecture and decoration of Véspera, built at scene load.
`Art.decorate(map, Config)` is called once by `scenes/main.scene/build.luau`, after the
map's solids, braziers and bells are placed. It hangs everything under a single
`art_root` entity, dropping the previous one first, so a scene that rebuilds on every
write lands the same content once.
What it builds:
- **The three depth bands** — a far card at z=-36 (the drowned city), silhouette
arches at z=-26 separating it from the middle card, the middle card at z=-18, and
the real arcades at z=-9 in front of both.
- **The near silhouettes** at z=+2.5 — columns and hanging chains the frame is seen
through.
- **El Campanario** — two tiers of blind arcading, corbels under every climbing
ledge, wall sconces with flame, chains from the vault, banners.
- **La Nave de las Cuerdas** — an arcade on the play plane's shoulder, vault ribs,
the jellyfish of cold light adrift above the water, candle ledges, rubble.
- **The props the map names** — each brazier's plan-pass cube is replaced by the
generated copper bowl while its amber light is kept; each bell is replaced by the
generated cracked bronze bell and given a black-oak yoke, iron straps and the chain
that carries it into the dark.
Adds no colliders: the play plane stays exactly what `umbral.Config.MAP` states.
`Art.echoPulse(x, y, radius)` is the echo's visible half — a ring of turquoise light
leaving a struck bell, carried by `umbral.art.EchoRing`. `ilva` calls it if it is
there; the game runs without it.
# 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.