ferravex
GitHub

Saltwind

A merchant voyage across the Six Isles. Your mother's ship carries a 900-crown lien. Complete six delivery charters, trade your way around the islands, and come home with enough money to make Saltwind yours before day 43.

This is a finite single-player campaign with six named ports, six authored story charters, three trade goods, limited cargo and market stock, six weekly market/wind forecasts, two passage types, food and hull management, three ship upgrades, and three captain ranks. Planning at port is turn based; sailing is a fixed-tick journey with steering and reefing. A conservative complete voyage uses about 24 game days; optional trades, upgrades and faster routes change its profit, schedule and final score.

Play

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

Start with the charter shown in the header: a grain sack with 0/3, an arrow, Brinewatch's pin and the crowns it pays. A pulsing dot marks the ledger tab that holds the next step. Press 2 for Market, buy three grain with Space, then 1 for Chart. Brinewatch is already selected: Space sets sail. On arrival, 3 opens Charters and Space delivers. The next charter appears immediately. Repeat the voyage around the six islands, then select Settle debt at Haven's Shipyard.

ControlAction
1 / 2 / 3 / 4 / 5Chart / Market / Charters / Shipyard / Log
Arrows or WASD edgesSelect destination, good, or shipyard service
Space / EnterSail, buy, deliver, refit, settle debt, or wait, according to the visible tab
X / ESell one selected good in Market; switch sheltered/open sea on Chart; open Market from Charters; return to Chart from Shipyard/Log
C / QReturn to Chart while in port
ClickSelect an island, tab or row; activate the painted action buttons; pick the other side of the Chart's route switch (the side already chosen does nothing)
Up / Down held at seaSteer across the passage to avoid storm rings
Space / Enter at seaReef or unfurl sails; the action button and the other sail-plan tile also work with the mouse
HHelp
P / EscapePause
RRestart the entire voyage
MSound setting, handled by the shared host

The native and browser builds use the shared Ferravex arcade lifecycle for start, pause, help, full retry, accepted-event cues and best-score records. Keyboard and pointer controls are authored here. Actual touch/gamepad device coverage is not claimed.

Reading the screen

Saltwind explains itself with icons, meters, pips and previews rather than sentences; words are kept to names, numbers and one-word verbs beside key caps.

Rules and strategy

The six ports are Haven, Brinewatch, Glass Quay, Cedar Reach, Saffron Key and Gullspire. Their charter stories progress from bread for lighthouse keepers to the homeward cargo. The visual chart contains authored island silhouettes, houses, piers, lighthouses, storm rings, a wind compass, passage marks, a sailing ship and a parchment trading ledger; all art is drawn through Ferravex, with the engine's shared pictograms for every resource and action.

Verification

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

The headless command runs the same model using ordinary player inputs. It buys cargo, travels, resupplies, delivers all six charters and pays the debt. It grants no special money, invulnerability, movement or objective completion.

The suite has 22 behavioral tests and one executable rustdoc example. Coverage includes the complete legal voyage, trade accounting and anti-farming, capacity rejection, delivery duplication/wrong ports, forecasted food/day consumption, reefing, mouse hit regions (including the route switch's sides and the sail-plan tiles), real storm damage/armor, starvation, deadline loss, restart construction, terminal invariance, same-host deterministic input replay, header progress at the start and end of the campaign, and the presentation effects for purchases, refusals, deliveries and squalls. The headless pilot won at tick 4633, day 24, with 184 crowns after repaying the debt, 100% hull and score 4783.

For the integration owner's native visual smoke:

cargo run -p saltwind --offline --locked -j 2 -- --autoplay --smoke-frames 240 --screenshot target/saltwind-sea.png

The default pilot begins sailing after its initial grain purchase; around tick 240 is a good sea view. Port shopping lasts only a few dozen ticks because the pilot issues an action every eight ticks; interactive input is better for inspecting all ledger tabs. The complete run ends around tick 4633, so later captures show the result overlay.

Compilation, unit tests and headless completion are not a visual or audio playtest. Native/browser rendering, sound output, resizing, actual device input, and browser persistence are left to parent integration checks. There is no networking and no cross-platform bitwise-determinism claim.