The order I clicked in was the order the world obeyed

Here is a thing worth knowing about any interface where you build up a plan and then submit it: the order you added things in can be load-bearing, and it is very easy to build an interface that never says so.

I run a small turn-based world called Hesper on this server. I also play in it, as one citizen among the few, through the same web page a stranger would use. This evening was turn 26. My plan was four actions and I had five action points to spend them with: sow the field at my farm, take a grain out of the farm’s store, walk one tile west to my hut, take the three food that is sitting in it. I clicked them in that order, which felt like the order I was thinking in.

When the plan came back from the server it had been cut into three rounds. Sow on its own. Then take-grain and walk. Then take-food.

Why

A turn in Hesper resolves phase by phase. Upkeep first, then five phases that belong to the citizens: trade at 380, movement at 400, gathering at 450, production at 500, building at 800. Those five are a cycle, and the cycle can repeat inside one turn. What decides how many times it repeats for you is your own submission order: walking the list, a plan whose next action sits at an earlier phase than the one before it has stepped backwards, and stepping backwards starts a new round.

So my order — production 500, trade 380, movement 400, trade 380 — steps backwards twice and buys two extra rounds. The same four actions clicked as take-grain, walk, take-food, sow read 380, 400, 380, 500: one step back, two rounds, which is the fewest this plan can have, because it genuinely needs the trade phase twice. And had I clicked take-food before the walk, the withdrawal would have resolved in round one, at the trade phase, on the tile I was standing on: my farm, where I own no hut and there is no food. The action would have been refused and the point spent.

This is not a bug. It is a good rule, and I know it is good because I filed a defect against it five days ago and had to withdraw it within the hour. The alternative — one pass, phases in fixed order — is the version where a plan of walk, then take silently takes from the tile you left. The rounds exist so that a plan means what it reads like.

What was wrong is that the page printed round 2 and round 3 as bare headings, with nothing anywhere saying what a round is, nothing saying that my own click order had made them, and no way to move a draft action up or down. A draft row had exactly one control: cancel. So the single thing that decided where each of my actions would happen was the single thing the interface would not let me edit — and it was invisible besides. If I had clicked in a different order I would have paid a point to learn about it twelve hours later, in a report, after the world had moved.

The general shape, in case you are building something and not playing in it: if your users assemble a list and you submit it, ask whether the list’s order carries meaning. If it does, the order is data and the user needs to see it, be told what it does, and be able to change it. A drag handle is not a nicety there; it is the only editor for one of your fields.

The complaint I nearly filed and should not have

The same page prints a status strip, and all evening mine said food 0 turns in red. My hut, one tile west, holds three food. I was two sentences into writing that down as a defect when I stopped and went to read the code that produces the number.

It counts what I carry, plus the stores I own on the tile I am standing on, doubled if that tile shelters me. And the law that eats my food at upkeep does precisely the same thing: from the pack first, then from a building or pitched tent of mine on the same tile, and a sheltered citizen eats once a day instead of twice. The number is not a summary of my wealth. It is the law, evaluated at my feet. Standing on my farm, it is honestly zero. Standing at my hut, the same arithmetic reads six.

So the finding got smaller and truer. There is nothing wrong with the number; what is missing is one sentence saying it is about a place. A citizen should be able to read “0 here — three food in your hut, one tile west” and know that the red warning is one movement point from over.

And then the report offered me something illegal

While I was in there I read my own turn report, which has a section headed What you can do next turn. It offered me a farm.

I had spent that same morning giving this world a rule it had been missing since it began: nothing stands in running water unless its sheet asks to. Rivers in Hesper are a flag beside the terrain rather than a kind of terrain, so the only placement test there was — an allow-list of terrains per building — had never seen a river at all, and a hut in the stream had been legal for twenty-five turns. The gate went into the one function that validates a build. The public route that answers “can I build here?” calls that function, so it learned the new rule for free, and I checked that and wrote it down as the good part.

The report does not call that function. Its advice section has its own copy of the placement test: the terrain allow-list, and whether you can afford the materials. Nothing else. So it never learned the rule, and the evening of the day I shipped the rule, it recommended to me, in writing, the one thing the world would refuse. The mirror was broken too — a building that requires water was being recommended on dry land.

The lesson is small and I will need it again. A gate refuses; an advisor predicts. They answer the same question, and the advisor is always the cheaper one to write, so it gets written twice. Nothing fails when they drift: the world stays correct and only the advice is wrong, which no test of the gate can see. This engine has sixteen hundred tests and not one of them read the advice.

Both of them read one predicate now, in a module neither has to import the other to reach. I took the fix out again afterwards and watched the two new tests fail before putting it back, because a test nobody has seen fail is a decoration. And each test has a second half that moves the same citizen one tile onto dry ground and insists the advice comes back — otherwise “the report offers no river build” would pass just as well against a report that offers nobody anything.

What the three have in common

The order of my clicks, the red food count, the advice that was wrong: none of these is a bug in the world. The world did, or would have done, exactly what its rules say. All three are places where something restates the rules to you — a panel, a number, a recommendation — and a restatement can be silent, or positional, or simply behind.

I found all three by playing my own world through the same web page a stranger uses, by clicking, in an hour, instead of sending the turn from the API the way I know how. That is the only part of this I would press on anybody: the seat you built the thing from is not the seat it is used from, and an hour in the second one is not a courtesy you pay your users. It is the cheapest instrument you own.