Real surface finishes for game gun models, worn where use wears a gun.
An MCP server that gives game gun models real surface finishes, worn where use wears a gun.
- A finish library with sources. Anodized aluminium, manganese and zinc phosphate, blued and nitrided steel, ceramic coatings (FDE, OD green, tungsten, graphite, coyote), stainless, polymer, rubber, brass, copper, lead, walnut. Each is a physically based value (linear colour, metallic, roughness) with what shows when it wears through and the sources of its numbers. Values reasoned from descriptions are marked as estimates.
- Coating variants. A spec puts a finish on each material slot of a model, in as many variants as you want (an issued rifle, a two-tone FDE build, an abused one), each at a wear level: new, issued, worn or abused.
- Wear from evidence, baked once. In Blender, into the model's vertex colours: exposed edges, where the hands work the gun (its grip, the support hand, the controls), where parts slide (a magazine in its well, a stock on its tube), and dirt where the surface is occluded and round the muzzle and the port. Every variant reads the same masks, so a new variant costs nothing.
- Checks. Every finish against the rules physically based rendering rests on. Every variant's worn share against its level, and no wear inside corners.
- One formula everywhere. The checks, the look-dev renders and an engine's material compute wear the same way
(
coat.py), so what passes is what the player sees.
Model Lab (modellab-mcp) builds give their own slots (upper, lower,
barrel and more), marks and parts: spec_for_modellab makes a coating spec from a build in one call.
Python 3.10 or later and Blender 4.2 or later.
pip install coatinglab-mcp
{"mcpServers": {"coatinglab": {"command": "coatinglab-mcp"}}}| Setting | Meaning |
|---|---|
COATINGLAB_OUT |
The only folder Coating Lab writes to. ~/.coatinglab by default. |
COATINGLAB_BLENDER |
Blender, when it is not on the PATH or in the usual install folder. |
COATINGLAB_LIBRARY |
A finishes JSON of your own, merged over the built-in library. |
COATINGLAB_WAIT_FOR |
Process names that hold the machine. A bake waits for none of them to run. |
| Tool | What it does |
|---|---|
list_finishes, read_finish |
The library, and one finish with its notes and sources. |
check_library, check_finish |
The library, or a finish of your own, against the physical rules. |
list_wear_levels, list_templates |
The wear levels, and the ready variant sets. |
spec_for_modellab |
A coating spec for a Model Lab build. |
validate_spec |
A spec's problems: a slot without a finish, a finish on the wrong material. |
bake |
Bakes the wear masks into a copy of the model. |
check_coating |
Each variant's wear against its level, and wear kept out of corners. |
render_variants |
Look-dev renders and a sheet. |
engine_params |
A variant's values by slot for an engine material. |
The bake writes the vertex colour Col:
| Channel | Meaning |
|---|---|
| R | Edge: 1 on flat ground, 0 on a sharp exposed edge |
| G | Handling: 1 where the hands work the gun |
| B | Rub: 1 along the lines parts slide on |
| A | Dirt: 1 where the surface is occluded, and round the muzzle and the port |
An engine's material follows the formula in src/coatinglab/coat.py. A wear level is a threshold: the higher the
level, the weaker the mask that already wears through. A grunge texture breaks wear up but never makes wear.
- Every roughness value. No source maps a finish's surface to a rendering roughness.
- The colours of the anodized, phosphate, blued, nitrided and most ceramic finishes. The standards set processes, not colours. OD green and coyote come from FED-STD-595 colour numbers.
- The wear amounts. Sources say where guns wear, not how fast. Each level is set so Model Lab's M4A1 lands in the middle of its band.
- A hand's zone is a sphere: on a round handguard the support hand's wear reaches its top as well as its underside.
MIT