ferravex
GitHub

Mosslight

Carry the village's last ember beneath a forest that stole the sun. Mosslight is a complete, turn-based dungeon expedition: six authored floors, three ordinary enemy species, a telegraphed final boss, permanent relic choices, limited healing and lantern charges, optional treasures, defeat, and a scored ending.

The dungeon waits for you. There is no real-time pressure and no need to hold movement keys. A careful expedition takes roughly a few hundred decisions; the reproducible smoke player reaches the ending in 155 accepted turns.

Play

cargo run -p mosslight --offline --locked -j 2

The shared Ferravex host supplies the title/tutorial, pause, help, restart, accepted-event audio and local best-record storage. Browser publication and catalog registration are owned by the collection integrator.

ControlAction
Tap arrows or WASDMove one tile; bump a creature to strike
Space / EnterGuard; descend when standing on stairs
X / EDrink one flask, restoring up to 12 health
C / QSpend one lantern charge to burst every foe within two tiles
1 / 2 / 3 at campChoose blade, heart or lantern relic
Left click on the boardMove or strike an adjacent tile; mark a distant creature
Left click on a sidebar buttonSame as its key: guard/descend (Space), flask (X), burst (C)
Left click on a relic cardChoose that relic
HoverPreview a step, strike, flask, burst or relic before committing
Esc / PPause
HField manual
RBegin a fresh expedition
MToggle sound

Holding a direction does not repeatedly spend turns. An idle fixed tick leaves all dungeon rules untouched. Blocked movement, an empty burst or an unnecessary flask spend no turn or resource. Input priority accepts at most one action in a tick: flask, burst, guard, then movement. A click on a sidebar button presses exactly that button's key, so both share one rule path.

Reading the screen

The interface shows state instead of describing it:

The expedition

FloorPlaceMain lesson
1The Lantern StairRead rootling attacks, find the key and unlock the stairs
2The GlasshouseBreak line of sight to spore beams; introduce bramble knights
3The Thorn LibraryUse recovery turns and choose routes through winding shelves
4The Flooded ChoirManage flasks and avoid intersecting attack lanes
5The Amber VaultDecide how much optional daylight is worth the detour
6The Root King's HallDefeat the King, retrieve the key and escape with the dawn

Every floor contains a key (the seed sigil), a moonwell, a flask and optional amber. Stepping on the key unlocks the gold seals, whose lock badges disappear, and the stairs, which start to glow. Reach the stair tile and press Space to finish a floor. The final stairs also require the Root King's defeat; until then they show a red crown badge.

After each of the first five floors, a camp offers one lasting relic as a card with its icon and gain. Hovering or selecting a card previews the result in the sidebar and lists the next floor's creatures:

All camps also restore seven health, one flask and one charge, capped by your current capacities. Flasks are limited to five. Moonwells restore eight health, one flask and one charge once per floor. A full flask belt leaves an unopened flask in place so you can return later.

Read the enemy, then act

Red bracketed cells show attacks that resolve after your next accepted action. They breathe in and out and deepen with the damage they carry. A knight striking from two tiles away is linked to its cell by a dashed lane. The target cells remain fixed during that action: step away, kill the attacker, or press Space to reduce each incoming hit by three. Creatures recover for one turn after attacking. Gold arrows indicate movement, z recovery and a red ! a pending strike.

Bumping a creature attacks without moving into its tile. A slain creature's pending attack is cancelled. Lantern bursts deal blade damage plus three to all foes within Manhattan distance two, including through thin walls. Thorns deal two damage when stepped on. Drinking a flask also gives surviving enemies a turn.

Scores and replay goals

A seed is worth 100, each defeated ordinary foe 80, each amber jar 140, each cleared floor 350 and the King 700. Victory adds 2,000, twenty points per remaining health, and an efficiency bonus of max(0, 600 - turns). Unique rewards cannot be collected twice. Ending ranks are Lantern Bearer, Dawnbringer at 6,500 and Sunkeeper at 7,800. Try a different relic build or retrieve amber that the shortest route leaves behind.

Implementation and validation

src/content.rs holds the authored maps. src/model.rs owns pure bounded rules and records a bounded list of presentation events for each executed tick (what was accepted or refused, and where). No rule reads that list. src/view.rs draws the board, original procedural characters, attack marks, sidebar and camp cards. It also implements the arcade hooks: header pips (progress), the quest chain (draw_objective), location effects (effects) and the results card (draw_result). Hover previews step a copy of the model. Drawing never mutates the game, and no game rule polls a renderer, wall clock or I/O. The shared ferravex-arcade host consumes fixed-tick action edges and owns saves, window/browser integration, audio and pause/restart.

cargo test -p mosslight --offline --locked -j 2
cargo clippy -p mosslight --all-targets --offline --locked -j 2 -- -D warnings
cargo run -p mosslight --offline --locked -j 2 -- --headless

The package check executes twenty behavioral tests and one rustdoc example. The complete-campaign regression starts from a fresh game and submits only legal player commands. It visits all six floors, chooses five relics, defeats the King and reaches victory. The --headless executable independently prints each floor milestone and fails if the same legal player does not finish. Further tests cover the sidebar buttons (each click matches its key, including refusals and descending), relic card clicks, event bookkeeping, header progress at the start and end, effects for the key and a landed blow, and side-effect-free previews.

For the integrator's graphical smoke capture, suitable points are 420 frames (the Glasshouse) and 1,350 frames (the King's hall):

cargo run -p mosslight --offline --locked -j 2 -- --autoplay --smoke-frames 420 --screenshot target/mosslight-glasshouse.png

The visual pass ran the tests, the headless expedition, strict Clippy and native smoke screenshots (play, hover previews, camp, both endings). It did not run a hands-on playtest, Wasm/browser build, audio-device test, or cross-platform/device validation. Those remain collection integration checks.