ferravex
GitHub

Signalbox

Take the brass key to Bramble Junction and bring every train home. Signalbox is a complete railway dispatch campaign: eight authored shifts, 61 scheduled services, four destination platforms, and one shared bridge. The train rules run in Rust on Ferravex's fixed-tick host; the same campaign builds for native windows and the browser.

Study both point settings, let a train through a signal, and keep the next service safely waiting. Fast mail, slow freight, opposing traffic, rain, snow, bridge inspections, and tighter due times gradually complicate the railway. There is no reflex penalty for thinking: planning mode stops the railway clock.

Playing

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

A supported native display/OpenGL host is required. For the shared browser catalog, use the repository's parent-owned web build and open the Signalbox entry. No downloadable art, fonts, or external libraries are required.

Each shift opens with a briefing card instead of instructions: the shift's name, its new challenge as an icon chip, every service as a lettered badge with its origin arrow and service icon, and the shift's facts as icons and numbers (trains, closing bell, inspection window, running speed, retries). Enter the signalbox with Space/Enter or the card's button, deliver every service before the closing bell, then advance to the next timetable. Complete the eighth shift to receive the brass key and a career rank. Losing all three shift retries and then suffering another incident ends the career; R immediately begins a fresh career through the shared host.

Controls

ControlAction
Left / Right, or A / DSelect one of the six switchboard controls
Space / EnterOperate selected control; accept a briefing or completed shift
Up / Down, or W / SCycle selected control forward/backward
1-5Select the first five switchboard controls; Right reaches the sixth
Click a bottom controlOperate that signal or set of points
Click a lamp or points on the mapOperate it exactly like its bottom control
X / E, or click the clock dialStop the railway clock to plan; resume it
C / QSpend one of three career retries and reopen the current shift
Escape / PShared pause menu
HShared help
MShared sound toggle
RRestart the entire career

Input acts on presses, not held keys. Space does not repeatedly cycle a switch while held. Mouse clicks and keyboard controls operate the same rules.

Reading the railway

The play screen has no sentences; state is drawn where it happens.

Every accepted action is felt at its place: rings at switched lamps and points, a red ring and lock popup on refused points or bridge lamps, rings as trains enter or pass a green lamp, a burst and a coin popup at the platform on each delivery (with a sparkle when on time), a clock popup when a train runs late, lock/unlock moments at the bridge, sparks and shake at incidents, "Go!" at each shift start, and a callout with confetti when a shift clears. The shift-cleared card shows the medal stars and icon stats; the incident card draws what happened (train and wrong platform, two colliding trains, or the bell and the trains left) with the retries left and any commission forfeited. Status readers still receive each briefing's story and tip, and a plain-language incident account.

Routes and signals

Every train carries a destination disc above it. The departure board repeats its letter, countdown, and current state. A/B are the west-bank stations and C/D are the east-bank stations. The point controls cycle STRAIGHT → NORTH → SOUTH. Points choose a route in either direction; they do not know a train's destination.

Origin → destinationWest pointsEast pointsSignals to clear
West → A (Abbey)North-West gate
West → B (Orchard)South-West gate
West → C (Quarry)StraightNorthWest gate, west bridge
West → D (Harbour)StraightSouthWest gate, west bridge
East → C (Quarry)-NorthEast gate
East → D (Harbour)-SouthEast gate
East → A (Abbey)NorthStraightEast gate, east bridge
East → B (Orchard)SouthStraightEast gate, east bridge

A green signal releases one train and automatically returns to red. The origin yards queue waiting services safely, but the open railway does not provide automatic routing or collision protection. Two opposing trains on the single bridge can collide. Fast mail can also catch a slow train ahead. Points lock when a train is within their protected area; trying to change locked points is rejected without a sound or scoring event.

Wrong platforms, leaving the network without a delivery, collisions, and an end-of-shift bell with services outstanding are safety incidents. An incident holds the railway until you spend a retry. Existing commissions survive; the failed shift's provisional earnings are discarded. Retrying an unfinished shift with C spends the same retry resource.

The eight shifts

ShiftServicesNew challengeClosing bell
The apprentice's bell4Learn near-bank and cross-bridge routes125 s
Two banks, one bridge5Opposing traffic and fast mail150 s
Harvest wagons6Slow, heavy freight and mixed traffic180 s
The bridge inspector7Bridge entrances closed at 18-34 s200 s
The seaside special8Tight due times and overlapping services220 s
Rain on the wires985% speed; closure at 26-43 s260 s
Winter through service10Snow reduces speed to 78%320 s
The royal timetable12Final inspection at 40-57 s; dense timetable340 s

Each shift has its own approach geometry and authored service order, origins, destinations, speeds, release times, and due times. The six-control network stays recognizable. Bridge inspections block new entries; an already-crossing train can finish. Pause/planning time never advances these windows.

Commission, medals, and replay

A delivery earns 200 provisional commission plus up to 180 for punctuality. The punctuality bonus decreases by one per 0.2 seconds late, down to zero. Safe late deliveries still count. A completed shift banks its provisional earnings plus 300 and 150 per medal star; provisional earnings cannot be farmed through retries.

The full campaign awards up to 24 stars. Final ranks range from Keeper of the Brass Key to Master of the Line. The shared host retains the best career record on the local device. There is no mid-shift resume save.

A safe first strategy is to release one train at a time. For higher ranks, route near-bank services while another train crosses the bridge, and prioritize mail before it catches freight. Use X to examine the whole board before opening a signal. A slow but safe dispatcher can finish every shift.

Source and checks

cargo test -p signalbox --offline --locked -j 2
cargo clippy -p signalbox --all-targets --offline --locked -j 2 -- -D warnings

The nineteen unit tests include a complete eight-shift win through ordinary player inputs, both terminal outcomes, geometric collisions, wrong routes, red signal holds, protected points, bridge inspection refusal, planning, deadline failure, bounded retries, one-time scoring, map clicks routed through the same rules as the switchboard, the per-tick presentation events, header progress pips, delivery/refusal/incident effects, route previews and hints, and the short help copy. A rustdoc example executes the pure model. The bot uses actual switch and signal controls; it has no invulnerability, teleportation, direct deliveries, or privileged routes.

For parent-owned native visual smoke, an active first-shift capture is:

cargo run -p signalbox --offline --locked -j 2 -- \
  --autoplay --smoke-frames 1400 --screenshot target/games20/signalbox.png

Tests establish behavior on the tested host; they are not a human playtest or proof of browser, audio-device, mobile, or cross-platform behavior. Native visual smoke, browser staging, catalog integration, and broader release validation are owned by the parent integration task.