coldice.sh

Operator's handbook

The Grid

Access terminal, version 1

This book describes a network of four billion addresses and the machines that answer at some of them. It explains how to find one, how to get inside it, what will be waiting when you do, and what it costs when that goes wrong.

You are not playing it on your own. There is one Grid and every runner is on it at the same time, so the machine you are standing in is a machine somebody else can walk into while you are still there.

Nothing in here is a spoiler. The Grid keeps no secrets about its own rules; the things worth knowing are the addresses, and this book does not have those. You have to go and look.

Players everyone, on one Grid Client any SSH Install none Account your public key

1Before you begin

The Grid runs on a machine that is reachable from anywhere, and you reach it the same way you would reach any other machine: with an SSH client. There is nothing to download and nothing to register.

$ ssh runner@coldice.sh

Your public key is your account. The first time you connect, one is created for you and you are given a handle, a deck and five hundred credits. Connect again from the same key and you are the same runner. Connect from a different key and you are somebody else, with nothing.

There is no password to lose and no address to confirm. If you keep your key, you keep your runner.

The game runs in your terminal at whatever size it happens to be. Eighty columns by twenty-four rows is enough. More is better, and the display rearranges itself if you resize the window while you are playing.

2The world

The Grid is four billion addresses. Roughly one in eight answers. Everything you find at an address is worked out from that address, which means it is the same machine for every runner, today and in a year. An address worth remembering stays worth remembering, and telling somebody about it does not use it up.

A live machine has a hostname, an owner, an operating system, a list of running services with real version numbers, files, accounts, and an opinion about you being there. Machines are rated one to five.

TierWhat it isWhat is usually defending itThe root password
1trivialnothing, or a sentrysometimes a bad one
2ordinarya sentry, sometimes a barriersometimes a bad one
3defendedbarrier, trapdoor or a huntera word and a number, at best
4seriousbarrier, trapdoor, hunter or blacka passphrase. wants reach 5: a level 5 wordlist (found, not sold), or a level 4 one with cracking 60
5military corehunter or black, at the top of its rangea key, not a password. wants reach 6: a level 6 wordlist (found, not sold), or a level 5 one with cracking 60 (found, not sold)

Nothing on the Grid is generated when you look at it and forgotten afterwards. What players change is kept: files you delete stay deleted, machines you build stay built, and a log you wiped stays wiped.

3Your first run

The shortest useful loop is four commands. Sweep a range, look at something that answered, get through the door, and take what is inside.

runner@coldice.sh:~$ scan 62.14.8.0/24

  62.14.8.44    archive-06        tier 2   ssh, http
  62.14.8.91    print-24          tier 1   ipp
  62.14.8.200   the-cellar        tier 1   ssh, bbs
  3 live of 256 swept.

runner@coldice.sh:~$ probe 62.14.8.44

  archive-06   Ardennes Data Holdings
  openssh 7.4, nginx 1.14.2
  ICE: sentry lv1
  a trace here would take about 40 seconds.

runner@coldice.sh:~$ crack 62.14.8.44

  [*] trying the list against 3 accounts.......
  svc-backup:backup2068   in every wordlist ever printed
  credential saved. connect 62.14.8.44

runner@coldice.sh:~$ connect 62.14.8.44

  archive-06 login: svc-backup
  you are in. 'ls' to look around.

From there, ls lists the files, cat reads one, and get copies it to your deck. What is on your deck is not money yet: a fixer works out of a bulletin board, so you carry it to one and sell it there. If you are ever unsure, hint will tell you what to do next, and it reads your actual situation rather than a script.

Typing less of it

You will have noticed that the address above appears four times. It does that in real play too, so:

KeysWhat they do
Esc then .Types the last address you typed. Press it again for the one before, and again to walk further back.
TabCompletes a command, an address you know, or a file in front of you.
any unambiguous prefixdisc is disconnect. pro is probe.
Shift + ↑ / ↓Reads back what has scrolled off the top, a line at a time. Enter, or coming all the way back down, returns you to now.
PgUp / PgDnThe same, a screenful at a time. On a keyboard with no page keys, fn + ↑ is one.

These are here because the game takes your terminal's own scrollback away and owes you one. The prompt and the bar are pinned to the bottom of the screen, which is done by giving the terminal a scroll region, and a line that falls off the top of a region is one your terminal never keeps. So the game keeps it instead: the last thousand lines, scrolled back through the same machinery that puts the screen together again after you resize the window. The prompt never moves while you read, so a half-typed command is still there when you come back.

Esc-dot is the shell's own yank-last-arg, so if it is already in your fingers it works here the way it works everywhere else. It reads what you typed rather than what the game found: a scan that answers with twenty hosts puts none of them in the ring, because the one out of twenty you wanted is not something the game can guess.

4Three ways through a door

There are exactly three, and they fail differently.

crack

A dictionary attack against the machine's accounts. It is loud, it takes time, and it works on machines whose owners chose badly. Your cracking skill and your wordlist decide how far down the list you can reach.

It takes the best account it can reach, and it prefers root. Passwords come in 6 strengths, and a level N wordlist reaches strength N, with cracking 60 worth one more level on top:

StrengthWhat it is
1in every wordlist
2the sector's own password
3a word and a number
4random
5a passphrase
6a key, not a password

The counter stops at a level four wordlist, which reaches everything a machine at tier three or below is likely to have. Deeper than that the root password is deliberately further off, and the two tiers differ: a tier four passphrase wants reach five, so a level 5 wordlist or the shop's level 4 carried by cracking 60 will open it. A tier five key wants reach six, which the counter cannot sell at any price. For those you get in as somebody ordinary and take the long way up with escalate, or you find a better wordlist out in the Grid.

exploit

Looks for a flaw in something the machine is running. Fast when it lands and useless when it does not, which depends on the software versions the machine actually reports and on how new your exploit kit is.

A machine often has more than one flaw your kit can reach, and they are not equally easy. The kit takes the surest way in by default and prints the odds it is working against, along with the harder flaw it passed over. The harder one is worth more experience, so name a service to insist on it:

