ferravex
GitHub

Starweaver

A complete, finite exploration and fabrication expedition. You command The Little Light, a survey cutter escorting a colony ark away from a dying star. Recover three ancient relics, manufacture their gate mechanisms, return to Loom Dock and open the gate before watch 52. Zero hull ends the expedition. Restart immediately with R.

The game uses Ferravex's shared arcade host for its title screen, field manual, pause/restart, accepted-event audio, terminal screen and local best-score storage. Simulation is separate from drawing and runs through fixed 60 Hz inputs. Planning is untimed: watches advance only when expedition work is accepted. Lane travel animates for 120 ticks without accepting another command.

Reading the screen

Starweaver follows the catalog's visual language: icons and numbers instead of labels, previews instead of instructions, and effects where things happen.

Content

The chart

Deposits below are the original alloy / crystal / circuit quantities. Mining and salvage never regenerate them. First-entry damage happens only on the first visit; extraction damage applies to each accepted mining or salvage operation. Both are halved, rounding up, by a Radiant Shield.

SectorDeposits A / C / CIRFirst-entry / extraction damageLandmark
Loom Dock0 / 0 / 00 / 0Home gate and trading station
Cinder Belt8 / 1 / 10 / 0One freight cache: 2 alloy
Glass Comet1 / 7 / 00 / 0One collector: up to 4 fuel
Wayfarer5 / 0 / 56 / 0Navigator's key and 20 credits
Hollow Choir0 / 7 / 210 / 2Singing lens encounter
Verdant Archive2 / 5 / 20 / 0Trading station; 2 seed crystals and 15 credits
Copper Reef5 / 2 / 68 / 1Privateer encounter
Silent Crown5 / 5 / 514 / 2Sentinel core encounter
Far Beacon1 / 3 / 20 / 0Rescue 9 engineers: +10 hull, +25 credits

The chart names every sector and marks lanes, hazards, landmarks, surveys and the goal; the Chart panel shows the selected sector's landmark and rewards, deposit stocks as pips, shielded hazard costs, station services and the route there with its total cost. Stocks are visible before surveying to support route planning.

Controls

InputAction
1-5 / click a tabChart / Survey / Forge / Ship / Mission
Arrows or WASDSelect a star, action row or encounter approach
Space or EnterAccept the selected action
Click a star, then click it again (or the jump button)Select it, previewing the route; then travel along a connected lane
Click an action row or bottom buttonAccept that action
X or E on a Survey resource rowDiscard one unit of that cargo; no reward or watch cost
X or E on ShipCycle the resource to sell
HShared paginated field manual
P or EscapeShared pause menu
RRestart the entire expedition with fresh stores
MShared sound toggle

During transit, arrival progresses automatically and other gameplay commands are ignored. In an encounter, arrows/Space or clicking an approach resolves the choice; each approach shows its costs and rewards, and unaffordable ones are dimmed with the missing store in red. Mission information is read-only except for the explicit gate-opening action. Hover highlights use the same hit regions as clicks.

Rules and fabrication

Start at Loom with 100 hull, 8/10 fuel, 60 credits, 1 alloy, 1 circuit and a 12-unit hold. Jumping costs one fuel and one watch. Survey a sector once before extracting resources or exploring its landmark. An extraction transfers up to two units, bounded by the remaining deposit and free hold space. Relics and fitted components occupy dedicated mounts, not the cargo hold.

Every accepted jump, survey, extraction, completed discovery, build or ordinary service spends one watch. The distress tow spends six. Declined or unaffordable actions, menu navigation, idle planning and the Choir's withdrawal spend none. Reaching watch 52 loses, including attempting to open the gate on that watch. Hull damage may end a run before another watch is spent.

RecipeAlloyCrystalCircuitRequirement or effect
Beacon spindle321Navigator's key from Wayfarer
Phase loom231Singing lens from Hollow Choir
Heart engine323Sentinel core from Silent Crown
Radiant Shield201Halve all hull damage, rounding up
Cargo Cradle301Increase hold capacity from 12 to 18
Deep Scanner120Extract up to three units per action

