First Light: Lavic Odyssey
Commits
Every published commit of this world, on every branch, newest first.
1698ee71e5showcase: six gameplay stills from a played round9afd7dc0aefix(knights): the pilgrim who is dressed is the one you are holding
Pilgrim.isDressed() answered for ANY body it had ever dressed, so the
guard in tryDress was already satisfied by the PROTOTYPE dressed in edit
and the play clone was never dressed at all. A browser session came up
with a bare-headed pilgrim and a fully plated mannequin standing at the
origin; the same session's pilgrimDressed() reported true.
isDressed now takes the body to ask about.358f61867cfix(staging): a caption over a card hugs the top edge
The letterbox inset put the line across the card's own heading. A card
fills a tall frame, so the only clear band is above its art.bed47db66dfix(staging): the narrator's line is held clear of the HUD's edge columns
The caption band took cardWidth - 86% of a tall frame - which is the right
width for a card the HUD stands down for and too wide for a line drawn
OVER it. On a browser session's near-square canvas the band reached across
the clock and the freed pips and left them half-legible; at 3:4 it clipped
the clock. Two thirds of the frame clears both columns at every shape.b43ff52665fix(spire): a second session in the world is not refused its own spire
entity.find matches by NAME across every peer in a multiplayer world, so a
browser session opening this world found the native session's SpireRoot,
tried to destroy it, and was refused - only the owner may despawn a synced
entity. The raise took awake() down and the whole slice was DISABLED, so
the second player got no stair, no ledges and no knight spots at all.
A root this session does not own is now left where it is.aa09de470bfix: the climb is playable, visible and legible at every shape
The round: the pilgrim returns to StartSpawn when one starts, and the tide
holds still for twenty seconds before it climbs, so a round no longer ends
on the start platform before the player has moved. requestTitle has a
listener instead of a warning and a fallback.
Sight: the helm's slit opens around the point the follow rig actually
draws the pilgrim - one fraction, in the shared contract, read by both -
so the helmed frame contains the pilgrim, the tread and the way up rather
than a band of empty sky. The basalt, the obsidian and the treads carry
the caldera's own faint heat, so the tower reads as rock under a night sun
instead of a black cut-out.
The ending: a staged finale runs when the rim is reached, which is the
event it was waiting to be given; it was listening for the round's end
instead, so every win sat twenty-five silent seconds on the staging cap
and cut to the card with no moment at all. Its second shot is level with
the horizon the sunrise is on.
Shapes: a card's numbers lay across a landscape frame and stack down a
tall one, so the pause and end cards fit a 16:9 screen; the narrator's
line moves to the top of the frame while a card owns it, where it no
longer covers the buttons; and the title card reserves the caption band's
whole footprint.
Also: six scratch entities out of the durable scene, and a written
how-to-play for whoever opens the world.61fdfda757spire: a knight's tread carries no parapet, so a lost knight stands on its ledge and not inside a column65cd350376knights: the helmed bronze pilgrim, the great helm coming off, and the six lost knights
The hero asset and the dishelm beat.
- game/knights/kit.module — socket-and-piece toolkit for dressing an animated
humanoid: unit-scale bone sockets so parts are authored in metres on a
centimetre-authored rig, limb-spanning plates aimed down the bone, mesh
fitting, subtree repaint, easing.
- game/knights/helm.module — the great helm, in a kept look and a long-dead
one: shell, dome, jaw, riveted bands, crest, breaths and the lit eye slit,
with a forward-facing visor lamp.
- game/knights/pilgrim.module — dresses the player's humanoid as the pilgrim
through eleven bone sockets, and takes the helm off the head down to the hip
and back on a real arc through the world, with the sooted coif and two lit
eyes coming up in its place.
- game/knights/lost.module — the six lost knights fused into the spire's rock
at KnightSpot_1..6, each with its own lean and depth in the stone, and the
freeing: a rising helm, a column of light, the statue to embers, and a
cooled scar left on the rock.
- game/knights/Knights.component — the slice: follows helm / freeHeld / phase
on L.bus, reads free and helm off game.input.lavic when nothing else is
driving them, and emits freeProgress and knightFreed.
- six materials, and the generated harness the statues wear.
Verified in play: hold-to-free reaches L.state.freed on keyboard (E), gamepad
(north) and the on-screen Free button; a freed knight cannot be freed twice;
the helm visibly leaves the head on Q and returns.36786eb45frules: a map that is not resolvable this frame leaves the controls where they are
Reaching for a handle to an inputMap raises while that map's own init.luau
is being hot-reloaded, and the raise came out of editorUpdate, which
disabled the component:
argument #1 'ref': expected RefArg, got nil
game.rules.Rules:117 function pointAtClimbMap
game.rules.Rules:143 function pointPrototypeAtClimbMap
game.rules.Rules:573 function editorUpdate
climbMap() and holdMap() now answer nil for those frames and every caller
leaves what it was going to write alone, so the next tick sets it instead.
The arm and the hold re-resolve their ref when they hold none.
Verified after the change: title -> Enter -> play, W walks 3.79 u in 1.0 s,
Q takes the helm off with heat at 14.9 after a second, and walking off the
start platform loses to the tide.99192fb7cescreens: title, how-to-play, HUD, visor, pause and end cards, with a focus ring three input families can drive
The presentation slice of First Light: Lavic Odyssey.
- game/screens/theme.module the dawn palette, the type hierarchy, the card
and control recipes, the entrance and idle motion
- game/screens/art.module the great helm lit and dark, the bare head, the
title crest, the sunrise, the tide, the knight pips
- game/screens/hud.module the heat column, the freed knights, the dawn
ladder, the helmet-slit visor, the canto toast
- game/screens/cards.module title, how-to-play, pause, won, lost — each
returning its tree AND its focus order
- game/screens/Screens.component the slice: four screens, the menu map, the
focus ring, and the requests it makes of rules
- game/input/menu.inputMap confirm / back / navigate / navigateDpad / restart
Every control is reachable by pointer, by finger and by pad. Nothing holds a
pixel position: every measure comes off L.layout(), a tall frame stacks and a
wide one puts the how-to card's prose beside its controls.759e4f7bdbspire: the climb — helix stair to the rim, crust gates, fumaroles, ember rain, knight spotsb9133ebfaflava: the tide bursts where it stands
The sound library owns the lava's rumble bed; what belongs to this slice is the
surface itself. A bubble goes off at a point on the tide around the spire,
placed in the world so the listener on the camera rig hears where it was, and
more often the closer the tide has climbed to the pilgrim. Guarded on
asset.exists so the slice still runs with the sound library absent.
---
rules: the round — phases, helm and heat, the rim and the tide, and the one live control scheme
The phase machine (title -> opening -> play <-> paused -> won/lost) driven
by requestStart / requestRestart / requestResume / requestPause and by
openingDone / finaleDone, with a staged moment given first refusal on the
opening and on the end, capped and skippable, so a round still finishes
with the staging slice absent or stuck.
Helm and heat: one toggle, heat rising at 14/s bare-headed and twice that
within 2.5 u of the lava, falling at 22/s helmed, +18 an ember. Height and
canto tracked off the local avatar. The rim wins, the tide and an overload
lose. The lava rises on the round's own clock when nothing else is writing
it.
Controls: game.input.lavic gains sprint (Scramble), which the humanoid's
CharacterController reads by name, and moves to its own group standing the
engine's default map down -- the player prototype holds that map live
whether or not anything reads it, so without this a phone drew this game's
four buttons beside a built-in Crouch, Interact, Zoom and Pointer Lock. The
new game.rules.hold map takes the controls back for every phase that is not
the player's and carries the Continue and the Again that work with no cards
at all.
game.rules.framing solves the follow camera from the live screen: the
vertical field of view backwards from a target horizontal one, the distance
from the aspect, and the aim point raised by a share of the visible height
so the pilgrim sits 40% up the frame on a 3:4 phone, a laptop and a
television alike.
Verified in play: start reaches play; W walks 5.76 u in 1.2 s; Space rises
1.41 u; Q toggles the helm with heat measured at 14.2/s off and 22/s on;
standing at the rim wins; the tide over the head loses; R restarts; and
inputSim proves every control fires from keyboard+mouse, from a pad and
from touch, with the touch overlay drawing exactly Helm, Free, Jump and
Pause over the move stick and the look zone.08612e38aasound: a spatial one-shot aimed at an entity no longer raises
An entity proxy is a `table` and raises on any key it does not carry, so the
`type(at) == "table"` branch read `.x` off one and threw — which took the whole
`knightFreed` bus handler down with it, so freeing one of the lost was silent.
`pointOf` now recognises an entity by the `id` and `position` it does carry,
before anything reads `.x`, and both `play` and `loop` go through it. All four
shapes an `at` may take — an entity proxy, an entity id, {x,y,z} and {1,2,3} —
verified twice, with the knightFreed and plateCrumble handlers driven from the
bus and the engine log clean afterwards.3230abe623staging: a fuller description and tags on skip.inputMap so search can find it891720ecdblava: the molten tide and the dawn
A rising lava surface with its own shader (world-space flow, three scales of
cooling crust, a glowing crack network, a grazing obsidian sheen and a
distance falloff), the ember veil drawn on cylinder shells the camera looks
through, a heat-haze sheet that bends the scene behind it, and five point
lights that carry the tide's glow onto the rock.
The dawn is a ramp read off L.dawn(): deep night on the caldera floor, first
blush mid-climb, first light with the sun on the horizon at the rim, driving
the sky, the sun, the ambient and the height fog. Its keys are measured
against this engine's ProceduralSky rather than assumed, and the module says
what was measured and why the numbers look the way they do.
---
sound: the clip bank, the beds and the score
game/sound/synth.module — the whole bank synthesised on the CPU from raw f32
PCM: oscillators, noise, one-pole and state-variable
filters and a small Schroeder reverb for the caldera.
Loops are folded back on themselves so the last
sample runs into the first, and stored as codec pcm
so the head survives decoding. Also trims and folds
generated music into a seamless loop.
game/sound/sfx.module — the library every slice reaches for: play / loop /
stop / bed / duck / music, a per-clip mix, a
retrigger guard, and emitters found by name so a hot
reload re-attaches rather than doubling up.
game/sound/Sound.component— the ear: ticks the library, turns L.bus events into
sound, and moves the mix under the round — the tide
below, the air at the rim, the score by phase, and
the pilgrim's own feet.
game/sound/clips/ — 24 .soundClip assets: 16 one-shots, 5 beds, 3 scored
tracks generated with audio_gen and made loopable.
---
lava: asset descriptions, and a night the climb can be read in
Every lava asset now carries a real .metadata description and tags so ZeroMind
search can find it. The night key's ambient and moonlight are raised and the
tide's glow lights reach further (radius 78, intensity 11) so the rock the
pilgrim climbs is lit from below by the thing chasing them.
---
staging: the narrator and the three staged moments
The moments slice of FIRST LIGHT: LAVIC ODYSSEY.
- game/staging/lines.module — the narrator's script, 13 lines, keyed
- game/staging/voice.module — one cached .soundClip handle per line
- game/staging/voice/ — the clips, generated once from those words
- game/staging/narrator.module — the voice entity, the caption screen and
the beat bloom, all laid out from L.layout()
- game/staging/moments.module — the opening, the finale and the loss beat,
written as cutscene data and built the frame
they play
- game/staging/skip.inputMap — Skip, on a key, a pad button and a touch
button, live only while a moment runs
- game/staging/Staging.component — the bus wiring; emits openingDone,
finaleDone and cutscene(name, active)
Every line is voiced by one narrator and captioned; the caption is the line,
so a clip that never generated costs a performance and not a word.8fdaa558dfplan: First Light: Lavic Odyssey — skeleton, shared contract, spec