Update the web console server, screens, help, prefs and loop setup, with matching page and logic suites

AI Assisted
This commit is contained in:
jparkerweb committed 2026-11-02 12:00:12 -08:00
1 parent 2468027a5a
commit 8e34bf1005
119 files changed
+9957 -3728

No files matched your search

+800 -45
View File
@@ -103,11 +103,12 @@ Scroll down for the utilities. Outside a git repository the **Git** card says so
tab put the most useful ones first. It changes the order, never the
questions a skill asks (see *Your role* below).
- **Light or dark, and a highlight color you pick.** The gear button at the
top right opens *User Preferences*: your role first, then these. It follows
top right opens *User Preferences* on its Appearance tab, which holds these
and your role. It follows
your system by default; set it to one or the other if
you would rather it stayed put. Remembered on your machine, so it carries
over to every session.
- **A card as wide as you want it.** The same panel has a *Card width*
- **A card as wide as you want it.** The same tab has a *Card width*
setting — **Narrow** (720px), **Comfortable** (880px, the default) or
**Wide** (1080px) — that widens the question card, the Previous / Next pager
and the document tabs together. The dashboard keeps its own layout, and on a
@@ -169,7 +170,7 @@ Scroll down for the utilities. Outside a git repository the **Git** card says so
turns red if that press was never collected, and goes back to the plain
icon once nothing is left, so a console left in a background tab can be
checked at a glance.
- **Help.** The **?** at the top right opens a Help dialog with 19 topics,
- **Help.** The **?** at the top right opens a Help dialog with 20 topics,
one per tab down the left (across the top on a narrow window), opening on
the one for where you are. It is part of the page itself, so it still reads
fully when the page has lost its program.
@@ -295,13 +296,13 @@ cannot open.
### Your role
The first control in *User Preferences* (the gear button) is **Role**:
The last control on *User Preferences*' Appearance tab (the gear button) is **Role**:
Engineer, Product lead / PM, Architect / tech lead, Designer (UX), QA / test
engineer, Engineering manager, or **Not set / none of these**, the default.
It only reorders things: the starter templates on an idea card and the starter
questions on the Ask tab. It never changes what a skill asks or does. It is
kept in `looks.json` with your colors, so it follows you into every session,
and **Back to default** sets it back to *Not set*.
and **Back to default** on that tab sets it back to *Not set*.
Until you have chosen, the dashboard shows a one-line banner at the top —
*Pick your role to get starter templates ordered for you.* — with **Set up
@@ -484,21 +485,46 @@ working in.
badge and a muted *Sent to <Skill> · <Date>* line under its text.
- **Removed only when you say.** No automatic cleanup touches it. Once the
newest file in a notebook is 30 days old or more, *User Preferences →
Cleanup* offers it as one item named after its folder's full path
System → Cleanup* offers it as one item named after its folder's full path
(*Notebook for /home/sam/code/shop*),
and deleting it removes the whole notebook, every tab's text and pictures.
### Activities
The **die** in the top bar, right of the megaphone, opens **Activities**: small
games to play while you wait, say through a long build. Two ship today,
**Snake** and **Mini golf**. With two games the window shows a picker, one
button per game, and remembers your last pick. The header shows the current
game's best, such as **Activities · Snake best: 12**, or **Snake: no best yet**.
games to play while you wait, say through a long build. Twelve ship today,
**Snake**, **Mini golf**, **Light Trails**, **Bug Hunt**, **Sunset Drive**, **Stack Deploy**, **Bumper Ring**, **Rapids Run**, **Hot Potato**, **Crossing Rush**, **Bounce Road** and **Ghoul Rush**. The window opens on a
**picker**: a card per game with a small cover scene, a line about it, its best
score, and a **Last played** tag on the one you played last, which also has the
focus. Click a card (or walk the cards with the arrows and press space or
Enter) to open its game, and **All games** at the bottom left goes back to the
picker. One game plays at a time: going back keeps a round paused on its card
(**Round paused, score 14**), reopening the window goes straight back into a
paused round, and picking a different game ends it. While a game is on screen,
the header shows its best, such as **Activities · Snake best: 12**, or
**Snake: no best yet**.
Every game has its own soundscape, all made in the browser with no audio
files: engines that rev and shift gears with your speed, outboard motors,
rivers, wind, light-cycle drones and the moans of nearby monsters run for as long as
the moment lasts, and crashes, splashes, explosions, pickups, combos, bosses,
new bests and game over each get a sound of their own. A game can play
chiptune music too, made the same way, which builds as play heats up (Sunset
Drive has a song for each road, Ghoul Rush a track for each room, played at
one steady level and fuller in a boss fight): turn on **Play game music** in **User Preferences → Sounds &
activities** (it starts off). **Play game sounds** there turns the games'
sounds (the 3, 2, 1 and the new-best burst included) and their music on or
off and leaves the page's own cues alone; the **Play sounds** switch above it
silences all of it, and a paused or closed game goes quiet at once. A game
with music has its own **Music** slider beside **Full screen**, which sets that
game's music volume and is remembered per game (Sunset Drive starts at 70,
Ghoul Rush at 65).
- **Snake** speeds up as it grows: 120 ms a step at its starting three cells,
4 ms quicker for each cell beyond, never under 60 ms, and 3% quicker again
for each level. Every 5 foods is a new level, and the first few each bring
for each level. Every 5 foods is a new level, which opens with Slow-mo on
for its full 7 seconds (Slow-mo eases back to the usual pace over its last
2.5 seconds, so its end is never a jolt), and the first few each bring
something new: **Rocks** at level 2 (a cell flashes before it turns to
stone, and never right ahead of the head), **Mystery boxes** at 3,
**Portals** at 4, **Comets** at 5 (into the head is a crash, through the
@@ -518,24 +544,36 @@ game's best, such as **Activities · Snake best: 12**, or **Snake: no best yet**
cells away, rests two steps between hops and tires after seven, so corner it
or wear it out for 6 points a level before it runs off after 12 seconds. Food eaten within 2.6 seconds of the last builds a
combo (x2 up to x5). Power-ups turn up every few seconds and fade if left: **Shield**
(takes one crash: wraps through a wall, smashes a rock), **Turbo** (faster,
double points), **Slow-mo**, **Magnet** (food slides toward you),
(takes one crash: wraps through a wall, smashes a rock), **Slow-mo**, **Magnet** (food slides toward you),
**Ghost** (walls wrap) and **Scissors** (half the tail, a point per cell
cut). A mystery box holds one of ten surprises: Jackpot, Gold rush, Earthquake,
Meteor shower, Mirror world (flipped keys), Lights out, Disco fever (triple
cut). A mystery box holds one of nine surprises: Jackpot, Gold rush, Earthquake,
Meteor shower, Lights out, Disco fever (triple
points), Big snack, Incoming! (a comet) and Treasure. Passing your best
mid-round plays a fanfare. A power-up, surprise or level banner opens on
the half of the board away from the snake's head, and fades almost clear
while the head is under it or heading into it, so it never hides what you
are about to hit. The start and end screens show how many of the 24
are about to hit. The start and end screens show how many of the 22
power-ups, surprises, levels and specials you have ever found, and what to look for
next.
- **Mini golf** is eighteen hand-made, thoroughly silly holes seen from above.
The front nine, **Pirate Cove**, floats in a shark sea: Walk the Plank,
- **Mini golf** is six themed courses of eighteen hand-made, thoroughly silly
holes, seen from above. Its card opens a **course dashboard**: a card per
course with a picture of one of its holes, its line, its holes and par, and
your best round on it (each course keeps its own), walked by the arrows like
the picker, with **All courses** to get back. Once a round is over, space
or a click goes back to the dashboard to pick the next course. **Dino Valley** has tar pits,
geysers, raptors, a stomping T-rex and a volcano finale; **Candy Carnival**
has gumdrops, gummy bears, licorice belts, a soda whirlpool and a chocolate
fountain; **Cosmic Glow** is black-light glow golf in space, with black holes
that pull a putt in, repulsor planets, wormholes, UFOs and airlocks; and
**Frosty Peaks** glides on ice past penguins, a yeti, icicle gates and a
frozen waterfall. Two hazards are theirs: ice, where the ball barely slows,
and gravity wells, which pull it in or push it away. Pirate Cove and the
Caves of Doom are eighteen holes each too, and their first holes are these.
**Pirate Cove** floats in a shark sea: Walk the Plank,
Shipwreck Cove, Cannon Alley, Treasure Beach, Kraken's Lagoon, Ghost Ship,
The Ship's Wheel, Skull Island and Captain's Plunder, with barrels,
The Ship's Wheel, Skull Island and, at the end, Captain's Plunder, with barrels,
cannonballs, a rolling powder keg, a scuttling crab, a kraken's tentacle and a
skull you putt through. The back nine, the **Caves of Doom**, is dark but for
skull you putt through. The **Caves of Doom** are dark but for
the ball's own light and whatever glows: Into the Dark, Stalagmite Forest,
Lava Lake, Mine Cart Madness, Crystal Pinball, The Bottomless Pit, Glowworm
Grotto, Crusher Corridor and The Dragon's Hoard, with glowing pools, lava, a
@@ -544,7 +582,8 @@ game's best, such as **Activities · Snake best: 12**, or **Snake: no best yet**
and splashes, bonks and tunnels pop up a word or two. Play is quick and
arcade style: the aim follows the mouse (or hold left or right to turn it,
slowly at first, then faster), and it points back at the cup each time the
ball stops. A click or space starts the power meter beside the ball; a second
ball stops, staying there until the mouse moves a few pixels, so a click
without a move putts along the arrow you see. A click or space starts the power meter beside the ball; a second
sets the power. The needle crawls near the bottom, so soft putts are easy,
and races near the top: the gold **MAX** band just under full putts 1.15
times as hard, and the red band past it is an overswing that shanks the ball
@@ -565,21 +604,717 @@ game's best, such as **Activities · Snake best: 12**, or **Snake: no best yet**
runs, following the needle. One
is held at a time, a new pad replaces it, and a held one carries over to the
next hole.
- **Light Trails** is a race to be the last rider moving. You, with Planny's
star eye, and one to three rivals each leave a glowing wall behind; a wall, a
trail (yours too), a crystal or another rider's head is out, and a rival's
trail goes once it has faded. You get a split second of grace: about to
ride into something, you hold in place for 150 ms first, and a turn pressed
then rides out of it (the rivals get none). Arrows steer and space spends a **boost**
charge for 1.4 seconds of speed (two charges a heat, up to three). A round
is a run of heats through nine arenas, each with its own scenery: Neon Grid,
Sunset Strip, Crystal Field, Warp Zone, Storm Front, Carnival, Glacier,
Volcano and the Golden Arena. Winning a heat moves you to the next arena; a
crash costs one of your three lives and runs the heat again, and you and the
last rival out at once is a draw that costs nothing. Each arena brings
something: a second rival and **power-up pads** at 2 (**Boost**, a charge;
**Phase**, ride through trails for 3 seconds; **Eraser**, wipes the trails
around you; **Slow-mo**, the rivals crawl; coins; and from arena 4 a
**1UP**), **crystals** at 3, a third rival and a pair of **portals** at 4,
**closing walls** at 5 (from 10 seconds in, the outer ring turns to stone
every 3.5 seconds, flashing red first), and a second pair of portals at 6.
The rivals ride sharper each arena, and grab a pad if they get there first.
Points come for riding (a point a level every 6 cells), for each rival out
while you still ride (10 a level, 5 more when it hit your trail), coins and
each heat won (25 a level). The start and end screens show the furthest
arena you have reached and the next one waiting.
- **Bug Hunt** is an arcade shooter. Planny's ship slides along the bottom
(left and right move it, up and down a little too) and fires while space is
held. Each wave of bugs swoops in from the sides into a formation that sways
across the top, and every couple of seconds one or more break off and dive
at you; a bug that misses flies back in from the top. A bomb or a bug that
reaches the ship costs one of three lives, and the ship comes back after a
second, blinking and safe for a moment more. The first waves each bring a new
bug: the everyday **Bug** (wave 1), the **Beetle** (2, two shots, and it
splits into two bugs that dive on their own), the **Race condition** (3,
zigzags as it dives), the **Exception** (4, throws at you), the **Null
pointer** (6, shots pass through it while it fades) and the **Firewall** (7,
five shots, never dives). Every fifth wave is a boss with a health bar: the
**Memory Leak** (grows while you wait and sprays drops), the **Spaghetti
Monster** (shrugs off every shot until its four meatball tentacles are shot
off) and the **Heisenbug** (blurs, then turns up somewhere else, and cannot
be hit while it blurs), then round again with more health. Squashed bugs
drop coins and, now and then, a power-up: **Spread shot**, **Rapid fire**,
**Shield** (takes a hit, up to two), **Slow-mo** (the bugs and their bombs at
half speed), **Magnet** (coins come to you), **Refactor** (clears every bomb
and squashes the everyday bugs on screen) and, from wave 4, a **1UP**. Kills
within 1.2 seconds of each other build a combo up to x5. A wave cleared
scores 50 points a wave, and 100 more a wave without a hit; a boss is 500
points each time round. The board is Snake's checkerboard scrolling past,
with bits of code drifting by, and new scenery every five waves: the
Codebase, Legacy Code, Production and the Cloud. The start and end screens
show how many of the 16 bugs, bosses and power-ups you have found.
- **Sunset Drive** is a road racer against the clock, seen from behind
Planny's convertible on a road drawn a segment at a time, with bends,
hills and scenery scrolling past. Hold up to drive (five seconds to a top
speed of 150 mph), down to brake, left and right to steer; bends push the
car to their outside, and off the road it slows to a quarter of top speed.
Space burns a **nitro** can for 2.5 seconds of a higher top speed (two to
start, up to three). A round starts with 40 seconds on the clock, shown big
in the top middle (in the last ten seconds it blinks red and swells on
every tick), and each
stage ends at a **checkpoint** that adds time (31.5 seconds
at the first, a second and a half less each stage, never under 18) and
1,000 points a stage. Just before it the road **splits** around a median:
the side you keep to as it begins picks the next road (the board above the
road names both, the gentler on the left, and a postcard of each road
shows in the top corner on its side as the fork is called), and the
median is a wall that holds you to your side. Six roads, each with its own
sky, scenery, bends, hills and traffic, and its own points bonus: **Sunset
Coast** (x1, where every round starts), **Canyon Road** and **Maple
Valley** (x1.2), **Snowcap Pass** (x1.4), **Neon City** (x1.5, the
heaviest traffic) and **Starlight Highway** (x1.8). Catching up with a car
drops you below its speed, and hitting a palm, cactus, rock or other prop
on the shoulder all but stops you. Points come for every stretch of road
driven (times the road's bonus, and 10% more a stage), coins (100), a
**close call** passing a car within a lane at speed (50) and each
checkpoint; **clocks** on the road add 5 seconds. Under 10 seconds the
clock beeps each second, and at none the car coasts to a stop and the
round is over. Spinning **?** boxes on the road hold **power-ups**, queued
up to three (a box past that pays 250 points): while one is held, space
fires the oldest instead of a nitro can, and timed ones run side by side,
one fired again while it runs adding its time. **Rocket Hop** (1.6
seconds) leaps over traffic and the shoulder, **Ghost Car** (5 seconds)
drives through cars and props, **Coin Magnet** (6 seconds) pulls in every
item across the road, **Monster Truck** (5 seconds) flings the cars it
hits into the sky (150 points each) and flattens props, and **Coin Storm**
turns the traffic ahead into coins at once. The start and end screens show
how many of the six roads you have found.
- **Stack Deploy** is a one-button tower stacker. A block slides back and
forth above the tower, and space, up or a click on the board drops it where
it is drawn: the part over the block below stays, the overhang is sliced
off and tumbles away, and the next block is that much narrower. A block
that misses the tower ends the round, and the camera pulls back to show the
whole tower once. A drop within 3% of the block's width of exact (or the
distance it slides in 18 ms, whichever is more, but never more than half
the block's width) is a **Perfect**: it snaps
on with nothing sliced, the drop's thunk climbs a scale with each perfect in
a row, and every third in a row grows the block back by 8% of the base's
width, never past it. Points: 1 a floor, a perfect 2 more times the run (up
to x5), and a perfect on a **gold** block (from floor 15, about one floor in
twelve) 10 more and twice the growth. The slide speeds up 2% a floor from
floor 10, and floors bring twists: from 20 blocks come from either side and
some turn back partway, from 30 **lag spikes** freeze a block for 150 ms
before it jumps on, from 40 **wind** eases a block in and out as it swings,
from 70 blocks rush through the middle, and from 90 everything is faster.
The tower changes style as it climbs (server racks, office floors from 25,
glass towers from 50, rockets from 75) under a sky that goes from day to
dusk, night and space, and a dashed line marks the highest floor you have
ever reached, which the start screen names with the next style to reach.
- **Bumper Ring** is sumo in bumper cars on a round platform over the void,
seen from above. Held arrows push your car that way (two at once push on
the diagonal), momentum carries it, and cars bounce off each other: the one
closing faster rams and wins the exchange, and two cars leaning on each
other are a pushing match the stronger push wins. Space **dashes**, a burst
the way you push that also makes the car heavier for a moment (two charges
a heat, one back every six seconds, up to three). A car whose center goes
past the edge falls (the last few units hold it back a little, so a push
back in can save it), and the last car on the ring wins the heat. Rivals
let go and rev before they dash, which is your moment to step aside; a
rival that misses near the edge may fly off on its own. A round runs
through nine arenas: **Training Mat** (the Bully), **The Ring** (a heavy
Turtle that holds the middle, and power pads), **Bumper Alley** (the Sniper,
who lines you up against the edge, and bumpers), **Ice Rink**, **Turntable**
(the ring turns, and the Scrapper hunts whoever is nearest the edge),
**Swiss Cheese** (holes that flash, then open), **Magnet Rink** (the middle
pulls, then pushes), **Hall of Mirrors** (the Mirror copies your moves a
beat later, and the ring turns square and back, its corners flashing before
they go) and the **Grand Final**; past it, Final 2, Final 3 and on, each a
little sharper. Each arena keeps what the earlier ones brought. A win moves
you on; a fall costs one of three lives and runs the heat again, and you
and the last rival off together is a draw. After 12 seconds the ring
shrinks 3 units at a time (the band flashes red first) down to a floor, and
a heat still going after that goes to **sudden death** until two cars no
longer fit. Pads (from arena 2): **Heavy**, **Spring** (the next car you hit
goes flying), **Charge** (a dash), **Shield** (bounce back off the edge
once), **Grow**, **Ghost** (pass through cars) and **Slick** (oil behind
you); rivals can take them too. Points, each times the arena: 10 for a
knockout (the last car to touch the one that fell within two seconds gets
it, and your hit carried through another car counts as yours, as does a
rival you rammed into another), with knockouts within 3.5 seconds of each
other building a combo of up to x5 and
two within a second both counting twice; 25 for a heat won, 15 more if you
never teetered at the edge; a point a second alive; and 5 for a rival that
falls chasing you untouched. The start screen names the furthest arena you
have reached, and the end screen says when you went further.
- **Rapids Run** is a fast vertical scroller on a winding river: Planny
pilots a jet-skimmer up a river that scrolls down the board, its banks
narrowing and splitting around islands. The arrows steer, held up speeds up
(twice the points for distance, and less time to react), held down slows
and held space fires. The battery drains all the while, a little faster at
full speed: run over a green charge buoy to top it up, or shoot it for 10
points if you can spare the charge. A bank, an island, a foe, a bolt or a
flat battery costs one of three lives, and you start the stretch again
from the last dam with a full battery (once a mini-boss's basin is reached,
from the basin's mouth instead, and a dam already blasted stays open). Each stretch, about 20 to 35
seconds of river, ends at a dam across it: shoot it open to pass (it takes
more shots each stretch, so slow down for it). Eight stretches, **Willow
Run**, **Reed Bend**, **Stone Gate**, **Mill Basin**, **Fog Narrows**,
**Heron Forks**, **Copper Gorge** and **Old Lock**, then Night Water,
Night Water 2 and on, quicker. Patrol skiffs drift from bank to bank and bob mines sit
still from the start; gull drones swoop across, over land and all, from
Reed Bend, bank sentries shoot back from Stone Gate, whirlpools tug you
toward their eye from Fog Narrows and darters swerve into your lane from
Heron Forks. Every fourth dam a mini-boss holds the basin before it, the
river stopped and your battery held while you fight: **the Dredger** (a
fan of bolts), **Ironclad** (rings of bolts, then one at you) and **Old
Leviathan** (a stream that sweeps). Crates hold **Spread shot**, a
**Shield** (one crash of any kind but a flat battery), a **Magnet** (charge
buoys come to you) and a **Surge** (a full battery). Points: 1 for every 5
units of river, 2 at full speed; 5 for every quarter second you skim a
bank at speed (10 at full speed); 20 to 60 for each foe, times your combo
(sinks within 1.6 seconds of each other, up to x5); 100 times the dam's
number for each dam blasted (once each), and 50 times it more for a
stretch with no life lost; and 400 for each of the first three
mini-bosses, 800 each the next time around and so on, each of which also
gives a life back. The
score shows big at the end, and the start and end screens show the
furthest dam you have blasted.
- **Hot Potato** is arena tag with a fizzing bomb: a merge conflict, its
`<<<<<<<` markers showing. Held arrows run (light momentum, quick to start
and stop), and whoever holds the bomb runs 1.12 times as fast and passes it
on by touching a runner who holds none. The one just handed it cannot pass
it for 0.6 seconds (it flashes white), and while three or more are left
nobody can hand it straight back to the one who just passed it for 3
seconds (a white ring at their feet shows who is safe). A pass never
leaves its new holder less than 1.4 seconds of fuse (the 0.6 it cannot
pass in, and 0.8 to reach someone): a fuse handed over lower is topped up
to that, on a rival's pass too, once a fuse for each runner. Space dashes: a lunge while you hold it, a dodge while you do not
(two charges, one back every 4 seconds). The fuse starts at 12 seconds,
ticking quicker as it burns, and each fuse after it in a match is 1.5
seconds shorter, down to 5; whoever holds the bomb at zero is blown out,
and after a moment the bomb lights again on a survivor picked at random. A
match's first fuse never starts on you. The last one standing wins the match
and moves on a venue; blown up, you lose one of three lives and the match
runs again. Nine venues: **Break Room** (the Sprinter, fast but turning
wide, the Hider, who lurks behind cover and is slow in the open, and the
Trickster, who feints before it dashes), **Open Plan** (pickups),
**Server Room** (long rows of racks, and the Pal, who sticks by you),
**Rooftop** (no wall at the bottom: off it is out, and a holder that goes
over takes the bomb with it), **Ice Machine** (slippery patches, and the
Clingy, who hangs just behind the holder), **Conveyor Hall** (belts),
**Blackout** (you see only round yourself, the bombs and the pickups),
**Two Bombs** (two fuses at once, never more than one bomb for every two
runners left) and the **Finale** (shorter fuses, 10 seconds down to 4, ice,
belts and two bombs); past it, Finale 2, Finale 3 and on, each a little
sharper. Rivals get sharper and quicker as you go, crouch before a lunge
(your moment to dodge), and may dodge yours. Pickups (from venue 2, one at
a time): **Freeze** (every fuse stops for 2 seconds), **Sneakers** (1.3
times as fast for 3 seconds), **Extra Fuse** (2 seconds more on every fuse)
and **Swap** (trade places with a random runner; a holder keeps the bomb).
Points: 10 times the venue for every fuse that ends on someone else (blown
up, or off the roof with it), 2 for each pass you make, 15 more for a hot
pass (under a second left) times your streak of hot passes in a row (up to
x5; a pass that is not hot ends it, and so does a life lost), and 50 times
the venue for a match won. The start and end screens show the furthest
venue you have reached.
- **Crossing Rush** is a lane-crossing race: Planny and two rival hoppers
hop up a strip of lanes eleven cells wide and 30 to 40 rows tall (the view
follows you, and a race bar beside it shows everyone's height), a cell a
hop (an arrow a hop, 0.12 seconds, with one more press queued). Roads of
cars, vans and trucks; rivers of logs and turtles, which you stand on and
ride (the water, or riding off the edge, is a send-back); train tracks
whose lane flashes red with a bell for 1.2 seconds before a train fills it;
and grass rows with bushes and rocks you cannot hop into. A car, a train or
the water sends you back to the last grass row in a spin, never out, where
you stand dazed for 2 seconds (stars round your head) before you may hop
again; rivals sent back are dazed the same. First to the top wins the heat and
moves on a zone; second or third costs one of three lives and runs the
same heat again (same lanes), except that in zones 1 and 2 second place
still gets through. Nine zones, each bringing something new: **Side
Street** (roads, the Hopper, who waits for a clear gap, and the Daredevil,
who takes the tight ones), **Riverside** (logs), **Rail Yard** (trains),
**Turtle Bay** (turtles that dive now and then; the divers wear a red
mark), **Highway** (trucks, lanes that speed up and slow down, and the
Bruiser, quick and pushy through tight gaps), **Night Market** (a dusk,
every lane still in view, brightened by headlights, lanterns and a glow
round each hopper),
**Rapids** (rivers that turn round, with arrows that blink first, and the
Tagalong, who follows a row behind you, then races you to the top), **Ice
Road** (icy lanes that slide you a cell further) and **Rush Hour**
(everything, tighter gaps); past it, Rush Hour 2, 3 and on, quicker each
time. Rivals get sharper as you go: they look further ahead and wait less
after each hop. Pickups (four to six a heat, on the grass): a **Coin** scores
10 points at once, and a **Spring**, **Shield** or **Horn** goes on your
stack, shown in the pills as the next one space uses and how many wait
behind it. Space uses the oldest: **Spring** leaps two cells the way you
face, over whatever is in between (it stays on the stack when that cell is
shut), **Shield** lets cars and trains pass through you for 3 seconds, and
**Horn** stops the nearest road for 1.5 seconds, for everyone. Pressed
mid-hop, it goes off as you land. The stack empties at every new heat, and
a rival uses a pickup the moment it lands on it. Points: 1 for each row
higher than you had got in the heat, 50 times the zone for a heat won,
times your streak of clean wins (a win where you were never sent back adds
one, up to x3; any other win, a second place or a lost heat ends it), plus
3 for each row the runner-up still had to go, 5 for a close call (a car or a train
through the cell you just left within a tenth of a second) and 10 for a
coin. Planny's star is your highlight color, and a rival whose color sits
too close to it wears a spare one. The start and end screens show the
furthest zone you have reached.
- **Bounce Road** is a fast scrolling road seen from above: Planny races a
springy toy car up a road laid across a giant's house and yard, with
rival toy cars on it that mean to stop him. Hold up to drive, down to brake
(a toy car never quite stops), the arrows to steer (a little less in the
air) and space to jump, once a press; a jump needs a little speed and goes
further the faster you are, and a ramp launches you on its own. Bump a
rival sideways and it slides: one that leaves the road within 1.5 seconds
of your bump is yours. Land on one and it is flattened while you bounce up
again; land on another before your wheels touch the road and the **bounce
chain** climbs, up to x8. Every stunt in quick succession (a crush, a
bump-off, a hole, train, ball or barrier jumped, a ramp's big air, a close
shave past a rival, a boost strip) steps the **combo**, which multiplies
the points once more every third stunt in a row, up to x4, and runs out
after 2.6 seconds without one. Water or a hole under your wheels, a crash
(a flowerbed or a toy block nose first, a train, a truck's back) or
anything landing on you (a ring on the road shows where) costs one of three
lives, and you go back a little before the spot, with room to get up to
speed. Ten stages of 25 to 45 seconds each, every one bringing something
new: **Chalk Lane** (cracks, boost strips, cones), **Hose Creek** (broken
bridges, a sprinkler, the Frog), **Kitchen Floor** (oil slicks, a rolling
orange, the Sneak, who drops cones), **Flowerbed Fork** (splits, ramps,
falling flowerpots, the Nudge), **Sandbox Run** (road that crumbles behind
you, the Hauler, the Bruiser), **Toy Room** (a toy train crossing, toy-block
chicanes, the Racer), **Garden Pond** (swaying bridges, drawbridges, the
Cop), **Rooftop Gutter** (gusts), **Night Lights** (everything, in the dark)
and **Monster Mash**, where the Monster truck hops at you and must be
stomped five times; then the road goes round again from Kitchen Floor,
quicker and meaner. The rivals get keener every stage: they block your
line, brake in front of you, swerve from under your landings, hop the gaps
and keep the pack close. Every hole has a warning sign and a straight
run-up, and can be cleared at 80% of the top speed. Power-ups lie on the
road from Hose Creek: **Spring**, **Bubble** (one free save), **Nitro** and
**Mega wheels** (bigger and heavier: flatten whatever you touch). Points
come from new road, rivals flattened (each kind its own, times the chain)
and bumped off, jumps, big air, close shaves, stars and boost strips (times
the combo), the Monster (2,000 for beating it), and each stage line (100
times the stage, a bonus for beating its par time, and with no life lost
250 more and a life back, up to five). Planny's car is your highlight
color, and a rival whose color sits too close to it wears a spare one. The
start and end screens show the furthest stage you have reached.
- **Ghoul Rush** is a fast, dark run-and-gun through a haunted house:
Planny sprints left to right through a mansion a room at a time, the view
scrolling with him. The house is pitch dark: you see what his glow, his
flashlight's cone, the candles, the moonlight and the muzzle flash light,
plus the eyes of whatever is waiting in the dark, and now and then
lightning lights the whole room for a moment. Hold left or right to run,
press up to jump (let go early for a short hop), down to drop through a
shelf or, on the ground, to duck (a crow, bat, gargoyle or other swooper
passes over your head if you are down before it reaches you), and hold space to fire his flashlight blaster the way he faces, ten
bolts a second; a bolt tilts toward a monster ahead near his height (and
toward a hovering wraith anywhere the tilt reaches). The blaster heats up
as it fires: about three seconds go at the full rate, then each bolt waits
longer, down to one a second (holding fire or hammering space heats it the
same). A **LIGHT** gauge at the right of the HUD shows it: the bar fills
as the blaster heats and empties as it cools, notched where the bolts
start to slow, pale, then amber near the notch, then red and **HOT** past
it. Let
go of fire and, after a fifth of a second, it cools, the hottest blaster
in about two seconds. Rapid fire's bolts add no heat and ignore it. **Tap
space twice** to use a **secondary weapon** you have picked up, shown by
a glowing icon and count beside the LIGHT gauge and by the same icon over
Planny's head; keep holding after the second
tap and the bolts carry on. The first tap still fires a bolt, feathering
the blaster never throws anything, and hammering space spends one at
most. The weapon you picked up last comes out first, you keep the rest
from room to room and through a lost life, and no weapon ever hurts you.
**Dynamite** (a wide blast on a short fuse), the **Iron Stake** (goes
through a whole line) and the **Bottle Rocket** (three at once: one
ahead, one that climbs and curves down onto the nearest monster above or
ahead, one behind, each going off in a blast with a trail of colored
sparks) turn up anywhere. Each stage has one of its own:
the Manor's **Billiard Ball** (rolls along the floor), the East Wing's
**Cast-Iron Skillet** (three pans circle you, then spiral off screen, each one-shotting what it touches and breaking on it), the
Graveyard's **Grave Salt** (burns the floor, even what is still buried),
the Grounds' **Hedge Sickle** (out and back, hitting on both passes), the
Chapel's **Tuning Fork** (a ring that cracks stone and strikes organ
pipes), the Sanatorium's **Flash Powder** (dazes what is near and shows
what hides), the Village's **Silver Bear Trap** (five a use: two behind, one at your feet and two ahead, each
snapping on the first thing to step in it) and the Mine's Dynamite, by the
bundle. A boss can take only so much from them (about a third of its
health at full force, then next to nothing), so they help a lot without
winning the fight, and one at half health drops its stage's weapon if your
bag is empty. Each room's door opens
once you grab its key, often up on a shelf. A run starts in **the Long
Hall**, an easy walk with only zombies, then goes **stage** by stage:
three rooms, then a boss, and beating it opens the door. Out of the hall
and out of each boss's room you **choose the next stage** from two
(one, once a single stage is left) never played that run, each card
showing the stage with its boss standing in it: left and right pick one
out, space or up goes in. Clear every stage and you **escape**, a win.
Each stage cleared makes the next quicker and tougher. Every other room keeps a **horde**
pouring in from the edges of the view, mostly ahead, so standing still is
never safe. **Zombies** shamble out of doors in the wall and sprint once
you are close, **crawlers** drag themselves up through loose boards,
**bats** swoop in level passes at your chest, **ghosts** drift through
walls and can only be hit (or hurt you) while solid, **skeletons** throw
bones you can shoot down, **hellhounds** crouch growling, then lunge in a
low arc a jump clears, **widows** hang from the ceiling and drop on you as
you pass under, **wraiths** hover ahead, shriek and dive at where you were
(keep moving, or shoot them first), and **bloaters** lob acid that leaves
burning puddles and burst into more acid when they die. Now and then a
zombie comes as a **runner** (fast, down in one bolt) or a **glutton**
(slow, 15 bolts to kill, a stomp only bruises it, and it never leaps or
climbs), and a widow or a hellhound as a **huntsman**, a big spider on the
floor that crouches and springs at you as high as you are. A shot to the head
or a stomp from above doubles a kill, and each kill within 1.2 seconds of
the last steps the chain, which multiplies kills up to x10. The rooms bring
pits, one-way shelves, crumbling boards and falling chandeliers that crush
whatever is below (a monster crushed counts double). Five stages so
far: **the Manor**, the **Foyer**, the **Portrait Gallery**, the **Library**, the **Ballroom**
(the **Rotting Gourd**, a giant rotten pumpkin that picks one of three
moves at random, never one three times running: a hop to where you stood,
its shadow showing where, that shakes loose gourdlings; a spit of two
acid globs after a shake; or a quake straight up and down that sends a
shockwave along the floor both ways). Its arena is stacked with balconies
in three tiers: up on one over its head it only spits at you, never hops,
a corner always leaves a pocket its hop cannot land on, and its gourdlings
jump up onto balconies after you and run off their ends to follow you
down), **the East Wing**, the
**Kitchen**, the **Conservatory**, the **Attic** and the **Crypt** (**Old
Rattlebones**, who throws volleys of five bones, slams shockwaves along
the floor you jump and throws his own skull like a boomerang, level at your
chest and back again, so jump it going and coming; headless meanwhile, he
has no weak spot, but a bolt to the flying skull does triple. His skull on
his shoulders takes double. At half his hp he shakes, his eyes flare and he
fights faster: his slams come in a double, he hurls bones up that come down
around you on shadows, and he raises up to two skeletons out of the floor),
and **the Graveyard**, out
under the night sky: the **Lychgate**, **Open Graves**, **Mausoleum Row**
and **Angel's Rest**. Its monsters are its own: **grasping hands** that lie
unseen under the dirt, burst up as you pass and creep along under the
ground after you; **mourners** whose wail slows you to half speed for a
moment if you are close; **grave robbers** who dig in and come up behind
you; **rotters**, zombies whose legs keep walking after you if you shoot
them down at the body (a headshot or a stomp finishes them); **carrion
crows** that wait on the headstones and dive at you; and rotters climbing
out of open graves. Its boss is **Mother Mourning**, a giant weeping angel:
while she weeps she is stone (your bolts glance off) and flings headstones,
then she turns and watches, and only then can she be hurt, but anything
but standing still while she watches brings a stone fist down where you
are, its shadow first. She does not stay where she was: each time she turns
back to watch she has blinked a few steps nearer, in a puff of stone dust.
At half her health she spreads her wings: a shorter weep, two headstones at
a time, a shockwave each way as each weep begins, and while she watches a
stone fist also falls near you now and then, moving or not.
A fourth stage, **the Grounds**, is the gardens under the night sky: the
**Hedge Maze**, the **Topiary Garden**, the **Gazebo** and the
**Groundskeeper's Yard**. Its monsters: **topiary beasts**, hedges clipped
into animals that stand frozen while you face them and charge the moment
your back is turned (so you can only shoot one while it is still);
**rootlings**, a crack that runs along under the lawn after you, stops
to warn, then bursts up as a solid root that hurts until it sinks again;
**lantern moths**, which come in flocks of three and flutter at you,
quicker in the dark and straighter still while you hold the Lantern; and
**mulch crawlers**, which wait in a leaf pile and burst out as you come
near. Its power-up is the **Hedge shears** (10 seconds, found only here):
one bolt cuts down a topiary beast or a rootling outright. Its boss is
**the Groundskeeper**. Jump his scythe as its low wave sweeps along the
floor, but when he raises it high (a pale band hangs in the air in front
of him) stay on the ground and let the high sweep pass over you; shoot the
lantern at his belt while it flares open (it takes triple damage, but only
then, and only briefly: after the scythe and again when the mower stalls);
jump or stand clear of the fire he lobs where you stand, which burns the
floor for a few seconds. At half his health he climbs onto a rusted mower:
when he revs, get up high on a shelf before he charges across the
arena (the charges come a little oftener), then shoot the lantern while he
is stalled against the far wall. On the mower he lobs a second fire where
you are heading, and each time the lantern opens a few lantern moths
flutter in toward it.
A fifth stage, **the Chapel**, is indoors again, candlelit stone and
stained glass: the **Nave**, the **Bell Tower**, the **Organ Loft** and
**the Choir**. Its monsters: **gargoyles**, stone on their ledges (your
shots glance off and a stomp does nothing) until you pass under one, when
it shakes loose, dives at your chest and flies back to turn to stone
again; **choir ghosts**, which drift at you and sing now and then, and
while they sing every monster near them moves faster, so kill them first;
**censer monks**, who walk at you, swing their censers and leave clouds of
harmless smoke that hide what is inside; and **bell bats**, asleep in the
bells until the bell tolls. The **bell toll** is the stage's twist: in the
tower and the choir the bell swings in view, then tolls, and for one
second everything freezes, you included (a bolt already flying still
hits), while a flock of bats bursts from every bell in view. Its power-up
is **Holy Water** (10 seconds, found only here): your bolts splash,
hurting every monster close to what they hit, hurting ghosts twice as much
and breaking a stone gargoyle even on its ledge. Its boss is **the
Choirmaster**, at his organ. Silence the four pipes to open him: each pipe
takes a handful of bolts, a sounding pipe spews a ghost now and then, and
while any pipe sounds he cannot be hurt. Once all four are silent, shoot
him. Between those he raises his baton and a column of notes flies at you
along the lines of a staff with one gap in it: mind the gap in each column
and be at its height (the floor or one of the boards) as it passes. At
half his health the hymn quickens: the notes fly faster, now and then a
second column follows close behind, and the pipes come back one by one,
each sounding again in turn.
A sixth stage, **Blackmoor Sanatorium**, is a derelict asylum of cracked
green tile: **Admissions**, the **Hydrotherapy Baths**, the **Surgical
Theater** and **the Night Ward**. Its monsters: **orderlies**, huge and
slow, which reach for you when you come close (jump clear while they wind
up), grab you and throw you a long way back (the throw costs no life, but
mind where you land); **gurneys**, solid enough to stand on while parked,
which rattle and roll at you when you come along their floor and hurt only
while rolling; **flickers**, gaunt patients you can neither see nor hit
while the lamps are lit, which lunge at you in the dark; and **specimen
bloaters**, which lob jars that shatter into puddles of formaldehyde. The
**flicker** is the stage's twist: in the baths and the theater the lamps
stutter, then go out for a moment, and in that blackout you see little
beyond your own glow. It has two power-ups found only here (10 seconds
each): **Smelling Salts** (you break an orderly's grab at once, and keep a
wide glow through a blackout, in which flickers show and take double
damage) and the **Bone Saw** (your bolts pierce every monster in a line,
and a gurney breaks in one hit). Its boss is **the Night Matron**. Stay out
of her lantern's beam as it sweeps the ward: a moment in it costs a life,
so hide behind a medicine cabinet or climb above it. Between sweeps she
throws fans of syringes, and cracks of light in a wall warn of a long arm
about to reach across the room at your height. At half her health the ward
goes dark, her lantern the only light, her arms come from both walls at
once and her fans of syringes grow.
A seventh stage, **Hollow End Village**, is out under the night sky again
(all but its inn): **Main Street**, **the Crooked Inn**, **the Town
Square** and **the Village Green**. The **moonrise** is the stage's twist:
in each room the moon climbs the sky, and when it is full every villager
in view turns into a fast, leaping wolf-man and the moonhounds grow, so
clear the villagers before the moon is up. Its monsters: the **torch mob**,
villagers who come in threes and lob torches that leave fire on the
ground; **hanged men**, swaying on their ropes until you pass under, when
they drop to head height and haul back up; **shutter ghouls**, which rattle
their shutters as you come near, then lunge out of the window (shoot them
while they are out); and **moonhounds**, which leap at you like
hellhounds. Its power-up is **Wolfsbane** (10 seconds, found only here):
wolf-men and moonhounds shy away from you, and your bolts do them and the
Beast double damage. Its boss is **the Beast of Hollow End**, a werewolf.
It bounds onto the walls at either end of the green and clings there a
moment, the time to shoot it for double damage, then pounces where you
stand (watch the shadow on the grass); up close it swipes, and its howl
calls moonhounds. At half its health the moon comes full: it waits less,
pounces twice in a row, and its howl calls grown hounds.
An eighth stage, **the Deep Seam Mine**, goes underground, where every room
is always dark: **the Mine Shaft** (ride the cage lifts up and down),
**the Flooded Tunnels** (knee-deep water slows you and your steps splash),
**the Collapse**, **the Runaway Cart** and **the Mother Seam**. **Rockfall** is the stage's
twist: dust trickling from the ceiling warns of a rock about to drop, which
crushes whatever is under it, you included. Its monsters: **Knocker imps**,
small and quick, whose touch steals your light (your glow shrinks to a
sliver for a few seconds, but no life is lost; shoot the imp to get it
back); **canary ghosts**, harmless to touch, but their scream brings three
rocks down around you, so shoot them first; **dead miners**, who burst out
of the walls with their helmet lamps still lit and swing a pickaxe up
close; and **blind crawlers**, which hunt by sound: stand still without
firing for a moment and they lose you. It has two power-ups found only
here: the **Hard Hat** (worn on your head until it is used, like the
Garlic shield: one rock bounces off it, or an imp knocks it off instead of
stealing your light) and bundles of **Dynamite** (three sticks here,
thrown with a double tap like any secondary weapon). Its boss is **the
Tommyknocker**, a miner-giant with a sledgehammer. He knocks on the rock
to bring the ceiling down, sweeps his hammer low along the floor (jump
it), and puts out the lights: in the dark an imp carries his lantern as a
decoy, so follow the knocking instead, and when he bursts out of the floor
he is dazed for a moment and takes double damage. At half his health the
dark lasts longer, his knocks come quicker and imps join in.
**The Runaway Cart** is a ride, not a walk: Planny rides a mine cart down a
roller coaster of track over the chasm and the cart does the moving. It
rolls on its own, quicker down a slope and slower up one; right leans
forward, left brakes, up jumps (left and right steer in the air) and down
ducks. Jump the gaps, the heaps of rubble and the crates (or shoot a crate
twice), duck the low beams, pick the right line where the track splits, and
do not brake for long: a boulder rolls up behind (and once it surges, hold
right to stay ahead of it). It is a **bonus round**: a long, fast ride (about
a minute) played for five hearts of its own, so a hit, a fall off the track
or a flattening costs a bonus heart, never a life, and you come back at the
last checkpoint. Lose all five and the round ends with nothing and the run
goes on to the Seam; get to the buffer stop and the door opens, and you earn
Lucky Dice (three at least, up to nine for hearts left, obstacles passed
untouched, crates broken and monsters shot, and not braking much).
A ninth stage, **the Midnight Carnival**, is a fairground at night:
**the Midway** (booths and counters to hop along), **the Hall of Mirrors**
(indoors), **the Funhouse** (its floors are conveyor belts that carry you
along while you stand on them, slower than you can run) and **the Big Top**.
Its monsters: **grinners**, clowns that honk out a balloon that drifts at
you at chest height (shoot it or it pops by itself, and it leaves a puddle
of acid for a couple of seconds; one on you costs a life, and ducking lets it
float over); **marionettes**, which hang just over your head and drop when
you pass under them (a bolt over its head, on the string, kills one at once,
else it takes four hits); **Mirror You**, which steps out of a mirror,
copies your moves the other way half a second late, and fires a bolt for
every bolt you fire (its bolts and yours cancel when they meet, so fire and
then move); **strongmen**, slow and huge, who lob barbells in an arc (a
stomp hurts one); and **circus hounds**, which crouch while a hoop of fire
flares and then leap, coming down where you stand (a ducked Planny is
passed over). It has two things found only here: **Cotton Candy** (10
seconds of sticky bolts that slow what they hit) and the **Custard Pie**
(thrown with a double tap in an arc, it splats and leaves everything near
stunned for three seconds; a pied Mirror You copies nothing meanwhile). Its
boss is **the Ringmaster**, on a gantry high over the ring, working a
giant puppet that hangs on three strings and stalks you round the ring: it
leaps to where you stood (watch the shadow, then jump the shockwaves),
charges along the floor to the wall (jump it) and stomps. Shoot the strings,
not the puppet: they follow it and slant as it moves, and from a trapeze
board or in a jump a bolt that crosses a string cuts into it, and
when all three are cut the puppet collapses and the Ringmaster is left
open on the floor for four seconds, the only time he can be hurt. Then he
climbs back and ties the strings again. Now and then he cracks his whip
along the floor at chest height (duck it, or jump it). At half his health the
cages in the wings open and hounds come out, and the strings take more hits.
Between the Funhouse and the Big Top is a second **bonus round**, **the Dark
Ride**: a side-view shooting gallery on rails where Planny sits in a ghost-train
car and twelve rooms of animatronics go wrong (a wax museum, a torture chamber
with the Executioner, a carousel, a hall of mirrors where only the solid ghoul
is real, a tunnel of love with the Black Swan, the Widow's nest, a lift hill, a
burning big top, a fake Exit, the Dark and the Barker), about a minute and a
half. Its title screen waits for a key or a click, and tips you to use the
mouse and to duck by moving your aim below the dashed line. Nothing walks: the **arrows** move an aiming reticle (it speeds up the longer
you hold), **Space** fires (hold to keep firing), and with the **mouse** you
move to aim and click or hold to fire. Pull the reticle down into the car,
below the dashed line, and Planny ducks (he cannot fire while ducked): the
answer to swinging blades, falling chandeliers and the big swings. Shoot
what lights up, chains and webs, and never the green-heart guests or a
mirror's reflections; a shot that just misses still finds a target close
to the reticle (never a guest). You have five hearts of your own and a
hit leaves you safe for a couple of seconds; killing a mini-boss gives one
back. Lose all five and the bonus ends with no dice and the run goes on to the
Big Top, its lives untouched; reach the end alive and you earn five to nine
Lucky Dice by how well you did (the dice pop out in a cascade).
A tenth and last stage, **the Frozen Lake**, is a frozen lake at night under
falling snow: **the Ice Fishing Huts** (open ice with holes in it), **the
Snowbound Lodge** (indoors, a hall the roof fell into), **the Black Ice**
(the longest room, ice nearly everywhere) and **the Widow's Web**. Between
the Black Ice and the Widow is a third **bonus round**, **the Coffin Sled**.
Two rules are its own and work in any room that sets them. **Ice** is
slippery: on it Planny's run eases up and eases off, so he slides a dozen
units past where you let go, a jump keeps the speed you had, and he stops
dead at the ice's edge. **Thin ice** is a tile that shows a crack when you
stand on it, breaks a moment later (the floor is a gap, and if you are on it
a life is lost: "went through the ice") and freezes again after a few
seconds; step off in time and it heals. Its monsters: **under-ice hands**,
which trail you beneath the ice, crack a thin tile under you or burst up and
grab (shoot or stomp one); **snow shades**, which you see only by their
footprints until one winds up or a bolt of yours passes near it, so shoot at
the prints; **frozen ghouls**, zombies that slide on ice and shatter when
they die into three shards (two run along the floor, jump them, and one flies
at head height, duck it); and **ice wraiths**, whose dive freezes you for
most of a second if it passes close (one dives at a time). Two things are
found only here: **Hot Cocoa** (10 seconds of no sliding, no freezing and
thin ice that cracks at half the speed) and the **Road Flare** (thrown with
a double tap in an arc, it lands and burns a patch for four seconds: it burns
what walks in without leaving drops, melts a Frozen Ghoul at once with no
shards, lights up a shade, and never hurts you). Its boss is **the Frost
Widow**, who hangs from the roof, drops to the floor and walks at you
behind a veil of ice that guards her. Kick or shoot the burning barrels at
her to melt the veil (a flare does it too); then, with her low, any shot
hurts and the heart takes triple while her mouth is open. A blizzard now and
then pushes you away from her (a barrel in between breaks the wind), ice
spikes rise from the floor where you stand (the line cracks first; a board
of 18 is over them), her web slows you while you are in it, and at half her
health the barrels are set out again and ice wraiths join in. **The Coffin
Sled** is a ride down a long frozen cemetery hill on a coffin lid, about a
minute and a half: the sled speeds up on the downs and slows on the ups on
its own, so you only jump (cracks in the ice, headstones, snowdrifts, hands),
duck (low branches and tombstone arches) and shoot (icicles, popping ghouls
and hands). It plays for five hearts of its own, so a hit costs a heart,
never a life, and a fall into a crack puts you back on the ice ahead. Lose
all five and the round ends with nothing and the run goes on to the Widow;
reach the snowbank and you earn three to nine Lucky Dice (hearts left,
obstacles passed untouched, things shot and souls and Cocoa taken).
Not every room is dark: each time you enter one it is dark three times in
five and otherwise lit, dim but seen whole (the same for the same run's
seed). In a dark room only half as many monsters come in from the edge
behind you. Power-ups lie in the rooms and now and then drop from
a kill: **Spread shot** and **Rapid fire** (eight seconds each), a **Garlic
shield** (shrugs off one hit and sees off what touched you; lose a life
within 12 seconds of coming in and you come back already holding one), a
**1UP**, a **Lucky die** (a white die, dropped by a kill as often as a
1UP and never lying in a room; every run starts with three, up to nine are kept for the whole run, shown
as a **DICE** pill, and a ninth more is points; when you would lose a life,
by any cause but the endless-lives code, one die rolls on the field (the rest
are kept). A 4, 5 or 6 brings you back where you fell, or after a pit on the
last ground you stood on, with no life lost and the room as it was: a 5 adds
a heart, a 6 a heart and a Garlic shield, and in an ordinary room every
monster in view blows apart for its points (in a boss's room nothing does).
A 3 or lower loses the life as usual: a 3 brings you back with Rapid fire and
a Garlic shield, a 2 with Bottle Rockets and a Garlic shield, and a 1 only
laughs at you, "Better Luck Next Time"; on your last heart a 2, 3 or 4 instead pays one heart, and you respawn with it as usual; every run starts with 3 dice), a
**Lantern** (15 seconds of the dark pulled far back, found only in a dark
room; in a lit one another power-up lies in its place), **Bat wings** (12
seconds of one flap in the air per jump, for a second jump; fall down a pit
with them on and they carry you back to the ground you fell from, costing no
life or die, and are used up), a **Church
bell** (4 seconds where every monster but a boss stands still and none
comes, ending at the door) and an **Hourglass** (20 more seconds on the
clock). Every room but a boss's has a **clock** (70 to 80 seconds, its
last ten ticking out loud); at none it costs a life and the room starts
over with a full clock. Two or more zombies, runners, crawlers or
gourdlings bunched under you climb over each other to reach you, arms
raised (land on the arms and they hurt you; only the head between them
takes a stomp), so a shelf over a
crowd is never a safe place to wait. The horde never ends, so its kills
(and those of the dead that come once the bonus is gone) are worth 80% of
the last one in the room, down to a tenth, and drop nothing: farming them
by the door pays next to nothing. A walker at the edge of a pit or a
drop (or a wall up to 8 high, for a zombie, runner or crawler) stops a
moment to think about it (a "?" over it), then leaps (or climbs): across
up to 10 units to floor at its own height, further down to a lower floor,
or straight down off a ledge; a wider pit or floor higher than a step
still stops it. High over each room's key
shelf (but a boss's) float **crystals** (250 points each) and in some
rooms **Silver bolts** (10 seconds of bolts that go on through every
monster they hit, found nowhere else): out of reach of one jump from
anywhere, but a jump and a **Bat wings** flap from the key shelf takes
them, and each such room has Bat wings on the way.
Points: 100 a zombie, 75 a crawler, 50 a bat, 150 a ghost or a hellhound,
120 a widow, 200 a skeleton or a wraith, 250 a bloater and 40 a gourdling,
all times the chain, 25 a bone or glob of acid shot down, 10 a soul and 50
a power-up; through a door, 300 times the room number, the time bonus left
(1500, dropping 50 a second; once it runs out, zombies come in from the
edges every second and a half) and 500 more with no life lost; 2000 for
the Gourd and 2500 for Rattlebones (90 hp), a quarter more for each stage
already cleared, with a life back up to nine. A hit or a fall costs one of seven lives and puts you back at the
room's start (in a boss fight, the arena's, the boss's hp kept), safe for
a moment, and on your last life the edges of the view pulse red. The start
and end screens show the most stages you have cleared in a run. When a
room starts again after a loss (a hit, a fall or the clock), a random
power-up shimmers a few steps ahead of Planny on every restart until you
clear the room (never a 1UP, and not in the bonus rides).
- **It never hides your turn.** A new question, a sign-off or a finish pauses
the game at once and shows a banner with **Go to it**, which closes the window
on that question. Hiding the page or clicking away from it pauses it too, and
nothing resumes by itself. Any game key (arrows, W/A/S/D, space, P) or, in
Mini golf, a click on the board plays on, and the banner stays down until the
next new question or finish.
on that question, and **Unpause game**. While that banner is up, only
**Unpause game** plays on, so a key or click you were already making cannot
wave the banner away unread. Hiding the page or clicking away from it pauses
the game too, and nothing resumes by itself. Otherwise (after **Go to it**, or
once you close and reopen the window) any game key (arrows, W/A/S/D, space,
P, Enter) or, in Mini golf or Stack Deploy, a click on the board plays on,
and the banner stays down until the next new question or finish.
- **Lives at a glance.** A game with lives shows them as a solid pink pill
with a heart per life, and its banners fade almost clear while you, or
whatever is coming at you, are under them.
- **Endless lives.** In any game with lives, type up, down, up, down, left,
right, left, right, B, A, space on the board: the lives pill turns to
"♥ x∞" and no life is lost until the round starts over (R, or a new round)
or you leave the game for the picker or close the window.
- **Stage select (Ghoul Rush).** Type up, down, up, down, left, right, left,
right, S on Ghoul Rush's board for a practice round that opens on its stage
select: up and down pick a stage, left and right one of its rooms (the last
is the boss's), space goes straight in. A practice run keeps no best score
and no record, and starts with a full stock of that stage's weapon and the
common ones. Endless lives typed before it carry over; typed after, they
last for the run as usual.
- **A countdown first.** Every game counts down 3, 2, 1 before a round starts
and before it plays on after a pause, so nothing moves before you are ready.
P or Esc during the count pauses again.
- **Keys.** Arrows or W/A/S/D steer, space starts and plays, P pauses, Esc
closes the window with the game paused. A page with no mouse or trackpad
- **Keys.** Arrows or W/A/S/D steer, space starts and plays (and boosts in
Light Trails, fires while held in Bug Hunt, burns nitro in Sunset Drive,
where held up drives and held down brakes, drops the block in Stack Deploy, dashes in Bumper Ring, where held arrows push, fires while held in Rapids Run, where held up speeds up and held down slows, dashes in Hot Potato, where held arrows run, uses the oldest pickup in Crossing Rush, where an arrow hops once a press, jumps once a press in Bounce Road, where held up drives and held down brakes, and fires while held in Ghoul Rush, where held arrows run, up jumps once a press and down drops through a shelf), P pauses, R starts the round over (from the 3, 2, 1), F (or **Full screen** under the board) gives the game the whole screen and F or Esc puts it back, and Esc closes the window with the game paused. In full screen the board takes the whole screen, as big as its shape allows, with black bars where the shape leaves room, and a panel (the game's name, the score line, the game's **Music** slider for a game with music, Exit full screen) is laid over it: docked in the side bar when that bar is at least 220 px wide, in the bottom bar on a tall screen when that is at least 110 px tall, and otherwise floating in the top right corner (Sunset Drive's 16:9 board on a 16:9 screen), where it shrinks to the score line in the bottom right corner while a round plays and the pointer is still. The board never gives up room for the panel. The pointer hides after two still seconds. In the desktop app the page asks the app (`activities-full`) to lay the console over its bar and terminal and put the window in full screen, since the app's frame allows the page no full screen of its own. A question, a sign-off or a finish takes a full-screen game back to the window's own size as it pauses it. A page with no mouse or trackpad
(touch only) shows "Activities need a keyboard." in place of the board.
- **Best scores** show beside the score while you play and after each round.
Snake keeps its highest score. Mini golf keeps its lowest full round, and a
half-played round never counts. **Reset best scores** clears them after a
Snake, Light Trails, Bug Hunt, Sunset Drive, Stack Deploy, Bumper Ring, Rapids Run, Hot Potato, Crossing Rush, Bounce Road and Ghoul Rush keep their highest score. Mini golf keeps its lowest
full round on each course, every course on its own, and a half-played round never counts. **Reset best scores** clears them after a
second click to confirm.
The line under the board is a pair of colored chips, Score and Best, with a
meter between them filling toward the best (for a game where the highest
@@ -588,8 +1323,8 @@ game's best, such as **Activities · Snake best: 12**, or **Snake: no best yet**
that beats a saved best ends with **New best!** on the end screen, and Mini
golf, which only knows at the end, fires its sparks then. Reduced motion keeps
the colors and drops the movement.
- **Private.** Best scores, Snake's surprises found, the last pick and the **Show Activities** switch
(User Preferences, which hides the die everywhere) are saved in
- **Private.** Best scores, Snake's surprises found, Light Trails' furthest arena, Bug Hunt's finds, Sunset Drive's roads found, Stack Deploy's highest floor, Bumper Ring's furthest arena, Rapids Run's furthest dam, Hot Potato's furthest venue, Crossing Rush's furthest zone, Bounce Road's furthest stage, the most Ghoul Rush stages cleared in a run, the last pick and the **Show Activities** switch
(User Preferences → Sounds & activities, which hides the die everywhere) are saved in
`~/.plan2code/console/looks.json`. Nothing about Activities reaches the agent
or the session.
@@ -777,8 +1512,8 @@ send never holds up a question.
- **Pictures.** The same as notes: the button, paste, or drag and drop, up to 5
per question.
- **Ten questions per conversation.** The `N of 10` counter is always in view.
After the tenth is answered, **New conversation** starts a clean one. So does
switching skills through the dashboard.
After the tenth is answered, **New conversation** starts a clean one.
Switching skills through the dashboard keeps the conversation going.
- **Edits need your approval.** Ask for a change to a file and the agent
replies with a summary and the list of files it would touch, with
**Approve** and **Decline**. Nothing changes until you approve. Afterwards
@@ -826,24 +1561,44 @@ links to the Releases page.
| In the Ask box: `Enter` / `Ctrl` + `Enter` (`⌘` + `Enter`) | `Enter` is a new line; `Ctrl` + `Enter` sends the quick question, never the cards |
| `Esc` | Closes whichever dialog is open; on the dashboard, backs out of a pick |
| In Help: arrow keys, `Home`, `End` | Move between topics (the arrows wrap). `Ctrl` + `Enter` does nothing inside Help |
| In User Preferences: arrow keys, `Home`, `End` | Move between its four tabs (up and down in the side list, left and right in the strip on a narrow window) |
Every control is a real button, radio or checkbox, so screen readers and
keyboard-only navigation work.
## Models in User Preferences
## User Preferences
The `plan2code` launcher's model menu comes from `models.json`, which every install overwrites with the authors' curated list. **User Preferences → Models** (Claude, Devin and Codex tabs) lets you add a model that came out before Plan2Code was updated; additions are kept in `~/.plan2code/models.json`, and **Reset to default** removes them. Restart `plan2code` to see a change. You can always run `plan2code --model <id>`, or switch model inside your agent before running a skill. Devin ids ending `-xhigh` or `-max` are refused. Maintainers refresh the curated list with the repo-local `/plan2code-model-update` skill, which shows a diff and changes only what they approve.
The gear button in the top bar opens **User Preferences**, always on its first tab. Its four tabs sit in a side list, or in a strip along the top on a window narrower than 720px, and the arrow keys, `Home` and `End` move between them:
## Agents and the desktop app in User Preferences
| Tab | What it holds |
| --- | --- |
| **Appearance** | Theme, Card width, Highlight color and Role |
| **Agents & models** | The agents `plan2code` can start, and the models each one offers |
| **System** | Cleanup, and Desktop app (only inside the desktop app) |
| **Sounds & activities** | Sounds and Activities |
**User Preferences → Agents** adds agent CLIs Plan2Code did not find on its own. Each one has a name, the command to run (a bare name looked up on `PATH`, or a full path), and optional fields:
On Appearance and Sounds & activities each change saves the moment you make it, and a small **Saved** mark shows beside it. **Close** (or `Esc`) shuts the dialog. **Back to default** resets only the tab on screen: Appearance's four settings (Role back to *Not set*), or every sound and the two Activities switches (Show Activities and Play game sounds); Activities best scores stay. It is not shown on Agents & models or System, which have nothing to reset.
### Agents & models
Most people never need this tab: Plan2Code finds the agents installed on the machine and ships an up-to-date model list with every release. It opens on a summary table, one row per agent with its models and whether its command was found on this machine. **Edit** opens that agent's form and **Add agent** a blank one. Nothing on this tab saves as you type: each form has its own **Save** and **Discard**, and shows an **Unsaved** badge while it holds a change. Leaving a form with an unsaved change (another tab, **Back to summary**, **Close**, `Esc`) asks first: save it, discard it, or keep editing. Saving one agent never sends another's half-typed edit.
**Models.** The `plan2code` launcher's model menu comes from `models.json`, which every install overwrites with the authors' curated list. Each built-in agent's form (Claude, Devin, Codex) shows that list under *Comes with Plan2Code*, and below it **Models you added**, each a model id and the name shown in the menu, for a model that came out before Plan2Code was updated. Additions are kept in `~/.plan2code/models.json` and survive updates, unless the curated list now includes them; **Remove** takes one out. Restart `plan2code` to see a change. You can always run `plan2code --model <id>`, or switch model inside your agent before running a skill. Devin ids ending `-xhigh` or `-max` are refused. Maintainers refresh the curated list with the repo-local `/plan2code-model-update` skill, which shows a diff and changes only what they approve.
**Agents.** An agent you add is an agent CLI Plan2Code did not find on its own, which the `plan2code` command and the desktop app can then start. Each one has a name, the command to run (a bare name looked up on `PATH`, or a full path), and optional fields:
- **Arguments**: one per row. `{prompt}` is replaced by the start prompt (for example `--message={prompt}`); with no `{prompt}` anywhere, the prompt is added last.
- **Start prompt**: `/plan2code` by default. Leave it blank to start the agent with nothing typed.
- **Bypass arguments**: added when permission checks are off.
- **Model arguments**: added when a model is chosen, with `{model}` replaced (`--model` and `{model}` by default), and a list of **models** to offer, each an id and an optional label.
- **Models**: a list to offer, each an id and an optional label.
- Under the **Command-line arguments** fold:
- **Arguments**: one per row. `{prompt}` is replaced by the start prompt (for example `--message={prompt}`); with no `{prompt}` anywhere, the prompt is added last.
- **Bypass arguments**: added when permission checks are off.
- **Model arguments**: added when a model is chosen, with `{model}` replaced (`--model` and `{model}` by default).
**Test** on a card shows where the command is found, or "Not found on PATH", and never runs it. Saving a duplicate name, a blank command or a built-in id marks the card and field and writes nothing. The list is plain text in `~/.plan2code/agents.json`, shared by the `plan2code` command and the desktop app; this page is the only thing that writes it, and a broken file or entry is skipped with a warning shown under the list, never a crash. If the file holds something the page could not read, saving asks first (**Save anyway**). `/plan2code` works only in agents that load the installed Plan2Code skills.
**Test** beside the command shows where it is found, or "Not found on PATH", and never runs it. Saving a duplicate name, a blank command or a built-in id marks the field and writes nothing. **Delete agent** asks once more on the form before it removes one. The list is plain text in `~/.plan2code/agents.json`, shared by the `plan2code` command and the desktop app; this page is the only thing that writes it, and a broken file or entry is skipped with a warning shown on the tab, never a crash. If the file holds something the page could not read, saving asks first (**Save anyway**). `/plan2code` works only in agents that load the installed Plan2Code skills.
### System
**Cleanup** lists what Plan2Code does not need in `~/.plan2code/`, with sizes, before anything is deleted (**Find files to clean up**, then **Delete these**); what it offers and what always stays is under *Or clean up on demand* below.
**Desktop app** appears only when the page is open inside the desktop app. Its switch, **Show on the taskbar when Plan2Code needs me** (on by default), controls the app's taskbar signal: on Windows a green dot on your move and a red one when it needs attention, plus one short burst of flashes when the window is not focused (the button stays lit until you look); on macOS a red `!` dock badge when it needs attention and one bounce; on Linux a badge where your desktop supports it. Turning it off clears the dot and stops flashes. The choice is kept by the app in its own `~/.plan2code/app.json`.
@@ -916,10 +1671,10 @@ exception being the note attachments the agent keeps for a spec, above):
| `~/.plan2code/console/sessions/<id>/uploads/` | images and documents attached to notes and quick questions | 30 days after the session was last touched |
| `~/.plan2code/handoffs/<id>.md`, `<id>.json` | each handoff's document, and which checkout, spec and skill it belongs to and whether it was picked up (`handoffs.mjs` is their one owner) | 30 days after it was last touched, picked up or not |
| `~/.plan2code/notepads/<folder-name>-<12 hex>/` | your notebook for one folder: `meta.json`, `tabs.json` and, per tab, `tabs/<id>/note.md` and `tabs/<id>/images/` (`notepads.mjs` is their one owner; the agent never reads them, except a tab you send) | until you delete it through Cleanup, which offers it once its newest file is 30 days old |
| `~/.plan2code/console/looks.json` | your role, theme, colors, sounds and card width, the Show Activities switch, the last activity picked (`lastActivity`), best scores (flat `activityBest<Id>` keys: `activityBestSnake`, `activityBestGolf`) and each game's memo (`activityMemo<Id>`: Snake's surprises found) | always |
| `~/.plan2code/console/looks.json` | your role, theme, colors, sounds and card width, the Show Activities and Play game sounds switches (`hideActivities`, `activitySounds`), the last activity picked (`lastActivity`), best scores (flat `activityBest<Id>` keys: `activityBestSnake`, one per Mini golf course from `activityBestGolfPirate` to `activityBestGolfFrost`, `activityBestTrails`, `activityBestBugs`, `activityBestDrive`, `activityBestStack`, `activityBestBumper`, `activityBestRapids`, `activityBestFuse`, `activityBestHop`, `activityBestBounce`, `activityBestGhoul`) and each game's memo (`activityMemo<Id>`: Snake's surprises found, Light Trails' furthest arena, Bug Hunt's bugs, bosses and power-ups found, Sunset Drive's roads found, Stack Deploy's highest floor, Bumper Ring's furthest arena, Rapids Run's furthest dam, Hot Potato's furthest venue, Crossing Rush's furthest zone, Bounce Road's furthest stage, Ghoul Rush's most stages cleared in a run) | always |
| `~/.plan2code/console/subagents.json` | your Subagents switch, instruction and limit, per project folder and skill | always |
| `~/.plan2code/console/sessions/<id>/subagents-setting.json`, `subagents-cursor.json` | this session's copy of the switch, and how far the agent has been told of it | with the session |
| `~/.plan2code/agents.json` | your custom agent CLIs (User Preferences → Agents), read by the `plan2code` command and the desktop app | always |
| `~/.plan2code/agents.json` | your custom agent CLIs (User Preferences → Agents & models), read by the `plan2code` command and the desktop app | always |
| your system temp directory | the port, process id and session token | until reboot |
Each of the workspace and meter files has exactly one writer: the server owns
@@ -942,7 +1697,7 @@ Your `looks.json` and the `console-dir` pointer are never touched, and neither
is the session being opened. Nothing of value goes with them: the page is
never the record, `specs/` in your project is.
**Or clean up on demand.** *User Preferences → Cleanup* → **Find files to
**Or clean up on demand.** *User Preferences → System → Cleanup* → **Find files to
clean up** lists, with sizes, everything in `~/.plan2code/` that is not
needed: sessions untouched for 30 days (never the one you are in), anything at
the top of `~/.plan2code/console/` other than `sessions/`, `looks.json`,
@@ -1030,7 +1785,7 @@ origin.
| Source | `src/web-console/` (one row per file in the files table of `.agents-docs/AGENTS-architecture.md`; a test keeps it complete) |
| Ships as | `skills/<every skill>/references/web-console/` |
| Wiring | one `additionalReferences` entry per skill in `install.js`; the dashboard's menu lives in `public/skills.js` (each entry's `card`; `SKILL_CATALOG` in `public/answers.js` is a lookup on it) |
| Agent contract | `src/web-console/console.md` (read once), its topic files (`console-*.md`), `notes/<workflow>.md`, and `building.md` / `building-review.md` for the builds; `console.mjs help <topic>` prints any of them |
| Agent contract | a card, `src/web-console/console.md` (read once), plus pointers: the console names a topic file (`console-*.md`, `notes/<workflow>.md`, `building.md` / `building-review.md`) in its own `read` output, once per session per topic, when its moment comes; `console.mjs help <topic>` prints any of them. A `stop` with no `finish`, or a `finish` while `stopWarning` is set, is refused with the fix; `stop --session <sid> --force` ends a dead page or an abandoned session anyway. Patches are one line, with lettered options and the console's own defaults filled in; a refused patch names the field and the fix. Byte budgets keep the card, the notes and a sample session's outputs from growing back (`scripts/test-console-wire-budgets.mjs`) |
| Tests | `node --test scripts/test-web-console-*.mjs` (split by area, shared setup in `scripts/web-console-test-helpers.mjs`), also run by `npm test` |
| Start-up benchmark | `node scripts/bench-web-console.mjs` (needs a local Chrome or Edge for the paint columns, driven through `playwright-core` from `npm install`; `--browser-delay 900` models a real browser launch, `--roundtrip` times Send→agent and post→page) |
| Screenshots | `node scripts/capture-screenshots.mjs` (needs a local Chrome or Edge, driven through `playwright-core` from `npm install`; `PLAN2CODE_TEST_BROWSER=chrome|msedge` forces one) |