exploit 62.14.8.44 sql

A service your kit cannot open is refused outright rather than quietly swapped for a different one.

connect

Walk in with a credential. You get credentials by cracking them, by reading them off a machine that had them written down, or by buying them from another runner. You can also type one somebody told you:

connect 62.14.8.44 svc-backup backup2068

A credential you type is stored on your deck the first time it works, so you only have to type it once. A login you were given rather than worked out is marked as such, and does not count towards your standing on the Wall.

5Noise, alert and the trace

Every action you take inside a machine makes noise. Noise accumulates as that machine's alert, which is shown as a percentage in the panel at the top of the screen. Alert belongs to the machine and not to you. Leave, and it settles.

When alert reaches the machine's threshold, a trace starts. A trace is a countdown. If it finishes while you are still connected, the machine works out one fact about who you really are and writes it into a file on its own disk. See section 9.

Three things buy you time. Being quieter to begin with, which is the damper and your stealth skill. Making the trace itself slower, which is the baffle. And leaving.

Heat, and the deck going dark

Heat is the Grid's attention on your handle rather than on any one machine. Completed traces give it to you, failed logins give it to you, sweeping gives it to you a little at a time, and walking a channel costs it per hop. Lingering on a job after a dangerous crewmate warns you costs a little more. Unlike alert, it follows you off the machine and into the next one: a hot runner is traced faster everywhere.

It also has a hard stop. At 100 heat the deck stops working: no scan, no probe, no crack, no exploit, no traceroute, no route add, no walking a channel, no planting, no offering access, no script that touches the Grid, and no connecting to anything that is not already open to you. A locked deck cannot even tell whether there is a machine at an address: it gets the same answer for a live one as for empty space. It stays locked until the number falls to 50, not merely back under 100, so a deck on the line cannot work for one command and refuse the next.

Heat itself has no ceiling. It keeps climbing past 100 while anything is still adding to it, so the figures below are the shortest the wait can be and not the longest: one completed trace on a tier-five machine taken at 99 lands near 127, which is about 3h 04m.

Nothing clears heat but time. It fades at 25 an hour, so from exactly 100 the wait is about 2 hours. A heat sink is the only thing that shortens it: fully levelled it takes the rate to 58 an hour and that same wait to about 51 minutes.

The three doors that were already open to you stay open while you cool: a public machine, a board, and any node of your own. You can read the Wall and mind your own servers. You cannot break into anything.

deck shows the number and, when it matters, how long is left.

Depth

Machines reached through other machines are deeper. Depth is shown down the left edge of the panel. Surfacing takes one step per layer, so a run four deep is four disconnects and real seconds you may not have. The ascender makes surfacing faster.

6ICE

Intrusion Countermeasures. A machine has at most one, with a class and a level. probe tells you it is there and ice tells you what it does.

ClassFrom tierBehaviour
sentry1Watches everything. Every action you take is louder than it would be.
barrier1Walls off the valuable files until it is broken. Use 'break'.
trapdoor2Plants bait. Touching the wrong file wakes the whole machine.
hunter1Traces fast, and keeps tracing after you drop the link.
black3Fights back. It will burn programs and cook your deck.

Only barrier can be attacked directly, with break and a breaker program at or above the barrier's level. The rest are conditions to work around rather than obstacles to remove.

Black ICE is the one that costs money. It burns a fitted program out of your deck permanently and damages your deck's integrity. Plating takes the edge off it. Nothing makes it safe.

7Your deck

Your deck is a chassis with a number of slots. Programs occupy slots, and only a program in a slot does anything. Owning it is not enough, so gear shows what you have and fit puts it in.

Every program runs from level 1 to level 10. The shop stocks the bottom 4. Above that a program has to be found on a machine or bought from another runner, and each level costs roughly two and a third times the one below, so a level 10 anything is a project rather than a purchase.

Your deck also has integrity, which black ICE takes away and repair buys back, and a hold of 6 items for what you are carrying.

Skills

Four, each 0 to 100, each earned by doing the thing rather than by spending anything.

SkillWhat it buys
crackingPatience with wordlists: how far 'crack' reaches, and how fast.
intrusionMaking an exploit land.
stealthBeing quieter than you were.
sysadminKnowing where the privilege is kept.

8Work and money

Credits come from four places.

A fixer. sell empties your deck at once, and it only works on a board, because that is where the fixers are. The board keeps a cut of what you clear, and you pay the WORSE of two rates: the board's own, and the one your record has earned. Both have to be good before the cut is small.

The open board takes twelve per cent from everybody, including the best runner on the Grid, because nobody reputable is running it. A board that asks three finished contracts of you keeps seven, and one that asks twelve keeps four, but only from the people who have done them: knowing an address is not the same as being somebody it deals with. Turn up somewhere you have not earned and you pay the rate your own record has earned, standing in the good room.

So a finished contract is worth more than the credits it paid. The third one takes five per cent off every sale you make at a board that asks for three, and the twelfth takes another three at a board that asks for twelve. The open board is unmoved by any of it.

That turns carrying something out into a decision rather than a formality. Data is worth what it costs to be the only one holding it, so the same file is worth less every time anybody anywhere sells another copy, and the walk to a better board is time in which somebody else might. Sell first and sell fast, or sell late and sell dear. You cannot do both.

Contracts. Bulletin boards carry work: reconnaissance, a file somebody wants, a log somebody wants cleaned. jobs lists them, take claims one, deliver hands it in. A contract pays for work you did after taking it, so reading the board first is worth the minute.

Courier work. A contract that is not about a file but about getting somewhere. Something has to be carried to a machine too far in to knock on, so the route matters: there are at least 40 distinct ways through, the destination will not open to you directly, and the credential for it is sitting on a machine one step outside. Find that, and then find your way in. The longer the way round, the better it pays.

Crew work. Some payloads are too big for one deck. A crew job needs between two and 10 runners, every seat has to be taken before the clock starts, and then everybody has 1h30m to get their own piece to the destination and hand it over. It is finished when the last piece lands.