Each recipe can be built once. Costs are checked before any ingredient is consumed. Gate components need their named relic; upgrades do not. The Forge panel shows each cost against the hold, the required relic and the effect.

The Choir permits a powered probe for 1 fuel, a dive risking 18 hull and recovering one bonus crystal if space permits, or a free withdrawal. The Sentinel permits a 2-circuit override, a 30-credit toll, or forced entry risking 34 hull. Privateers offer 3 circuits for 1 alloy (requiring two free hold spaces), an escape costing 2 fuel, or a fight risking 22 hull and awarding 40 credits. Each completed landmark resolves only once.

Ship services are:

Full-tank and full-hull services do not consume resources. Partial fills consume the full advertised price, so plan ahead. There is no material-buying loop, infinite discovery reward or recurring deposit. If all fuel options and the tow have been exhausted, R begins a fresh expedition.

Strategy and score

Begin Loom → Cinder → Wayfarer to recover the key and salvage alloy and circuits. Cinder connects to Hollow Choir's rich crystal deposits. Keep crystals for both fabrication and fuel; spend them deliberately. Forge components as materials arrive to release hold space. Shielding can pay for itself on a hazardous route, while a scanner exchanges early resources for later watches. The upgrades are optional, not prerequisites.

Loom and Verdant offer safe station services. Copper Reef provides a circuit-heavy alternate route. The optional Far Beacon rescue repairs the hull and earns credits, but requires travel and two actions if unscanned. Surveying every sector may improve discovery score while consuming time needed for the gate.

Scans award 75 points; each relic and the privateer resolution awards 250; each component awards 500; each upgrade awards 100. Cinder and Glass landmarks award 100 each, Verdant's archive awards 150, and rescuing the engineers awards 350. Resource extraction itself awards no score. A successful escape adds 1200 + 25 × remaining watches + 3 × remaining hull + min(credits, 500). The terminal result reports time, mapped sectors, hull, rescued or abandoned engineers and final score. A new run allows a different route or a better result.

Run and validation

From the repository root:

cargo run -p starweaver --offline --locked -j 2
cargo run -p starweaver --offline --locked -j 2 -- --headless
cargo test -p starweaver --offline --locked -j 2
cargo clippy -p starweaver --all-targets --offline --locked -j 2 -- -D warnings
rustfmt --edition 2024 --check examples/starweaver/src/*.rs

The headless pilot emits only ordinary player inputs into the same rules. It finishes at tick 2424, watch 37, 64 hull, 4817 points, with all three mechanisms, all three relics, all nine engineers rescued and at least eight sectors visited. It surveys five sectors; its successful route does not claim to demonstrate every optional choice or upgrade.

Validation completed: 24 behavioral tests plus one executed public-API doctest, strict scoped Clippy, owned-file formatting and the complete headless expedition. Regressions cover recipes and duplicate builds, finite stocks, capacity, upgrades, invalid routes, encounter affordability, loss/restart, deadline/idle behavior, transit input handling, service costs, trading, tow limits, mouse regions, the click-again jump, terminal immutability and reproducibility. Presentation tests cover header progress, short objectives, per-tick events, effects for surveys, extraction, relics, refusals and damage, lane routes, and that every action preview agrees with what the rules accept across the whole bot expedition. The complete-win test begins at Game::new() and never injects state.

The parent also inspected a native autoplay capture at frame 1100 and reported a readable chart, sidebar and transit/resource display with no overflow. For further parent-owned captures, --autoplay --smoke-frames 1100 --screenshot PATH gives a mid-expedition chart; 2500 reaches the completed ending. Headless validation is not a comprehensive manual playtest. Browser/Wasm packaging, audio behavior, persistence, controller/remapping integration and the remaining panel/branch screenshots are owned by the parent integration; this game has no standalone network or unfinished-campaign save claim.