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 2A 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
| Control | Action |
|---|---|
| Left / Right, or A / D | Select one of the six switchboard controls |
| Space / Enter | Operate selected control; accept a briefing or completed shift |
| Up / Down, or W / S | Cycle selected control forward/backward |
| 1-5 | Select the first five switchboard controls; Right reaches the sixth |
| Click a bottom control | Operate that signal or set of points |
| Click a lamp or points on the map | Operate it exactly like its bottom control |
| X / E, or click the clock dial | Stop the railway clock to plan; resume it |
| C / Q | Spend one of three career retries and reopen the current shift |
| Escape / P | Shared pause menu |
| H | Shared help |
| M | Shared sound toggle |
| R | Restart 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.
- Header: eight shift pips and the shift's name; one capsule per service (outlined while waiting, pulsing on the railway, filled once home); the shift timeline with each due time as a colored mark, the bridge inspection as a red lock block, the current time as a knob and the closing bell at its end; the running speed (rain, snow, sun or crown icon) when it differs from normal; and the three career retries as pips.
- Trains carry a destination disc (color and letter) with a ring that drains toward the due time and glows red once late. A train held at a red lamp bobs.
- Route preview: a dashed line in the train's color shows where it will run with the current points, dimmed past the red lamp that holds it, ending in a green check at the right platform or a red cross at a wrong platform or the far yard. The focus is the hovered train or board row, else the first train heading the wrong way, else the first on the railway. When the focus can still be saved, the points to change pulse on the map and on the switchboard, and its destination glows. Hovering a set of points ghosts the branch one click would set and previews the route through it.
- Stations list one pip per service due there. Yards queue the next arrivals as badges whose rings fill until release; a pulsing amber ring means released and waiting for the yard to clear.
- Signals are two-aspect lamps on the map; points show their blade. Lock markers appear on points with a train inside their protected area and on bridge lamps during an inspection, when the bridge also shows barriers and a countdown lock.
- Switchboard: each control is a pictogram (a lamp head, or a junction whose lit arm leads to its colored platform letters), a one-word caption and its number key. Hovering one draws a wire to its lamp or points on the map.
- Departure board: a row per service with its badge, name, origin arrow and service icon (people for local, bolt for mail, crate for freight), then a countdown: an hourglass before release, a clock until due, a red alert once late and a check when home. A red lamp dot marks a service held at a signal. The footer shows the medal still possible (stars), certain delay against the 45-second silver allowance, and this shift's pending commission.
- Clock dial: a ring for the shift's elapsed time, pause/play for running and planning, the X key and the time left before the closing bell. While planning, the map rests under a cool veil with a pause badge.
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 → destination | West points | East points | Signals to clear |
|---|---|---|---|
| West → A (Abbey) | North | - | West gate |
| West → B (Orchard) | South | - | West gate |
| West → C (Quarry) | Straight | North | West gate, west bridge |
| West → D (Harbour) | Straight | South | West gate, west bridge |
| East → C (Quarry) | - | North | East gate |
| East → D (Harbour) | - | South | East gate |
| East → A (Abbey) | North | Straight | East gate, east bridge |
| East → B (Orchard) | South | Straight | East 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
| Shift | Services | New challenge | Closing bell |
|---|---|---|---|
| The apprentice's bell | 4 | Learn near-bank and cross-bridge routes | 125 s |
| Two banks, one bridge | 5 | Opposing traffic and fast mail | 150 s |
| Harvest wagons | 6 | Slow, heavy freight and mixed traffic | 180 s |
| The bridge inspector | 7 | Bridge entrances closed at 18-34 s | 200 s |
| The seaside special | 8 | Tight due times and overlapping services | 220 s |
| Rain on the wires | 9 | 85% speed; closure at 26-43 s | 260 s |
| Winter through service | 10 | Snow reduces speed to 78% | 320 s |
| The royal timetable | 12 | Final inspection at 40-57 s; dense timetable | 340 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.
- Gold / three stars: every train on time.
- Silver / two stars: at most 45 seconds of combined lateness.
- Bronze / one star: everyone safely delivered before closing.
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
src/content.rs: eight authored schedules and district conditions.src/model.rs: bounded train state, fixed ticks, routing, signals, collision checks, scoring, retries, legal dispatcher, and behavioral tests.src/view.rs: read-only countryside, railway, trains, route previews, departure board, switchboard, briefing/result cards, header objective, ending results, and location-based effects for the shared host'sJuice.src/lib.rs: shared host integration and player metadata.
cargo test -p signalbox --offline --locked -j 2
cargo clippy -p signalbox --all-targets --offline --locked -j 2 -- -D warningsThe 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.pngTests 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.