There are no separate commands for any of this. A crew job uses the same verbs and they mean something slightly different: take signs you on to a seat rather than claiming the job, deliver hands over your own piece rather than finishing it, drop gives your seat back while the sheet is still filling, and job shows you who else is on it.

Crew work pays each member the full amount multiplied by the size of the crew, so two runners are paid double each and ten are paid ten times each. That is deliberate. Getting nine other people into the same machine inside the window is the hard part, and it is worth paying for.

The market. Other runners. market lists what is for sale on the board you are standing on, and offer puts something up. You can sell data, a way into a machine, or a program.

offer payroll.dat 1200            a file from your deck
offer access 62.14.8.44 800       a login you hold
offer gear wordlist-5 9000        a program, off your deck until it sells

A program leaves your deck the moment you list it, because there is only one of it. Data and logins are information, and the seller keeps a copy of those: selling a login does not take away your own.

Your own machines. See section 10.

9Your name

This is the part of the game where being caught costs something that does not grow back.

Every runner has a true name: a civilian identity you never chose, never see, and cannot change. It is 6 facts.

FactField
legal namename
locationcity
carrier and exchangecarrier
deck signaturedeck
behavioural patternpattern
payment trailmoney

A trace that completes writes one of those facts into a real file on the machine that caught you. Anybody who breaks into that machine can read it, and reading it copies it to their deck. After a delay the record also reaches the attribution clearing house, where it becomes public to everybody. Runners on the Wall leak faster: fame costs you time.

At 4 of 6 public, the Grid can put a person behind your handle. Every machine starts suspicious of you and the heat does not come off.

The two ways out

Wipe it. Get back into the machine that caught you, get root, and wipe. That destroys the record, but only while it is still sitting there and has not spread.

Go underground. underground retires the handle and starts a new one. It works, and it costs you the handle, its standing, and its reputation on every board.

The race nobody can buy out of

There is no way to clear a name. Heat cools and a name does not, which means every handle is on a clock that only runs one way, and the only question is how much you get done before it runs out. That is deliberate: a punishment you can pay to remove is a delay with a price on it, not a consequence.

So the Grid keeps score of it instead. Deepest cover on the Wall is the runners still working with the most already on file — not the ones who were never caught, which is a different list, but the ones who were and went back out anyway. Burn out completely and you come off it: the clock has run, and there is no nerve left in carrying what you cannot survive.

And when a handle finally goes under, that is written into the history with how far it got: what was public, what it earned, what it delivered. The name is gone from everywhere else. This is the one place it is kept, and it is kept under the old name — nothing about it points at whoever you are next.

The other side of it

What you read off other people is yours to keep. dossier on its own shows what the Grid has on you and what you hold on everybody else. dossier <handle> shows one sheet. Holding the most of other people's names puts you on the Archivists list on the Wall.

A copy is forever. If somebody reads a record before you wipe it, wiping the machine does not reach into their deck — it only stops everybody who has not looked yet. That is the whole reason to go back quickly.

All six

Six facts is a complete dossier, and it is the only amount that is worth anything. Five is five. With all six on one person you can do exactly one of two things, once, and then that person is spent — for everybody, not just for you. If somebody else has already sold them, there is nothing left to hunt; if somebody else has already found them, there is nothing left to sell.

expose <handle> sells it. You are paid a thousand credits for every level of the life they are living now — what they have earned, delivered, got into and how deep since they last changed names. Skill does not count here and neither does an old life: a runner who went under last week is worth almost nothing no matter how good they are, and somebody who has been building the same name for months is the find. Then all six records go public at the same moment. Four is the line where the Grid can put a person behind a handle, so a sale always burns them: every node starts suspicious, the trace runs faster for the rest of that name's life, and underground is the only way out. It cannot be taken back.

track <handle> spends it on finding them instead. Six facts say who somebody is; they do not say where the deck is. Against your own level it is a coin toss, and five points a level either way from there. You get one attempt — one for everybody, not one each, so a second key buys nothing. Miss and the trail is cold for good, though you can still sell what you have. Land it and you know where they are.

The Arena

A substation switch room with the switches taken out. No data, no money, nobody's logs, no ICE and no owner — the one place on the Grid that exists so that two constructs can be somewhere without one of them having broken in. Standing in it is not a door you opened and counts for nothing.

callout <handle> is what a landed track buys, and it happens whether or not they are connected: a construct answers for its runner while the runner is asleep, which is what nerve and aggression are for. Nerve cannot refuse this one. The rout still applies — a construct that finds itself in front of something far beyond it drops the link at once, and nothing is counted against anybody. Once. That is what the track bought.

10Machines of your own

A dark address can be made into a machine. plant needs a forge fitted, and what you build is a real node on the real Grid that other runners can find, probe and break into.

What it is for:

  • Storage. A vault holds what will not fit on your deck. Other runners can empty it if they get in.
  • Bouncing. route sends your runs through machines you own, which puts distance between you and the trace.
  • A back way in. backdoor, on a machine you have root on, leaves a way back that does not need the front door. Backdoors expire.
  • Saying something. banner sets what your machine says to whoever gets inside it. A welcome, a warning, or a line of poetry.

You can buy ICE for your own machines with install, and it behaves exactly as it does everywhere else, which means it will happily trace another runner standing in your front room.

11Junctions and roads

Most of the Grid is nowhere in particular. A few addresses are junctions: places with a board, a market, and other runners standing in them. They are where you go when you want to meet somebody rather than hope to.

JunctionWhat it is
The Cellar 62.14.8.200where everybody starts. loud, cheap, and nobody checks anything
Switchboardolder traffic, better manners. the work is worth more here
Deep Watera city in a bad sector. people come for what they cannot get elsewhere

Following the signal

You are not told where they are. Machines carry routing information, and probe reads it: a mask, and how sure the machine sounds.

  route    62.14.8.0/24  one hop out
  route    62.14.8.0/24  same sector
  route    62.14.0.0/16  a long way upstream

It never names the place. It names the direction. Follow the masks and they converge, and far enough out the trail goes cold entirely. That is deliberate: a junction you had to find is worth more than an address somebody handed you, and the first runner to map a route somewhere has something worth selling.

