No description
  • GDScript 95.8%
  • Python 2.6%
  • GDShader 0.8%
  • PowerShell 0.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-18 16:59:09 -05:00
addons/wavedash Adds train sending multiplayer on web build 2026-10-14 20:16:21 -04:00
fonts MVP sandbox mode 2026-10-13 00:59:49 -04:00
instructions Bunch of new stuff 2026-11-18 16:59:09 -05:00
music Adds more music tracks for each biome 2026-11-11 16:43:06 -05:00
scenes MVP sandbox mode 2026-10-13 00:59:49 -04:00
scripts Bunch of new stuff 2026-11-18 16:59:09 -05:00
shaders Bunch of new stuff 2026-11-18 16:59:09 -05:00
tests Bunch of new stuff 2026-11-18 16:59:09 -05:00
tools Adds more music tracks for each biome 2026-11-11 16:43:06 -05:00
.gitattributes Prototype art style 2026-10-13 00:04:18 -04:00
.gitignore Adds music tracks and UI scale settings 2026-10-21 05:41:44 -04:00
achievements.json Bunch of new stuff 2026-11-18 16:59:09 -05:00
export_presets.cfg Audio not starting on web fix 2026-10-30 10:44:24 -04:00
icon.svg Removes annoying sounds and changes game icon 2026-10-29 22:50:38 -04:00
icon.svg.import Prototype art style 2026-10-13 00:04:18 -04:00
PATCH_NOTES.md Default inspector tool 2026-11-16 14:57:16 -05:00
project.godot Bunch of new stuff 2026-11-18 16:59:09 -05:00
README.md Bunch of new stuff 2026-11-18 16:59:09 -05:00
toybox.cmd version bump to v0.1.0 2026-10-29 22:38:19 -04:00
toybox.ps1 version bump to v0.1.0 2026-10-29 22:38:19 -04:00
wavedash.toml Adds train sending multiplayer on web build 2026-10-14 20:16:21 -04:00

Toybox Junction

A sandbox toy train set inspired by LEGO Loco, seen from the isometric angle of RollerCoaster Tycoon 2 and Transport Tycoon Deluxe / OpenTTD.

You get a studded baseplate on the playroom floor and build whatever you like on it: wooden track you lay piece by piece (straights, curves and merges), roads with traffic lights and level crossings, sidewalks with crosswalks over the roads and track, brick houses, a hospital, a fire station and a police station whose ambulance, fire engine and police car race about with their sirens going, supermarkets, skyscrapers, gas stations and a clock tower that strikes the hours, banks, schools, movie theaters, a drive-in with a giant screen, arcades and fast food restaurants, toy trees and lakes, a park full of flowers, fountains and a volcano, satellite dishes, dinosaurs, farms with cows, pigs, sheep, hens, horses and goats wandering about their fields, and trains to run through it all, out of their depots and round to the stations, post offices where you paint postcards and the trains carry the mail, and runways with airports whose little planes take off, fly away and come back to land, and roller coasters, ready-made or laid a piece at a time, up lift hills, down drops and round loop-the-loops, with the townsfolk queuing for a ride. Some pieces combine into something bigger when play starts: two cottages into a big house, four fountains into a grand fountain with a rainbow, and two satellite dishes into a rocket that the whole town turns out to watch blast off. Start from a blank baseplate or a ready-made town, in a green meadow, spring, autumn, winter snow, the desert, the jungle or the mountains. Little toy people (grown-ups, teenagers and kids) move into the houses, potter about, chat in gibberish, go to work, go shopping, eat out, see a movie, win prizes at the arcade, get money out of the bank, take the kids to school, take pictures, skateboard about, wait at the station to hop on your trains and drive their cars about town. Birds nest in the trees and on the roofs, hot air balloons and geese drift over, planes take off and land, and once in a while a flying saucer drops off a little green man to say hello. Around the holidays, special visitors come to town: Santa Claus and an elf, a witch and a ghost, the Easter Bunny, Cupid, a leprechaun, a turkey and Baby New Year, handing out treats. You can poke them, carry them about, rename them and follow them about under a big magnifying glass, and name the buildings they live and work in and the trains they ride. Build a tunnel at the edge of your baseplate and your trains (and roller coaster cars) can visit other players' towns on Wavedash, carrying postcards you've painted, and there are achievements to unlock there. Days turn to night, the weather comes and goes, the townsfolk make wishes, the town grows from a hamlet into a metropolis, the morning paper tells you what happened yesterday, and you can take photos for a sticker book. Your plots are saved, so you can come back to them. It is built with Godot 4.7, and runs on Windows and in the browser.

Playing

Main menu

The title screen shows a demo layout turning slowly behind the buttons, with its train running round the loop, cars driving about, its people going about their day, and a park in the middle of the loop with a grand fountain that now and then shoots a rainbow, and a clock tower telling the time. A bouncy toy-band tune plays over it (see Music).

  • Continue opens your most recently saved plot. It only shows once you have a save.
  • New Game asks for a name for your plot, what to start with (an empty baseplate or one of the starter towns), a baseplate size and a theme. The size is Small (24 × 24 tiles), Medium (32 × 32) or Large (48 × 48) for an empty baseplate. A starter town comes in its own size, and the other sizes are greyed out. While the page is open, the scene behind it shows what you've picked, zoomed out to the right of the page, with its trains running. Picking a town names the plot after it, unless you've typed a name of your own.
  • Tutorial teaches you the game step by step on a new small baseplate (see Tutorial).
  • Load Game lists your saved plots, newest first, with their size, their theme and when they were saved. You can load one or delete it. Deleting asks first. The button is greyed out until you have a save.
  • Settings has three volume sliders: Master for everything, Music and Sound Effects (the people's voices, the toys' sounds and the building sounds). Letting go of the Master or Sound Effects slider plays a sample line so you can hear the new level. Below them, Size scales the menus, panels and labels from 60% to 140% (85% is the default; the 3D view isn't affected). While you drag it, the new size shows as a number and is applied when you let go. Pointer picks the size of the mouse pointer: Small (the system pointer's size), Medium (the default, half as big again) or Large (half as big again as Medium). Vignette sets how much the edges of the picture blur and darken, from 0% (sharp all over) to 100% (the full toy-camera look, the default). Day & night turns the light following the town clock on (the default) or off, for an always sunny day (see Day and night). Settings are saved straight away, in settings.cfg next to the saves folder.
  • Quit closes the game. The web build has no Quit button, since a browser tab can't be quit.

Tutorial

Tutorial on the main menu starts a small (24 × 24) meadow baseplate called Tutorial Town and walks you through the game, one tool at a time, in eleven lessons. A card in the top right-hand corner says what each lesson is about and gives you a checklist of goals, each one a step to do. A goal ticks itself off (with a blip) as soon as you've done it, and stays ticked even if you clear away what did it. The next goal to do is in bold, and while it needs something from the toolbox, a pulsing yellow ring points at it: the piece, the drawer's tab it's in, the button in the lid, or the shut case to open it. When everything's ticked you hear bricks click home, the card says Well done! and Next lights up.

Lesson What you do
Welcome Shut the toolbox, and open it again
Lay some track Pick up the Straight and drag out a line of it, then pick up the Curve, turn it with R, and bring the line round into a loop
Your first train Build a train depot beside the loop, shut the toolbox to watch its train come out, stop and start it (Space) and turn it round (V)
Merges and points Clear a straight out of the loop with the Eraser (X), lay a merge in the gap and a branch off it, pick up the Points and switch it
Roads and level crossings Lay a road, and put a level crossing on the track with the road joined up to it
Sidewalks and houses Paint a sidewalk along the road, build two houses beside it, and wait for people to move in
The Inspector and the Hand Shut the toolbox and click someone to open their card, and a house to open its card, then pick up the Hand (H) and carry someone
Looking around Pan, turn and zoom the view
Trees and tidying up Plant five trees, then clear one with the Eraser (X)
Lots more to find Look in three of the Fun, Park, Dinos and Farm drawers, and build something from one
Saving Save your plot

The last lesson's button says Finish. You don't have to start again to play: the game asks whether to Keep This Plot, and carry on building on the town you made in the tutorial, or Start Fresh on an empty baseplate of the same size and theme (with a name of its own, like My Plot, and its own save file; a save of the tutorial plot stays under Load Game). Skip Tutorial, on the card, asks the same, with Keep Learning to go back to the lesson. Either way the card goes and the game carries on. You can do the tutorial again from the main menu whenever you like.

Starter towns and themes

A new plot can start as an empty baseplate or as one of five ready-made towns. They're yours to change: clear anything away, build more, rename the people. Each has its trains running and its people moved in, and a message says hello when it opens. Every town also has a hospital, a fire station and a police station beside its roads (see Hospitals, fire stations and police stations). Market Town and Big City have a supermarket, a clock tower, skyscrapers and a gas station too, and Toybox Junction has a clock tower in its park (see Supermarkets, clock towers, skyscrapers and gas stations). Market Town and Big City also have a bank, a school, a movie theater, a drive-in, an arcade and all three fast food restaurants (see Banks and schools and Movie theaters, drive-ins, arcades and fast food). Every town's trains come out of its train depots, one train each, and every town has a station or two where people catch them (see Track and trains). Country Line, Market Town and Big City, the towns with tunnels, have a post office by the track too (see Post offices and postcards), and Big City has an airport with a runway (see Airports and planes).

Town Size What's in it
Little Loop 24 × 24 An oval of track with one train round a little park (flower beds, a fountain, a frog pond), and a road over a level crossing to a village street.
Toybox Junction 32 × 32 The town from the title screen: a loop with a branch line, a main road over two crossings, a park with a grand fountain and a clock tower, and a volcano.
Country Line 32 × 32 Two trains on a long loop with a line across the middle, a branch to a tunnel on the east edge, a country road crossing the railway three times, two villages, a farm (a barn, a silo, a windmill, fields of crops and a big fenced field of animals) and lots of trees.
Market Town 32 × 32 A grid of streets inside a loop of track, two avenues crossing the railway and meeting the streets at five sets of traffic lights, a market square with a grand fountain and jumping jets, a clock tower, a supermarket, a skyscraper and a gas station, a school and a bank, a movie theater, a drive-in, an arcade, Burgerzilla, Cluckingham Palace and Pizza the Action, a volcano in one corner and a tunnel on the west edge. Two trains.
Big City 48 × 48 Two loops of track joined on both sides, tunnels at the north and south edges, a ring road between the loops, avenues across everything, a grid of busy streets with seven sets of traffic lights, a central park with a clock tower, three skyscrapers downtown with a movie theater and an arcade, a supermarket, a bank, a school, a gas station, a drive-in on the main avenue, a row of fast food restaurants, a park with a volcano, and an airport at the bottom of town with a runway along the inner loop. Three trains, and a plane.

Every plot also has a theme, picked on the New Game page. A starter town plants the theme's trees, and the theme sets the baseplate's colour, what's dotted over its empty tiles, the sunlight, the sky the plastic reflects, and the camera filter's colour grade. Big toys stand on the floor round the baseplate. You can still build any piece in any theme.

Every starter town has sidewalks along both sides of its roads, with a crosswalk wherever they meet another road or the track, and its houses stand back behind the sidewalks, facing them. The demo layout also has a path round the inside of its loop, beside the track.

Theme Baseplate Starter town trees Round the baseplate
Meadow Green, with little plastic plants: the classic look Every kind but cacti and ferns Nothing but floorboards
Spring Fresh green, dotted with pink and white flowers Mostly blossom, with apple, round and birch trees Big blossom and apple trees
Autumn Golden grass with piles of fallen leaves, in warm golden light Mostly autumn trees, with pines and birches. Light green leaves turn orange and yellow Pumpkins, hay bales and big autumn trees
Winter Snow with snowy lumps, in cool light. Snow lies on the roofs, trees, park pieces and tunnels, but not the trains, cars or people Mostly pines, with birches and bushes Snowmen, snowy pines and snow-capped peaks
Desert Sand with pebbles and little cacti, under a hot sun. Leaves turn dusty olive Mostly cacti, with palms Striped red rock mesas, big cacti and palms
Jungle Deep green with ferns, in humid light. Leaves are deep, bright greens Palms and ferns, with round and tall trees Giant palms and ferns, and an old stepped stone temple
Mountain Alpine green with grey rocks, in crisp light. Snow lies only on the tallest things: pine tops, tall roofs Mostly pines, with birches Rocky snow-capped peaks and big pines

Tall toys stand further from the edge, so they don't hide the baseplate. The theme is kept in the save.

Building with the toolbox

As in LEGO Loco, you build from a floating toolbox, and it's the game's menu too. It's a red plastic case with a handle, two yellow latches and a studded lid, sitting in the bottom right-hand corner. Shut, it shrinks to a small case, out of the way of the plot. Drag it anywhere. Click the shut case (or press Tab or Esc) and it grows to full size as its lid flips back on its hinges like a briefcase's, with a little bounce as it lands. It grows away from the side of the screen it's on, and shrinks back into the same place once it's shut. Everything stops while the toolbox is open: trains, cars, people and stations' call-outs all wait until you shut it again (the water and the volcano keep playing), and a red Paused shows under the plot's name. You can still pan and zoom while it's open, and it's the only time you can build or clear anything: each with the piece or tool you pick from it.

Every button in the toolbox is a picture with no words. Hover over one to see what it does. Inside the lid:

  • along the top, Save (a floppy disk), Settings (a cog), Main Menu (a house), Quit (the power symbol) and Undo (a purple arrow turning back; see Undo), and a big green Play button that shuts the lid again (so do Tab and Esc). The lid falls shut with a bounce and the game carries on. In the web build, Quit takes you back to the main menu (offering to save first), so there's no separate Main Menu button.
  • along the bottom, coloured tabs for the ten drawers, each showing one of its pieces. Keys 1 to 9 and 0 open them too.

The tray below holds the open drawer's pieces, each pictured by a small render of its real 3D model. Pick a piece or a tool to hold it. While the toolbox is shut your mouse is always the Inspector, which looks at things without changing them; open the toolbox again and you're holding what you picked before. Every plot starts with the Inspector held. A new blank baseplate starts with the toolbox open, and a starter town or a loaded plot starts with it shut and running.

Drawer Pieces
Track Straight, Curve, Merge Left and Merge Right: pieces of track, each laid by hand and turned with R (see Track and trains). Drag the Straight to lay a line of it. Train: click a train to pick it (new trains come out of depots). Train Depot: build it facing the track and a train comes out of its doors, one train per depot. Station: build it beside the track with a sidewalk behind it, and trains stop at its platform for people to get on and off (see Track and trains). Post Office: build it beside the track, and trains stop at its platform to drop off and pick up the mail; double-click it to go inside, read your mail and paint postcards (see Post offices and postcards). Tunnel: build one on the edge of the baseplate to send trains to other players' towns (see Tunnels). The drawer also has Stop/Go (a red square while the train runs, a green arrow while it's stopped), Reverse (two arrows) and Remove (a dustbin) buttons for the picked train. Also the track extras: Bridge, Buffer Stop, Signal and Turntable (see Track extras).
Roads Road: paint road tiles; each piece shapes itself from its neighbours. Sidewalk: paint sidewalk tiles, for people to walk on. Crossing: a level crossing, where a road crosses track. Crosswalk and Rail Crosswalk: take a sidewalk across a road or the track (see Sidewalks and crosswalks). Traffic Lights: lights for a road junction (see Roads, cars and level crossings). Runway: paint runway tiles for planes; runway side by side joins up. Airport: build it beside a runway, and its plane takes off from it and comes back to land (see Airports and planes). Also a Bus Stop, a Bus Depot, a Car Park and an Overpass (see Buses and working vehicles and Track extras).
Buildings Cottage (one storey) and Townhouse (two storeys): every house you place gets new colours. Hospital, Fire Station and Police Station, whose vehicles go out on calls (see Hospitals, fire stations and police stations). Supermarket, Clock Tower, Skyscraper and Gas Station, where people work, shop and take pictures (see Supermarkets, clock towers, skyscrapers and gas stations). Bank and School (see Banks and schools). Satellite Dish: a radar dish that slowly turns to scan the sky (two side by side make something special; see Combining pieces). Also Apartments, and the newer places: Cafe, Library, Museum, Town Hall, Hotel, Factory, Toy Shop, Ice Cream Parlour and Recycling Centre (see More places to go).
Fun Movie Theater, Drive-In, Arcade, and three fast food restaurants: Burgerzilla, Cluckingham Palace and Pizza the Action (see Movie theaters, drive-ins, arcades and fast food). Also a Bowling Alley, Mini Golf, a Zoo, a Stadium and a Bandstand.
Nature Round Tree, Tall Tree, Apple Tree, Pine Tree, Blossom (pink or white), Autumn Tree (orange, red or yellow), Birch, Palm Tree, Bush (plain, with berries or with flowers), Cactus (tall with arms, round with flowers, or a prickly pear) and Fern (plain, or with bright tropical flowers). Each one you plant gets new colours. Lake: water with a shore round it, sandy with pebbles or a grassy bank with reeds; lake tiles side by side join into one stretch of water (see Lakes). Also a Lighthouse, Hills, Rocks and a Jetty.
Park Flowers, Flower Bed, Fountain, Sprinkler, Jumping Jet, Frog Pond and Volcano (see The park). Also Benches, Picnic Tables, a Playground, a Statue and Hedge Maze pieces (see Park, countryside and lakes).
Dinos T. Rex, Long-Neck, Triceratops, Stegosaurus, Pterodactyl (on its rock), Dino Nest (eggs, one hatching), Fossil Dig and Cycad (a prehistoric palm). Each dinosaur you place gets new colours (see Dinosaurs).
Farm Cow, Pigs, Sheep, Chickens, Horse and Goats, each in a fenced pen; pens side by side join into one field. Paddock (an empty pen), Barn, Silo, Windmill, Crops (wheat, corn, cabbages or pumpkins) and Hay Bales (see The farm). Also a Market.
Rides Four ready-made roller coasters, built whole in one click: Kiddie Coaster, Big Dipper, Loop-the-Loop and Twister. And coaster track to lay a piece at a time: Coaster Station, Coaster Straight, Coaster Curve, Coaster Slope, Steep Slope, Lift Hill, Loop and Booster (see Roller coasters). Also a Carousel, a Ferris Wheel and Bumper Cars.
Tools Inspector (a magnifying glass) looks without changing anything: click someone to poke them and open their card, a building to open its card, a pen to poke its animals, a train to pick it for the train buttons and open its card, a merge to switch its points, or a tunnel to open its settings. It's what you start with, and what your mouse is whenever the toolbox is shut. Points switches merges, or opens a tunnel's settings, without building anything. Hand (H) pokes, carries and renames people (but not visitors), pokes and names buildings, and pokes farm animals (see People, Buildings and the magnifying glass and The farm). Eraser (X) is the only tool that clears things away, one per click, whatever's on top: a person, a car (its driver hops out), a train, or else the piece on the tile. On traffic lights it takes the lights down and leaves the junction. Bomb: click anywhere on the baseplate and, once you've said yes, everything goes up in a flash: every piece, train, car and person, and any trains away in other towns or on their way in. You're left with an empty baseplate in the same theme. Also Paint, Copy and Paste (see Paint, Copy and Paste).

