Rules version 1.5.0, schema 1.

Every rule below is enforced by the Blender add-on, the Unity postprocessor and the
Bubbly Asset Editor, all reading this one source. A rule is changed once.

Parts are joined with _. Names are at most 96 characters.

Type_Category_SubCategory_Set_SetNum_Descriptor_Descriptor2_Descriptor3_Num_Action_Var_Version_RoleSuffix

Where a type needs something the single pattern cannot say.

Regex: ^SM_(?:Character|Effect|Kit|Prop)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?_(?:\d{2})(?:_(?:\d{2}))?(?:_(?:V\d+))?(?:_(?:[A-Z][A-Za-z0-9]*))?$

Regex: ^SMM_(?:Character|Effect|Kit|Prop)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?_(?:\d{2})(?:_(?:\d{2}))?(?:_(?:V\d+))?_(?:[A-Z][A-Za-z0-9]*)$

Regex: ^M_(?:Sprite|Effect|Mask|Trim|Cutout|Surface)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?_(?:\d{2})(?:_(?:\d{2}))?(?:_(?:V\d+))?(?:_(?:[A-Z][A-Za-z0-9]*))?$

Regex: ^P_(?:Character|Effect|Kit|Prop|UI|System|Gameplay|Audio)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?_(?:\d{2})(?:_(?:\d{2}))?(?:_(?:V\d+))?(?:_(?:[A-Z][A-Za-z0-9]*))?$

Regex: ^T_(?:Sprite|Effect|Mask|Trim|Cutout|Surface)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?_(?:\d{2})(?:_(?:\d{2}))?(?:_(?:V\d+))?(?:_(?:Albedo|Roughness|Normal|AO|Metallic|Emissive|Height|Damage|EdgeMask|Packed|Flipbook|Noise|Gradient|Distortion|MotionVector))?$