cities lists the ones you have found. Getting close enough to read a machine clearly is what counts as finding one; a faint signal from the far side of a region is a rumour.

A junction is not a safe room. ICE, alert and traces work there exactly as they do anywhere else. What makes a city safe is that it is busy, not that the rules are suspended.

Channels

Junctions are places and channels are the roads between them. A channel is a named route whose last machine is reachable only through it. You cannot scan that machine, you cannot probe it, you cannot connect to it, and knowing its address buys you nothing at all: it answers a walk of the channel and it answers nothing else.

ChannelWhat it is
Longwire (longwire)one leased line nobody has billed for in nine years
Backstitch (backstitch)doubles back on itself twice. that is the whole trick
Nine Mile (ninemile)nine hops on the paperwork. three of them are one building
The Gantry (gantry)built for maintenance traffic. the maintenance stopped
Old Ferry (oldferry)crosses a gap that nothing else crosses
The Culvert (culvert)underneath everything, and usually full of water

The names are fixed. Where each one starts is not: every world lays its roads somewhere different, and the mouth of a channel is the part worth selling.

Finding one, and walking it

A road is written down exactly once, on the machine it leaves from, in /etc/route.map, behind root. Reading it gives you the whole route and saves the far address to your deck. Then you have to get back to the mouth and say the name:

  channel longwire

  [*] opening Longwire out of The Cellar
      hop 1   62.14.207.98    relay-22       still in the sector
      hop 2   87.62.84.57     archive-09     no reverse path
      hop 3   104.173.184.75  core-03        nothing here routes back
      ────    the road ends
  [+] 45.106.147.138 answers. host-14, tier 5.

Opening a road does not put you inside anything. It makes the far machine answer you, and everything after that is the ordinary job: probe, crack, connect, escalate, get, wipe. These are tier five machines and they are as unpleasant as that sounds.

The road stays open until you log out, and it is open for you and nobody else. Somebody standing beside you at the far end walked it themselves.

routes lists the roads you have the map for, which of them are open right now, and what each one would cost.

What a deck runs on

Power is the price of ambition, not the price of existing. Channels cost it. Nothing else in the game does. With a flat deck you can still scan, probe, crack, connect, trade, duel and talk; what you cannot do is run the deep routes today.

A deck holds10 to 50, depending on the battery fitted
A battery adds4 per level, which gives that family a second job besides deck integrity
Empty to fullabout 3 hours, whatever the capacity, so a bigger battery is never a longer wait
A road coststwo, plus one per hop
A top-up costs25 credits a point (power buy)

The recharge is the reason there is no hard cap on anything. Everybody gets some channel running for free, every day, without spending a credit. Buying more is a choice about what an evening's earnings are for.

power shows the meter. It also appears in the status bar, but only while there is less than a full deck of it: a meter that is always at its maximum is furniture.

12Constructs and duels

A runner can build an avatar: a construct that runs from the deck and fights other runners' constructs. Two runners inside the same machine can set theirs on each other. avatar new <name> builds one.

The fight itself is automatic. It lasts 4 rounds and nothing is typed while it happens, so it is decided by what you built and how you told it to behave, not by how fast you can type. Somebody on a slow link is not at a disadvantage.

It opens over the wire, with each side trying to get a virus into the other's deck before the constructs ever touch. Closing to the same process costs a turn.

Three settings, three questions

This is the whole of it, and each setting answers a different question. Aggression starts a fight, nerve permits it, and bravery both refuses it and ends it. Aggression and nerve are public. Bravery is not.

Bravery refuses before a blow is struck. A construct that finds itself in front of something far beyond its own weight drops the link at once, and nothing can override that: no damage, no record, nothing counted against anybody. It is the reason attributes stop at 20 and a long-lived construct is not simply a bigger one. Age shows in the record instead — wins, streaks, what it has taken off whom — and a beginner does not get to stand in front of a veteran and win on a lucky roll, because it does not get to stand there. How far above itself each setting will go is in the table below. Fearless means it.

Nerve: who you will fight

Nerve is a weight class. It says how far above your own weight you are willing to be, and it is asked of both constructs before anything happens.

Weight is your level plus everything you have fitted. Level is the points spent on the construct; weight is what you are walking in as. Both are public, both are on the band at the top of your screen, and it is weight the gate reads. Fitting heavy things makes you heavier, so fewer people will take you on, and the ones who do have chosen to. There is no cap on it and there does not need to be one: at some point you are carrying a monster nobody will fight. If either one refuses, the link simply drops: no damage, no record, and it does not count as a defeat.

That is what protects a newcomer from the fights nobody asked for, and it is on by default. A runner who has changed nothing carries nerve 5, which refuses everybody above them.

It does not protect you from somebody standing in the machine with you. Nerve decides what your construct tolerates while nobody is driving it. A runner who has found you, is connected to the same machine, and types your name has taken the wheel, and the fight happens whatever either of you had it set to. The same is true in reverse: your own nerve never stops you calling somebody out in person.

Fights you did not start

Two of them, and neither one overrides your nerve. Both are the ordinary gate, asked the ordinary way, with your own setting on your side of it.

The crew. There are runners on the Grid who are not people, and they have constructs of their own. One standing in the same machine as you may set theirs on yours without anybody typing anything. If your nerve does not permit the gap, it does not happen: the link drops, no damage, no record. If it does happen you are told what it was, how it ended and what it paid, wherever you are and whatever you were doing.

Machines. Some machines are already running a construct when you break in. It is not ICE — ICE is the door, and this is an occupant. Nothing below tier 3 ever has one; above that it rises with the tier, from 20% to 60% of machines at the deepest. When you arrive, a machine with a tenant notices you about 50% of the time — and when it does not, you will never know it was there.

Its strength is the tier and nothing else. It does not grow, it is not somebody's, and it is the same construct every time you come back: a machine forty people have fought in is exactly as hard as one nobody has found. The deepest of them run to about level 25, which is past anything else you will meet.

