UMBRAL · Art — what makes Véspera gothic.
Called once by `build.luau` as `Art.decorate(map, Config)`. Everything here
hangs under one `art_root` entity, which is dropped and rebuilt on every
call, so the scene can rebuild as often as it likes and land the same
content once.
What it adds, by depth band:
z = +2.5 the near silhouettes that frame the play plane
z = 0 the play plane's own ornament: corbels, sconces, the bell yokes
z = -6..-9 the middle band: the arcades of the tower and the nave
z = -18 the middle backdrop card
z = -26 silhouette arches that separate the cards
z = -36 the far card, the drowned city's diffuse light
Nothing here adds a collider: the play plane stays exactly the map.
nm(prefix: ?) → void
| arg | type | description |
|---|
| prefix | ? | |
tryResolve(id: ?, kind: ?) → void
| arg | type | description |
|---|
| id | ? | |
| kind | ? | |
put(parent: ?, name: ?, pos: ?, scale: ?, mat: ?, model: ?, deg: ?) → void
| arg | type | description |
|---|
| parent | ? | |
| name | ? | |
| pos | ? | |
| scale | ? | |
| mat | ? | |
| model | ? | |
| deg | ? | |
light(parent: ?, name: ?, pos: ?, color: ?, intensity: ?, radius: ?) → void
| arg | type | description |
|---|
| parent | ? | |
| name | ? | |
| pos | ? | |
| color | ? | |
| intensity | ? | |
| radius | ? | |
carve(map: ?, mat: ?) → void
The map's solids are scaled cubes (`build.luau`), and that file is not
ours to edit. A cube's UVs run 0..1 per face, so a 24 x 2 wall carries one
texel of the masonry across its whole face — the walls read as flat paint.
The stone material now projects in world space, so it tiles at any size,
but a material swapped on an existing `Model` component is read back
without ever reaching the renderer. So each solid's whole Model component
is replaced instead, which the renderer binds from scratch.
| arg | type | description |
|---|
| map | ? | |
| mat | ? | |
pillar(parent: ?, M: ?, x: ?, y0: ?, y1: ?, z: ?, r: ?) → void
A column: shaft, plinth, capital and a bronze ring at the neck.
| arg | type | description |
|---|
| parent | ? | |
| M | ? | |
| x | ? | |
| y0 | ? | |
| y1 | ? | |
| z | ? | |
| r | ? | |
pointedArch(parent: ?, M: ?, cx: ?, ySpring: ?, span: ?, z: ?, depth: ?, thick: ?, mat: ?) → void
An equilateral pointed arch: two arcs of radius `span` springing from
(cx -/+ span/2, ySpring) and meeting over the middle. Built out of
voussoirs so the silhouette is stepped stone, not a smooth curve.
| arg | type | description |
|---|
| parent | ? | |
| M | ? | |
| cx | ? | |
| ySpring | ? | |
| span | ? | |
| z | ? | |
| depth | ? | |
| thick | ? | |
| mat | ? | |
arcade(parent: ?, M: ?, x0: ?, x1: ?, count: ?, yBase: ?, ySpring: ?, z: ?, depth: ?, thick: ?, r: ?) → void
A row of columns with pointed arches between them: the arcade that gives
the nave its height.
| arg | type | description |
|---|
| parent | ? | |
| M | ? | |
| x0 | ? | |
| x1 | ? | |
| count | ? | |
| yBase | ? | |
| ySpring | ? | |
| z | ? | |
| depth | ? | |
| thick | ? | |
| r | ? | |
chain(parent: ?, M: ?, x: ?, yTop: ?, yBottom: ?, z: ?, r: ?, mat: ?) → void
A hanging chain: rings alternating face-on and edge-on, so it reads as
links from the side rather than as a dotted line.
| arg | type | description |
|---|
| parent | ? | |
| M | ? | |
| x | ? | |
| yTop | ? | |
| yBottom | ? | |
| z | ? | |
| r | ? | |
| mat | ? | |
banner(parent: ?, M: ?, x: ?, yTop: ?, w: ?, h: ?, z: ?) → void
A soaked processional banner: rod, cloth, and the bronze finial.
| arg | type | description |
|---|
| parent | ? | |
| M | ? | |
| x | ? | |
| yTop | ? | |
| w | ? | |
| h | ? | |
| z | ? | |
rubble(parent: ?, M: ?, x: ?, y: ?, z: ?, seed: ?, size: ?) → void
Broken masonry: a scatter of fallen blocks and salt-crusted rubble.
| arg | type | description |
|---|
| parent | ? | |
| M | ? | |
| x | ? | |
| y | ? | |
| z | ? | |
| seed | ? | |
| size | ? | |
flame(parent: ?, M: ?, x: ?, y: ?, z: ?, s: ?) → void
The bronze brazier's stand-in flame: a cone of ember light over the bowl.
| arg | type | description |
|---|
| parent | ? | |
| M | ? | |
| x | ? | |
| y | ? | |
| z | ? | |
| s | ? | |
bellHousing(parent: ?, M: ?, x: ?, y: ?, r: ?, yokeY: ?, ceilY: ?) → void
The yoke a bell hangs from: two beams of black oak, iron straps, and the
chain that carries it up into the dark.
| arg | type | description |
|---|
| parent | ? | |
| M | ? | |
| x | ? | |
| y | ? | |
| r | ? | |
| yokeY | ? | |
| ceilY | ? | |
backdrops(root: ?, M: ?, C: ?) → void
| arg | type | description |
|---|
| root | ? | |
| M | ? | |
| C | ? | |
foreground(root: ?, M: ?) → void
Foreground silhouettes: what the frame is seen through.
| arg | type | description |
|---|
| root | ? | |
| M | ? | |
tower(root: ?, M: ?, C: ?) → void
| arg | type | description |
|---|
| root | ? | |
| M | ? | |
| C | ? | |
nave(root: ?, M: ?, C: ?) → void
| arg | type | description |
|---|
| root | ? | |
| M | ? | |
| C | ? | |
props(root: ?, M: ?, meshes: ?, C: ?) → void
| arg | type | description |
|---|
| root | ? | |
| M | ? | |
| meshes | ? | |
| C | ? | |
decorate(map: ?, Config: ?) → void
Build Véspera's art under `map`. Idempotent: the previous run is dropped
first, so a scene that rebuilds on every write lands the same content once.
| arg | type | description |
|---|
| map | ? | |
| Config | ? | |
echoPulse(x: ?, y: ?, radius: ?) → void
The echo made visible: a ring of turquoise light leaving a struck bell.
`ilva` calls this when a bell is rung; a scene with no art still runs.
| arg | type | description |
|---|
| x | ? | |
| y | ? | |
| radius | ? | |