Pick a piece, then click the baseplate to build it. Hold the button and drag to lay a line of straight track or road, or plant a row of trees or flowers. A see-through copy of the next piece of track, tree, building, park piece, level crossing or crosswalk follows the cursor, outlined in yellow, so you can see where it will go and which way it will face. A piece with a front (a house's door, a shop's windows, a station's platform, a fire station's garage, a barn's doors, a dinosaur's nose) also has a yellow arrow on the ground pointing out of the side it faces, drawn over the building so you can always see it. Press R to turn it: the copy swings round to its new way, and so does the arrow. Track lies flat on the baseplate, so its copy is nearly solid and sits just above the studs, with a wider outline, so a curve or a merge is easy to make out. The cursor frame turns red where the piece can't go.

Each tool has its own mouse pointer: the Inspector's is the plain arrow, turning into a pointing finger over something it can look at; the Hand's is an open hand (a pointing finger over someone or a building, a fist while carrying); the Eraser, the Bomb and the Points each have their own. While you hold a piece of track (a Straight, Curve or merge) the pointer is a little piece of track.

Building sounds

Everything you build makes a little sound to suit what it's made of, and so does every tool:

What How it sounds
Houses Two plastic bricks clicking together
Hospitals, fire stations, police stations, and every building people work in, shop at or visit A quick cascade of bricks clicking home
Level crossings, crosswalks, traffic lights Bricks clicking, then a two-note blip as the lamps come on
Track A wooden knock, then a tock as the peg seats in the next piece
Tunnel A deep, hollow wooden thonk and the click of its brick portal
Road, runway A plastic plate clacking down and rattling onto the studs
Sidewalk Little paving slabs ticking into place, with a bit of grit
Trees A wooden stand tapping down and the leaves rustling
Flowers and flower beds A plastic pop and a rustle
Fountains, sprinklers, jumping jets, frog ponds, lakes A clunk and a few drops of water blooping
Volcano A heavy thud, a rumble and a bubble of lava
Satellite dish Bricks clicking, then the blip of it switching on
Dinosaurs A plastic click and a little growly roar
Dino nest, fossil dig, cycad A pop and a rustle, little slabs ticking down, a wooden tap and a rustle of leaves
Coaster track and ready-made coasters A plastic click and the rails ringing (a ready-made coaster: a cascade of bricks)
Farm animals A plastic click, then a moo, an oink-oink, a baa (goats too), some clucks and a bawk, or a whinny. Poking them with the Hand does it again
Paddock, barn, silo, windmill, crops, hay bales A wooden knock, a cascade of bricks, a pop and a rustle, a tap and a rustle
Pieces combining (see Combining pieces) A quick cascade of bricks clicking home
A train dropping off or picking up the mail, going into a post office, posting a postcard The post office's bell going ding-ding
Stamping a stamp on a postcard A rubber stamp's thump
Keeping a postcard, opening the mail A card slipping into place
Train When a depot sends out a train: three wooden cars set on the track, a clink as each magnet couples. Picking a train gives it a tap
Points The points sliding over and clunking home
Eraser A rubber squeaking to and fro, then a fwip as the thing goes
Hand A boop for a poke, a rising whoop as you lift someone and a falling one as you let go
Turning a piece (R) A ratchet tick
A click that can't do anything A dull bonk

So they don't wear thin when you lay a long line of track, each sound comes in four takes, every one struck a little differently, and each time it plays it's a different take from the last, nudged a little up or down in pitch and loudness. Like the rest of the sound they're synthesised (scripts/audio/build_sounds.gd), and they play on the Sound Effects slider. You made them, so they're heard even with the people's voices turned off (M).

Undo

Made a mistake? Press Undo in the toolbox's lid, or Ctrl+Z while the toolbox is open, to take back your last change to the plot. Each undo takes back one thing you did: a whole drag of track, road or sidewalk at once, one click of building, a junction switched, or a piece the Eraser took away. Undo again to go further back, up to 50 changes. A building you cleared comes back with its name, a tunnel with its settings, and a grand fountain, big house or rocket that a cleared piece broke up comes back whole. The button is greyed out while there's nothing to undo.

Undo only puts back the map. A person, car or train you took away with the Eraser doesn't come back, and after the Bomb there's nothing left to undo. If a train, car or plane is on a tile that undo would change, it waits: you're told what's in the way and can try again once it's moved on.

The park

The Park drawer has flowers, water features and a volcano to dot around your town. They're all for looking at: people walk round them, and stop to admire them.

  • Flowers. A clump of toy flowers: red, yellow or pink tulips, daisies, sunflowers or bluebells, a different kind each time.
  • Flower beds. A wooden planter of soil and flowers in two colours. Flower beds side by side join into one long bed, with no walls between them, so you can lay out a border or a big square bed.
  • Fountains. A stone fountain (grey, sandstone or terracotta) spraying water from the top into its basin. Build four fountains in a 2 × 2 square and, once play starts, they turn into one grand fountain (see Combining pieces).
  • Sprinklers. A lawn sprinkler with a hose, whose head spins round throwing water out in spirals.
  • Jumping jets. A nozzle set in a stone plate. Water leaps in an arc from one jumping jet to another up to 3 tiles away, lands with a splash and leaps on to the next, never straight back if it can go somewhere else. Each group of jets near each other has one leaping blob of water for every three jets. A jet on its own leaps straight up and back down.
  • Frog pond. A round pond edged with pebbles, with lily pads and a frog on a rock spitting water into it.
  • Volcano. A rocky cone with lava running down its sides, which smokes all the time. A few seconds after you build it, and every half a minute or so after that, it rumbles, shakes, puffs out a cloud and throws blobs of lava that land around it and cool away.

The rainbow's song and the volcano's rumble play while voices are on (M), when they happen on screen. The water, smoke, lava, rainbows and ducks are only for show: they're worked out from the clock each frame, and nothing about them is saved.

Lakes

Lake is in the Nature drawer. Paint it like flower beds: lake tiles side by side join into one stretch of water running right to the edge between them, so you can dig a pond, a long river or a big lake. Round its edge there's a shore: sandy, with pebbles, or a grassy bank with reeds and bulrushes (each tile you lay picks one). Lily pads float on it, some with a flower, and now and then a yellow rubber duck paddles round in circles, bobbing on the water. People stop on the sidewalks to watch the ducks.

Dinosaurs

The Dinos drawer has toys from the age of the dinosaurs to stand about the plot: a T. rex with a mouthful of teeth and tiny arms, a long-neck tall enough to look over the houses, a triceratops with three horns and a bright frill, a stegosaurus with plates down its back and spikes on its tail, a pterodactyl perched on a rock with its wings spread, a dino nest of spotted eggs with a baby peeping out of one, a fossil dig with a skeleton half out of the sand, a spade and a flag, and a cycad, the prehistoric palm the dinosaurs munched on. The dinosaurs come in green, orange or purple (and other colours on their spots, frills and plates), with googly eyes, and each one you place gives a little roar. People admire them (the T. rex from a safe distance), and cheer the biggest.

The farm

The Farm drawer has everything for a farm:

  • Animals. A cow (black and white, brown and white, or black with a white belt, with a bell), pigs (a pig and her piglet, pink or spotted, with a mud puddle and a trough), sheep (a sheep and her lamb, white or black), chickens (three hens and a chick round a little red hen house), a horse (chestnut, grey or black, with a water trough) and goats (a goat and her kid, with a rock to climb). Each stands in its own fenced pen on a green studded plate. Drag to lay a row of them.
  • Fields. Pens side by side join up: the fence between them goes, and the animals wander from one into the next, so a few pens make a big field with the animals all mixed up in it. A paddock is an empty pen (with a water trough or a hay rack) to give them more room.
  • Animals about. The animals stroll about their field, never out past the fence and round the troughs and hen houses, stopping to graze (the hens peck). They walk on swinging legs: four-legged animals step with diagonally opposite legs together, and hens step one foot after the other. Goats like to climb up on their rock. Poke a pen with the Hand and its animals jump and call out. Taking a pen away sends any animals wandering in it home to their own pens.
  • Buildings. A big barn with a hay loft (red with white trim, or plain wood), a tall silo (steel, or red with a white dome) and a windmill whose sails go round and round.
  • Crops and hay. A crops field fills its tile with four rows of wheat, corn, cabbages or pumpkins, and fields side by side carry straight on. Hay bales are big round ones or a stack of square ones.

People stop on the sidewalks to look at the farm animals, and cheer the horse and the windmill. The animals and sails are only for show: nothing about where they are is saved.

Combining pieces