Beating one pays a bounty on the machine, claimed once a day by whoever gets there first, across the whole Grid. Losing costs what losing a duel always costs. And if you have no construct at all, nothing happens to you: it reads your deck, finds nothing to answer it with, and goes back to watching.

Fifty things to carry

An avatar has five slots. There are fifty items to put in them, with no levels and no upgrade path, and every one of them is a trade: a spread across two to four attributes, some up and some down. Nothing is simply better than anything else, so the question is never "is this good" but "is this good for the construct I built".

SlotHow many
chassisone
edgeone
payload2, and a chassis can change that
counterone
routineone

An item's weight is what its spread adds up to, and nothing else. Give two more than you take and you are two heavier; give back everything you take and you are free to carry, however dramatic the trade. That is why weight can be trusted at the gate: you cannot get net power for nothing.

You also have to be able to pay what an item takes. No attribute can be driven below one, so the deepest trades are something you grow into, and the item you cannot wear yet is the one worth trading for.

How rare, and what rarity buys

Rarity buys shape, not power. A common item nudges two attributes; a unique one moves all four and moves them further. The weights are much the same across the range, which is deliberate: a deep find should change what your construct is, not simply make it stronger, because the curve has to stay flat enough for somebody who arrived today.

  • Common. Sold by a fixer, or found on tier 1 and 2.
  • Rare. Tier 3 and 4.
  • Extra rare. Tier 5.
  • Unique. Six of them, and each exists exactly once in the whole world. When somebody takes it, that is the only one there will ever be.

Every item remembers the machine it came out of and who first pulled it.

avatar kit is what you own, avatar fit <name> puts something on, and avatar shop is what a fixer stocks.

Selling it on

offer kit <name> <price> puts a piece on the board you are standing on, and it works exactly the way selling a program does: one object, off your construct the moment it is listed, onto the buyer's when it sells. Nothing is copied, so nothing loses value the way a leaked file does. withdraw takes it back.

It arrives owned and not fitted. What suited the person who sold it is very often wrong for the person who bought it, and that is the whole reason this market is worth standing in.

NerveWhat it means
1nothing starts on you by itself. somebody here can still call you out.
2you fight only constructs 3 or more lighter than you.
3you fight only constructs 2 or more lighter than you.
4you fight only constructs 1 or more lighter than you.
5you fight at or below your own weight, never heavier.
6you fight anyone up to 1 heavier than you.
7you fight anyone up to 2 heavier than you.
8you fight anyone up to 3 heavier than you.
9you fight anyone up to 4 heavier than you.
10you fight anybody, at any weight.

Nerve can be raised at any time and lowered only after two hours. You can always decide to be braver on the spot; backing off is something you commit to in advance.

Aggression: whether a fight starts at all

Two runners in the same machine is the ordinary case, so something has to decide whether anything happens. Read only for the side that might begin it. Typing duel yourself is not governed by it: aggression describes what your construct does while you are busy elsewhere.

SettingBehaviour
dormantstarts nothing. still answers
guardedstarts nothing, answers anybody
watchfulstarts on somebody clearly weaker
huntingstarts on anybody nerve allows
rabidstarts on anybody, without looking first

Dormant is not immunity. It means you start nothing; you will still be fought if your nerve allows it. Nerve 1 stops every fight you did not ask for, and nothing else: anybody in the machine with you can still call you out by name.

Bravery: when it runs

The private setting, and the only one your opponent cannot read. A failed escape wastes the turn, so running early is not free.

SettingBehaviour
cowardleaves below 75% coherence; walks away from 6 over its weight
carefulleaves below 50% coherence; walks away from 9 over its weight
steadyleaves below 30% coherence; walks away from 13 over its weight
braveleaves below 15% coherence; walks away from 20 over its weight
fearlessnever leaves, and stands in front of anything

Plans

An ordered list of rules, first match wins, which is what your construct follows during the fight. Pick one with avatar plan <name>.

PlanRules
balancedif failing -> drop the link; if over the wire and holding a virus -> inject; if in the same process -> strike; else -> close
aggressorif failing -> drop the link; if in the same process -> strike; else -> close
turtleif failing -> drop the link; if hurt and holding a patch -> patch; if exposed -> harden; if in the same process -> strike; if holding a virus -> inject; else -> harden
sniperif failing -> drop the link; if in the same process -> break off; if holding a virus -> inject; else -> harden

What it costs and what it pays

Losing crashes the construct and damages the deck's integrity, which repair buys back. Nothing is stolen: no gear, no credits, no permanent loss. Duelling is not a way to take somebody's things.

Attribute points come out of what you risked. Carrying a high nerve pays more, because more of the Grid could have reached you while you carried it, and reaching above your own weight pays more again. Being crashed pays a single point. Running away pays nothing. Beating somebody three or more levels below you pays nothing at all, which means the bullying setting cannot grow.

Fighting the same person over and over is worth less each time and nothing by the fourth bout, and it resets after 1 day. A rematch that is worth nothing is refused outright, because the machine you are standing in pays for the noise either way.

And winning pays credits. 10,000 against your own weight, moved 2,000 by each level of difference either way. Only a decisive win pays: a standoff is worth attribute points but it is not a victory, and running is worth neither.

Both rewards are capped at 3 duels a day. Past that a fight still happens, still counts on your record and still moves a streak — it simply stops paying. The cap is the whole reason the rest of it can be generous: there are enough constructs on the Grid to fight one every minute until morning, and a reward without a ceiling is a reward you grind rather than earn. Losing counts toward it too, or turning up to lose would be a living.

Not every handle on the Grid belongs to a person. Beating one that does not is a bounty on that construct rather than a payment to you: the first runner to take it in a day gets it, and everybody else who beats the same one that day gets nothing. Beating an actual person pays in proportion to what they have done, so a handle made five minutes ago is worth nothing at all to beat.

A duel is loud. It raises the alert on the machine it happens in, for everybody standing there, which makes picking your ground part of it and makes duelling in the middle of a run a bad idea. Duelling alone can never drive a machine past its trace line, so a crowd cannot poison somebody else's node with it.