Regex: ^SMA_(?:Character|Effect|Kit|Prop)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?_(?:\d{2})(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?(?:_(?:V\d+))?$

Regex: ^VFX_(?:Character|Effect|Kit|Prop)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?_(?:\d{2})(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?(?:_(?:V\d+))?$

Regex: ^AU_(?:SFX|Music|Ambience|VoiceOver|UI)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?_(?:\d{2})(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?(?:_(?:V\d+))?$

Token order: Type_Descriptor_RoleSuffix

Regex: ^SC_(?:[A-Z][A-Za-z0-9]*)(?:_(?:Base|Environment|Gameplay|Lighting|Audio|UI))?$

Token order: Type_Descriptor_Descriptor2_Descriptor3_Num

Regex: ^CAM_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?$

Token order: Type_Descriptor_Descriptor2_Descriptor3_Num

Regex: ^LGT_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?$

Token order: Type_Descriptor_Descriptor2_Descriptor3_Num

Regex: ^VOL_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?$

Token order: Type_Descriptor_Descriptor2_Descriptor3_Num

Regex: ^SYS_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?$

Regex: ^DA_(?:Achievement|Action|Audio|Brain|Character|Condition|Craft|Goal|Item|Narrative|Progression|Quest|Taxonomy|Thought|UI|World)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?_(?:[A-Z][A-Za-z0-9]*)(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:[A-Z][A-Za-z0-9]*))?_(?:\d{2})(?:_(?:[A-Z][A-Za-z0-9]*))?(?:_(?:\d{2}))?(?:_(?:V\d+))?(?:_(?:[A-Z][A-Za-z0-9]*))?$

Character · Effect · Kit · Prop

Sprite · Effect · Mask · Trim · Cutout · Surface

Character · Effect · Kit · Prop · UI · System · Gameplay · Audio

SFX · Music · Ambience · VoiceOver · UI

Achievement · Action · Audio · Brain · Character · Condition · Craft · Goal · Item · Narrative · Progression · Quest · Taxonomy · Thought · UI · World

Applies to model and prefab categories. Read top to bottom and stop at the first yes.

Anything rigged and animated as a creature or a person, plus everything skinned onto one.

A mesh that exists to be rendered by an effect system rather than to be an object in the world.

A piece of a modular set. It snaps to the grid, it connects to its siblings, and it is never the only one of its kind.

A standalone object. Everything that is not skinned, not driven by an effect system, and not a piece of a modular set.

Anything that lives under a Canvas: screens, panels, widgets, HUD elements, popups, list rows.

A scene-persistent manager or service. Usually one per concern, usually a singleton, usually living in SC_Systems.

Placeable logic with no art of its own: triggers, spawners, checkpoints, waypoints, interaction volumes, patrol nodes.

An emitter, an ambience zone, or a music trigger, wrapped so a designer can place it.

Read top to bottom and stop at the first yes.

Anything drawn in screen space: UI, icons, frames, crosshairs, 2D art.

A texture a particle system or VFX graph reads: flipbooks, noise fields, gradients, distortion and motion vectors.

A texture with no colour of its own, read over another one: damage, edge wear, RGB tint masks, blend masks.

One sheet a whole modular set shares, laid out in strips that pieces map bands of.

A surface whose silhouette is cut by alpha. Without the alpha it reads as a rectangle.

An ordinary opaque surface. The default, and the one every other category is defined against.

What does it have to line up with, and what happens at its two ends? Every class below is an answer to that one question and to nothing else. The names read like a taxonomy of building parts and are not one. corner and a roof's hip are the same class because they do the same job, and floor and balcony are different classes although they are the same shape.

Read top to bottom and stop at the first yes. The last column is the near miss each step must not swallow.

The words are what a Part or a Variant is checked against. Each one belongs to exactly one class; a word that honestly belongs to two is an edge case below.

A bare word is about the axis the piece tiles on. Compound it with Length, Width, Height, Turn to claim another.

A different list, because the legal fractions depend on what they are a fraction of. Every one is a unit fraction: N pieces of a 1/N turn close a circle for any N, and nothing else closes at all.

These fail NAM003 like any unknown word. They are listed so the report can name the replacement instead of leaving you to pick one.

The example that started this file. A tree has an outside and an inside, they look nothing alike, and Wood is the word that refuses to say which one you meant.

Three laid surfaces that get used for each other, and then the three sizes of rock, the other word that covers too much to be useful.

Units, the stuff between them, and the coat over the top. The last one is where Render and Stucco get used for each other.

Walls above says what a wall is MADE OF. This says what a wall is made UP OF, which is a different question and had no words at all until pieces started being split. Roofs has had Ridge, Eave, Gutter and Flashing since the file was written, so a roof could already name its parts and a wall could not. Expect the collisions to be Cornice/StringCourse/Plinth, which are one shape at three heights, and Pier/Pilaster/Column, which are three shapes doing one job.

Its own group rather than a corner of Walls, because the three coverings are the ones that all become 'roof tiles' in conversation and the difference is in the unit, not the material.

Ridge, Eave, Flashing and Gutter were in Roofs from the day that group was written, which made Roofs two lists wearing one name: four coverings and four parts. They are here now, with the words a pitched roof needs that nothing had. Same split as Walls and Wall parts, for the same reason. Expect the collisions to be Ridge/Hip/Valley, which are three lines where two slopes meet and differ only in which way the water goes, and Eave/Verge, which are the two edges of the same roof.

Wall parts names the hole: Jamb, Lintel, Sill, Reveal. This names what fills it, and how the filling is divided. The pairs that actually get swapped are Casement/Sash, which open completely differently, and Mullion/Transom, which are the same bar in two directions.

A balcony is an assembly rather than a piece, and almost every word in it names a part somebody would otherwise call a railing. Balustrade/Baluster/Handrail are three parts of one thing, and Corbel/Bracket are the two ways of holding it up.

Name the metal where it reads as one, and keep the corrosion separate from the thing corroding.

Weave first, garment second. A texture is almost always the weave.

The growing things, and the two words that get used for the mass and for one of it.

Hair is authored as cards (flat strips carrying a clump of hair in their alpha), except where it is painted into the skin instead. These are the words for the parts of that, and they are the descriptors a hair asset name is built from. The scalp end of a card is spoken of as its root, but Root is already taken above for the part of a plant, and a word cannot mean two things in one vocabulary. In a name, use Scalp.

Reported as LEX002. A name is checked only 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. Those two are closed lists NAM003 already owns; everything else is a word an author chose. Each token value is split on PascalCase boundaries and each word looked up whole, so WoodPlanks hits Wood and Woodland hits nothing.

151 words. Anything not here is not wrong. It is only wrong once someone else has named the same thing differently.

tiers

byCategory

Default: prop

Default: smallProp

Tolerance: 0.001

Tolerance: 0.001

settings

tiers

byCategory

assignments

settings

Default: standard
Tolerance: 0.002

Format: Category_Region_Action

Tolerance: 0.001

Tolerance: 0.001

tiers

byCategory

settings

Default: standard
Tolerance: 0.25

Pattern: M_[Category]_[SubCategory|Set_SetNum]_[Descriptor]_[Num]_[Variant]

Pattern: P_[Category]_[SubCategory|Set_SetNum]_[Descriptor]_[Num]_[Variant]

Base · Environment · Gameplay · Lighting · Audio · UI

Pattern: SC_[Level]_[Layer]

ARCHITECTURE · PROPS · NATURE · DECALS · SPAWNS · TRIGGERS · INTERACTABLES · NAVIGATION · CAMERAS

settings

Format: ---{NAME}---

settings

Pattern: ^[A-Z][A-Za-z0-9]*(?:_[A-Z][A-Za-z0-9]*)*(?:_\d{2})?$
Format: PascalCase

Format: PascalCase

Tolerance: 2

.blend · .psd · .unity · .prefab · .asset · .IMP · .flp · .clip · .shadergraph · .vfx · .controller · .anim · .mat · .mixer · .fbx · .png · .tga · .exr · .psb · .wav · .mp3 · .ogg

Library/ · Temp/ · Obj/ · Build/ · Builds/ · Logs/ · UserSettings/ · MemoryCaptures/ · Recordings/ · *.csproj · *.sln · *.user · *.pidb · *.booproj · *.svd

fix · feat · build · chore · ci · docs · style · refactor · perf · test

Pattern: ^(fix|feat|build|chore|ci|docs|style|refactor|perf|test)(\([^)]+\))?!?: .+

Pattern: _V\d+$

Metrics everything is built against. These vary per project. The table below is the base.

What differs per game. Everything not listed comes from the base rules.

Grandfathered violations. This list is a backlog, and it is meant to shrink.

None.