blockyard 0.0.9 → 0.1.1

package/docs/USER-GUIDE.md

@@ -20,6 +20,10 @@ are node actions, which are off unless an operator explicitly enables them (see
 - [Tetrust](#tetrust)
 - [Blockout](#blockout)
 - [Blockanoid](#blockanoid)
+- [Scorched Yard](#scorched-yard)
+- [Wolfenstein 3D](#wolfenstein-3d)
+- [DOOM](#doom)
+- [Quake](#quake)
 - [Peers](#peers)
 - [Network](#network)
 - [Mining](#mining)
@@ -218,35 +222,40 @@ both modes move to their new places rather than disappearing and reappearing.
 
 While the board is at rest, one effect plays every seven to thirteen seconds — the first
 about a second after the board lands — and never one that has played within the last twelve
-(**No repeats within**, 0 up to the length of that board's list). There are **30**, and each has its own switch. **Each board
+(**No repeats within**, 0 up to the length of that board's list). There are **34**, and each has its own switch. **Each board
 has its own list**: the Block space board's switches are the **Space effects** tab, the
 Markets board's are the **Market effects** tab, and each tab has its own no-repeat window, so
 trimming one board's effects leaves the other's alone.
 
 | | |
 |---|---|
-| **Ripple**, **Outline sweep**, **Scan line**, **Tide** | fronts crossing the board: a spreading ring, traced edges, a tight line, a swell that lifts the cubes it passes under |
+| **Ripple**, **Outline sweep**, **Scan line**, **Tide** | fronts crossing the board: a spreading ring, traced edges, a curtain of light standing floor to top — a white core with soft cyan faces, raster rippling down it, a bar it hangs from, a glowing foot with a phosphor tail, motes in the beam — and a swell that lifts the cubes it passes under |
+| **X-ray** | a front sweeps the board and everything behind it goes x-ray — bodies to glass, edges and a raster lit — then develops back to solid |
 | **Cascade**, **Twinkle**, **Sparkle** | the blocks light in fee-rate order; scattered flashes; a constellation, each block its own colour |
 | **Light cycles** | a TRON-style race in blue and orange from opposite edges, leaving light walls, until one crashes and de-rezzes |
 | **Lightning ball** | a pale plasma ball entering from off-screen, tracing the grid, throwing bolts and trailing electrical dust |
-| **Shockwave**, **Nova**, **Fireworks**, **Solar flare** | a hard ring that throws blocks into the air; an implosion then a brighter blast; three bursts; one block going supernova |
+| **Shockwave**, **Nova**, **Fireworks**, **Supernova** | a hard ring that throws blocks into the air; an implosion then a brighter blast; a fireworks display; a supernova — a star swells white-hot and crackles, blows out in a flash and a lens flare, a shockwave rings out, plasma is flung on every side, and a ring nebula expands and cools gold → red → violet round a white dwarf, lighting everything near it as it goes |
 | **Wave**, **Quake**, **Checkerboard**, **Combo chain** | crests rolling across; the board shaking itself out; squares flipping against each other; a chain reaction down the diagonal |
 | **Code rain**, **Radar**, **Vortex** | a drop falling down every column; a sweep hand with a phosphor tail; spiral arms draining inward |
 | **Power-up**, **Aurora**, **Plasma** | the board charging from the floor up in gold; drifting curtains of colour; the demoscene plasma |
 | **Centipede**, **Interception**, **Collapse** | a body that weaves down the board and splits in two; arcs raining down against interceptors rising to meet them; the board giving way from a point, cubes collapsing outward |
 | **Tractor beam** | a UFO that draws the tallest transaction up into its beam, flies off with it and drops it back under gravity |
-| **Ball lightning** | a plasma sphere in a nebula drifting across the whole view from off-screen to off-screen, its arcs electrifying the blocks they strike — and half the arcs chain on from the struck block to another as a green discharge, half of those on to a third; on Markets it flies through the chart, striking candles and charging the price line where it passes |
-| **Energy pulse** | the surge that runs the neon price line on Markets, electric blue behind its head |
+| **Ball lightning** | a plasma sphere in a nebula drifting across the whole view from off-screen to off-screen, a hazy white light on everything it passes, its arcs electrifying the blocks they strike and lighting where they land — and half the arcs chain on from the struck block to another as a green discharge, half of those on to a third; on Markets it flies through the chart, striking candles and charging the price line where it passes |
+| **Energy pulse** | the surge that runs the neon price line on Markets: the pipe swells round its head and goes white-hot behind it, cooling back to the wire through hot gold, with a warm cloud, crackle and motes — nothing blue |
+| **Breathe** | on Markets: the price line breathes, three slow swells from the plain wire to the pulse's white heat and back |
+| **Light saber** | on Markets: the price line ignites from its left end as a light saber — blue, green, red or purple by the run — hums, spits sparks, and retracts |
+| **Black hole** | on Markets: a point of darkness opens on the price line and grows; the line bends round it as through a lens, the candles nearest are swallowed, and an accretion disk in the chart's own colours spirals in round the shadow — brighter on the side coming toward you, its far side arched over the top and under the bottom, a photon ring hugging the horizon, starlight bent into arcs — until it shrinks away and lets everything go |
 | **Pipe bulge** | on Markets: a ball forced through the price line, the tube swelling around it with a stretched skin; it enters at the line's start at the tube's own size, leaves at its end, and runs quicker downhill than up |
 
 They are decoration only: they carry no data, they never play during a refresh, and they
 are switched off entirely under `prefers-reduced-motion`. The Block space list is every effect
 but the two drawn on a price line (**Energy pulse**, **Pipe bulge**). The Markets board is eight
 units deep and as wide as the hours, so everything there moves **along the hours, left or right,
-never toward you**, and lights the candles or the line. Its list is the **twelve** that
+never toward you**, and lights the candles or the line. Its list is the **sixteen** that
 translate to a chart: **Ripple**, **Outline sweep**, **Tide**, **Cascade**, **Twinkle**, **Scan
-line**, **Fireworks**, **Solar flare**, **Wave**, and the price line's own **Energy pulse**,
-**Pipe bulge** and **Ball lightning** (half its Block space size there). Fronts run along the
+line**, **X-ray**, **Fireworks**, **Supernova**, **Wave**, and the price line's own **Energy pulse**,
+**Pipe bulge**, **Breathe**, **Light saber**, **Black hole** and **Ball lightning** (a quarter of its
+Block space size there). Fronts run along the
 chart, rings start on the candle row, the candles light where they stand. Nothing on it waits
 its turn: the pulse, the bulge and ball lightning are picks like any other, and how often you
 see one is the length of the list you leave switched on.
@@ -400,8 +409,8 @@ page reads **not indexed** and says so in a note with the phase, the progress, t
 and the time left; the Overview's "what this panel cannot tell you" box shows the same line, and
 adds `paused while the node's RPC is slow` whenever the build is holding back so the node keeps
 answering. A notification appears in every open tab when the build starts, when it finishes and
-if it fails; on finish the page fills in with no restart. The build does not resume after the
-server is stopped: the next start begins it again.
+if it fails; on finish the page fills in with no restart. A build stopped with the server
+resumes on the next start from the files it had finished, and its progress picks up from there.
 
 **Without an index configured**, the address and its type are still confirmed
 (`validateaddress` needs none), and balance, totals and history read **not indexed**. It does
@@ -422,11 +431,14 @@ Core supports.
 
 ## Markets
 
-The BTC/USD price from five exchanges' public APIs. The server fetches market data
-**only while someone is reading it** — the Markets or Kiosk tab, or Overview, whose price
-line (**Display settings → Markets & Price → Price line on Overview**, on by default) reads
-the same feed — and stops about ten minutes after the last request. Switch that line off
-and, with no one on Markets or Kiosk, the monitor makes no exchange requests at all.
+The BTC/USD price from five exchanges' public APIs. **Polling is off by default**: out of
+the box the monitor makes no outbound connection but to your node, and Markets and Kiosk say
+so. Tick **Display settings → Markets & Price → Enable market polling** — one switch for
+every screen of this monitor, no restart needed. With it on, the server fetches market data
+**only while someone is reading it** — the Markets or Kiosk tab, or Overview, whose price line
+(**Display settings → Markets & Price → Price line on Overview**) reads the same feed — and
+stops about ten minutes after the last request. Switch that line off and, with no one on
+Markets or Kiosk, the monitor makes no exchange requests at all.
 
 ![Markets](images/markets.jpg)
 
@@ -706,6 +718,385 @@ rather than the look, flipping them reaches the game you are playing, not just t
 
 ---
 
+## Scorched Yard
+
+Scorched Earth, the 1991 DOS artillery game, on the block engine: a landscape of dirt cubes that
+craters and falls, tanks that aim by angle and power, wind, and a round that ends when one tank is
+left. Under **Diversions**, after Blockanoid. You play against two computer opponents out of the
+box (**Display settings → Scorched Yard → Computer players** fields up to seven, for the original's
+eight seats; every tank has its own colour).
+
+The rules are the original's (docs/PLAN-SCORCHED-YARD.md is the whole plan): the manual's roster
+of thirty-three weapons and eleven accessories at the manual's prices, packs and blast radii,
+craters, falling dirt, fall damage, death and its blast, the walls, wind, cash for damage and
+kills, a shop between rounds, and a game of rounds. The manual's eight computer
+personalities take the other seats. The fabulous part is on its way.
+
+### Playing
+
+| Keys | |
+|---|---|
+| **←** **→** or **A** **D** | the barrel's angle, a degree at a time (Shift: five) |
+| **↑** **↓** or **W** **S** | power, ten at a time (Shift: one, Ctrl: a hundred) |
+| **[** **]** or **PgUp** **PgDn** | the weapon, through what you own |
+| **space** or **Enter** | fire |
+| the mouse | drag on the field to aim: the direction from your tank is the angle, the distance the power |
+| **A** **D** | drive a cell left or right, a unit of fuel each |
+| **B** | a battery: 30 health back |
+| **S** | raise a shield (the best you own) |
+| **T** **H** | arm a contact trigger or heat guidance for the next shot |
+| **P** or **Esc** | pause |
+| **N** | the next round, from the shop |
+
+### The roster
+
+You start with the bottomless **Baby Missile** and your cash; everything else is bought. What a
+shell does when it lands:
+
+| weapon | what it does |
+|---|---|
+| Baby Missile, Missile, Baby Nuke, Nuke | a blast: a crater and damage that falls off with distance, from a cell and a half across to eleven |
+| Leap Frog | three warheads, one after another, each blast bigger than the last |
+| Funky Bomb | a blast, then six bomblets thrown out that each blast where they land |
+| MIRV, Death's Head | five (or nine, large) warheads splitting at the top of the arc |
+| Tracer, Smoke Tracer | no crater and no damage: it shows you the wind |
+| Baby Roller, Roller, Heavy Roller | lands and rolls downhill until it meets a tank or the bottom of a dip, then blasts |
+| Riot Charge, Riot Blast | a wedge of dirt cut from the turret along the barrel's line, at once; nobody hurt |
+| Riot Bomb, Heavy Riot Bomb | a shell that clears a sphere of dirt and hurts no one |
+| Dirt Clod, Dirt Ball, Ton of Dirt | a shell that bursts into a ball of dirt |
+| Liquid Dirt | oozes downhill and sets where it pools, filling the holes |
+| Dirt Charge | a wedge of dirt thrown from the turret, at once |
+| Earth Disrupter | every hanging piece of dirt on the field settles, at once |
+| Napalm, Hot Napalm | liquid fire that runs downhill along the surface and burns what it reaches |
+| Baby Digger, Digger, Heavy Digger | digs straight down, then blasts |
+| Baby Sandhog, Sandhog, Heavy Sandhog | tunnels on along its heading through the dirt, then blasts |
+| Plasma Blast | energy thrown from your own tank, its reach set by the power; you are spared, no crater |
+| Laser | a straight line from the barrel, at once: dirt along it goes, a tank on it burns |
+
+The accessories: **Shield**, **Force Shield** and **Heavy Shield** absorb 60, 100 and 150 damage;
+a **Mag Deflector** pushes passing shells away and a **Super Mag** harder and from further; a
+**Parachute** opens when you fall; a **Battery** restores health; **Auto Defense** raises a shield
+for you as your turn begins; a **Fuel Tank** lets you drive; a **Contact Trigger** sets the shell
+off within reach of a tank before it buries; **Heat Guidance** bends the shell toward the nearest
+tank as it falls. The items line under the fire button shows what you carry and what is armed.
+Prices, packs and radii are the manual's (SCORCH.DOC); the original started every player with $0
+and 5% interest, which the settings allow.
+
+### The computer players
+
+![Scorched Yard](images/scorched.jpg)
+
+Out of the box you face a **mix**, climbing from the easy ones: a Shooter and a Tosser, then a
+Chooser, a Spoiler, a Cyborg and a Poolshark as you add seats. **Display settings → Scorched Yard
+→ Their kind** fields one kind in every seat instead. They are the manual's eight, and they
+behave as it says:
+
+| kind | how it plays |
+|---|---|
+| Moron | picks an angle and a power, and shoots; buys at random |
+| Shooter | takes low, straight shots when it has a line of fire, and shoots like a Moron when it does not |
+| Poolshark | a Shooter, except that under rubber or spring walls it looks for the bank shot too |
+| Tosser | lobs high, then corrects its power from each miss, by halves, until it hits |
+| Chooser | tries the straight shot, the lob and the bank, and takes whichever lands closest |
+| Spoiler | works the shot out from the wind and gravity and is nearly perfect, with a wobble now and then |
+| Cyborg | a Spoiler with a grudge: it fires at whoever hit it last, else at the weakest, else at the leader |
+| Unknown | one of the others, drawn afresh each round and never announced |
+
+All but the Moron use a battery when hurt and raise a shield before firing, and each shops to its
+own taste between rounds: Shooters buy missiles, Tossers MIRVs and Funky Bombs, Cyborgs the
+Death's Head and the heaviest shields.
+
+### Cash and the shop
+
+Every point of damage you land earns $10, a kill $2,000, and the last tank standing $1,000; interest
+(a setting, 5% out of the box) is paid on what you keep between rounds. When a round ends the
+**shop** opens: every weapon and item with its price and pack size, what you own, and a buy button
+while you can afford it. The computer players shop at the same moment, in their own way. What you
+buy stays with you for the rest of the game.
+
+### The controls
+
+**← →** turn the barrel, **↑ ↓** change the power, and a **held key accelerates**: one a step, then
+two, then five, so crossing the whole arc takes about a second and a half and the last degree still
+takes one press. **Shift** is fine (1° and 1), **Ctrl** coarse (100 of power). **, and .** nudge the
+power by one. The **wheel** over the field changes the power, and with **Shift** the angle. **Click
+the angle or the power** on the panel and type the number. **Drag** on the field to aim; **press on
+your own tank** and drag to turn the barrel without touching the power. **R** fires the last shot
+again, exactly.
+
+**Correcting.** Click an enemy tank to mark it (a red ring goes under it; click it again to clear).
+After your next shot the panel says how it did against that tank — *10 over*, *6 short*, *close*,
+*hit* — and **C** sets your power to what that miss says it should have been. It works from your
+own last shot, so the wind and the hills are still yours to read; change the angle and it is only
+an estimate. Display settings → Scorched Yard → *Correction helper* turns it off.
+
+**Weapons.** **W** opens a grid of what you own, biggest blast first, with counts and the key for
+each; click one or press its number. **1–9** pick the weapons you own in the shop's order, **Q**
+picks the last one you fired, **[ ]** still cycle. The **fire button names what it will send**
+(*fire · Missile × 5*), and the last of a weapon sold one at a time — a Nuke, a Death's Head —
+**asks once**: the button turns red and says so, and a second press within three seconds sends it
+(*Confirm the last of a weapon* in Display settings).
+
+**The aim guide** draws a ghost of the shell's path while you aim, under this round's wind and
+gravity: by default just the first fifth of the flight, enough to read the lean of the shot without
+giving the landing away. *Aim guide* in Display settings chooses short, the whole flight, or off.
+**Cheat mode** draws the whole flight with a ring where it lands.
+
+**Items** are buttons: click a pill to use a battery, raise a shield or arm a trigger, or press
+**B**, **S**, **T**, **H**; **A D** drive if you have fuel. **Space** or the fire button sends the
+shot; **P** pauses; **N** starts the next round.
+
+**Restart** on the panel (or **F2**) starts a fresh war from round one, whatever the board is doing:
+a war is five rounds, and a player knocked out early should not have to watch the computer finish.
+
+The wind is **simulated air**, behind the land. A small fluid simulation is pushed by the round's
+wind and treats the land as its solid floor, so the air rises over the hills, speeds across the
+crests and rolls into eddies behind them, and it follows the craters as they are blown. You see it
+as thin flow lines, the wind-map kind: each one the recent path of something weightless carried by
+that air, fading in and out and thinning away at the edges of the field. The sky behind them sways
+very slightly, as if seen through moving air. When the wind changes, the air turns round by its own
+momentum rather than jumping. A row of **chevrons** at the top of the field points the way it
+blows, as many as it is strong, brightest just after a change. A computer player decides its shot
+as its turn begins, and you can watch its barrel swing onto it while it thinks.
+
+**Cheat mode** (a switch on the panel, also under Display settings → Scorched Yard) draws the
+firing solution while you aim: the shell's own path under this round's wind and the game's
+gravity, clipped where it would meet the dirt, with a ring where it lands. It moves as you move
+the barrel or the power, so you can watch the arc bend under the wind. It is the rules' own
+arithmetic, so what it draws is what the shot does.
+
+Over the tank whose turn it is stands the **aim gauge**: a protractor with a tick every fifteen
+degrees, a needle along the current angle whose length is the power, and both numbers at its tip.
+It is dimmed on a computer player's turn, so you can read what it is about to do before it fires.
+
+The HUD shows whose turn it is, the round, the **wind** (an arrow and its strength: it changes
+every turn, and it bends every shot; you can see it too — streaks of moving air run level across
+the sky behind the land, short and slow in a breeze, long and quick in a gale, in three bands of
+depth so the air has thickness; the pennant on every turret streams downwind; and the Earth sky's
+clouds go with it), your angle, power and weapon with its count, and every
+tank's health. **Fire** on the HUD does what space does. A shell that lands carves a circle out of
+the dirt; the blast itself is drawn the way the fireworks are — a white core, a shockwave, sparks
+that curve and trail, and smoke that rises, spreads, drifts downwind and thins; the dirt above the
+crater falls until it rests, and a tank left in the air falls with
+it and is hurt by the fall. A blast hurts every tank in reach, most at its centre. A tank at zero
+health explodes, and its blast can take a neighbour with it.
+
+A round ends when one tank is left (or none); the survivor scores 200, a kill 100, and a tank
+that kills itself loses 50. **Rounds** (a setting, five out of the box) make a game; the highest
+score at the end wins, and your score goes in the high-score table, this browser's.
+
+### The switches on the panel
+
+**Sky** goes round the Galaxy, the Earth and none: the same choice as the **Sky** tab's map. The
+game ships under the Earth, and each round takes its own hour of it, dawn to night, unless **A sky
+per round** is off. **Music** is a march in D minor on oscillators. **Sound** is the shot, the blast, a hit, a
+fall, a death. **Talk** is what the tanks say when they fire, are hit, or die. **Fast** flies
+shells at three times the pace. **Watch** is the attract mode: the computer takes your chair as
+well, so every seat is a computer player and the war runs on by itself — a round rolls into the
+next without waiting at the shop, and when one of them wins the war a fresh one begins. Nothing
+is scored in the high-score table for a war nobody played. Turn it off and the next game seats
+you again; it is also in **Display settings → Scorched Yard → Attract mode**, and it is what to
+leave running on a screen in the corner.
+The rules the original exposed are in **Display settings → Scorched Yard**: the number of
+computer players, the rounds, the **walls** (none loses a shell off the edge, the original's
+default; concrete explodes it there; padded stops it and drops it; rubber bounces it; spring
+bounces it back harder; wraparound brings it in the other side), the **wind** (once a round, which is how it ships: the round's
+direction is drawn when the round starts and held to the end of it, while the strength is drawn
+again for every turn, so the air blows one way and how hard is still something to read before each
+shot; every turn, which is the original's and can turn right around between two shots; every shot;
+or none), **gravity**, the **landscape** the rounds are drawn from (hills, mountains, a valley,
+flat), the **starting cash** and the **interest** rate. They take effect at the next new game.
+
+## Wolfenstein 3D
+
+The shareware episode of Wolfenstein 3D, **Escape from Wolfenstein**, under **Diversions**, first of
+the three DOS games. It is id Software's own `WOLF3D.EXE` v1.4 and its `.WL1` data files, unmodified,
+on the same PC BlockYard emulates for DOOM and Quake. Where those two were 32-bit programs, Wolfenstein
+3D is a 16-bit **real-mode** DOS program from 1992, so here the emulated processor runs the way a PC
+started up: segments and offsets, DOS's own memory, the interrupt table at the bottom of memory. AdLib
+music plays on the sound card's OPL and the digitised effects ("Achtung!") on its DSP. It draws at 70
+frames a second, the VGA's refresh rate, with plenty of machine to spare.
+
+Press **play**. The sign-on screen shows what the game found (memory, mouse, Sound Blaster); press a
+key, the title and the demos follow, and **Enter** or **Esc** brings up the menu: **New Game**, pick
+the episode and how tough you are.
+
+### The files
+
+The game's files live on the server in `games/wolf3d_dos/`: `WOLF3D.EXE`, and the eight `.WL1` files
+it cannot start without (`AUDIOHED`, `AUDIOT`, `GAMEMAPS`, `MAPHEAD`, `VGADICT`, `VGAGRAPH`,
+`VGAHEAD`, `VSWAP`). `CONFIG.WL1`, its settings and high scores, is optional. The page names a missing
+file instead of starting.
+
+### Playing
+
+**Click the screen to capture the mouse**: moving it forward and back walks, left and right turns,
+the left button fires. **Esc** gives the mouse back. The keys are the game's own:
+
+| Keys | |
+|---|---|
+| **↑** **↓** | walk |
+| **←** **→** | turn |
+| **Alt** + **←** **→** | strafe |
+| **Ctrl** or left click | fire |
+| **Space** | open doors, push walls |
+| **Shift** (held) | run |
+| **1**–**4** | knife, pistol, machine gun, chain gun |
+| **Esc** | the menu |
+| **F8** / **F9** | quick save / quick load |
+
+Rebind them under **Change View** and **Control** in the game's own menu; it keeps what you choose.
+
+### Pausing, saving, quitting
+
+Exactly as DOOM: it **pauses when you look away** with the machine stopped dead, **savegames, the
+settings and the high scores stay in this browser**, and **Quit** ends the program the way it ended
+in DOS, with a **play again** button.
+
+### The switches on the panel
+
+**♫ sound**, **◌ smooth** and **⛶ full screen**, as in DOOM. In full screen a tap of **Esc** is the
+game's menu, not the browser's exit; leave with the **exit full screen** button in the top corner,
+or hold **Esc** for a second.
+
+---
+
+## DOOM
+
+If anyone asks *"well, can it run DOOM?"*, the answer is an emphatic **"Naturally. What sort of AI
+slop generator do you take me for?"**
+
+The shareware episode of DOOM, **Knee-Deep in the Dead**, under **Diversions**. Not a remake: it is
+id Software's own `DOOM.EXE` v1.9 and `DOOM1.WAD`, unmodified, running on a 486 PC that BlockYard
+emulates in your browser — the processor, DOS and its memory extender, the VGA card and a Sound
+Blaster, all written in JavaScript. It plays exactly as it did in 1993, demos, sound effects, OPL
+music and all.
+
+Press **play**. The machine boots (you will see DOOM's own start-up screen for a moment), the
+demos start, and **Esc** opens DOOM's menu: **New Game** from there.
+
+### The files
+
+The game's files live on the server, in `games/doom_dos/` beside the application — the shareware
+package the operator put there. Without `DOOM.EXE` and `DOOM1.WAD` in that directory the page
+says which file is missing instead of starting. Nothing is downloaded from anywhere else.
+
+### Playing
+
+**Click the screen to capture the mouse**: moving it turns, the left button fires, the right
+strafes, the middle walks forward. **Esc** gives the mouse back (and opens DOOM's menu). The keys
+are **WASD** by default:
+
+| Keys | |
+|---|---|
+| **W** **S** | walk |
+| **A** **D** | strafe |
+| **←** **→** | turn |
+| **E** | open doors, press switches |
+| **Ctrl** or left click | fire |
+| **Shift** (held) | run |
+| **1**–**7** | choose a weapon |
+| **Tab** | the map |
+| **Esc** | DOOM's menu |
+| **F2** / **F3** | save / load |
+| **F5** | detail · **F11** gamma |
+
+Turn the **⌨ WASD** switch off for DOOM's own 1993 keys: **↑** **↓** walk, **Alt** + **←** **→**
+strafe (or **,** and **.**), **Space** opens. The switch applies **at once**, in the middle of a
+game — the page rewrites the running game's key settings — and DOOM saves whichever you chose
+when you quit.
+
+### Pausing, saving, quitting
+
+**It pauses when you look away** — another browser tab, or another page of the monitor — and the
+emulated machine stops dead: its clock stops with it, so nothing moves while you are gone. Press
+**resume** to carry on.
+
+**Savegames and settings stay in this browser.** DOOM's six save slots, and the configuration it
+writes when you quit (volumes, screen size, detail), are kept in the browser's storage and come
+back the next time you play — on this browser only; they are never sent to the server.
+
+**Quitting** from DOOM's menu ends the program the way it ended in DOS: the text-mode ENDOOM screen,
+and a **play again** button.
+
+### The switches on the panel
+
+| Switch | |
+|---|---|
+| **♫ sound** | The Sound Blaster, on or muted. |
+| **⌨ WASD** | W A S D and E (the default), or DOOM's own keys; applies immediately. |
+| **◌ smooth** | Smooths the 320×200 picture instead of showing its square pixels. |
+| **⛶ full screen** | The screen alone. In Chrome it also keeps **Esc** for DOOM's menu, so leave with the **exit full screen** button in the top corner, or hold **Esc** for a second. |
+
+The **Machine** panel says what the PC is doing: running or paused, how fast the emulated
+processor is going (in millions of instructions a second), how many frames reach the screen, and
+the sound card's rate. DOOM draws at most 35 frames a second, as it always did.
+
+If the sound will not start, the page may be served over plain HTTP from a LAN address: the browser
+refuses its low-latency audio there, and DOOM falls back to a simpler path that works everywhere
+but can crackle when the machine is busy.
+
+---
+
+## Quake
+
+The shareware episode of Quake, **Dimension of the Doomed**, under **Diversions**, after DOOM and on
+the same emulated PC. Again the real thing: id Software's `QUAKE.EXE` v1.06 and `PAK0.PAK`,
+unmodified. Quake asked a lot more of a PC than DOOM did — a Pentium and a maths coprocessor — so it
+is the harder test of the machine. It plays at **forty to fifty frames a second** — better than the
+Pentium it was written for managed in 1996.
+
+Press **play**. The first start downloads the 18 MB PAK file from the server (after that the
+browser revalidates it rather than fetching it again), the console scrolls past, the demos start,
+and **Esc** opens Quake's menu: **Single Player → New Game**.
+
+### The files
+
+The game's files live on the server in `games/quake_dos/`: `QUAKE.EXE` and `ID1/PAK0.PAK` are the
+two it cannot start without. The page names a missing one instead of starting. Quake's CD music was
+never part of the shareware download, so there is none; the sound effects play through the Sound
+Blaster.
+
+### Playing
+
+**Click the screen to capture the mouse.** Quake starts with **mouse look** on and the keys a later
+game taught everyone:
+
+| Keys | |
+|---|---|
+| **W** **S** | walk |
+| **A** **D** | strafe |
+| mouse | look and turn |
+| left click or **Ctrl** | fire |
+| **Space** or right click | jump |
+| **Shift** (held) | run |
+| **1**–**8** | choose a weapon |
+| **Esc** | Quake's menu |
+| **−** / **=** | a smaller or bigger view |
+| **~** | the console |
+| **F6** / **F9** | quicksave / quickload |
+
+Those are set the first time only. Change anything in Quake's own **Options → Customize controls**,
+and Quake saves your bindings when you quit; the page never overwrites them again.
+
+**A smaller view runs faster.** Quake starts with its view a little inside the screen, a border
+round it. Quake only draws the 3D world inside that view, so **−** makes it smaller and faster and
+**=** makes it bigger, up to the whole width; Quake keeps your choice. Measured on this machine's
+emulator, a smaller view is worth about a tenth more speed at the starting size, and a quarter or
+more below that.
+
+### Pausing, saving, quitting
+
+Exactly as DOOM: it **pauses when you look away** with the machine stopped dead, **savegames and
+Quake's config stay in this browser**, and **Quit** ends the program the way it ended in DOS, with
+id's order screen and a **play again** button.
+
+### The switches on the panel
+
+**♫ sound**, **◌ smooth** and **⛶ full screen**, as in DOOM (and the same two ways out of full screen).
+
+---
+
 ## Peers
 
 | Panel | What it shows |
@@ -732,15 +1123,22 @@ Peer identity is not guessed from another source.
 
 ## Mining
 
-The block under construction and who has been mining.
+The block under construction and who has been mining. The layout follows mempool.space's mining dashboard: Block flow across the top, then two columns — reward stats and the difficulty adjustment, the pools and the hashrate, recent blocks and the adjustments — and our own panels beneath. **View more »** on the pools, hashrate, recent blocks and adjustments cards opens that card full screen (Esc, the close button or a click outside shuts it).
+
+![Mining](images/mining.jpg)
 
 | Panel | What it shows |
 |---|---|
+| **Reward stats** | The last 144 blocks: the miners' reward (subsidy plus fees), the average fees per block and the average fee per transaction, from `getblockstats`, rolled forward a block at a time. Each carries its dollar figure while market polling is on (the cached spot price, never a new poll); off, a note says so. |
+| **Difficulty adjustment** | Blocks remaining in the current period and when it ends at the pace so far, the estimated change (the pace projected over the period against the ten-minute target, within the protocol's factor-of-four bounds), the previous change, and the next halving's height and date. |
+| **Pools** | The last week's blocks by pool, as a donut with its legend: luck (blocks found against the 1,008 the target spacing would give), the block count and how many pools. Every coinbase of the week is read from the node, eight every few seconds behind the live polls, and the note says how far that has got. |
+| **Hashrate & difficulty** | The week's hashrate from `getnetworkhashps` and the current difficulty, and a year's chart: one block header a day gives that day's mean interval, and difficulty × 2³² over it is the day's hashrate estimate (the thin line), with a seven-day mean over it and the difficulty's steps on the right axis. |
+| **Recent blocks** | The attributed window newest first: height (a link to the explorer), pool, when it was mined, the reward (the height's subsidy plus its fees) and the fees. Eight on the card, the whole window under View more. |
+| **Adjustments** | The last periods: the first block's height, when, the difficulty and its change from the period before. Six on the card, a year under View more. |
 | **Block flow** | The same Block flow as on Overview. |
 | **Packages in the block being built** | The ancestor graph from `getrawmempool … depends`: a histogram of package sizes, then a table of the top packages with fees, weight, package fee rate, child and parent fee rates, and a small picture of the package's shape. Rows with a child paying at least twice its parent's rate are highlighted as child-pays-for-parent. If every transaction stands alone, the panel says so. That is a real reading, not a missing chart. |
 | **Feerate landscape** | The template's transactions bucketed by sat/vB, with green buckets well above the block's median and red ones below it. |
 | **Pools in this window** | Blocks per pool, share, median fee rate, average weight, and the coinbase tags seen. A pool the curated label map does not recognise is marked `unlabelled` and shown by its raw tag. |
-| **Mempool space** | The Block space viewer, with a note giving how many transactions are drawn and how long ago the pool was read. |
 | **Attribution** | How many blocks have been attributed, the height window, how many labels matched, where the label map came from, and the cost of the block template. |
 | **Detailed** (click to expand) | What this node can and cannot answer about mining, and why. |
 
@@ -782,8 +1180,7 @@ How the monitor treats your node, and where every number comes from.
 
 ## Admin
 
-Visible only when accounts are enabled (`BLOCKYARD_AUTH=1`) and you are signed in as an
-admin.
+Visible only when accounts are enabled (the default) and you are signed in as an admin.
 
 - **Users**: every account with its role, creation date and last login, with buttons
   to change the role or disable the account. **generate password** creates a user
@@ -857,6 +1254,8 @@ can bookmark it or send it to someone who can reach the same monitor:
 | Tetrust | `#tetrust` |
 | Blockout | `#blockout` |
 | Blockanoid | `#blockanoid` |
+| DOOM | `#doom` |
+| Quake | `#quake` |
 | Peers | `#peers` |
 | Network | `#network` |
 | Mining | `#mining` |
@@ -896,9 +1295,37 @@ same whatever you choose here.
 
 ![Display settings](images/settings.jpg)
 
-The panel is **tabbed** — Block space, Sky, Markets & Price, Blockout, Blockanoid, Space
-effects, Market effects and Tetrust. The two **effects** tabs are lists of switches, so they
-also get **all on** and **all off**; twenty-eight of them is a lot of clicking otherwise.
+The panel is **tabbed**, in three labelled rows: **Boards** (Appearance, Block space, Sky,
+Markets & Price), **Effects** (Space effects, Market effects) and **Diversions** (Tetrust,
+Blockout, Blockanoid). The two **effects** tabs are lists of switches, so they also get **all
+on** and **all off**; twenty-nine of them is a lot of clicking otherwise.
+
+### Appearance
+
+The colours of the layout: the page, its cards, text, lines, the accent, and the axis text, grid
+lines and tooltips of every chart. The 3D boards are space whatever you choose, and the
+Explorer's block and transaction pages keep their own dark cards.
+
+- **Theme mode** — Light, Dark or System. Every theme has a light face and a dark face; the mode
+  picks which. System follows the operating system's setting and changes with it.
+- **Theme** — a card per theme, each with a strip of its swatches in the face the mode picks:
+  - **BlockYard** — the shipped look, charcoal and bitcoin orange. The default; its dark face is
+    exactly what the monitor drew before this tab existed.
+  - **Mono** — clean grayscale, minimal and focused. The good, warning and bad colours stay, muted.
+  - **Nous** — GitHub's chrome with a Nous blue accent.
+  - **GitHub** — GitHub Light Default and Dark Default.
+  - **Catppuccin** — the soothing pastels, Latte (light) and Mocha (dark).
+  - **Custom** — your own nine colours, from the pickers below the cards.
+- **customise …** — the button beside the cards copies the theme on screen into the nine pickers
+  and selects Custom, so you start from a look rather than from scratch.
+- **The nine pickers** — Page, Panels, Text, Muted text, Accent, Lines, Good, Warning and Bad.
+  Everything else (a raised panel, the softer rules, the fainter text, the darker accent of a
+  pressed button) is derived from them, so a custom theme hangs together whatever you pick.
+  Whether Custom counts as light or dark follows from the Page colour, so a pale page gets dark
+  derived shades and vice versa. The pickers are dimmed until Custom is the theme.
+
+Like every other setting these are saved on the server, so the theme is the same on every screen
+of this monitor; the sign-in page draws in the theme this browser last saw.
 
 ### Block space
 
@@ -922,29 +1349,69 @@ these are the settings that buy it back, roughly most expensive first:
 | **Metallic finish** | *Chrome* mirrors a horizon in every face, and the reflection slides as the blocks move; *satin* is the softer highlight along the lit edge. Needs Metallic sheen on. |
 | **Departures and arrivals** | How blocks leave and rejoin the board on a refresh. |
 | **Depth** | How much height foreshortens, 0 to 0.001. 0 is the flat parallel camera the board shipped with: a cube is the same size however high it flies. Raise it and a cube's top grows a little wider than its base and a flying block swells slightly as it rises. |
-| **Star field** | On by default. The stars twinkle, so the board keeps repainting while they are on; switch it off to save that. What the stars *look* like is the **Sky** tab. |
+| **Sky** | Which sky stands behind the board: the **Galaxy**, the **Earth**, or none. What each sky is made of is the **Sky** tab; this is only the choice, and the Kiosk's left panel follows it. The Galaxy twinkles, so the board keeps repainting while it is up; none saves that. |
 | **Board curve** | How far the board bows toward you. 0 is flat. |
 | **Light** | Where the lamp hangs: *straight above* (the default) lights the whole board evenly, which keeps the front rows as bright as the middle; a corner shades the far slope of the curve and the sides turned away from it. |
 
 ### Sky
 
-One sky, shared by every board that shows stars — so the density you choose applies to Block
-space, Markets and Tetrust alike. Whether a given board shows it stays that board's own switch.
+There are two skies, and every board that has a sky behind it chooses one. The tab opens with the
+map, which is the whole answer to "which settings apply to which panel":
+
+| board | draws |
+|---|---|
+| **Block space** (and the Kiosk's left panel) | Galaxy |
+| **Markets & Price** (and the Kiosk's right panel) | Galaxy |
+| **Tetrust**, **Blockout**, **Blockanoid** | Galaxy |
+| **Scorched Yard** | Earth |
+
+Those are the shipped choices; each row is a select with **Galaxy**, **Earth** and **None**, and
+changing it here is the same setting as the **Sky** row at the top of that board's own tab. The
+games also carry a **sky** button on their panels that goes round the three. Below the map, the
+two skies themselves, each with only its own controls; neither is ever dimmed, because any board
+may be using it.
+
+**The Galaxy** is the star field, BlockYard's own sky: one set of stars shared by every board that
+draws it, so the density you choose applies to Block space, the candles and the games alike.
 
 | setting | what it does |
 |---|---|
+| **Spiral arms** | Lays the stars on slowly turning spiral arms instead of scattering them evenly. One turn takes about a quarter of an hour. |
+| **Arms centre** | Behind the board, or any of the four corners. A corner crowds the bright nucleus there and sweeps the arms across the panel. |
 | **Star density** / **Star brightness** | How many stars (up to 8x the shipped number) and how strongly they burn. |
-| **Spiral galaxy** | Lays the same stars on slowly turning spiral arms instead of scattering them evenly. One turn takes about a quarter of an hour. |
-| **Galaxy centre** | Behind the board, or any of the four corners. A corner crowds the bright nucleus there and sweeps the arms across the panel. |
-| **Nebulae**, **Dust lanes**, **Star clusters**, **Distant galaxies** | The layers of the sky, each its own switch: gas clouds along the arms, dark ribbons on their inner edges, tight knots out in the halo, and small faint galaxies in the deep field behind everything. |
 | **Star colours** | Warm old stars in the nucleus, blue-white young ones in the arms. Off is one colour of starlight. |
 | **Star glints** | The halo and cross glint on the brightest stars. |
+| **Nebulae**, **Dust lanes**, **Star clusters**, **Distant galaxies** | The layers of the sky, each its own switch: gas clouds along the arms, dark ribbons on their inner edges, tight knots out in the halo, and small faint galaxies in the deep field behind everything. |
+
+**The Earth** is a real day drawn from this machine's clock: the sun climbs and sets, the dome
+goes through night, dawn, day and dusk by the sun's height, clouds drift lit from the sun's side,
+the moon rises at tonight's phase, and the stars come out as the sun goes down (the Galaxy's
+density and brightness apply to them; its arms and layers do not, since a spiral over a real night
+is wrong).
+
+- **Clock** — real time, a whole day every 24 minutes (to watch it turn), or a fixed hour to
+  admire; **Fixed hour** is that hour.
+- **Weather** — clear, scattered cloud, overcast, or a storm with rain and lightning; **Cloud
+  cover** overrides the weather's amount, and -1 leaves it to the weather.
+- **Latitude** — with one set, sunrise, sunset and the sun's height follow the real formula for
+  the date (short winter days, the midnight sun); left unset, the day runs six to six.
+- **Sun rays**, **Rainbow** (opposite a low sun, in scattered weather) and **Shooting stars** (now
+  and then, at night) are the touches, each a switch.
+- **Moon** — up every night, highest at midnight and never thinner than a fat crescent (the
+  shipped choice), or on its real track at its real phase, which some nights means no moon at all.
+
+The sun and the moon are drawn in front of the clouds, so neither is lost behind one, and a board
+whose land fills the lower part of the panel sets its horizon where the land is, so they go down
+behind the hills rather than under them.
+
+A board under the Earth plays no idle effects: a supernova over a blue afternoon is wrong, on the
+block board and on the candles alike. Their switches are kept, and the Galaxy gets them back.
 
 ### Space effects and Market effects
 
-One tab per board. **Space effects** is a switch for each of the **28** idle effects the Block
+One tab per board. **Space effects** is a switch for each of the **29** idle effects the Block
 space board can play, listed under [Idle effects](#idle-effects) above; **Market effects** is a
-switch for each of the **12** the Markets board can play (named under Idle effects). Each tab has **all on** and **all off**, and its own
+switch for each of the **16** the Markets board can play (named under Idle effects). Each tab has **all on** and **all off**, and its own
 **No repeats within**: how many other effects must play before one can play again (12 by
 default; 0 allows a repeat straight away).
 
@@ -962,9 +1429,11 @@ Markets & Price.
 
 ### Markets & Price
 
-The candle board on Markets and Kiosk: the **star field** on or off, and **board effects** — one
-switch for everything that moves on this board, both the idle effects and the flight when the
-candles refresh. Which idle effects may play is the **Market effects** tab.
+First the feed itself: **Enable market polling**, off out of the box, is the one switch that
+lets this monitor talk to anyone but your node (see [Markets](#markets)). Then the candle board
+on Markets and Kiosk: the **star field** on or off, and **board effects** — one switch for
+everything that moves on this board, both the idle effects and the flight when the candles
+refresh. Which idle effects may play is the **Market effects** tab.
 
 Your toolbar choices are remembered too: the **exchange** whose candles are drawn and the
 **range** (24 hours, 48 hours or 7 days). Click them on the Markets page or set them here; either
@@ -972,7 +1441,8 @@ way the page opens where you left it.
 
 | setting | what it does |
 |---|---|
-| **Price line on Overview** | The USD median, spread, 24 h volume and how many books reported, at the top of Overview. **On by default** — and because it needs the exchange feed, this monitor then contacts five exchanges whenever Overview is open, not only on Markets and Kiosk. Switch it off and the landing page talks to nothing but your node. |
+| **Enable market polling** | **Off by default.** Lets the server ask five exchanges for prices, candles and order books — the only thing the monitor ever says to anyone but your node. Until it is on, Markets and Kiosk say so and the explorer shows no dollar figures. Shared by every screen; takes effect at once, and unticking parks the feed at once. (`BLOCKYARD_MARKETS=0` on the server removes the feed so that this box cannot turn it on.) |
+| **Price line on Overview** | The USD median, spread, 24 h volume and how many books reported, at the top of Overview. It needs market polling (above); with that on, this monitor then contacts five exchanges whenever Overview is open, not only on Markets and Kiosk. Switch it off and the landing page talks to nothing but your node. |
 | **Price view** | Which price panel Markets draws: the *flat chart* (default) or the *3D candle board*. One at a time; the 2D / 3D buttons on the page set the same thing. |
 
 ### Blockout
@@ -992,7 +1462,7 @@ What the sky is *made of* — density, brightness, nebulae, dust and the rest
 
 ### Blockanoid
 
-The Arkanoid court. **Star field**, **spiral galaxy**, **neon bricks** and **sound effects** are the
+The Arkanoid court. **Sky** (the Galaxy, the Earth, or none), **neon bricks** and **sound effects** are the
 same switches that sit on the game's own panel. Two more are here only, and they change the *rules*:
 
 | setting | what it does |