A new construct spends 12 points across four attributes and no attribute goes above 20. The curve is deliberately flat: a veteran is about three times a newcomer, not fifty times, because a permanent world has to stay open to somebody who arrived today.

13The history

Some things can only happen once. The first runner through a door, the first to find a junction, the first to pull a one-of-a-kind item out of the dark. When one of those happens the Grid writes it down, with your name on it, and never takes it off again.

The rule is that if a thing can happen twice in a day, it is not history. A log of everything is not worth reading; a page where every line is the only time that thing ever happened is worth reading for years. So the list is short on purpose, and most of it is finite: there are six one-of-a-kind items and three junctions, and each is claimed exactly once by exactly one person, forever.

Records are the other half. Nobody writes a line for the ten thousand sales that did not beat the biggest one, but taking a record off somebody is itself worth a line, and it names them both.

And then there is everything else, which is mostly people having a bad evening in an interesting way. Losing three duels in a row gets written down. So does losing five, and ten.

  day 1    deckard was the first runner on the Grid.
  day 3    tilly pulled the ghost off core-11. there is only one.
  day 9    rook lost to kestrel, and then lost twice more without
           stopping to think about it.

Reading it

history is the recent entries, history firsts is the honour roll in the order it happened, and history <handle> is one runner's part in it. The same thing is on the website at coldice.sh/history.

It records who you were

The name in an entry is the one you had when you did the thing. Change your handle and the old entries keep the old name; go underground and burn the identity entirely, and the Grid still remembers what was done under it. That is deliberate. You can stop being that person. You cannot make them not have existed.

14The boards are readable from outside

The Cellar is mirrored on the website, at coldice.sh/boards. It is a mirror and nothing more: nobody can post from a browser, there is no account to make and no reply box. The game writes the page every five minutes and the web server hands it over.

What you write there can be read by somebody who has never connected. That is the point of it: a game whose community is invisible from outside looks like a game nobody plays. But it is your writing, so it is your call.

  whoami hide posts     
    your posts, on the website is nobody's business but yours.

  unpublish 412         
    #412 is off the website.

whoami hide posts keeps everything you write from then on inside the game, and whoami show posts puts it back. unpublish <id> takes one post off, and takes its replies with it; publish <id> puts one back. Both work on your own posts only. When you post, the reply tells you which way it went, so it is never a thing you find out later.

Only The Cellar is published. Switchboard says it does not tell anyone who you are, and Deep Water is invitation only. Putting either of them on a public URL would make the place into something it is not. Nothing you write there leaves the Grid, whatever your setting says.

Neither does anything that has been reported and taken down, or anything written by somebody who is currently silenced. The page is rebuilt every five minutes, so a post taken off it is gone within about that.

15Writing a script

The Grid has a language. It is called ci, files are .ci, and it exists because typing probe forty times is not the interesting part of anything.

A script is a faster keyboard, not a new power. It can do exactly what you could do by typing, and it cannot do it any faster: a sweep from a script costs the same from the same bucket as a sweep you typed, makes the same noise, and takes the same deliberate seconds. There is no version of this that turns into an address-space scanner.

What a script can reach

What it does
scan(range)Sweeps a range and answers with a list of what replied.
probe(address)One machine, or nil if nothing answers.
log(...)Prints to your own screen, and nobody else's.

That is the whole list. A script cannot connect, crack, take, sell, plant or speak — it looks, and it tells you what it saw. Those are the parts worth automating; the rest is the game.

Writing one

script edit sweep and then type. A single dot on a line of its own ends it.

runner@deck:~$ script edit sweep
  typing sweep. end with a single dot on its own line.
... for h in scan("62.14.8.0/24")
...   let p = probe(h.addr)
...   if p.tier < 3 and p.ice == "none"
...     log(h.addr, h.host, "tier", p.tier)
...   end
... end
... .
  sweep saved, 7 line(s). 'run sweep'

A sweep sees less than a probe

This matters, and it is why the example probes inside the loop. scan answers with what a sweep can see — and nothing more, because that is all the typed command shows you:

Fields
scanaddr, host, services
probethe same, plus org, tier, ice and lv

Knowing a machine's tier costs a probe, from a script exactly as it does from the keyboard: two tenths of the deck's bucket and the six hundred milliseconds. A version of scan that handed back tiers would have made triage several times cheaper in a script than by hand, which is precisely the thing this is not allowed to be.

Then run sweep. script lists what is on your deck, script show <name> reads one back, and script rm <name> throws one away. Ctrl-C stops a running script.

The language

let, if / elif / else, while, for x in, fn, return, break, continue, all closed with end. Numbers, text, true / false / nil, lists [1, 2] and records {a: 1} read with x.a. # starts a comment. There are no classes, no imports and no libraries, and there will not be: the absence of that whole category of problem is worth more than the convenience.

Scripts are files

A .ci on a machine is an ordinary file. You can cat it, and if you get it, it goes onto your deck where it can be run rather than into the hold to be sold. So a good script spreads the way an address does: somebody finds it, and tells somebody.

When it stops

Three things bound a run, and they stop three different problems: the cycle budget stops a program that computes forever, the deck's bucket stops one that asks the Grid for too much, and a time limit stops one that is doing nothing wrong very slowly. If the deck runs out rather than the program going wrong, it says so — you are not meant to go hunting for a bug that is not there.

ACommand reference

94 commands. In the game, help lists them by group and help <command> explains one.

Finding things

CommandWhat it does
channel <name>walk a channel from its mouth and open the far end
citiesthe junctions you have found, and where they are
hosts [new|sector|name]your map: what you know, and what you have not been inside
power [buy]what the deck has left, and what a top-up costs
probe <address|host>identify one host: services, ICE, trace estimate
routesthe channels you have the map for
scan <cidr>sweep an address range for live hosts
traceroute <address|host>show the hops on the way there

Getting in

CommandWhat it does
connect <address|host> [user] [password]log in with a credential you have, or one you were told
crack <address|host>dictionary attack on its logins, loud
exploit <address|host> [service]break in through a flawed service, fast, unreliable

Inside a machine

