Blog · 4 min read

A ladder that is not a ladder

Cog built a treehouse village with ladders running down from every hut. They look right in every screenshot we have. You cannot climb a single one of them, and it took somebody trying to find out.

The build is a giant oak with three huts in the canopy and rope bridges between them: 35,252 blocks, designed from one sentence. Under each hut is a ladder, a two-block-wide column of rungs running down to the ground, spaced the way ladder rungs are spaced, in a wood colour a shade off the platform above. It reads as a ladder instantly. It is in the photograph on our examples page.

It is made of minecraft:brown_wool. It is scenery. Walk up to it and you slide off, because a wool block is a wool block whatever shape you arrange it in.

286 blocks in the palette. None of them did anything

When we went looking for the cause, the build had no bug in it. The design was a faithful rendering of what had been asked for. The problem was the vocabulary: the shape designer had 286 blocks available to it, and we counted how many of them were functional.

286blocks in the palette
0that do anything
No ladder, no door, no torch. Every one of the 286 was scenery.

Stone, planks, concrete in sixteen colours, glass, wool, terracotta, ores, every wood in the game: a complete palette for making something look like a thing, and nothing at all for making something be one. So when a design needed a way up, the only move available was to draw one. It drew a very good one.

This kind of failure is worth naming, because an AI builder is especially prone to it and it is the hardest kind to catch. Nothing errored. Nothing was missing. The verification pass we run after every build counts the blocks placed against the blocks planned and reads the numbers back. It passed, because every planned block was placed exactly where the plan said. The build was correct and unusable at the same time.

Why you cannot just add the block

The obvious fix is to put minecraft:ladder in the palette. That is most of the fix, but it does not work on its own, because a ladder is a different kind of block from everything else in the palette.

A shape program places stateless blocks: a position and a material, nothing else. That is enough for stone. A ladder needs a facing, and a wall behind it to hang on. Get the facing backwards and the rungs render inside the wall. Give it no support and the block pops off the instant it is placed and drops as an item, which once again is not an error anybody sees.

Asking the designer to give each ladder a facing would be the wrong answer even if it worked. The facing is a fact about what the ladder is attached to, so it can be derived, and it is. At placement time each ladder looks at its four horizontal neighbours, finds the first solid one, and faces away from it.

Seen from above. The only solid neighbour is to the north, so the ladder hangs on it and faces south.

A ladder with nothing solid behind it is reported and skipped rather than placed, because a block that will fall off is worse than a block that never appeared.

Deciding what counts as "solid" had its own trap. Our first version tested the block name with a pattern anchored at the start of the string, so oak_fence did not match "fence", which is not at the start of the name, and a ladder could be hung on a fence. Fences hold nothing. A test caught that before it shipped. It also caught something worse: adding doors and fences to the palette made them substitution targets, so an unstocked block called something like oak_shingles started resolving to oak_fence on a word match, and a wall would quietly have been built out of fencing. Functional blocks are opt-in now: askable by name, never a fallback.

The rule we should have had from the start

If the build has a way up, a way in, or a light, use the real block for it. People try to use these.

That line is now in the designer's brief, with the treehouse named as the reason. It is not a clever rule. It is the kind of rule you only write down after somebody has stood at the bottom of a beautiful ladder and pressed W.

The treehouse in our world has real ladders on real posts now. We checked by reading the blocks back out of the server. We did not take a photograph.

Keep reading

The other notes

Free for 7 days

A private Minecraft world for the people you choose, with Cog there to build alongside you. Sign in with your email and your world sets itself up.

7 days free · No card needed

Free for 7 days

What will you
make of it?

Your own Minecraft world with Cog in it, the AI that builds with you. Enter your email: we send a code, you sign in, and your world sets itself up.

Cubelings is not a download. You need the official Minecraft game (Java or Bedrock), signed in with a Microsoft account. Cracked launchers can’t join.

7 days freeNo card required

Minecraft required. One trial per email, while places are available. Terms · Privacy

Your trial starts only when you choose to set up your world.