The Words We Use
From Asset Rules (Generated), which is the same JSON the validators read. Change a word in the
bubbly-asset-rules repo, not here.
Naming Conventions says what shape a name is. This page says which word goes in it.
It exists because two people naming the same thing differently is the quiet way a project becomes
unsearchable. Nobody is wrong, both names are legal, and neither of them finds the other's asset.
How to use this page
You do not read it. You come here when you are about to name something and there are two words
that would both do, or when LEX002 fires and you want to know why.
LEX001is info: the descriptor is not the studio word for that thing.LEX002is a warning: the name uses a word we have replaced, and the message names the
replacement.
A name is only checked once it parses. An unreadable name was already reported by its NAM
rule, and a second row for the same file is how a report gets skimmed. Every token except Type and
Category is checked, split on PascalCase boundaries and looked up whole, so WoodPlanks hits Wood
and Woodland hits nothing.
The conventions
The last of those is the important one, and it is more permissive than people expect:
A word not in this file is not wrong. It is only wrong once someone else has named the same
thing differently. That is the moment to add both here and pick one.
So this is not a list to obey. It is a record of the arguments that have already been had, so that
nobody has to have them again.
Words we have replaced
The ones that actually fire. Worth skimming once, because several are words you would reach for naturally.
By group
Wood
Ground, paving and stone
Walls
What a wall is made of.
Wall parts
What a wall is made up of: the words a split element needs. Added 2026-09-21 with
Splitting a Piece, because a roof could already name its parts (Ridge, Eave, Gutter,
Flashing) and a wall could not.
Openings
What fills a hole, and how the filling is divided. The parts of the hole itself are under
Wall parts above. → Openings
Roofs
The four coverings, which all become "roof tiles" in conversation.
Roof parts
What a roof is made up of. Ridge, Eave, Flashing and Gutter moved here from Roofs on
2026-09-21, which had been two lists wearing one name since it was written. → Roofs
Balconies and railings
Three parts of one balustrade, and the two ways of holding a balcony up. → Balconies
Metal
Fabric
Nature
Every word
When you hit a thing the list does not name, and you can tell that someone else would have named it
differently, add both, pick one, and say why. That's the whole process, and it is how every entry
above got here.
Changes go in the bubbly-asset-rules repo, then npm run docs && npm run vault.