CommandWhat it does
backdoorleave a way back in (root only)
breakattack a barrier (needs the breaker program)
cat <path>read a file, where addresses and logins come from
depthhow far under the surface you are
disconnectsurface, one layer at a time
escalatetry to become root
get <path>copy a file to your deck
icewhat is defending this node, and how
logsread the auth log (root)
lslist files on the node you are inside
tag <text>leave a message on a machine somebody else built
userslist accounts on this node
wiperemove yourself from the log (root)

Bulletin boards

CommandWhat it does
board [category] [page]read the bulletin board on this node
buy <listing>buy data from the market
flag <id> [why]report a post to a person who reads them
job <id>read one contract
jobscontracts on this board
marketdata for sale on this board
offer <item> <price> · offer access <address|host> <price> · offer gear <program> <price>sell something you are carrying, a way into a machine, or a program
post <cat> <title> | <text>post to the board you are on
publish <id>put one of your posts on the website
read <id>read a post and its replies
reply <id> <text>reply to a post
take <id>claim a contract
unpublish <id>take one of your posts off the website
withdraw <id>take your listing back

Contracts you carry

CommandWhat it does
contractsthe jobs you are carrying
deliver <id>hand in a finished contract
drop <id>give a contract back

Other runners

CommandWhat it does
block [handle]stop hearing from somebody
history [firsts|<handle>]the firsts and the disasters, since the Grid began
leaderboard [list]the standings, from wherever you are
newswhat happened while you were away, again
page <handle> <text>message a runner anywhere on the Grid
report <handle|id> [why]tell a person about somebody
runners [query] [page]search who is online
say <text>talk to the runners on this node
unblock <handle>hear from them again
whowho else is on this node with you

Constructs and duels

CommandWhat it does
avatar [new <name>|kit|shop|buy|fit|unfit|aggression|bravery|plan|spend] ...your construct: what it is, what it carries, how it behaves
duel <handle>set your construct on somebody in this machine
duelswho here you could fight, and who will not have it
nerve [1-10]how far above your level you will fight

Your deck

CommandWhat it does
credslogins you have collected
deckyour hardware, credits and heat
fit <name>put something into a slot
gear [name or family]what you own; name one thing for what it does, in numbers
lootdata on your deck
repairpatch your deck back up, for credits
rigyour deck: slots, what is in them, what it all does
run <name>run one of your scripts
script [edit|show|rm] <name>programs on your deck, written in ci
sellsell your deck to a fixer, on a board, which takes a cut
shop [program]buy a program, or take one up a level
unfit <name>take something out of a slot

Machines you own

CommandWhat it does
banner <text> · banner clearwhat your machine says to whoever gets in
install <class> <level>buy ICE for your own node
minethe nodes you have built
nodesyour backdoors and how long they have left
plant <addr> <host>build your own node on a dark address
rm <path>delete a file from your own node
route [add <address|host>|clear]bounce runs through nodes you own
untagclear what strangers wrote on your machine
vault [store|take|empty]storage on a player node, yours or theirs
write <path> <text>store a file on your own node

You, and your name

CommandWhat it does
callout <handle>fight somebody you tracked down, at the-arena
dossier [handle]what the Grid has on you, or what you have on them
expose <handle>sell a complete dossier to the clearing house
handle <name>change your handle
skillswhat you have learned by doing it
track <handle>spend a complete dossier on finding somebody
underground [new handle]retire this handle and start again
whoami [show|hide <thing>]who you are, and what others see of it
whois <handle>what a runner shows about themselves

The terminal itself

CommandWhat it does
clearclear the screen
exitclose the terminal
help [command]list commands, or explain one
hintwhat to do next
hud [on|off]the animated panel at the top
skipstop the first-run hand-holding
termwhat the server thinks your terminal is

CConstruct kit

All fifty, by slot. Weight is the net of the spread and nothing else. An item that gives back everything it takes weighs nothing, however dramatic it is, and several of the best ones are exactly that.

