Coating Lab
Real surface finishes for game gun models: sourced finishes, variants, wear baked from use
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
coatinglab-mcpclaude mcp add coating-lab -e 'COATINGLAB_OUT=<COATINGLAB_OUT>' -e 'COATINGLAB_BLENDER=<COATINGLAB_BLENDER>' -e 'COATINGLAB_LIBRARY=<COATINGLAB_LIBRARY>' -e 'COATINGLAB_WAIT_FOR=<COATINGLAB_WAIT_FOR>' -- uvx coatinglab-mcp==0.1.0{
"mcpServers": {
"coating-lab": {
"command": "uvx",
"args": [
"coatinglab-mcp==0.1.0"
],
"env": {
"COATINGLAB_OUT": "<COATINGLAB_OUT>",
"COATINGLAB_BLENDER": "<COATINGLAB_BLENDER>",
"COATINGLAB_LIBRARY": "<COATINGLAB_LIBRARY>",
"COATINGLAB_WAIT_FOR": "<COATINGLAB_WAIT_FOR>"
}
}
}
}متغيرات البيئة
COATINGLAB_OUTThe only folder Coating Lab writes to; defaults to ~/.coatinglabCOATINGLAB_BLENDERBlender's executable, if it is not on the PATH or in the usual install folderCOATINGLAB_LIBRARYA finishes JSON of your own, merged over the built-in libraryCOATINGLAB_WAIT_FORProcess names that hold the machine (e.g. UnrealEditor.exe); a bake refuses to start while one runs
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Coating Lab
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.
Install
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. |
Tools
| 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 masks and the formula
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.
What is estimated
- 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.
License
MIT
الأسئلة الشائعة
ما هو Coating Lab؟
Real surface finishes for game gun models: sourced finishes, variants, wear baked from use
كيف أثبّت Coating Lab؟
يعمل على جهازك. في Claude Code: claude mcp add coating-lab -e 'COATINGLAB_OUT=<COATINGLAB_OUT>' -e 'COATINGLAB_BLENDER=<COATINGLAB_BLENDER>' -e 'COATINGLAB_LIBRARY=<COATINGLAB_LIBRARY>' -e 'COATINGLAB_WAIT_FOR=<COATINGLAB_WAIT_FOR>' -- uvx coatinglab-mcp==0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Coating Lab إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Coating Lab مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Coating Lab؟
ينشره hpdkhoa. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.