Some pieces combine into something bigger. They only do it once you shut the toolbox and play starts again (or, if you build them while the town's running, a moment after you put the last one down), and only if at least one of them is new since then, so pieces that were already side by side stay as they are. When they combine there's a quick cascade of bricks clicking together, the pieces squash flat and spring up into their new shape in a puff of smoke and a burst of sparkles, and a message says what they made.

  • Big house. Two cottages side by side (not townhouses) join up into one big house, with a tall hall between them under a pointed roof with a flag on top, a grand double door, a porch and a balcony. Both cottages turn to face the same way, out of a long side (towards a sidewalk if there's one in front). They're still two homes underneath, with their own residents.
  • Grand fountain. Four fountains in a 2 × 2 square make one really big fountain: a wide basin on a paved square, with three tiers, gold balls round its rim, a gold crown, a tall jet and jets arching in from the rim. It glitters with sparkles all the time. When it's made, and every minute or two after that, it shoots a long rainbow out across the screen and off into the distance (fainter the further it goes), with a pretty song (a harp sweeping up the scale over a shimmering chord) and sparkles twinkling all along it. The rainbow stays a while and then very slowly fades away, over most of a minute. Where fountains make more than one square (a 2 × 3 block, say), the top-left square wins and the others stay small.
  • Rocket. Two satellite dishes side by side turn into a rocket on a launch pad, with a red gantry, a fuel tank and hazard stripes. The whole town wants to see it: people come from all over to stand on the sidewalks near it, snapping pictures while they wait. Over it a sign says how big a crowd it's waiting for (four people, or everyone on the plot if there are fewer, but at least two). Once enough are standing round it, the countdown starts: big numbers from 10 count down over it, each with a blip, turning from green through yellow to red, while the crowd shouts them out and vapour hisses off the pad. At zero the engine lights with a roar, the rocket shakes on its pad in billowing clouds of smoke, then climbs away faster and faster on a flame, leaving a trail of smoke, until it's gone. Everyone watching takes pictures of it going up, then cheers, jumps for joy and sets off fireworks, which whistle up into the sky and burst into showers of coloured sparks. Once the rocket's out of sight its pad is cleared away.

The Eraser takes a combination away whole: clear any tile of it and all of it goes, rather than coming apart into the pieces it was made from. Combinations are saved with the plot (a rocket that hasn't gone yet waits for its crowd again when the plot's loaded).

Track and trains

  • Laying track. You lay every piece of track yourself, and it stays the way you laid it. The Track drawer has four pieces: a Straight, a Curve (a quarter turn), and two merges, Merge Left and Merge Right. Press R to turn the piece you're holding; its see-through copy shows which way it will go. Drag the Straight to lay a line of it: it turns to run the way you drag. Track only joins track whose piece meets it end to end, so you can lay lines side by side without them joining up, and to change a piece, clear it with the Eraser and lay another.
  • Merges (points). A merge is a straight with a curve branching off it to the left or right, from its trunk end. A train coming in by the trunk goes whichever way the points are set. A train coming the other way, along the straight or the branch, always runs through onto the trunk, however the points are set, so a branch merges into a line. Click a merge with the Points tool or the Inspector (or while holding track, a house or a tree) to switch it. With the toolbox shut your mouse is the Inspector, so you can switch points while the trains run. A toy lever on it shows the way it's set, with a green lamp for straight and a red lamp for the branch. Only the selected route's grooves are full depth. Two merges back to back make a crossover between two lines side by side, and a merge into a siding lets a depot there send its train onto a line other trains run on.
  • Starter towns and old saves. The starter towns and the demo layout are laid out with their track already joined up, and a plot saved before track was laid by hand loads with every piece the shape it had. Where three or four pieces met there's now a merge, set the way its points were.
  • Trains. Each train is a steam engine, a coach and a wagon, and its cars follow curves exactly. At a dead end a train waits a moment and reverses. A plot can have up to 8 trains, counting visitors on their way in.
  • Train depots. Your trains come out of train depots: a brick engine shed whose doors open onto the track in front of it. Each depot has one train. A few seconds after you build one, its train rolls out of the doors onto the track (with a message, and the sound of its cars coupling up). It heads the same way round as the first train along the line, so trains follow each other round a loop instead of meeting head-on and both having to back up. A depot built beside track turns to face it by itself; one with no track in front of its doors can't send out a train until you lay some, and its card says so. If its train goes (you take it away, it derails, or another town keeps it), the depot sends out a new one once the track in front of it is clear. A train away in another town is still the depot's train, so no new one comes out while it might come home. Clear a depot away and its train keeps running, belonging to no depot. A new town's depots send out their trains straight away.
  • Stations. A station is a little brick building with a platform along its front, a canopy, a name board and a clock on the roof. Build it beside the track, with a sidewalk behind or beside it for people to get in from; built beside track, it turns its platform to face it. A train stops for 3 seconds when its middle car reaches a station's platform, each time it comes by, and the status line says it's at the station. People walk to a station to catch a train, wait on the platform, and hop off at a station further on (see People). A station's card says how many people are waiting, and the station has a job selling tickets (the depot has one too, polishing the engines).
  • Post offices. A brick post office with a big envelope on its sign, and a mail platform along the track with a red post box and a pile of mail sacks. Build it beside the track; it turns its platform to face it. A train passing its platform stops for 3 seconds if there's mail to swap (see Post offices and postcards), and carries the postcards it picks up as little parcels on its engine's cab roof.
  • Picking a train. The Stop/Go and Reverse buttons, Space and V work on the picked train. Click a train with the Train tool or the Inspector to pick it. While there is more than one train, a yellow arrow bobs over the picked one.
  • Train cards and names. Click a train with the Inspector (it's your mouse whenever the toolbox is shut) to open its card, with the big magnifying glass held over its engine and the view following it round the track (see Buildings and the magnifying glass). The card says what the train's doing (running, stopped, at the station, waiting at a crossing...), which depot it lives in (or the town it's visiting from), how many cars it pulls, who's riding and how many postcards it's carrying, and has Stop/Go and Reverse buttons. Click the name box, type a name and press Enter (clear it to take the name away). Someone riding it, or standing nearby, says what they think of it ("Big Bertha! What a lovely name!"), and from then on the townsfolk call it by its name: on the status line, in messages, on riders' cards ("Riding Big Bertha"), and when they chat about the trains ("Have you seen Big Bertha today?"). The name is saved with the plot and goes with the train to other towns. Only your own trains can be named: a train visiting from another town keeps the name its owner gave it (or its owner's label, "Sam's train"), and its card's name box can't be changed.
  • Sharing the track. Several trains can run on one line: build more depots beside it, or on sidings that join it at merges. A train that comes up behind another going its way, or to a merge another train is running through, waits until the track ahead is clear, then carries on, and the status line says it's waiting. Trains that meet head-on both stop, wait a moment and reverse. Going back, a train checks each piece of track again, in case another train has come up behind it.
  • Derailing. You can't clear track under a train or switch points one is on. If the track changes under a train some other way, it derails and comes off the plot. Its depot sends out a new one.

Roads, cars and level crossings

  • Self-shaping roads. Road tiles shape themselves from the roads around them: straights, curves, T-junctions, crossroads, and dead ends with room to turn round. Roads have pavements and a dashed white line, and cars keep to the left.
  • Level crossings. Road and track never join, except at a Crossing from the Roads drawer: one tile with track running straight one way and road straight across it. Build it on a straight piece of track or road, or on an empty tile, and it lines itself up with the track and road beside it (R turns it when there's nothing to line up with). It won't go on a curve or a junction. Dragging road onto track tells you where to find the crossing.
  • Traffic lights. Build them from the Roads drawer on a road junction, where three or four roads meet (or on an empty tile with road on three sides). A signal stands on the corner beside each road coming in, with red, amber and green lamps, and a stop line across the lane. The lights take turns: north and south go together, then east and west. A way stays green for at least 4 seconds, and then until a car is waiting at red the other way. Then it turns amber, every way shows red for a moment while the junction clears, and the other way turns green. Cars stop at red and amber, and never jump a red light. Unlike a junction without lights, several cars can be on it at once if their ways across don't cross: cars going straight on each way pass each other, and a car turning right waits for the cars coming the other way. The Eraser takes the lights down and leaves the junction, even with cars on it. Erase it again to clear the road.
  • Cars. Every house with a sidewalk beside it that meets a road has a car, in its own colour. Now and then someone who lives there walks out to the kerb, the car pops out onto the road beside the sidewalk and off they drive: over to see a friend (they toot hello outside their house) or a good long way round, and then home, where they park, hop out and go indoors. They take the quickest way, turning round at the end of a road if they must. Sometimes they stop at a gas station on the way to fill up (see Supermarkets, clock towers, skyscrapers and gas stations), and sometimes they go to the drive-in instead, park and watch a movie (see Movie theaters, drive-ins, arcades and fast food). Kids and teenagers don't drive. A plot can have up to 12 cars out at once, and up to 4 emergency vehicles besides.
  • Traffic. Cars follow the car in front, take turns at junctions without lights (one car on a junction at a time), and never stop on a junction or a crossing they couldn't drive straight off. They stop for anyone in the road, and toot if they're kept waiting, and people standing in the road get out of the way.
  • Trains at crossings. When a train is coming (within 4 tiles of track, as the points are set) or on the crossing, the red lamps flash and the barriers come down. Cars wait behind them. Once the train has gone the barriers go back up and everyone carries on. A car already on the crossing drives off it, and the train waits for it to clear rather than running into it.
  • The Hand and cars. Clicking a driver (with the Inspector or the Hand) opens their card, which says where they're driving, or that they're waiting at the level crossing, the traffic lights or a crosswalk. Picking a driver up lifts them out of the car, and the car is put away. You can't clear road under a car.

Sidewalks and crosswalks

People on foot only ever walk on sidewalks, and cross roads and track only at crosswalks, so they keep out of the way of the cars and trains.

  • Sidewalks. Paint them from the Roads drawer, on empty tiles. They're paved with square slabs, level with the roads' kerbs, and sidewalks side by side join into one wide one, with a kerb along their open sides. People walk along them and cut across their corners, but never over the grass, a road or the track.
  • Houses need a sidewalk. People only come out of a house with a sidewalk beside it: out of the front door if the sidewalk's in front, or a side door if it's round the side. Without one they stay at home, and come out once you lay one. A house whose sidewalk meets a road has a car, which pulls out onto the road beside that sidewalk.
  • Crosswalks. A Crosswalk takes a sidewalk straight across a straight road, and a Rail Crosswalk straight across straight track. Build one on the road or track, or on an empty tile, and it lines itself up with the road (or track) and the sidewalks beside it (R turns it when there's nothing to line up with). They won't go on a junction, a curve or a level crossing. Painting sidewalk onto a road or track tells you where to find them. People only step onto a crosswalk from its ends.
  • The lights. A crosswalk has a post on each side, with a signal for the cars (red, amber and green) and a red man and a green man for the people across the way, each with a yellow button. A rail crosswalk has rubber boards between the rails, a "stop, look and listen" sign on each side, and a post on each side with a red and green signal for the trains coming towards it, and a red man and a green man. While nobody wants to cross, the cars (or trains) have green and the red man shows. Someone who wants to cross presses the button and waits. Once the traffic has had at least 6 seconds, the cars' lights turn amber, then red (a train's signal turns red). As soon as nothing is on the crosswalk (a car that had already taken its turn drives on, and so does a train already on it), the green man shows for 2 seconds, and people step out. Then he flashes and nobody new steps out, and the traffic goes again once everyone is across.
  • Cars and trains wait. Cars stop at red and amber, and a train waits at a red signal without reversing. A car never drives onto a junction it would have to wait on because the crosswalk just past it is red, and doesn't wait on a crosswalk for what's past it. Cars stop for anyone on a crosswalk all the same, and trains still bump anyone they find on the track.
  • Clearing them. The Eraser takes a crosswalk away and leaves the road or track it crossed. Erase it again to clear that too.

Hospitals, fire stations and police stations

The Buildings drawer has a Hospital, a Fire Station and a Police Station. Build one beside a road, facing it (R turns it), and it gets its own vehicle, with a crew of two aboard:

  • Hospital. A white brick building with glass doors, a red cross over them and a helipad on the roof. Its ambulance is a white van with a red stripe and red crosses, and two paramedics in green.
  • Fire station. Red brick with a big garage door, a bell and a hose tower with a flag. Its fire engine is long and red, on three axles, with silver lockers, a ladder and a hose reel, and two firefighters in yellow with red helmets.
  • Police station. Pale stone with a band of blue and white checks, a blue lamp and sign over the door, and a radio mast on the roof. Its police car is a white tourer with blue checks and a roll bar carrying a blue and a red lamp, and two officers in peaked caps.

A few seconds after a station is built, and every half a minute to a minute or so after its vehicle gets home, it's called out. The vehicle pops out onto the road in front:

  • The ambulance races to a house where somebody's poorly, and the fire engine to a house with a chimney fire. Their lamps flash and their sirens go "nee-naw" all the way there, and they drive a bit faster than other cars. They stop outside for a few seconds, lamps still flashing, then drive home quietly and are put away.
  • The police car goes out on patrol: round three places a good long way apart, and home. Sometimes it sets off in a hurry, siren going, and turns it off once it gets there.

Emergency vehicles keep to the rules of the road like everyone else: they wait at red lights, level crossings and junctions. One that can't pull out because traffic is queued in its lane goes off the other way instead (a car would wait for a gap), and a car going by in the other lane never stops anything pulling out. People on foot nearby call out as one races past ("Where's the fire?"). A station that isn't beside a road has nowhere to send its vehicle. If you clear a station away while its vehicle is out, the vehicle still drives home and is put away. The crews aren't townsfolk, so the Hand can't pick them up, and you can't clear road under a vehicle any more than under a car.

Supermarkets, clock towers, skyscrapers and gas stations

The Buildings drawer also has places for the townsfolk to go. Each one you place gets new colours. Build one facing a sidewalk (R turns it): people go in through the front, or a side if the sidewalk's round the side, and a building with no sidewalk beside it has no visitors.

  • Supermarket. A wide shop of cream bricks with big windows, sliding glass doors, a striped awning, a sign with a shopping basket on it, trolleys and a crate of fruit out front. Its sign and awning are green, red or blue.
  • Clock Tower. A tall brick tower (red brick or sandstone) with a clock on all four sides, an open belfry with a gold bell, and a copper spire. Its hands go round with the time in town, and on the hour it strikes it: once at one o'clock, twice at two, up to twelve times at noon and midnight. The bell swings with every "bong", which is heard all over town while voices are on (M), louder with the tower on screen. People near the tower look up and say what time it is, and anyone admiring it cheers.
  • Skyscraper. A slim glass tower (blue, green or gold glass) of eight floors and a crown, with steel ribs up its sides and an aerial with a red lamp on top: the tallest thing you can build.
  • Gas Station. Two pumps under a canopy, a little shop at the back and a price sign on a pole, in red, blue or green. Build it beside a road, facing it, and cars stop at its pumps for a few seconds to fill up ("Glug glug glug.") on about a third of their drives. Give it a sidewalk beside it too, for people to get to its shop.

Jobs. The supermarket has two jobs, the clock tower one, the skyscraper three and the gas station one. Each goes to whichever grown-up lives nearest without a job, and their card says where they work. Now and then they walk over and go in for a shift of a minute or so ("Winding up the big clock", "Busy in an office up the skyscraper"), then come out with $25 for the shift and carry on. If you clear a building away, the people inside come out (they're not pleased) and its workers are out of a job until another building has one going. Every building in the Banks and schools and Movie theaters, drive-ins, arcades and fast food sections has jobs too, the same way, and so do train stations and depots.

Shopping and pictures. People also go shopping in a supermarket, a skyscraper or a gas station near them (out of sight for a few seconds, and out again with a bargain; it costs $8), and stand on the sidewalk near the clock tower, a skyscraper or a drive-in to take pictures of it: they hold a little camera up to their eye, and its flash goes off (with a click, while voices are on) every couple of seconds. Visitors from other towns shop and take pictures too.

The time. Every plot has a time of day, shown beside its name at the top left. A minute in town takes a second, so a day goes by in 24 minutes. A new plot starts at 8:45 in the morning, and the clock stops while the toolbox is open, like everything else.

Banks and schools

The Buildings drawer also has a bank and a school. Like the buildings above, each one you place gets new colours, and needs a sidewalk beside it, which it should face.

  • Bank. A grand stone bank (white marble or sandstone) up three wide steps, with four columns holding up a pediment with a gold coin in it, BANK along the frieze and tall bronze doors. Two tellers work there.
  • School. A long brick schoolhouse (red or yellow) with big white-framed windows, SCHOOL over the door in coloured letters, a bell in a cupola on the roof and a flagpole, and a playground out front with a slide and a stack of alphabet blocks. Two teachers work there.

Money. Everyone has some money in their pocket, shown on their card: grown-ups move in with $30 to $80, kids with $5 to $20 of pocket money. A shift at work pays $25. Shopping costs $8, a meal at a fast food restaurant $6, a movie $10 (indoors or at the drive-in) and a go at the arcade $5. Nobody spends money they haven't got ("I'm skint!"). Instead they go to the bank, and come out a few seconds later with $30 to $60 more ("Ka-ching!"). People go to the bank now and then anyway, and much more often once they're down to their last $15. Without a bank, people who have no job eventually run out.

Kids. Some of the people who move into a house are kids (never the first one in): smaller, with squeakier voices and pocket money. They potter about, chat, play at the arcade, eat out and go to the movies like anyone else, but they don't work or drive. Their card says they're a kid.

School. School runs from 8 o'clock in the morning to 3 in the afternoon by the town clock. In school hours, kids go to the nearest school (up to 24 tiles away), and don't stay indoors at home for long. A grown-up from their house takes them if one is about nearby, or at home: the grown-up walks to the school's door ("Got your lunchbox?") and the kid walks along beside them, holding their hand, catching up along the sidewalks if they've fallen behind. At the door the kid goes in, and the grown-up waves them off ("Have a lovely day, Timmy!") and gets on with their day. With nobody to take them, kids walk to school on their own. Inside, their card says what they're doing ("Learning their times tables at school").

At 3 o'clock school's out: the kids come out and wait by the door, and a grown-up from home (out and about, or at home) sets off to pick them up. When they get there, they walk home together and go indoors. If nobody comes within 45 seconds, the kid walks home on their own ("Nobody came! I'll walk."). The school's teachers are its workers, and come and go like any other job. Clearing the school sends everyone inside out of it.

Movie theaters, drive-ins, arcades and fast food

The Fun drawer has places to spend money. Each one you place gets new colours, and needs a sidewalk beside it, which it should face (a drive-in faces the road instead). People go to the ones within 12 tiles of them.

  • Movie Theater. A cream picture palace with glass doors under a marquee (red, purple or blue) with light bulbs round its letter board, a tall sign of bulbs on the roof, posters in gold frames either side, a red carpet with ropes, and a giant bucket of popcorn on the roof. Two people work there. People go in to see a movie for half a minute or so, or just to buy popcorn. It shows a different movie every hour ("Attack of the Giant Toaster", "Space Train 3", "Ninja Grannies"...), and the card of anyone watching says which.
  • Drive-In. An outdoor movie theater: a lot of asphalt with three parking bays, a speaker on a post beside each, and a screen as big as a billboard (red or teal) up on posts at the back, with a projection booth behind it and a sign with a bulb on top. Its screen plays all the time, short scenes picked at random every few seconds, at a few jerky frames a second like a GIF: a rocket zooming past the moon, a bouncing ball, a sailboat at sunset, a car chase, a beating heart and fireworks, with a flash of projector light between scenes. Each drive-in shows its own. Build it beside a road, facing it, with a sidewalk beside it for its projectionist to get in. On about a third of their drives, people who can afford it head for the drive-in instead of their usual trip, turn in and park in a free bay, and sit at the wheel watching the movie (out loud they say "Shh, it's starting!", "Pass the popcorn"), then pull out and drive home. When all three bays are taken, nobody else goes.
  • Arcade. A dark arcade with a neon sign (purple, teal or pink) and chaser bulbs, a window of glowing game cabinets, a claw machine full of prizes out front, and a giant joystick and buttons on the roof. One person works there. People (kids especially) go in to play for a while, and about half the time they come out with a prize: a teddy bear, a rubber duck or a giant lollipop, in turn. They carry it about in their hand for 40 seconds or so, and their card counts the prizes they've won.
  • Burgerzilla. A red or yellow restaurant with a monster of a burger on the roof: bun, lettuce, patty, cheese, sesame seeds, two googly eyes, teeth and a pair of little horns. ("Munching a Monster Mega Stack at Burgerzilla.")
  • Cluckingham Palace. A white or pink restaurant with red-roofed turrets on its corners and a chicken wearing a gold crown on the roof. ("Munching a bucket of Royal Nuggets.")
  • Pizza the Action. A white or green restaurant with a striped awning in the colours of the Italian flag and a giant slice of pepperoni pizza standing on the roof. ("Munching a Pepperoni Party Slice.")

The three restaurants each have two jobs, a striped awning, a name board along the roof, a big window and two tables out front. People drop in for a bite (out of sight for 10 to 20 seconds) and come out full ("Burp! Pardon me.").

Roller coasters

The Rides drawer has roller coasters: toy ones, with red tubular rails on yellow ties, a blue spine underneath and white posts holding them up in the air, and a train of three little cars in its own colour, the front one with a nose and googly eyes.

Ready-made coasters. Pick one and its see-through copy follows the cursor, centred on the tile you point at (red where it won't fit). R turns it, and a click builds the whole thing at once, with its station named after it. It needs a clear patch of baseplate.

Coaster Size What it does
Kiddie Coaster 2 × 5 A gentle lift hill two levels up, round the top and a swoop down
Big Dipper 2 × 8 A lift hill five levels up, two steep drops one after the other, and a bump
Loop-the-Loop 3 × 6 Up three levels, a steep drop and straight round a loop-the-loop
Twister 4 × 7 Up four levels, S-bends high in the air, a steep drop and a booster that fires the cars home

Once built, a ready-made coaster is ordinary coaster track: clear a piece with the Eraser and lay another to change it.

Building your own. Lay coaster track a piece at a time, like track, turning each with R:

  • Coaster Station. Where a coaster starts and stops, with a platform under a striped canopy on its left and a fence on its right. Its arrow shows the way the cars leave it.
  • Coaster Straight and Coaster Curve (a quarter turn).
  • Coaster Slope climbs one level the way its arrow points, and Steep Slope two. Turn them round to go down.
  • Lift Hill climbs a level too, with a chain that pulls the cars up it the way its arrow points, clanking as they go. Drag a line of them for a tall hill.
  • Loop: the cars go right round a loop-the-loop, upside down.
  • Booster: spinning tyres that fire the cars along, the way its arrow points.

Each piece goes at the height of the coaster track it joins (the end at the back of its arrow first), or on the baseplate if it joins none, so a line of lift hills climbs higher and higher. Coaster track only joins track whose end meets it at the same height. It can be up to seven levels high, and never goes below the baseplate: the copy turns red where a piece would, and clicking says why. Straights, slopes and lift hills can be dragged out in a line.

The train. A coaster opens once its track runs out of the front of a station, all the way round and back into the station's other end. A message says so, and its train is waiting at the station. It goes round and round for as long as the track's whole: rolling out of the station, pulled up the lift hills, swooping down the drops (gravity speeds it up downhill and slows it uphill, though it never quite stalls), fired along by boosters and round the loops upside down. It stops at every station it comes to for a few seconds. Change the track so it no longer makes it round, and the train goes (letting its riders off where they got on); make it whole again and a new one's waiting at the station. The trains run only while play does, like everything else.

Riders. Lay a sidewalk beside a coaster station and people come to ride it (kids especially). They pay $4 and queue on the sidewalk, beside the platform if they can. When the train stops, up to six get on, two to a car, and ride a whole lap with an arm in the air, then get off back where they queued, cheering or a bit dizzy ("Again! Again!"). Their card says they're riding it, and the magnifying glass follows them round. Nobody queues for ever: after 50 seconds they give up and get their money back. While voices are on (M), the lift hill's chain clanks and riders scream down the drops, on screen. People also stop on the sidewalks to watch the coasters go round.

The station's card. Click a coaster station with the Inspector for its card: whether its train's running or loading, who's riding, how many are queuing (or that it needs a sidewalk beside it), how many pieces of track it has and how high it climbs, and its top speed so far. Name it there like any building. A station whose track doesn't make it round says what's missing.

Coasters through tunnels. Like trains, coaster cars can go to other players' towns. Run coaster track up to the front of a tunnel on the baseplate (level 0) instead of back round into the station, and the coaster becomes a line:

  • Sending. Its cars wait at the station for riders, roll out, ride the track and drive into the tunnel, riders and all, off to the player the tunnel is set to send to (or, set to Anyone, a town whose tunnels take coaster cars). The station puts out new cars a few seconds later, while fewer than four sets are away. The riders are visitors in the town they reach.
  • Coming home. Coaster track only runs one way, so cars can't come back out of the tunnel they left by. Give the line a return tunnel: a second tunnel whose coaster track runs into the back of the station (tunnel, station, any other stations the same way round, tunnel). If nobody takes the cars within 2 minutes, they come back out of the return tunnel, their riders hop out at the station, and the cars carry on round the line and out again. Without a return tunnel, the riders just turn up at the station, cheering.
  • Receiving. A line with a return tunnel that's open to visitors takes in cars from other towns too. They come in their owner's colour, called by their owner's name ("Sam's coaster"). Their riders hop out at the first station to look round town, people queuing there get on, and the cars ride on into the tunnel at the end and away to another town. A line has one set of cars on it at a time: cars coming home or from other towns go first, and the station puts out its own when none are waiting.
  • A tunnel that coaster track runs into is for coaster cars only: trains never come out of it. Its panel says "Open to visiting coaster cars" and "Send coaster cars to". The station's card says where the line's cars go and come home by.

Coaster track is saved with the plot (the trains start again at their stations when it's loaded), and undo puts it back like any other piece. Coaster cars away in other towns and cars waiting to come in are saved too, like trains.

Tunnels: trains to other towns

A tunnel is a brick portal in a little studded hill. It can only go on the edge of the baseplate, and not in a corner. Its track runs straight out over the edge, so lay track up to its mouth. Lay coaster track up to it instead and it carries roller coaster cars, not trains (see Coasters through tunnels); everything below works the same way for them.

  • Sending. A train that drives all the way into a tunnel leaves your plot. It goes to the player the tunnel is set to send to. Set to Anyone, it goes to a random town in the exchange with an open tunnel.
  • Coming home. If nobody takes the train within 2 minutes, it comes back out of the tunnel it left by. If that tunnel has been cleared away, it uses another one, or waits until you build one. A train that was taken now belongs to the town it went to, and you get a message saying where it arrived.
  • Receiving. A tunnel that is open to visiting trains (its lamp is green) lets in trains from other towns. They come out of one of your open tunnels as soon as it's clear, and a message tells you who sent them. A visiting train keeps its owner's colour and name ("Sam's train"). Like your own trains, it travels on if it drives into one of your tunnels.
  • Passengers. People riding a train go wherever it goes (see People). In another town they're visitors. If nobody takes the train, they come home with it.
  • Settings. Building a tunnel, or clicking one with the Tunnel or Points tool, opens its panel. It turns visitors on and off and picks where the tunnel sends trains: Anyone, one of your Wavedash friends, or anyone in the exchange right now. A player who isn't online is invited to the exchange when a train is waiting for them.

Trains travel between towns only in the web build, played on Wavedash while you're signed in (see Web build and Wavedash). Anywhere else the card at the top left says you're offline, and trains that go into a tunnel come home after 2 minutes. While a train is away the status line counts it, and trains on their way in are counted too.

Trains carry the mail too: postcards a train picked up at a post office go with it to the town it goes to (see Post offices and postcards).

How the exchange works

Every player online joins one shared public Wavedash lobby, the exchange. The game finds the busiest one with room (32 players each), or opens one if there isn't one. A lonely exchange keeps looking for a busier one, so two players who start at the same moment still end up together. Players use lobby messages to say whether their town has a tunnel open to trains, and one open to coaster cars, and to offer each other trains and coaster cars (an offer of its own kind, which a game from before coasters travelled ignores). An offer to a player is answered "got" or "nope". A train for anyone goes to each open town in turn until one takes it. A train for one player waits for them to be in the exchange with an open tunnel. Messages from other players are checked before they're used: a train's size, colour, name and passengers are kept within limits, and an offer is only taken once, even when a lobby replays its last few messages to someone who just joined. A lobby message can only be 500 characters long, so a postcard's picture doesn't go in it: it's uploaded to Wavedash (as a public user-generated content item), and only its id and who sent it go with the train. The town it reaches downloads the picture, checks it's a PNG postcard of the right size before opening it, and draws it again from scratch before keeping it.

Post offices and postcards

A post office (in the Track drawer) is where the mail comes and goes, and where you paint postcards to send to other players.

  • The mail train. Build a post office beside the track, facing it. When a train comes past its platform with letters from another town on board, it stops for 3 seconds and drops them off, and the post office keeps them for good. If there are postcards waiting to go, the train picks up as many as it has room for (three) and carries them on its engine's cab roof, one little brown-paper parcel each. So you can spot a mail train from anywhere in town, a fan of envelopes (one for each letter on board) floats over its engine, facing you. A message says what was dropped off and picked up, and the post office's bell rings. When the train goes through a tunnel to another town, the postcards go with it, and that town's post office gets them when the train stops there. If nobody takes the train, it comes home with its postcards still on board. A train taken off the plot (or bombed) puts its postcards back in the outbox, and drops its letters at the post office. So do the trains away in other towns and on their way in, when the plot's bombed.
  • You've got mail. While there's a letter you haven't read, a big envelope bobs and turns over every post office on the plot, and the post office's card says so.
  • Mail to go. While there are postcards in the outbox waiting for a train, a fat mail sack hops up and down over every post office's platform, and the post office's card says how many. The train's envelopes and the mail sack grow as you zoom out, so you can spot them across town.
  • Going inside. Double-click a post office (with any tool), or press Go inside on its card (the Inspector or the Hand opens it). You're inside the post office: a toy room with floorboards, a panelled wall with a window and a clock, bunting of little envelopes, pigeonholes stuffed with postcards, a counter with a bell and a set of scales, mail sacks and a post box, and in the middle, an easel with a big canvas on it. Everything outside waits while you're in here, as it does while the toolbox is open. Leave (the door, top right, or Esc) takes you back outside.
  • Painting. Paint on the canvas on the easel with the mouse. Down the left are the brushes: a pencil for thin lines, a paintbrush with soft edges, a grainy crayon, a spray can that keeps spraying while you hold it still, and a paint bucket that fills an area of one colour. Then the eraser, which rubs back to the white paper, the bomb, which clears the whole sheet with a boom, undo (Ctrl+Z, up to 15 steps, the bomb too) and four sizes. On the right is a paint wheel for any colour, with a bar from bright to dark, and a row of ready-mixed colours. Along the bottom is a tray of stamps: pictures of the townsfolk, the steam engine and a coach, a car, a rubber duck, a rocket, a cottage, the post office, the clock tower, trees, flowers, a fountain, the volcano and the dinosaurs, made from their models. Pick one and click to stamp it, at the size you've picked. There's no way to write words on a postcard: only pictures.
  • The picture stays on the easel. It's kept a couple of seconds after each stroke and when you leave, so it's still there when you come back, on any plot.
  • Keeping postcards. The green postcard button (top right) keeps the picture as a postcard in your album (up to 24). The picture stays on the easel to carry on with.
  • The mail. The red envelope button opens the mail, with a badge saying how many letters are new. Letters are the postcards other players sent you, newest first, with a red frame round the new ones; click one to see it big, with who sent it and when. One still being downloaded says it's on its way. My postcards is your album: click one to Post it (a copy waits in the outbox for a train to pick it up; up to 12 can wait), Paint on it (it goes on the easel, and undo brings back what was there) or Throw away (it asks first). Letters can be painted on and thrown away too. The mail says how many postcards are waiting for a train.

Your mail belongs to you rather than to one plot: every post office, on every plot, opens onto the same easel, album, outbox and letters. It's kept in post_office.mail, a JSON file beside your saved plots, written a moment after anything changes, so it doesn't wait for you to save the plot. Postcards on a train are saved with the plot, like its passengers. So they're never lost or sent twice, the mail remembers the letters trains have dropped off, delivered or given back: a plot loaded from an older save leaves those behind. If you leave a plot without saving it, the postcards its trains picked up since it was last saved go back in the outbox, and the letters they brought from other towns are dropped off at the post office. A postcard that finished uploading only after its train went through a tunnel didn't go with it, so it comes back too.

Postcards only travel between towns in the web build on Wavedash, like trains (see Tunnels). Anywhere else you can still paint and post them, and trains pick them up, but they come home again.

People

Every house has residents: two in a cottage, three in a townhouse. A few seconds after you build a house they move in, coming out onto its sidewalk if it has one (see Sidewalks and crosswalks). The first one in is a grown-up, and the others may be kids (see Banks and schools) or teenagers (see below). Each has an everyday first name and a surname that's a bit silly ("Doris Puddleworth", "Nigel Crumpet"), their own clothes, hair or hat, and their own voice.

  • Getting about. People walk along the sidewalks, and would rather not cross a road or the track if they needn't; when they must, they use a crosswalk and wait for the green man. They find things to do nearby: a stroll, a look at a tree, a house, the hospital, the flowers, a fountain, the ducks on a lake, a dinosaur or the farm animals (apple trees, grand fountains, jumping jets, volcanoes, clock towers, skyscrapers, drive-ins, arcades, big houses, the T. rex, the long-neck, rockets, horses and windmills get them excited), going to work, shopping, eating out, seeing a movie, playing at the arcade, getting money out of the bank, going to school (kids, in school hours), taking pictures of the clock tower, a skyscraper, a drive-in or the planes at an airport, knocking on a neighbour's door (if someone's in, they come out for a chat), chatting with whoever's about, going home for a sit-down, standing on a sidewalk beside the track to watch and wave at the trains, going to watch a rocket go up (see Combining pieces), going to stare at a flying saucer's little green man (see Up in the sky), stopping to wave at a plane taking off or landing (see Airports and planes), or going for a drive (see Roads, cars and level crossings).
  • Teenagers. About one in five of the people who move in after the first is a teenager: a bit smaller than a grown-up, with a younger voice and pocket money, and never without their skateboard, which they carry about under their arm. They don't work, drive or go to school. Instead they often skate off along the sidewalks, two and a half times as fast as anyone walks, arms out for balance and kicking along now and then, popping kickflips as they go (the board flips right round under their feet). They stop for the green man at crosswalks like everyone else, land a trick when they get where they were going ("Nailed it!"), and often skate on somewhere else, up to three runs in a row. They're keener on the arcade than grown-ups, and their card says they're a teenager.
  • Riding trains. Sometimes they walk to a station near them, go through it onto the platform and wait there for a train (up to six on a platform; after 45 seconds with no train they give up). When a train stops at the station with a free seat they hop on: two sit on the coach's roof and two on the wagon's load. After a while they hop off onto the platform the next time the train stops at a station, and go on their way. On a plot with no stations, people you drop on a train (and visitors from other towns) hop off onto a sidewalk beside the track instead; with none there, they stay on. A train that runs into someone on the track bumps them out of the way.
  • Talking. Out loud, people babble in a made-up gibberish language, each in their own voice (M turns voices off and on). Their speech bubbles show what they mean in your language, which is English for now. Bubbles that would overlap stack up. The mouse shows the name of whoever it's over.
  • Chatting. Two people who stop for a chat take turns, in conversations of two to six lines: jokes (knock knock!), gossip, the weather, the trains (by name, if you've named them), and what everyone's up to. What they talk about depends on who they are and when it is: kids chat about tag, dinosaurs and wobbly teeth; teenagers about how boring everything is; grown-ups and kids about school and growing up; locals welcome visitors and visitors ask the way; people who live together talk about the washing-up; workers talk about work; mornings, evenings and each holiday (Christmas, Halloween, Easter...) have chats of their own.
  • Thinking out loud. Someone standing about on their own sometimes mutters to themselves for a few lines ("Did I lock the front door? I'm sure I did. Almost sure."), and their card says they're thinking out loud. Their odd remarks suit them too: kids, teenagers, visitors and workers each have their own, and so do mornings and evenings.
  • The Hand. Pick the Hand from the Tools drawer (or press H). Click someone to poke them: they jump, and get crosser the more you poke them. Hold the button and drag to pick someone up; they dangle and kick until you let go, then fall and pick themselves up, a bit dizzy. Drop them on a train with a free seat and they get a ride. Drop them off the sidewalks and they hop onto the nearest one. With none near, they're stuck, and say so, until you carry them to one.
  • Renaming. Clicking someone (with the Inspector or the Hand) also opens their card, which says where they live, where they work (or that they're a kid or a teenager), how much money they've got, any prizes they've won and what they're up to. Click the name on the card, type a new one and press Enter. They'll tell you what they think of it. You can rename anyone who lives in your town, at any time, even while they're on a train. Their new name goes with them to other towns. Visitors from other towns (and holiday visitors) keep their own names: their card's name box can't be changed.
  • Following them. While someone's card is open the view follows them about, with a big toy magnifying glass held over them (see Buildings and the magnifying glass).
  • Moving in and moving away. If you clear a house away, its residents complain and walk off the edge of the baseplate. If one goes to another town on a train and doesn't come back, someone new moves in after a minute. People from other towns get off their train, look around for a few minutes, then head home.

Holiday visitors

Around the real-world holidays (going by your computer's date), special visitors come to town in costume. Each walks in off the edge of the baseplate onto a sidewalk there (or, with no sidewalk at the edge, drops in out of the sky onto one), with a message saying who's come. They're never counted against the town's 60 people, so they come to full towns too.

Holiday Dates Who comes What they hand out
New Year 30 December – 2 January Baby New Year, in a top hat and a sash Party hats
Valentine's Day 7 – 14 February Cupid, with little wings and a golden bow Hearts
St. Patrick's Day 10 – 17 March Seamus the Leprechaun, with a pot of gold Gold coins, worth $10
Easter The week before Easter Sunday, and Easter Monday The Easter Bunny, with a basket of eggs Easter eggs
Halloween 17 – 31 October Wanda the Witch, with a broomstick, and Boo the Ghost Sweets (the ghost just says "Boo!")
Thanksgiving The week up to the fourth Thursday in November Tom Turkey, with a fan of tail feathers Slices of pumpkin pie
Christmas 1 – 26 December Santa Claus, with a sack of presents, and Jingle the Elf Presents and candy canes
Summer Fete 20 – 31 July Coco the Clown, with a red nose and a pom-pom hat Balloons
  • Arriving. The first comes a quarter to half a minute after the plot opens, and each of a holiday's visitors comes back a minute or two after they've gone. Only one of each is in town at a time.
  • Treats. They wander the sidewalks, look round, and go up to people nearby to give them a treat. Whoever they're coming to stops and waves while they wait, and once it's handed over they say thank you and carry it about in their hand for half a minute. The leprechaun's gold coins go in their pocket too. The ghost sneaks up instead, says "Boo!", and they jump out of their skin.
  • Being seen. People nearby wave and call out to them ("It's Santa!", "Don't turn me into a frog!"), and they have plenty to say themselves, in their own voices (Santa's deep, the elf's squeaky).
  • Leaving. After two or three minutes they say goodbye and walk off the edge of the baseplate.
  • Their cards say where they're from and what for ("Visiting from the North Pole for Christmas") and what they're up to ("Off to give Doris a present"). You can poke them, carry them about and put them on a train (they travel to other towns as themselves), and they're saved with the plot. Like visitors from other towns, they keep their own names.

Nobody comes during the tutorial, or the showcase tour.

Up in the sky

Things fly over the town all by themselves, in every theme, and stand still while the toolbox is open. None of them get in the way of anything.

  • Birds. For every five trees and buildings (houses, service buildings and venues) on the plot, a little bird comes to live there, up to twelve: blue, red, black or brown. Each builds a twiggy nest with two eggs in it on top of its own tree or roof, and sits about pecking and looking round, then flutters off to another tree or building nearby (up to eight tiles from home), or back to its nest. Plant more trees and more birds fly in from off the baseplate. Clear a bird's tree away and it builds a nest somewhere else; with too few trees and buildings left, birds fly off for good. When a plot opens, its birds are already sitting in their nests.
  • Hot air balloons. Every minute or two a hot air balloon drifts slowly across the plot from one side to the other, high over the rooftops, its envelope striped in one of five pairs of colours. One or two people stand in its wicker basket and wave, and now and then its burner roars, with a flare of flame that lights up the basket. Up to two can be in the air at once.
  • Geese. Every minute or two a flock of five to nine geese flies over in a V, the leader in front and the rest falling back to either side, beating their wings and honking as they go.
  • Flying saucers. Rarely (every five to ten minutes of play) a flying saucer comes, with a warbly sci-fi swoop heard all over town and a message telling you to look up. It flies in to hover over the grass or a sidewalk near somebody out and about (never right beside a venue or a service building), spinning, its rim lights blinking, and beams a little green man down in a shaft of green light. He stands on the ground and turns to wave at you for a few seconds, then he's beamed back up, turning round and round, and the saucer zips off into the sky. Everyone within seven tiles who isn't busy (chatting, on the school run, waiting for a train or watching a rocket) stops to stare: some take pictures and some wave ("Take me to your leader!"). Anyone standing right where he lands hops back out of his way. When he's beamed up they wave the saucer off ("Bye, little green man!") and get on with their day.

People out on foot under a balloon, the geese or a plane look up and say so ("Look, a hot air balloon!", "Honk honk!", "Look, a plane!"). Geese honking and balloons' burners are heard while they're on screen, with voices on. Nothing in the sky is saved. The airports' planes fly too (see Airports and planes).

Airports and planes

Runway and Airport are in the Roads drawer.

  • Runways. Paint runway like road: dark tarmac with white lines down its sides, a dashed line down the middle and lights along its edges. Runway side by side joins up. Where a runway ends there's a threshold of white bars with a row of green lights across the end, and where runways meet both ways there's a pad with yellow lines. Planes only use a runway in a straight line, and it must run straight for at least 4 tiles.
  • Airports. A brick terminal with a long window and a sign with a plane on it, a control tower with a glass cab and a red beacon, and a tarmac apron at the front with a windsock, where its plane waits. Build it beside a runway and it turns to face it (R turns it otherwise). Its plane uses the runway straight across the front of the airport, or the one running straight on away from it, whichever's longer. A few seconds after you build one, its plane flies in to land. Without a long enough runway in front, the airport's card says so, and its plane waits.
  • Planes. Every airport has a little propeller plane of its own (one of five paint jobs). It waits on the apron for half a minute or so, then taxis out onto the runway and along to its nearer end, turns round, and races off down the runway with a buzz of its propeller (heard while it's on screen, with voices on), lifts its nose, takes off and climbs away off the baseplate. Half a minute to a minute later it comes back: it flies in low along the runway from its far end, touches down, slows to a stop in front of the airport and taxis back in, turning round to wait for its next flight. A runway takes one plane at a time, so with two airports on one runway their planes take turns (one coming back waits off the baseplate). Its propeller stands still while it waits, ticks over as it taxis and blurs in the air.
  • People work at an airport (up in the control tower), look round it, and go to watch the planes and take pictures. Anyone out on foot near the runway when a plane takes off or lands stops to wave at it, and some take pictures ("There it goes!", "Welcome back!").
  • Clearing them. You can't clear runway while a plane is using it. Clear an airport away and its plane goes too: one on the ground is put away, and one in the air flies off for good.

Planes aren't saved: when a plot's loaded, every airport's plane is waiting on its apron.

Buildings and the magnifying glass

With the Inspector (or the Hand), click a house, a hospital, fire station or police station, or any venue (a supermarket, a restaurant, the school...). It wobbles like a poked toy and opens its card, which says what it is and, for a house, who lives there and how many are at home; for a venue, who works there, how many people are inside and, at a movie theater or drive-in, what's showing; at a train station, how many are waiting for a train, and at a train depot, whether its train is out (or that it needs track in front of its doors); at an airport, what its plane is up to (or that it needs a runway); at a coaster station, who's riding and queuing (see Roller coasters); and for a hospital, fire station or police station, whether its vehicle is out or waiting for the next call. A big house made of two cottages is one building.

Naming buildings. Click the name box on a building's card, type a name and press Enter (clear it to take the name away). The townsfolk call it by its name: "Works at Bob's Burgers", "Lives in Rose Cottage", "Going shopping at Mega Mart". A name goes with its building: clear the building away and the name goes too. Names are saved with the plot.

The magnifying glass. While a person's, a building's or a train's card is open, the view glides over to them and keeps them in the middle of the screen, and a big red magnifying glass is held over them (over a train's engine, with the train's name on the tag). Its lens shows them close up, as a second camera sees them (a person about five times their size at the middle zoom), with their name on a tag underneath. A person being watched says what they say from the top of the rim, and other people seen through the lens get their speech bubbles over them on the lens. Clicks on the lens go to what it shows, so you can poke or pick up someone you can see through it, or click another building. Panning (WASD, the arrows or a middle-drag) stops the view following; the glass stays over them while they're on screen. Click them again to follow them once more. Close the card (Done) to put the glass away.

More places to go

The newer places are built just like the venues above (each gets new colours, and faces a sidewalk; R turns it), and people work at them, visit them and talk about them. They're spread over the drawers:

Drawer Place What happens there
Buildings Cafe People drop in for a hot chocolate and a cupcake, and come out with a coffee in hand
Buildings Library People look round for free, and come out with a book
Buildings Museum A dinosaur skeleton out front. People look round, and take pictures
Buildings Town Hall The first person to work there is the mayor, and their card says so
Buildings Hotel Visitors from other towns check in for a rest
Buildings Factory Three jobs, and a chimney puffing smoke
Buildings Toy Shop People (kids most of all) shop there and come out with a teddy
Buildings Ice Cream Parlour People come out with a cone. Beside a road, its van tours the streets (see Buses and working vehicles)
Buildings Recycling Centre Beside a road, its bin lorry calls at the houses
Buildings Apartments A block of flats with balconies: six people live there, like a house
Roads Bus Depot Its bus goes round the town's bus stops
Fun Bowling Alley, Mini Golf People pay for a go, like the arcade
Fun Zoo A giraffe and an elephant. People look round for free, and take pictures
Fun Stadium Match days (see Events)
Fun Bandstand Evening concerts (see Events)
Rides Carousel, Ferris Wheel, Bumper Cars People pay for a ride. The carousel and the wheel go round, and riders come away with a balloon
Nature Lighthouse A striped tower whose lamp sweeps round after dark
Farm Market Stalls of fruit and veg: people shop there and come out with carrots

A drawer with more pieces than the tray holds shows them a page at a time: the blue arrows tile at the end of the tray turns the page, and picking a piece turns to its page.

Track extras

The Track drawer has four more pieces of straight track with something extra, each laid and turned like a Straight:

  • Bridge: track on red girders and piers. Lay it over a lake (it takes the water's place, and the lake runs on under it), dragging to lay a line.
  • Buffer Stop: a red buffer on whichever end of the piece doesn't join more track, to finish off a line. Trains wait there and go back, as at any dead end.
  • Signal: a signal post beside the track, showing red while a train is on the line within two tiles of it and green when it's clear.
  • Turntable: track on a round pit. A train that comes to a stop on it at the end of a line is turned round, so its engine leads the way back instead of pushing.

The Roads drawer has an Overpass: build it where a road crosses straight track, like a level crossing, and the track goes up and over the road on a hump of a bridge. Cars and trains never wait for each other there, and trains (and their riders) ride up over the road.

Engines and cars. A train's card has buttons to change its engine (steam, diesel or electric) and what it pulls (a coach and a wagon, passenger coaches, freight wagons and tankers, or mail vans), a Toot! button that blows its whistle (or press T for the picked train; people nearby wave), and Ride along, which zooms right in and turns the view to look the way the train's going, until you pan away. Engines and cars are saved, and go with the train to other towns.

Buses and working vehicles

  • Bus stops. The Roads drawer's Bus Stop is a piece of sidewalk with a shelter, a bench and a sign. Build it beside a road. With a bus depot by a road somewhere in town, its bus goes round the stops (nearest first, up to six), stops at each for a few seconds and goes home, and soon goes round again. People walk to a stop near them and wait (up to a minute or so). When the bus stops, anyone who got on somewhere else gets off, and anyone waiting gets on (eight seats). They're out of sight while they ride; their card says they're riding the bus.
  • The ice cream van. An ice cream parlour beside a road sends its pink van round the houses now and then. At each stop it plays its jingle (heard while voices are on), and people nearby with $3 to spend come running, kids first, for a cone.
  • The bin lorry from a recycling centre calls at three streets with houses, and the delivery van from a supermarket drives round to the restaurants. A barn beside a road sends a milk lorry with the farm's eggs and milk to the supermarkets and the market.
  • Car parks. The Roads drawer's Car Park fills up with cars, one for each person busy in a place (or at home) within four tiles, up to six.
  • Bikes. About half the teenagers ride a bike instead of a skateboard, pedalling along the sidewalks.

These vehicles drive like everyone else (they wait at lights and crossings), up to six out at once on top of the townsfolk's cars and the emergency vehicles.

Day and night

The light follows the town clock. The sun turns golden round sunrise (about seven) and sunset (about half past six), and from dusk to dawn the town is a blue moonlit night: windows glow warm yellow, the street lamps along the sidewalks beside the roads light up, and so do the bulbs on the movie theater, the train and bus lamps and anything else with a bulb. People go home to bed at ten, sleep till six (their card says they're fast asleep), and the crops in the fields grow through the day, until a tractor harvests them in the afternoon. Day & night in Settings turns it off, for an always sunny day.

Weather

Every minute or three the weather changes: sunny, cloudy, showers, the odd thunderstorm, and, on a winter or mountain plot, snow (the desert hardly ever sees rain). Rain and snow fall over the part of the plot you're looking at, the light dims under the clouds, thunder rolls and lightning flashes in a storm, and when the sun comes out after rain, a rainbow arches over the town. People put up umbrellas in the rain, would rather go home than go for a stroll, and talk about the weather. The weather is saved with the plot.

Wishes, stars and the town growing

Every minute or two, one of the townsfolk wishes out loud for something the town hasn't got ("I wish we had a library!"). Kids wish for fun things (a zoo, a toy shop, a T. rex), grown-ups for anything. Up to three wishes wait at once: on the wisher's card, and on the Wishes card (the button under the plot's name, which counts them). Build what they wished for anywhere on the plot and the wish comes true: they say thank you, and the town earns a star.

People, buildings and stars make the town grow, from a hamlet to a village, a town, a city and a metropolis. The size shows under the plot's name, and each time it grows the townsfolk throw a party with fireworks. A new starter town settles into its size quietly, as its people move in. Stars and the size are saved with the plot.

The morning paper

Every morning at seven, The Town Times lands: a front page about the day before, with the biggest story as the headline (a rocket going up beats a new cafe opening, which beats a shower of rain), a few more stories underneath, and the town's numbers and the weather in the corner. The Paper button opens it again. The days count up from day 1, shown beside the time.

Photos and the sticker book

Press Photo under the plot's name (or P) to take a picture of what's on screen, without the cards and buttons. It goes in your Album, and if it caught a special moment (a flying saucer, a rocket going up, a rainbow, fireworks, a holiday visitor, a train at night, a golden sunset, a storm, snow, a plane or a balloon in the sky, geese, a roller coaster, the volcano erupting, a crowd of fifteen, three dinosaurs, five farm animals, a ferris wheel), it earns a sticker in the sticker book. The album keeps your last 30 photos: leaf through them, throw them away, or Make a postcard of one, ready to post from any post office. Like the mail, the album is yours rather than one plot's: it's kept in photos.album, beside your saved plots.

Park, countryside and lakes

The Park drawer has Benches (with a lamp), Picnic Tables, a Playground, a Statue and Hedge Maze pieces, and the Nature drawer Hills, Rocks and a Jetty. People walk along the paths through the benches, picnic tables, playground and maze as if they were sidewalk: they sit down on a bench or at a picnic table, kids play in the playground, and people looking at a hill fly a kite. A new statue is of one of your townsfolk (the mayor, if there is one), and named after them; click it to see who. Build a jetty on a lake: people go fishing off it (and from the lake's shore), and some catch a fish. Rowing boats and little sailing boats go round some of the lakes.

People's lives

  • About one in four grown-ups has a dog, which trots along beside them. Its name is on their card, and now and then they call to it and it woofs.
  • Everyone has a birthday, every 24 town days. On the day, balloons are tied to their house, people wish them happy birthday when they chat, and it's in the paper.
  • Their card says who their best friend is (who they've chatted with most), their favourite place (where they've been most), how many fish they've caught, and how they're feeling: happy, delighted with a treat, a bit soggy in the rain, sleepy at bedtime, worried about money, or grumpy if you keep poking them. Friends and favourite places are saved.

Events

When What Needs
Every evening at 7 A concert: a crowd gathers round the bandstand and the band plays (heard while voices are on) A bandstand
Every third day at 3 pm Match day: a crowd watches at the stadium, and the score's in the paper A stadium
Every fifth day at 11 am Sports day: kids first, a crowd cheers outside the school A school
Every fourth day at noon A wedding at a big house: guests cheer and set off fireworks A big house
Every sixth day at 10 am, and every holiday A parade: someone marches a long way along the sidewalks, with up to five falling in behind and the band playing People and sidewalks
Every seventh day at 9 am A fun run: a few people run off along the sidewalks People and sidewalks
New Year's Eve at midnight Fireworks all over town New Year

Halloween evenings (5 to 9 pm), kids go trick-or-treating door to door and come away with sweets. Through December, the houses are strung with Christmas lights, which shine at night.

More combinations

Some more pieces combine, the same way (see Combining pieces):

Pieces Make
A hospital, a fire station and a police station in a row Emergency HQ, with a rescue helicopter circling over it
Four skyscrapers in a 2 × 2 square A megatower, the tallest thing in town
Burgerzilla, Cluckingham Palace and Pizza the Action in a row A food court
A station and a clock tower side by side Grand Central Station
A volcano and a dinosaur side by side A prehistoric valley
A dinosaur nest and a T. rex side by side The egg hatches: a baby dinosaur toddles round its mum

They only combine with one of each (three hospitals don't make Emergency HQ), and the pieces underneath keep working: the services still send out their vehicles, and people still work, eat and catch trains there.

Post office extras

  • A postman (the post office's staff) takes letters round to the houses near it.
  • Every other day, one of your townsfolk sends you a postcard: a picture of something they love (their house, a train, trees, a rocket, a dinosaur, a boat, a balloon, flowers), straight into your letters.
  • Pin on the wall (on a postcard or letter, in the mail) hangs it in a frame on the post office's wall, up to four. Every post office shows the same wall.
  • The tray of stamps grows with your town: a village unlocks a cafe, a bus and a boat, a town a ferris wheel, a carousel and the zoo, and a city a lighthouse, a baby dinosaur and the megatower.

Mini-games

  • Claw Machine and Choo-Choo Catch, on an arcade's card: move the claw and drop it over a prize (three goes), or steer a little train to catch falling stars and dodge rocks for 30 seconds.
  • Go fishing, on a jetty's card: cast, wait for the float to bob, and click quick to reel in a fish. Five casts.

Paint, Copy and Paste

The Tools drawer has three more tools:

  • Paint: click (or drag over) a building, a tree, a park piece or anything else that comes in colours, to give it its next ones. It keeps its name and the way it faces.
  • Copy: click one corner of a patch of the plot, then the opposite corner, to copy everything on it (not people, cars or trains).
  • Paste: click to stamp down what you copied, its top-left corner on the tile you click. It builds on empty tiles only, and pieces combine as usual.

Gift crates and parade trains

On your own train's card: Load a gift crate puts a crate of something nice (a fountain, a ferris wheel, a T. rex...) on it. The town that takes the train unpacks it, and the piece is built by one of its sidewalks as a surprise. Make it a parade dresses the engine in bunting: every town it visits adds a car (up to six), and is told the parade train's coming.

Achievements

Playing on Wavedash (the web build, signed in), you unlock achievements as you play. They show in Wavedash's own achievements list, and nowhere else: the Windows build doesn't have them.

Achievement How to get it
Junior Engineer Finish the tutorial
Pointsman Switch the points on a junction
Busy Builder Build 100 pieces (over all your plots)
Master Builder Build 1,000 pieces
Moving On Up Join two cottages into a big house
Over the Rainbow Make a grand fountain out of four fountains
Liftoff! Watch a rocket blast off
Cleared for Takeoff See a plane take off from your airport
Season's Greetings Welcome a holiday visitor to town
Hello, My Name Is Give one of your townsfolk a new name
Rush Hour Have 6 trains on your plot at once
Boomtown Have 50 people in your town at once
Wish You Were Here Paint a postcard at the post office
Bon Voyage Send a train through a tunnel to another player's town
Visitors from Afar Get a train from another player's town
Special Delivery Get a postcard you painted to another player's town
You've Got Mail Get a postcard from another player
Wish Come True Grant one of your townsfolk's wishes
Metropolis Grow your town all the way into a metropolis
Say Cheese! Take a photo of your town
Sticker Collector Fill half of the sticker book
Teamwork Build Emergency HQ
Sky High Build a megatower
Claw Champion Win a prize from the claw machine
High Score Score 15 on Choo-Choo Catch
Gone Fishing Catch three fish off a jetty in one go
A Special Gift Get a gift crate from another player's town
Join the Parade Welcome a parade train from another player's town

Seven more are secret until you find them.

Busy Builder and Master Builder count every piece you build (a stroke of track counts each tile) in a Wavedash stat, Pieces Built, and Wavedash unlocks them by itself when it gets there. The rest the game unlocks when they happen. See Web build and Wavedash for setting them up in the Developer Portal.

Saving

Press Save (the floppy disk in the toolbox's lid), Ctrl+S or F5. The first save of a new plot creates its save file, and later saves update it. A dot after the plot's name (top left) means it has unsaved changes. If you leave for the main menu or close the window with unsaved changes, the game asks whether to save first. Close the window while another question is open (the Bomb's, say), and it asks once you've answered that one.

A save keeps everything:

  • every tile, including traffic lights, sidewalks and runways, and the style and facing of every house, service building, venue, tree and park piece, and which way each level crossing and crosswalk runs. Traffic lights and crosswalks' lights start afresh when a plot is loaded

  • how each set of points is switched, and each tunnel's settings

  • every train exactly where it was, whether it was running (or standing at a station), its colour and name, and the depot it belongs to

  • every car out on the road, where it was going, and who was driving, and every emergency vehicle out on a call, with its siren on or off. Stations' next calls start afresh

  • the time of day and the day, the weather, the town's stars, wishes and size, and the news for the morning paper

  • the names you gave buildings

  • everyone in town: their names (including the ones you gave them), looks, voices, homes, jobs, whether they're kids or teenagers, their money and prizes, where they were, who was at home, and who was at work, out shopping, eating, at the movies, at the arcade, at the bank or at school, and who was watching the drive-in from which bay. People riding a train are saved with their train, and people driving with their car, keeping their jobs, money and prizes too

  • trains away in other towns' tunnels, with the time left before they come home and the depot they belong to (they are sent again when you load the plot), and visiting trains still waiting to come in. When another town keeps one of your trains, it's taken out of the plot's save straight away, even if you don't save, so loading the plot never brings it back or sends it twice

  • roller coaster cars away in other towns, with their riders and the time left before the riders come home, and coaster cars (visiting, or your own coming home) still waiting to come in. Cars another town keeps are taken out of the save straight away, like trains

  • the mail on every train (your mail itself is kept in its own file; see Post offices and postcards)

  • the camera's position, rotation and zoom

  • the plot's theme

Plots saved before tunnels existed load with their one train. Trains saved before depots belong to no depot, and keep running. Plots saved before there were people load with every house already full. Plots saved before themes are meadows, and their trees stay the kinds they were. In plots saved before sidewalks, people standing on the grass go onto the nearest sidewalk, or home until their house has one. People saved before there was money get some to start with, before there were kids everyone is a grown-up, and before there were teenagers nobody is one.

Saves are JSON files in %APPDATA%\toybox-junction\saves\, one per plot. Each is written to a temporary file and then renamed over the old one, so a crash while saving can't damage it. The folder name is fixed in project.godot, so renaming the game won't lose anyone's saves.

Pausing and the menu

There's no separate pause menu: the toolbox is the menu, and opening it pauses the game. Its lid has buttons to save, undo, change the volumes and interface size (the same Settings as the main menu, shown over the game until you press Back or Esc), go back to the main menu or quit (in the web build, quitting goes back to the main menu).

A card in the bottom left-hand corner reminds you of the controls, in three columns: Build, Look around and Play. Each key is drawn as a little keycap, and each mouse button as a mouse with that button lit up. F1 folds it away to a small tag, and brings it back.

Controls

Input Action
Double-click a post office Go inside it (see Post offices and postcards). Inside, Esc closes the mail or goes back out, and Ctrl+Z undoes
Left mouse (click or drag) While the toolbox is shut, the Inspector: click someone to poke them and open their card (and follow them with the magnifying glass), a building to open its card, a pen to poke its animals, a train to pick it, a merge to switch its points, or a tunnel to open its settings. While it's open, use what you picked from it: build with the piece you're holding (click a junction to switch it). With the Hand, click as the Inspector does, or drag to carry someone. With the Eraser, click to take away one thing. With the Bomb, click to clear the whole plot (it asks first).
Tab / Esc Open the toolbox (pausing the game) or shut it to play. Esc closes the settings first if they're open
1 2 3 4 5 6 7 8 9 0 Open the toolbox at a drawer: Track, Roads, Buildings, Fun, Nature, Park, Dinos, Farm, Rides, Tools
R Turn the next piece of track, building, tree, park piece, decoration, level crossing, crosswalk, coaster track or ready-made coaster a quarter turn
H Open the toolbox and pick up the Hand (press again to go back to the last piece)
X Open the toolbox and pick up the Eraser
Space Stop or start the picked train
V Reverse the picked train
T Blow the picked train's whistle
P Take a photo for the album (see Photos and the sticker book)
WASD / arrows / middle-drag Pan
Q / E Rotate the view 90°
Mouse wheel Zoom (three levels, like RCT2)
F Toggle the camera filter (tilt-shift, grade, vignette)
M Turn people's voices off or on
Ctrl+Z Undo your last change to the plot (see Undo)
Ctrl+S / F5 Save
F1 Fold away or bring back the controls card in the bottom left-hand corner
F3 Show or hide the performance overlay (see Performance)

The toy look

The world is a toy train set on a playroom floor, rendered at full resolution so it looks like a photo of real toys:

  • A classic 2:1 isometric camera. An orthographic camera at 30° pitch and 45° yaw draws each square tile as a diamond twice as wide as it is tall. This is the projection RCT2 and Transport Tycoon used. The view rotates in 90° steps, and the sun turns with the camera, so the light always comes from the same side of the screen.
  • A studded plastic baseplate lying on wooden floorboards.
  • Wooden toy railway with grooves for the wheels. At junctions only the selected route's grooves are full depth, and a toy lever with a lamp shows the route.
  • Brick-built houses on their own studded plates. Walls are laid brick by brick in running bond, with slope-brick roofs, a studded ridge, and plastic windows and doors. The hospital, fire station and police station are built the same way, a little bigger, and so are the supermarket, the clock tower, the gas station's shop, the school, the movie theater, the arcade, the fast food restaurants, the train station (with a concrete platform and a yellow line along its edge) and the train depot (an engine shed with a big arched doorway and track running in). The skyscraper is glass and white plates, stacked up like bricks, and the bank is smooth stone with round columns. The restaurants wear what they sell on their roofs: a burger with googly eyes, a chicken in a crown, a slice of pizza.
  • The post office inside is a toy room built the same way, seen through its own camera with a little perspective, lit by daylight from the window and a warm lamp. The picture on the easel is a texture on the canvas, unlit and with no tone mapping in the room, so its colours look as they were painted. The stamps are renders of the real models, like the toolbox's pictures.
  • A drive-in movie screen that plays by itself (shaders/movie_screen.gdshader): each scene is drawn from simple shapes in the shader, at ten frames a second so it jerks along like a GIF, with a projector's flicker and a flash of light between scenes.
  • Painted wooden toy trees on round stands: lollipop balls, tall eggs, apple trees, stacked cones, clouds of blossom, autumn colours, slim birches with black marks, palms with coconuts, low bushes, cacti and ferns. Small plastic plants are dotted over the baseplate (or a theme's leaves, snow, pebbles, rocks or ferns).
  • Themes change the light and the colours (see Starter towns and themes). Snow is drawn by the toy shader: on a winter or mountain plot, scenery's faces that look up, and are higher than the theme's snow line, get a soft coat of snow with drifting edges. Leaf colours are swapped in the meshes' vertex colours, so a tree's finish stays painted wood.
  • A toy park: plastic flowers on stems, wooden planters, stone fountains with glossy blue water, a lawn sprinkler with a coiled hose, a frog on a rock, and a volcano with lava blobs running down it. Water is a stream of glossy drops, each stretched along the way it flies. Smoke comes out in cotton-wool puffs. A grand fountain's rainbow is see-through (shaders/rainbow.gdshader): it grows out along its arc, fainter towards its far end, and then fades. Sparkles, sparks and fireworks are little glowing four-pointed stars that always face the camera (shaders/sparkle.gdshader), bright enough to bloom.
  • Lakes of glossy blue plastic water on a sandy or grassy plate, with pebbles or reeds round the edge, lily pads and rubber ducks.
  • Toy dinosaurs made of rounded plastic, with googly eyes, and a satellite dish whose white bowl turns on its yoke. Toy farm animals with googly eyes in pens of wooden fencing on green studded plates, a red barn, a silo, a windmill and rows of crops. Two dishes make a white toy rocket with a red nose cone, red fins and round windows, on a concrete launch pad with a red lattice gantry. Its flame glows.
  • A painted wooden train: a blue tank engine with red wheels and magnet couplings, a yellow coach, and a green wagon carrying toy blocks and a ball.
  • Plastic road plates with pavements, kerbs and a dashed white line. Level crossings have rubber ramps up over the track, stop lines, and signal posts with flashing red lamps and striped barriers that swing down. Traffic lights are white poles with black heads on yellow backboards, and a hood over each lamp.
  • Paved sidewalks of square grey slabs with pale kerbs. Crosswalks have zebra stripes, stop lines, and signal posts with red and green men and yellow buttons. Rail crosswalks have black rubber boards between the rails, red and green train signals, and red-edged "stop, look and listen" signs.
  • Open-top toy cars, right-hand drive, with a windscreen, a steering wheel and round headlamps. They pop up when they pull out and shrink away when they're put away. The ambulance, fire engine and police car are open-topped too, so you can see their crews, and their blue (and on the police car, red) lamps take turns to flash. The cars' "beep beep", the sirens' two-tone "nee-naw" (muted for now), a grand fountain's rainbow song, a volcano's rumble, the bomb's boom, the clock tower's "bong" (a low bell with a real bell's out-of-tune overtones), the cameras' click, a rocket's countdown blips and lift-off roar, the fireworks' whistle and bang, the geese's nasal honks, a balloon burner's roar, a flying saucer's warble and a plane's propeller buzzing up to full throttle are synthesised too (scripts/audio/toy_sounds.gd).
  • Little plastic people with round heads, dot eyes and a smile, in thousands of combinations of shirt, trousers, skin, hair colour and hair or hat (a cap, a top hat, a bobble hat, a bun...). Kids are the same, a bit under three quarters the size, and teenagers a bit under nine tenths. Their arms and legs swing from the joints as they walk, wave, dangle, fall, sit, hold a camera up to take a picture and ride a skateboard, and someone who's won a prize at the arcade carries it in their hand.
  • Things in the sky are toys too: plastic birds and geese with flapping wings, twig nests, balloons with striped envelopes and wicker baskets, a silver saucer with a glass dome and blinking lights, and a little green man with big black eyes, antennae and a silver suit.
  • Toy planes with round plastic bodies, a glass canopy and windows, low wings with coloured tips, a coloured tail fin, three chunky wheels and a two-bladed propeller that spins. Runways are dark tarmac plates with white paint and little lights, and the airport is built like the station: bricks on a studded plate, with a glass-topped control tower and a striped windsock.
  • Gibberish voices. Every syllable is synthesised as the game runs (scripts/audio/babble.gd): one period of a wave made from the voice's harmonics, loudest near the two formants of a vowel, looped at the voice's pitch after a click, hiss or hum. The same line in the same voice always sounds the same, and questions go up at the end.
  • Toy materials. One shader (shaders/toy.gdshader) gives glossy or satin moulded plastic, painted wood, bare wood with procedural grain, and sanded wood. Edges are chamfered so they catch the light the way moulded bricks and wooden blocks do. The camera is orthographic, so the shader lights every pixel with the same view direction. Godot's built-in specular would leave a fixed hotspot on the flat plastic.
  • Camera filters. A tilt-shift blur keeps only a band across the middle of the screen sharp, which makes the scene read as a miniature photographed up close (shaders/toy_camera.gdshader, toggle with F). It also adds a warm grade and a vignette. The Vignette setting scales the blur and the vignette together (see camera_blur.gd). Shadows, ambient occlusion where toys touch, sky reflections on the plastic, a little glow and 4x MSAA complete the photo look. The camera snaps to whole pixels, so as the view pans the picture slides along a pixel at a time, and thin details such as kerbs, slab joints and road markings don't blink on and off. Shadows use hard-edged filtering because Godot's soft shadow filter adds a fixed per-pixel noise pattern that shows up as flickering dark specks once the scene moves under it. An orthographic camera's shadow map covers its whole depth, so the camera sees only just past the baseplate's far edge at the top of the view (deeper zoomed out, shallower zoomed in). That keeps the shadow map's texels small, so the shadows of trains, cars and people stay clean as they move instead of flickering from one coarse texel to the next.
  • Toy-box menus. Buttons are chunky plastic bricks that sink when pressed, panels are cream plastic, and the title is a row of tipped, multicoloured letters. Text uses the rounded Fredoka typeface (SIL Open Font License, in fonts/).
  • Procedural models. Every model is generated in code. The music is made by a script in this repo too (see Music), so the font is the only asset made anywhere else.

Using real 3D means no sprite-sorting bugs (trains behind trees, over bridges), view rotation without redrawing every sprite four times, and smooth movement on curves.

Music

There's a title tune and a playing tune for each theme, and all of them loop seamlessly:

  • "Toybox Junction" (title screen, 80 seconds): a bouncy, lightly swung tune in C major at 120 bpm. A marimba plays the tune over a strummed ukulele, plucked bass and toy percussion (a soft kick and snare, shaker and woodblock), with a glockenspiel joining in and answering. A whistle takes the tune in the middle section, and a train whistle toots "toot toot" at the end of the loop, leading back to the top.
  • "Lazy Afternoon" (while playing, about 2.5 minutes): slow (75 bpm), soft and warm, in F major. An electric piano and a quiet pad play gentle jazzy chords over a round bass. Sometimes a kalimba or vibraphone plays a sparse tune or rippling arpeggios, and a hush of shaker and side-stick keeps time. It never builds to a climax, and its highs are rolled off, so it stays in the background while you build. It is mixed about 4 dB quieter than the title tune. It plays on Meadow plots.

Every other theme has a playing tune of its own, written the same way: unhurried, never building to a climax, and mixed to the same loudness as "Lazy Afternoon".

Theme Tune Sound
Spring "Blossom Lane" (80 s) G major, 96 bpm. A fingerpicked nylon guitar and plucked bass, a pan flute tune with a glockenspiel joining in, a hush of shaker and side-stick, and birds chirping.
Autumn "Conkers and Cocoa" (91 s) D dorian, 84 bpm and swung. An electric piano, a walking bass and brushes; a clarinet takes the tune, then a vibraphone.
Winter "Snow Globe" (84 s) A music-box waltz in E flat (3/4, 138 bpm). A music box and a celesta over a plucked harp's oom-pah-pah, with sleigh bells in the middle and a slow wind-down at the end.
Desert "Tumbleweed Express" (74 s) E minor, 104 bpm. A twangy boom-chick guitar, woodblocks clip-clopping like hooves, a frame drum and a lone whistler, with the guitar picking out the tune the last time round.
Jungle "Temple Steps" (86 s) A dorian, 112 bpm. A marimba ostinato over a log drum, congas and bongos; a kalimba and then a pan flute take the tune, and birds call through a drums-only breakdown.
Mountain "Echo Valley" (101 s) D major, 76 bpm. Harp-like arpeggios and a wide pad, an alphorn whose calls echo round the valley, a pan flute tune and distant cowbells.

The music fades from one tune to the other when you start or leave a plot, and plays on the Music bus (the Music slider). Going to the menu starts the title tune from the top. A plot always starts its tune from the beginning, which opens with chords only.

Like the rest of the sound, the music is synthesised rather than recorded: tools/music/compose.py writes out every note, synthesises each instrument (FM electric piano, additive marimba, Karplus-Strong plucked strings and so on) and renders each tune to music/<name>.ogg. Each track is mixed into a buffer exactly one loop long. Notes still ringing at the end carry on at the start, and the reverb wraps round the same way, so there's no seam where the loop restarts. Each tune's last bar is a turnaround into its first, as a repeat would be. After encoding, the script decodes each file to check that it's exactly one loop long and doesn't jump at the loop point. Their import settings (music/*.ogg.import) make Godot loop them.

To change the music, edit the script and run it. It needs Python 3 with numpy, and ffmpeg on PATH:

py -3 tools/music/compose.py                 # every tune
py -3 tools/music/compose.py playing desert  # just these

Performance

Press F3 anywhere in the game (or start it with --perf) to show the performance overlay in the top-right corner. Twice a second it shows:

  • the frame rate, the average frame time and the slowest frame
  • how long the timed scripts took, and the renderer's CPU and GPU time
  • the renderer's draw calls, objects and triangles
  • the size the 3D view is drawn at, and the renderer (gl_compatibility in a browser)
  • how long each part of a frame took: the trains, the traffic, the services, the people, syncing the 3D views to them, and the cursor and HUD

It works in the web build too, so it shows how the game runs on Wavedash, in a player's own browser.

The game keeps the work in each frame down in a few ways:

  • The map's shape is worked out once. Trains, cars and people ask which way track and roads run and where people can walk many times a frame. The world keeps each answer until the map next changes.
  • Flat pieces are drawn in blocks. Roads, traffic lights, level crossings, sidewalks, crosswalks, runways and track are merged into one mesh for each 4 x 4 block of tiles, so there are far fewer things to draw. A block is drawn again when one of its pieces changes.
  • Lamps change colour, not mesh. Every lamp of one shape in a block (a crossing's, a traffic light's, a crosswalk's red and green men) is one MultiMesh. Lighting a lamp just changes its colour, and a crossing's, light's or crosswalk's lamps are only touched when what they show changes.
  • Studs are drawn in blocks too. Each 8 x 8 block of baseplate is its own MultiMesh, so the blocks out of sight aren't drawn. There are no studs under roads, sidewalks, crosswalks, traffic lights and runways, which cover their whole tile.

In a browser, the game also:

  • draws the 3D view at most 1080 pixels tall and scales it up to fill the page (the menus stay sharp), so a high-DPI screen doesn't draw two to four times the pixels
  • uses a 2048 x 2048 shadow map instead of 4096 x 4096
  • leaves out the studs' shadows (a million or so triangles a frame on a big plot)

Running (Windows, no install needed)

From the project folder, in PowerShell:

.\toybox.ps1            # play
.\toybox.ps1 -Test      # run the test suite
.\toybox.ps1 -Editor    # open the project in the Godot editor
.\toybox.ps1 -Record    # record the showcase video (see below)
.\toybox.ps1 -Web       # export the web build to build\web (see below)
.\toybox.ps1 -Zip       # export a versioned web build folder and .zip for Wavedash

From cmd, or if PowerShell's execution policy blocks scripts, use toybox.cmd with the same options (toybox, toybox -Test, toybox -Editor, toybox -Web, toybox -Zip).

On first use the launcher downloads a portable copy of Godot 4.7.2 (about 85 MB) into .tools\, which is git-ignored. It checks the download against Godot's published SHA-512 checksum, then reuses that copy on later runs. It also refreshes Godot's project cache (.godot\) automatically when scripts change. To change the Godot version, update $GodotVersion and $ZipSha512 in toybox.ps1.

The game's log and any errors print to the terminal you started it from.

Screenshots

To render a screenshot and quit (useful for checking the look without playing), run:

.\toybox.ps1 --screenshot=shot.png                  # the main menu
.\toybox.ps1 --screenshot=shot.png --demo --zoom=0  # the demo layout, zoomed in

The screenshot renders in the background on a hidden desktop, so no window appears and nothing you're doing is interrupted. These options choose what it shows. They also work without --screenshot.

Option Effect
--new[=size] Skip the menu and start a blank plot (default 32 tiles a side)
--town=<id> With --new, start from a starter town: little_loop, toybox_junction, country_line, market_town or big_city. With --page=new, pick it on the New Game page
--theme=<id> With --new or --demo, use a theme: meadow, spring, autumn, winter, desert, jungle or mountain. With --page=new, pick it on the New Game page
--demo Skip the menu and play the demo layout
--tutorial[=n] Skip the menu and start the tutorial, at lesson n (from 1)
--load=<id> Skip the menu and load a save (its file name without .json)
--page=new / --page=load / --page=settings Open the New Game, Load Game or Settings page of the menu. With --pause, --page=settings opens the game's Settings page
--pause Open the toolbox, which pauses the game
--saves=<folder> Use another folder for saves, to keep test saves away from your own
--tunnel=x,z Open the settings of the tunnel on that tile. Quote it in PowerShell, like --focus
--wait=<seconds> Let the game run this long before taking the screenshot (to catch a train at a crossing, say)
--item=<id> Hold a piece from the toolbox, with the toolbox open at its drawer (road, crossing, cottage...)
--turns=<n> With --item, turn the piece n quarter turns, as if you'd pressed R n times
--hover=x,z Point at that tile as if the mouse were over it. With --item, the toolbox stays shut and the piece's see-through copy shows there. Quote it in PowerShell, like --focus
--person[=n] Poke the plot's first (or nth) person, so they say something, open their card and centre the view on them
--train[=n] Open the card of the plot's first (or nth) train, with the magnifying glass over its engine, and centre the view on it
--building=x,z Open the card of the building on that tile, with the magnifying glass over it. Quote it in PowerShell, like --focus
--post-office=x,z Go inside the post office on that tile. With --page=mail, open the mail too. Quote it in PowerShell, like --focus
--sky Send a hot air balloon and a flock of geese over the town (part way across already), and a flying saucer in to land near somebody, and centre the view where it lands. Add --wait=8 to catch the little green man waving
--holiday=<id> Make it a holiday, whatever the date (new_year, valentines, st_patricks, easter, halloween, thanksgiving or christmas), bring its visitors in straight away near the middle of the plot, and centre the view on them. Try --town=little_loop --holiday=christmas --person=99 to look at Santa's elf with his card open
--perf Show the performance overlay (F3 shows and hides it)
--plane Send the first airport's plane off to take off straight away, and centre the view on its airport. Try --town=big_city --plane --wait=6 to catch it racing down the runway
--hour=<h> Set the town clock to that hour (21 for nine at night, 18.5 for half past six)
--weather=<kind> Set the weather: sunny, cloudy, rain, storm or snow
--place=all Build every newer place in rows from the top left, each with a sidewalk (or a list of toolbox ids, split by commas)
--showcase=<name> Lay out a showcase: track (bridges, a signal, an overpass, a turntable and a buffer stop), roads (a bus depot and stops, the ice cream parlour, a car park and the park props) or combos (the newer combinations)
--paper / --wishes / --album Open the morning paper (with some news), the Wishes card (with a couple of wishes) or the photo album
--zoom=0..2 Zoom level (0 is closest)
--yaw=0..3 View rotation in quarter turns
--focus=x,z Centre the view on a tile. Quote it in PowerShell, which otherwise splits at the comma: '--focus=15.5,6.5'

Showcase video

.\toybox.ps1 -Record

This plays a scripted, captioned tour of about 30 seconds on the demo layout (scripts/demo_tour.gd). It shows:

  • zooming in and following the train
  • rotating the view
  • laying track, and placing houses and trees from the toolbox
  • flipping the points
  • the train reversing at the end of the new branch

The result is saved to recordings\toybox-junction-tour.mp4 (1280×720, 30 fps, about 10 MB), and recordings\ is git-ignored.

Godot's Movie Maker renders every frame offline at a fixed 30 fps, so the video is smooth on any PC. Like screenshots, it records in the background on a hidden desktop. Encoding the MP4 needs ffmpeg on PATH (winget install Gyan.FFmpeg). To watch the tour without recording it, run .\toybox.ps1 --tour.

Web build and Wavedash

.\toybox.ps1 -Web

This exports the game for the browser into build\web\ (about 38 MB, nearly all of it the engine's WebAssembly). build\ is git-ignored. It runs headless, like the tests. The first web build downloads Godot's export templates. They only come as one archive for every platform (about 1.3 GB), so the launcher checks it against Godot's published SHA-512 checksum, keeps the four web templates (about 40 MB) in .tools\export-templates-4.7.2-stable\ and deletes the rest. export_presets.cfg holds the Wavedash web preset: threads on, since Wavedash serves games cross-origin isolated. It reads its templates from that folder, and leaves the tests and the Wavedash editor add-on out of the build.

The web build can only use Godot's Compatibility renderer, so it looks a little different. It has no ambient occlusion, a lighter tilt-shift blur and slightly stronger colours. To see it on Windows, add -Compatibility to a run or screenshot: .\toybox.ps1 -Compatibility --screenshot=shot.png --demo. In a browser it also draws the 3D view at most 1080 pixels tall, with smaller shadows and no studs' shadows (see Performance). Press F3 there to see how it's running.

In a browser, Godot normally hands each sound to the browser to play ("sample" playback), and then a player's volume changes never reach it: the music, which fades in from silence, would stay silent. project.godot sets the web build to stream playback instead, so Godot mixes everything itself as it does on the desktop (fades, the buses made in code, the build sounds' random takes). Browsers also keep a page's audio paused until the player clicks or presses a key, and Godot's own resume doesn't reach it in a threaded build, so the Wavedash preset's html/head_include adds a little script that resumes it on their first click, key or touch.

To play the web build on Wavedash, install the Wavedash CLI, sign in with wavedash auth login, and put your game's ID from the Developer Portal in wavedash.toml (or run wavedash init). Then:

wavedash dev                          # play build\web locally with the Wavedash SDK (sandbox data)
wavedash build push -m "Tunnels"      # upload build\web as a new build
wavedash publish <build id>           # make that build live

To upload by hand instead, run .\toybox.ps1 -Zip. It exports the web build to a folder named after the game and its version, such as build\toybox-junction-v0.1.0\, and zips it to build\toybox-junction-v0.1.0.zip with index.html at the zip's root. The name and version come from config/name and config/version in project.godot, so raise the version there before each release. In the Developer Portal, open the game's Builds tab, click Upload new build and drop the zip in (the limit is 1 GB uncompressed). Uploading doesn't make the build live. Click Publish on it when you're ready.

Setting up the achievements

Each achievement and stat has to exist in the Developer Portal too, with the identifier the game uses (such as POINTSMAN), or Wavedash ignores it. They're all in achievements.json, in the portal's import format: open the game's Achievements page, click Add achievement, then Import JSON, and pick the file. Importing again updates them by identifier and keeps their icons. Icons are optional, and are added in the portal (or with wavedash achievement update --id <id> --image <file>).

The list lives in scripts/game/achievements.gd (Achievements.LIST and STATS), and a test checks that achievements.json still matches it. After changing the list, rewrite the file and import it again:

.\.tools\godot-4.7.2-stable\Godot_v4.7.2-stable_win64_console.exe --headless --script res://tests/write_achievements.gd

The game queues each achievement as it's unlocked. In the web build, WavedashLink loads the player's stats (request_stats()) once they're signed in, then every few seconds passes the queue on with set_achievement(), and adds the pieces built to the stat. Wavedash drops any set before the stats have finished loading, so whatever doesn't go through stays queued and is tried again. Each achievement is passed on once a session. wavedash dev uses sandbox achievements, and wavedash clear-playtest-data --achievements clears them for another go.

The Wavedash Godot SDK (Apache 2.0, version 1.3.1) is in addons/wavedash/. Its WavedashSDK autoload reaches the Wavedash SDK on the page. It only works in a web build on Wavedash, and everywhere else the game stays offline. Opening the project in the editor also adds the add-on's Wavedash dock, which can export, run wavedash dev and push builds.

With your own Godot install

If Godot 4.7 is already installed, open project.godot in the editor and press F5, or run godot --path . from the project folder.

Tests

The game has a headless test suite. It covers:

  • the town (tests/test_town.gd): the newer places (going in, coming out with something, looking round for free, playing, the mayor), drawers paging, apartments, days and nights, people going to bed, the weather and umbrellas and rainbows, the chronicle and the morning paper, wishes and stars, the town growing, photos and stickers, track extras (bridges joining lakes, turntables turning trains round, signals, overpasses), engines and cars, toots, buses and bus stops, the ice cream van, milk lorries, car parks, props, friends, favourite places, birthdays and dogs, events (concerts, parades, fun runs) and trick-or-treating, the newer combinations, townsfolk's postcards and the post office wall, postmen, mini-games, riding along, paint, and gift crates and parade trains travelling between towns

  • track geometry, pieces laid by hand (straights, curves and merges, turned, and lines side by side staying apart), merges sending trains both ways and taking them back, the starter towns' auto-shaping, and old saves' track taking the shape it had

  • the world's answers about its shape (which way roads and track run) following every change, including switching points, loading and clearing

  • tunnels: where they can go, their hidden track past the edge, their settings

  • train movement, reversing, derailing, and arriving through a tunnel

  • several trains keeping out of each other's way: waiting behind a train going their way, and a siding's train merging onto a loop and sharing it

  • train depots: sending out one train each after a moment (straight away in a new town), not without track in front, sending out another when theirs has gone but not while it's away in another town, a depot's train running on when the depot's cleared, and saving which depot a train belongs to

  • stations, depots and post offices facing the track, and trains stopping at a station's platform with their middle car beside it, each time they come by

  • trains leaving through tunnels, coming home after 2 minutes, being delivered (and taken out of the plot's save, which keeps each train's id), and visitors waiting for a clear tunnel

  • the rail exchange protocol, with players in a pretend lobby. It covers sending to anyone or to one player, refusals, invites, replayed and repeated offers, a train travelling from one plot's tunnel to another's, and a train full of mail fitting in a lobby message, its letters carrying their senders' names

  • post offices and the mail: trains stopping at a post office only when there's mail to swap, dropping off letters and picking up as many postcards as they carry, postcards going back in the outbox when a train goes without them, the album and outbox filling up, letters being downloaded (and thrown away if what came down wasn't a postcard), only upload ids (never pictures) going to another town and the postcards that couldn't go (even ones uploaded after their train left) coming back, the mail remembering the letters dealt with and a save's trains leaving them behind, received letters being from their senders, letters from other towns cleaned (safe ids and names, no pictures, no more than a train carries), postcards being PNGs of the right size (checked before they're opened), and saving the mail and its file (beside the saves, but not listed as one, and a damaged file reading as an empty post office)

  • painting on the easel: the pencil, paintbrush and crayon painting lines, the spray can spraying while held, the paint bucket filling an area up to its lines, the eraser rubbing back to paper, stamps printing their pictures at the stamp size, the bomb and undo, and pictures turning into postcards and back

  • saving and loading worlds, trains, trains away and trains coming in

  • the save folder: listing, overwriting, deleting, damaged files and unsafe names

  • naming buildings: which pieces are buildings, tidying names up, a big house being one building, names going with their buildings, saving them and skipping damaged ones, and buildings' cards saying what they are and who lives or works there

  • the toolbox catalogue, including which kind of tree, park piece, service or venue each style is

  • the tutorial: every lesson having a checklist of goals that can be met and point at real pieces, goals ticking off from what the player does and what's on the plot (and only from what they do during that lesson), tallies going up, goals staying ticked when what met them goes, finding loops of track (and not dead ends), and a whole run through every lesson on a real plot, with its train coming out of the depot and its people moving in

  • themes: their names, the trees they plant, leaf colours swapped without changing the finish, snow only in winter and on the mountains, the meadow looking as it always has, saving the theme, older saves keeping their trees, and the toys round the baseplate staying off it

  • starter towns: every town in every theme, at its size, track that always goes somewhere, crossings with road and track both ways, traffic lights on junctions, houses facing a sidewalk, a hospital, fire station and police station facing the road in every town, supermarkets, clock towers, skyscrapers, banks, schools, movie theaters, arcades and restaurants facing a sidewalk and gas stations and drive-ins facing the road, train depots and stations facing straight track (and stations with a sidewalk beside them), the big city's airport facing a runway long enough for its plane, and each town's depots sending out their trains, and its trains, people and emergency vehicles running for 45 seconds

  • the park: trees and park pieces built and saved, flower beds and lakes joining and splitting, four fountains making a grand fountain only once they combine (and only the first of overlapping squares, and older saves' grand fountains still there), jumping jets linking when near, and people admiring them. The water: fountains, sprinklers and frogs spraying and landing in their basins and on their tiles, water leaping back and forth between jumping jets (one leap for every three jets, never to a jet that's gone), a grand fountain's rainbow shooting with its song and sparkles, fading and coming back, ducks paddling round their lake tiles, and volcanoes smoking, erupting and rumbling once an eruption

  • decorations and combining pieces: dish and dinosaur styles, the Dinos drawer, their sounds and lines, pieces combining only when asked and only with something new, cottages making a big house that faces its sidewalk and keeps its residents (and townhouses not), combinations coming apart and being saved, a rocket waiting for a crowd, counting down from ten and lifting off, its pad clearing once it's gone, people gathering round a rocket, shouting the countdown, taking pictures, cheering and setting off fireworks, and the dishes turning, the rocket popping into shape, its sign, countdown, flight, smoke and the fireworks' sparks

  • the farm: farm piece styles, the Farm drawer, pens joining into fields and being saved, every piece fitting on its tile, animals moving in and staying inside their fences while wandering into the next pen, going home when a pen under them goes and going with their own pen, goats climbing their rock, windmills' sails turning, the animals' sounds and what people say

  • roads and level crossings: shaping, never joining track except at a crossing, where crossings can go and which way they turn, and saving them

  • traffic lights: where they can go, staying green until a car waits the other way, amber and red all round before changing, cars never driving onto the junction at red, cars going opposite ways crossing together while ways that cross never share the junction, taking the lights down, and saving them

  • cars: lanes that keep left and join up, trips there and back, queueing, stopping (and tooting) for people, taking turns at a crossroads, a car whose road is cleared away, and plenty of traffic in the demo town without bumps

  • level crossings closing before a train arrives and opening after, cars waiting for trains, and trains waiting for a car on the crossing

  • sidewalks and crosswalks: where crosswalks and rail crosswalks can go and which way they turn, which sides people can step on from, and saving them; a crosswalk's button stopping the cars, the green man showing, and the cars going again; a rail crosswalk's signals stopping a train while people cross

  • people driving: off to a friend's and home again, one car per house, being lifted out by the Hand, and saving cars with their drivers

  • hospitals, fire stations and police stations: each sending its own vehicle out by itself (and not without a road), an ambulance racing to a house with its siren going, flashing there and driving home quietly, a police car's patrol, a vehicle coming home to a station that's been cleared, room for emergency vehicles on busy roads, saving them (and older saves' cars staying cars), and people calling out at sirens

  • supermarkets, clock towers, skyscrapers and gas stations: the town clock striking the right number of times on the hour (twelve at noon and midnight) and its hands pointing the right way, the clock towers' hands and bells following it, jobs going to the nearest residents and ending when a building's cleared, going in to work and coming out again, shopping, taking pictures of the clock tower, people hearing it strike, cars stopping at the pumps to fill up, and saving who's at work and who's shopping

  • banks, schools, movie theaters, drive-ins, arcades and fast food: the first four venues keeping their old styles, every venue having jobs, names and lines, money (paying for things, not spending what you haven't got, wages, the bank), eating out, watching a movie and the film changing every hour, winning prizes and carrying them, the first to move into a house being a grown-up and kids not working or driving, a grown-up walking a kid to school hand in hand, kids walking to school alone, being picked up after school and walking home together (or alone if nobody comes), driving to the drive-in, parking in a bay facing the screen and driving home after the movie, the drive-in filling up, the drive-in's screen, and saving money, prizes, kids, who's at school and who's parked where

  • people: their names and lines, moving into houses (and away when a house is cleared), staying in until their house has a sidewalk, keeping to the sidewalks, crossing a road at a crosswalk when the green man shows, crossing the track while the train waits, being poked, picked up and dropped (and dropped onto a train), walking to a station, waiting on its platform and catching a train that stops there, getting off only at stations (onto the platform), being bumped by trains, riding through a tunnel and coming home, visitors arriving from another town and leaving, renaming, and saving and loading

  • chats and thinking out loud: plenty of conversations for every kind of chat (kids, teenagers, visitors, housemates, workers, mornings, evenings, the trains and every holiday), each of at least two lines, the two taking turns however long the chat goes on, and someone thinking out loud saying every line and then getting on with their day

  • naming trains: names tidied up, cut short and saved, going with the train to other towns, visitors' trains (and visitors) from other towns keeping their own names, someone nearby saying the new name, and the townsfolk calling it that

  • passengers in a train's travel data: kept within the seats, with safe names and looks

  • the sky: one bird for every few trees and buildings, nesting on top of them, finding a new nest when theirs is cleared and flying off when there's nowhere left, birds on buildings too, balloons drifting slowly across and firing their burners, geese flying in a V and honking, a flying saucer coming near someone, landing clear of anything tall, beaming its little green man down and back up and leaving, saucers coming rarely but coming, people stopping to stare and waving it off, teenagers moving in (never first, never a kid too, travelling and saving as teenagers), skateboarding faster than walking with tricks along the way and one at the end, and everything in the sky (and teenagers' boards) being drawn

  • runways and airports: airports facing their runway, the runway across the front or straight on away from it, runways too short to use, saving them; a plane waiting at its airport, taxiing out, racing down the runway and lifting off before its end, climbing away off the baseplate and coming back to land from the far end without going through the runway, stopping in front of its airport and taxiing back in; a new airport's plane flying in, one plane for every airport, planes waiting without a runway, two planes never using a runway at once, planes going with their airport (or pulling up and flying off), people waving at planes, the airport's card, and the planes and runways being drawn

  • holidays and their visitors: the dates of every holiday (Easter and Thanksgiving worked out each year), every holiday having a cast with lines to say, visitors walking in from the edge only in season (one of each at a time), dropping in when there's no sidewalk at the edge and coming to full towns, going over to someone to hand them a treat (and them waiting and carrying it about), the leprechaun's gold being money, the ghost's "Boo!" making people jump, leaving when their time's up, travelling and saving as themselves, and being drawn in costume with what they carry

  • the gibberish voices: length, loudness, the same line always sounding the same

  • the building and tool sounds: every take short, heard and not clipping, takes differing but each always the same, plays varying in pitch and loudness without repeating a take, each piece sounding like what it's made of, and the sounds being quick to make

  • roller coasters: pieces and heights packing into a variant, their ends and how high each end is, loops going right round and upside down, coaster track taking the height of what it joins (and never going below the baseplate or above the top level), every ready-made coaster making a whole circuit that never crosses itself and comes back down, building turned every way round and needing room, trains going round, stopping at their stations and climbing the lift hills, open track having no train, riders queuing, getting on and off after a lap, queuers who've gone off not getting on, breaking the track letting riders off, townsfolk paying for and riding a coaster and getting off where they queued, the station's card, saving, and the Rides drawer

  • coasters through tunnels: coaster track joining a tunnel (and trains staying out of it), a station's cars riding into the tunnel with their riders and going to the network as coaster cars, the station putting out new ones, riders nobody takes coming home (out of the return tunnel in their cars, or on foot without one, and on foot if it's gone meanwhile), cars from another town coming out of a tunnel in their own colour and passing through (their visitors getting off, people queuing getting on and riding on), tunnels closed to visitors, saving the cars away and coming in, townsfolk riding off and visitors arriving, coaster offers only going to towns that take them, and cars another town kept being taken out of the save

  • the volume settings: the Music and Sounds buses feeding into Master, how loud each setting is (zero mutes), saving and loading them, and ignoring a damaged settings file

  • the interface size: applied to the window, kept in range, saved beside the volumes, and ignoring a damaged settings file

  • the mouse pointers: each draws at the size picked, within the engine's limit, every tool (and laying track) has one that looks different from the others, the three sizes growing in turn, and the size saved beside the other settings

  • the music: every tune loops and lasts at least a minute, each theme has a tune of its own, and changing tune fades between them

  • the performance overlay: timing the parts of a frame only while it shows

  • achievements: every one listed once, with a title, a description and a stat that exists if it unlocks from one; achievements.json matching the list; unlocks and counts staying queued until Wavedash takes them, and each achievement passed on only once

It also builds every model (including a person in every hair style, every station and emergency vehicle, every venue in every colour, the drive-in's screen, the arcade's prizes, the new-mail envelope, the mail sack, the mail parcels, the room inside the post office, every runway shape and every plane, and every holiday visitor's costume, what they carry and the treats they hand out) and checks that each triangle faces the way its normal points, that the emergency vehicles fit their lanes with their lamps on top, that their crews are in uniform, that the venues fit on their tiles, that planes stand on their wheels on the runway and fit on their airport's apron, and that the clock tower's faces look out of it. It checks that flat pieces are drawn in blocks (and drawn again when they change) with no studs under the ones that cover their tile, and that traffic lights' lamps light up and stay lit when their block is drawn again. Finally, it compiles every script. The menus and HUD need a window to run, so this is how a mistake in them still fails the suite.

Run it with .\toybox.ps1 -Test. With your own Godot install:

godot --headless --path . --import                         # first run only: builds the class cache
godot --headless --path . --script res://tests/run_tests.gd

The runner exits with code 1 if any test fails or any engine/script error is logged.

Background runs

Tests, the project import, screenshots and recording never show a window or take focus. Only plain play and -Editor open a normal window.

Tests run with --headless. Screenshots and recording need a real renderer, because --headless draws nothing. For those, the launcher starts Godot on a separate Windows desktop that is never displayed. The game renders on the GPU as usual, but its window can't appear over yours. Godot's output still prints to your terminal, and Godot is killed if you stop the launcher, so nothing keeps running out of sight. They also use Godot's dummy audio driver, so the music doesn't play out loud.

(An off-screen, unfocusable window isn't enough. Godot moves any window that starts off-screen back onto the primary monitor.)

Project layout

scenes/main.tscn    The root scene: just App
scripts/
  app.gd            Root node: switches between the main menu and a game; command-line options;
                    the 3D view's size in a browser
  sim/              Pure simulation data, no rendering
    world.gd            Tile map, track pieces and merges, junction switches, scenery variants,
                        tunnels and their settings, stations and depots facing the track,
                        sidewalks and crosswalks, runways and airports facing them, flower beds,
                        lakes and farm pens joining, pieces combining (grand fountains, big houses,
                        rockets), coaster track and its heights, jumping jets' links, its theme, saving to a Dictionary, the
                        demo layout; answers about its shape kept until it changes
    scenery.gd          What each tree, park piece, decoration, farm piece, service building
                        and venue style is
    rockets.gd          Rockets waiting for a crowd, counting down, flying off, and the
                        fireworks after
    town_sky.gd         What flies over: birds and their nests, hot air balloons, geese in a
                        V, and the flying saucer with its little green man
    air_traffic.gd      The airports' planes: waiting, taxiing, taking off, flying away,
                        coming back to land, taking turns on a runway
    themes.gd           The themes: names, blurbs, which trees their starter towns plant
    starter_towns.gd    The towns a new plot can start from, laid out in code
    mail.gd             The player's post office: the easel's picture, the album, the outbox
                        and the inbox, swapping mail with trains, cleaning letters from other
                        towns, postcards' pictures
    track_geometry.gd   Path math for straight and curved pieces
    coaster_geometry.gd Roller coaster pieces: their ends and heights, and the path along each
                        (round a loop too)
    coaster_designs.gd  The ready-made roller coasters, laid out piece by piece, turned and built
    coasters.gd         The roller coasters' circuits and trains: gravity, lift hills, boosters,
                        stopping at stations, riders queuing, getting on and off, and lines
                        into tunnels sending cars to other towns and taking theirs in
    train.gd            Train movement along the track, reversing, derailing, stopping at
                        stations, arriving through a tunnel, travel data, saving
    fleet.gd            All of a plot's trains: depots sending them out, stopping them at
                        stations, keeping them apart, sending them through tunnels, bringing
                        them home, letting visitors in, saving
    person.gd           One little person: name, looks, voice, kid, teenager or grown-up, home, money,
                        prizes, what they're doing, travel data
    townsfolk.gd        Everybody on a plot: moving in, walking about on the sidewalks,
                        crosswalks, things to do, chats, riding trains, jobs, money,
                        shopping, eating out, movies, the arcade, the bank, school runs,
                        the drive-in, taking pictures, filling up, watching rockets go up,
                        skateboarding, staring at flying saucers, waving at planes, holiday
                        visitors walking in and handing out treats, riding roller coasters,
                        the player's hand,
                        renaming, saving
    folk_names.gd       Everyday first names and silly surnames
    folk_lines.gd       What people say, by topic, in the player's language
    holidays.gd         The real-world holidays by date (Easter and Thanksgiving worked out
                        each year), and the visitors who come for them
    road_geometry.gd    Lane math for cars: keeping left, turns and U-turns
    car.gd              One car (or emergency vehicle): its trail of road segments, driver,
                        stops, siren, saving
    traffic.gd          All of a plot's cars: trips, queueing, junctions, traffic lights,
                        level crossings closing for trains, crosswalks' lights stopping cars
                        and trains for people, saving
    services.gd         Hospitals, fire stations and police stations: their vehicles'
                        call-outs and patrols
    town_clock.gd       The time of day and the days, dusk and dawn, and the clock towers striking the hours
    weather.gd          Sunny spells, showers, storms and snow, and rainbows after rain
    chronicle.gd        What happened in town each day, for the paper
    newspaper.gd        The morning paper's front page
    wishes.gd           The townsfolk's wishes, and the stars for granting them
    town_growth.gd      Hamlet, village, town, city, metropolis
    photo_album.gd      The player's photos and sticker book
    town_vehicles.gd    Buses, ice cream vans, bin lorries, delivery vans and milk lorries
    town_events.gd      Concerts, matches, sports days, weddings, parades, fun runs, New Year
    town_cards.gd       The postcards the townsfolk send, drawn in code
  audio/
    babble.gd           Synthesised gibberish voices
    toy_sounds.gd       A car's horn, a rainbow's song, a volcano's rumble, sirens, the bomb's boom, a clock
                        tower's bell, a camera's click, a rocket's countdown and lift-off,
                        fireworks, geese honking, a balloon's burner, a flying saucer, a
                        plane's propeller
    build_sounds.gd     Building and tool sounds: bricks, wood, plates, water, dinosaurs, farm
                        animals, the
                        eraser and hand, each in a few takes that vary as they play
    music.gd            The title tune and each theme's playing tune, fading from one to the
                        other
    sound_settings.gd   Master, music and sound effects volumes: the audio buses, saved
                        settings
  net/              Trains between players' towns
    rail_exchange.gd    The exchange protocol: who's online, offers, answers. No SDK calls
    wavedash_link.gd    Connects the exchange to Wavedash: lobbies, messages, friends, invites,
                        postcards' pictures going up and coming down; passes achievements on
  game/             Playing a plot
    game.gd             A plot being played: input, building, pieces combining when play
                        starts, trains, tunnels, the Inspector and the Hand, the mail and going into post
                        offices, saving, leaving, the tutorial and starting fresh after it
    tutorial.gd         The tutorial's lessons and their checklists of goals, ticking them off
    build_items.gd      The toolbox catalogue: drawers, pieces and their styles
    save_games.gd       Save files: list, read, write, delete, names not yet taken
    mail_file.gd        The mail's own file, beside the saves
    album_file.gd       The photo album's own file, beside the saves
    achievements.gd     The achievements and their stat, queued up for Wavedash
  render/           Turns simulation state into 3D
    stage.gd            The 3D scene for a world: lighting, camera, camera filter, views
    iso_camera.gd       2:1 orthographic camera, zoom levels, rotation, the menu's orbit
    camera_blur.gd      How strong the camera filter's blur and vignette are, saved
    world_view.gd       Baseplate, studs, plants, per-tile meshes, combinations drawn as one,
                        flat pieces and their lamps drawn in blocks, studs in blocks,
                        cursor, build preview (outlined, with an arrow out of its
                        front), clock towers' hands and bells, drive-ins'
                        movie screens, satellite dishes turning, the envelope over post
                        offices with new mail, the mail sack over their platforms while
                        postcards wait for a train
    garden_view.gd      Water from fountains, sprinklers, frogs and jumping jets, rainbows
                        and sparkles, volcanoes' smoke and lava, ducks on the lakes
    farm_view.gd        Farm animals wandering about their fields, grazing and jumping when
                        poked, and windmills' sails turning
    wonder_view.gd      Pieces popping into a combination, rockets' signs, countdowns,
                        flights and smoke, and fireworks
    sky_view.gd         Birds flapping and perching, their nests, balloons and their riders
                        and burners, geese, the flying saucer, its beam and its little green man,
                        and the planes with their spinning propellers
    train_view.gd       Poses a train's cars, hides them in tunnels, marks the picked train,
                        shows the mail it's carrying (parcels on the cab roof, envelopes
                        floating over the engine)
    person_view.gd      Poses a person's figure (smaller for kids and teenagers), speaks their
                        lines out loud, flashes their camera, shows their prize, their car
                        parked at the drive-in and a teenager's skateboard, dresses holiday
                        visitors (the ghost floats) and shows the treats they hand out
    car_view.gd         Poses a car, toots its horn, flashes an emergency vehicle's lamps
                        and sounds its siren
    models.gd           Baseplate, floor, wooden track, roads, level crossings, traffic
                        lights, sidewalks, crosswalks and rail crosswalks, houses, trees (cacti and ferns too), tunnels, trains and their
                        liveries, cars, people, the picked-train marker, magnifying
                        glass, eraser, bomb
    theme_look.gd       How each theme looks: baseplate, light, sky, grade, leaf colours,
                        snow, the toys round the baseplate and where they stand
    theme_models.gd     Themes' ground bits, and peaks, mesas, a temple, snowmen, pumpkins
                        and hay bales
    service_models.gd   The hospital, fire station and police station, the ambulance, fire
                        engine and police car with their crews, and their flashing lamps
    venue_models.gd     The supermarket, clock tower (with its hands and bell), skyscraper,
                        gas station, bank, school, train station and train depot, and the
                        camera people take pictures with
    fun_models.gd       The movie theater, drive-in (and its screen), arcade, Burgerzilla,
                        Cluckingham Palace and Pizza the Action, the arcade's prizes and the
                        teenagers' skateboards
    park_models.gd      Flowers, flower beds, fountains, the grand fountain, sprinklers,
                        jumping jets, frog ponds, volcanoes, lakes, ducks, water drops, smoke,
                        lava, the rainbow, sparkles
    decor_models.gd     Satellite dishes (and their turning heads), dinosaurs, a dino nest,
                        a fossil dig and a cycad
    coaster_models.gd   Coaster track (rails, ties, posts, a station's platform and canopy, a lift
                        hill's chain, a booster's tyres, loops), its cars, and ready-made coasters
    coaster_view.gd     A roller coaster's train, posed on its track, with its riders (out of
                        sight inside tunnels)
    farm_models.gd      Pens and their fences, troughs and hen houses, cows, pigs, sheep,
                        hens and chicks, horses, goats, the barn, silo, windmill (and its
                        sails), crops and hay bales
    combo_models.gd     The big house, the launch pad, the rocket and its flame
    sky_models.gd       Birds and their wings, nests, geese, hot air balloons, the flying
                        saucer and its lights, and the little green man
    holiday_models.gd   The holiday visitors' costumes and what they carry (Santa's sack, the
                        witch's broomstick, the Easter Bunny's basket...), and their treats
    post_models.gd      The post office, the new-mail envelope, the mail-to-go sack, the
                        mail parcels on a train,
                        and the room inside the post office with its easel
    airport_models.gd   The airport, runway pieces, and the planes and their propellers
    icon_renderer.gd    Renders models into the toolbox's pictures
    mesh_kit.gd         SurfaceTool helpers (triangles, quads, boxes, prisms, copying meshes)
    toy_kit.gd          Bevelled boxes, smooth round parts, studs, toy material finishes
    place_models.gd     The newer venues: cafe, library, museum, town hall, hotel, factory, toy
                        shop, ice cream parlour, recycling centre, bus depot, bowling, mini golf,
                        zoo, stadium, bandstand, carousel, ferris wheel, bumper cars, lighthouse,
                        market, and the parts that turn
    prop_models.gd      Car parks, benches, picnic tables, playgrounds, statues, mazes, hills,
                        rocks and jetties
    rail_models.gd      Bridges, buffer stops, signals, turntables, overpasses, and the newer
                        engines and cars
    vehicle_models.gd   Buses, vans and lorries, bus stops, car parks' bays, bikes, tractors
    thing_models.gd     What people carry (umbrellas, cones, books, kites, rods...), dogs,
                        boats, balloons, bunting and Christmas lights
    day_night.gd        The day and night setting, and the light at each time of day
    weather_view.gd     Rain and snow falling
  ui/               Menus and HUD
    main_menu.gd        Title screen, with its New Game (town, size and theme, with a
                        preview behind it), Load Game and Settings pages, and the Tutorial
    game_hud.gd         Plot name, time of day, pause, train and exchange status, messages, the
                        Settings page, the bomb's flash, the tutorial's card
    controls_card.gd    The controls card in the corner, with its keycaps and mice (F1 folds it)
    tool_cursors.gd     The mouse pointers: the arrow, one for each tool, and a piece of track for
                        laying track, at the size picked
    tutorial_panel.gd   The tutorial's card: the lesson, its checklist and the Next button
    settings_panel.gd   The Settings pages: the volume sliders and the interface size
    sound_panel.gd      The volume sliders
    ui_scale.gd         The interface size (the window's content scale), saved
    perf_overlay.gd     The performance overlay (F3): frame rate, rendering, each part's time
    tunnel_panel.gd     A tunnel's settings: visitors on or off, where it sends trains (or
                        coaster cars)
    person_card.gd      A person's card: their name (to rename them), home and doings
    building_card.gd    A building's card: what it is, its name (to name it), who's there,
                        and a post office's way in
    train_card.gd       A train's card: its name (to name it), what it's doing, who's riding,
                        and Stop/Go and Reverse buttons
    magnifier.gd        The big magnifying glass held over whoever or whatever's card is open
    post_office_room.gd Inside a post office: the room, the easel, the paints and stamps
    paint_canvas.gd     The picture on the easel, and the brushes, bucket, eraser, stamps,
                        bomb and undo that paint it
    color_wheel.gd      The paint wheel
    mail_panel.gd       The letters and the album, inside the post office
    speech_bubbles.gd   Speech bubbles over people's heads, and the name under the mouse
    toolbox.gd          The draggable toolbox and menu, with its flip-open lid, shrunk while
                        it's shut, and the tutorial's ring pointing at what to pick up
    toy_dialog.gd       Modal questions ("Save your plot?")
    title_logo.gd       The multicoloured title
    toy_theme.gd        Colours, fonts, brick buttons and plastic panels
    newspaper_card.gd   The morning paper
    list_card.gd        The Wishes card
    album_card.gd       The photo album and sticker book
    mini_game.gd        The claw machine, Choo-Choo Catch and fishing
  demo_tour.gd      Scripted, captioned tour used to record the showcase video
shaders/
  toy.gdshader          Plastic and wood materials, and snow on them
  toy_camera.gdshader   Tilt-shift blur, grade and vignette
  ghost.gdshader        See-through build preview
  ghost_outline.gdshader The build preview's outline
  rainbow.gdshader      A grand fountain's rainbow, shooting out and fading
  sparkle.gdshader      Glowing four-pointed stars facing the camera: sparkles, sparks, fireworks
  movie_screen.gdshader The drive-in's movies: random looping scenes, like a GIF
fonts/              Fredoka (SIL Open Font License, see fonts/OFL.txt)
music/              The music loops (title, and one per theme), made by
                    tools/music/compose.py
tools/music/        compose.py: writes, synthesises and renders the music (not part of the game)
addons/wavedash/    The Wavedash Godot SDK (Apache 2.0), as published
tests/              Headless test runner and suites
export_presets.cfg  The Wavedash web export preset
wavedash.toml       Wavedash CLI settings: game ID, build folder, Godot version
achievements.json   The achievements and stats, for importing into the Wavedash Developer Portal
toybox.ps1          Launcher: fetches portable Godot, then plays / tests / records / exports /
                    opens the editor
toybox.cmd          Same launcher for cmd, or when PowerShell scripts are blocked

The simulation (scripts/sim) does not depend on rendering. It can run headless, and the art approach can change later without touching game logic.