ItemSlotRarityWTradeWhereWhat it is
ablativechassisrare1-1 edge -1 reflex +4 frame -1 signaltier 4layers to lose. the first hits cost you nothing
latticechassiscommon1-1 reflex +2 framefixerlight bracing. more of you, a little slower
carapacechassiscommon0-2 edge -1 reflex +3 framefixerheavy plate. you will feel it in your hands
driftwoodchassisrare0-2 edge -1 reflex +2 frame +1 signaltier 4accreted junk. odd, tough, and slow with it
hollowchassisrare0+1 reflex -2 frame +1 signaltier 3gutted for room. a third payload, and less of you
kesslerchassisunique0+2 edge -3 reflex +2 frame -1 signalone onlywreckage that takes company with it
mirror shellchassisunique0+1 edge -2 reflex +3 frame -2 signalone onlypolished to nothing. what hits it notices
stock framechassiscommon0no change at alltier 0what everybody starts in. no trade at all
second windcounterrare2-1 edge +2 frame +1 signaltier 3one more patch than you packed
answercounterrare1+2 edge +1 reflex +1 frame -3 signaltier 4gives the first one straight back
bootstrapcounterrare1-1 edge +2 reflex +1 frame -1 signaltier 4comes back up, once, from almost nothing
deadmancounterunique1-2 edge -2 reflex +4 frame +1 signalone onlyone more breath than you actually had
ghostcounterunique1-2 edge +4 reflex -2 frame +1 signalone onlyyou leave when you decide to leave
purgecountercommon1+1 reflex +1 frame -1 signalfixerthrows the first thing off before it sets
stiffencountercommon1-1 edge -1 reflex +3 frametier 2sets hard the moment it has to
tripwirecounterrare1+1 edge +1 reflex -1 signaltier 3coming close costs them something
shroudcounterrare0-1 edge +1 reflextier 3there is nothing on you to read
arcedgeextra rare2+3 edge -1 reflex -1 frame +1 signaltier 5it builds while it runs
feedbackedgerare2+1 edge -1 frame +2 signaltier 3hits the deck as well as the construct
humedgerare2-2 edge +1 reflex +3 signaltier 4no blade at all. it simply gets louder
shivedgecommon2+1 edge +1 reflexfixershort, quick, and nothing to it
mauledgecommon1+4 edge -2 reflex -1 signaltier 2enormous, and slow to bring round
needleedgerare1+2 edge +1 reflex -2 frametier 3finds the gap. nothing to hide behind
rustedgeextra rare1+1 edge -1 reflex -1 frame +2 signaltier 5gets into the shielding and stays there
scalpeledgeextra rare1+2 edge +2 reflex -2 frame -1 signaltier 5for finishing, never for starting
cleaveredgerare0+4 edge -1 reflex -1 frame -2 signaltier 3everything in one swing and nothing left over
twinedgecommon0+2 edge +1 reflex -1 frame -2 signaltier 2two lighter passes instead of one
blindpayloadcommon2-1 edge +2 reflex +1 signaltier 2they stop seeing you coming
bloompayloadrare2-1 reflex +3 signaltier 3opens once, and then again
clamppayloadrare2-2 reflex +2 frame +2 signaltier 3holds them exactly where they are
leechpayloadrare2+1 edge -1 reflex +2 frametier 3takes back some of what it spends
mimicpayloadextra rare2+2 reflex -2 frame +2 signaltier 5learns whatever they brought with them
severpayloadcommon2+1 edge -1 frame +2 signaltier 2cuts the belt before they reach for it
quarantinepayloadunique1-2 edge +1 reflex +1 frame +1 signalone onlywhatever they were counting on does not fire
smearpayloadcommon1-1 edge +2 signalfixercrude, and it always works. heavy in the hand
stallpayloadunique1-2 edge +1 reflex -2 frame +4 signalone onlya whole turn of nothing happening to you
staticpayloadrare1-2 edge +1 frame +2 signaltier 3nothing lands cleanly anywhere near it
unspoolpayloadextra rare1-2 reflex +1 frame +2 signaltier 5slow, and worse the longer it is left
keyholepayloadcommon0-1 edge +1 reflex -1 frame +1 signaltier 2reads far more than it breaks
signaturepayloadcommon0+1 reflex -1 signaltier 2marks them rather than hurting them
wedgepayloadrare0+2 edge +1 reflex -3 signaltier 3closes the distance whether they like it or not
closerroutinerare1+2 edge +1 reflex -2 signaltier 3no wasted step getting in
duellistroutinecommon1+2 reflex -1 signalfixertrained for the close
first bloodroutinecommon1+2 edge +1 reflex -1 frame -1 signalfixereverything into the opening
last standroutinerare1+3 edge -2 frametier 4worth more the worse it gets
opportunistroutinerare1+2 edge +1 reflex -2 frametier 3takes the moment they blink
patientroutinecommon1-2 edge +2 frame +1 signaltier 2waits, and is harder for having waited
standoff drillroutinecommon1-1 edge +2 signaltier 2trained for the wire
grudgeroutinerare0+2 edge -2 signaltier 3remembers exactly who
nerve holdroutinerare0-1 edge +2 reflex -1 signaltier 4it does not panic, whatever you told it

BEquipment

Prices are the shop's, in credits. The shop sells to level 4 only. Level 10 is shown to give the shape of the curve, not because you can buy one.

ProgramWhat it is forLv 1Lv 4Lv 10Slots
logedit'wipe' uses this. A higher level edits the log faster and more quietly.3003,650540,3401
wordlist'crack' uses this. A higher level knows passwords more people thought were clever.4004,860720,4601
breaker'break' uses this, against barrier ICE. Below the barrier's level you will not get through.5506,690990,6301
holdMore room on the deck for what you are carrying.6007,3001,080,6901
exploitkit'exploit' uses this. The level is how new the flaws it knows about are.6507,9001,170,7401
busTransfers finish sooner, so 'get' is less time standing still.7008,5101,260,8001
ascenderSurfacing through a chain of machines is faster.8009,7301,440,9201
damperEverything you do is quieter, so machines take longer to notice you.90010,9501,621,0301
batteryMore deck integrity, so there is more to lose before anything is fried.1,00012,1601,801,1501
cloakA machine starts less suspicious of you, even when it already knows the name.1,10013,3801,981,2601
sensor'probe' reads one more thing off a machine for every level of this.1,20014,6002,161,3801
platingBlack ICE does less damage, and is less likely to burn a program off the deck.1,30015,8102,341,4901
baffleA trace takes longer once it has started, which is time to wipe and get out.1,40017,0302,521,6101
array'scan' sweeps a wider range, and every level costs less heat to sweep.1,50018,2502,701,7201
heatsinkHeat fades faster, and a locked deck comes back sooner.1,60019,4602,881,8401
beacon'probe' says who is inside a machine, and at higher levels who is near it.1,70020,6803,061,9501
ledgerA fixer pays more for the same data.1,80021,9003,242,0701
spooferWhen a trace lands, it costs you less heat than it should.1,90023,1103,422,1901
analyser'break' is likelier to get through a barrier.2,00024,3303,602,3001
janitorSometimes cleans the log on the way out when you forgot to. Needs a logedit fitted.2,20026,7603,962,5301
clockThe deck does everything faster, every pause is shorter.2,40029,2004,322,7601
router'route' bounces through more of your machines, and every level makes each hop buy more trace time.2,60031,6304,682,9901
scrubberA record takes longer to reach the clearing house, which is time to scrub it.3,20038,9305,763,6802
maskA completed trace sometimes recovers nothing at all about you. See 'dossier'.4,20051,1007,564,8402
forge'plant' needs this: it is what builds a machine of your own on a dark address.25,000304,17045,028,8102

CSpecifications

Addresses in the Grid4,294,967,296
Roughly aliveone in eight
Machine tiers1 to 5
ICE classes5
Program levels1 to 10
Sold by the shoplevels 1 to 4
Price step per levelabout 2.3 times
Skills4, each 0 to 100
Deck hold, unfitted6 items
Facts in a true name6
Public facts to be burned4
Starting credits500
Commands94
Client requiredany SSH client
Accountyour public key