Coating Lab

Coating Lab

ゲームの銃モデルに、実際の銃と同じように使用によって摩耗したリアルな表面仕上げを施します。

ゲームの銃モデルに、実際の銃と同じように使用によって摩耗したリアルな表面仕上げを施す MCP サーバーです。

• 出典付きの仕上げライブラリ。 アルマイト処理アルミニウム、マンガンおよび亜鉛リン酸塩処理、ブルーイングおよび窒化処理鋼、セラミックコーティング（FDE、OD グリーン、タングステン、グラファイト、コヨーテ）、ステンレス、ポリマー、ゴム、真鍮、銅、鉛、ウォールナットを収録しています。それぞれに物理ベースの値（リニアカラー、メタリック、粗さ）、摩耗時に現れる下地、数値の出典を設定しています。記述から推定した値には、推定値であることを明記しています。
• コーティングのバリエーション。 仕様を使ってモデルの各マテリアルスロットに仕上げを割り当て、必要な数だけバリエーションを作成できます（支給品のライフル、ツートーンの FDE ビルド、酷使されたモデルなど）。それぞれに、新品、支給品、摩耗、酷使の摩耗レベルを設定できます。
• 根拠に基づく摩耗を一度だけベイク。 Blender でモデルの頂点カラーにベイクします。露出したエッジ、銃を扱う手が触れる場所（グリップ、支持する手、操作部）、部品が滑る場所（マガジンとマガジンハウジング、ストックとチューブ）、表面が遮蔽される箇所や銃口、排莢口の周囲の汚れを反映します。すべてのバリエーションが同じマスクを読み取るため、新しいバリエーションの作成にコストはかかりません。
• チェック機能。 すべての仕上げについて、物理ベースレンダリングの基礎となるルールを検証します。各バリエーションの摩耗割合が設定レベルに合っていること、内側の角に摩耗がないことも確認します。
• どこでも同じ計算式。 チェック、ルックデブレンダリング、ゲームエンジンのマテリアルで、同じ方法で摩耗を計算します（coat.py）。そのため、チェックに合格した見た目がプレイヤーにもそのまま表示されます。

Model Lab（modellab-mcp）のビルドには、固有のスロット（アッパー、ロワー、バレルなど）、マーク、パーツがあります。spec_for_modellab を使えば、1 回の呼び出しでビルドからコーティング仕様を作成できます。

インストール

Python 3.10 以降と Blender 4.2 以降が必要です。

pip install coatinglab-mcp

{"mcpServers": {"coatinglab": {"command": "coatinglab-mcp"}}}

設定	意味
COATINGLAB_OUT	Coating Lab が書き込みを行う唯一のフォルダーです。デフォルトは ~/.coatinglab です。
COATINGLAB_BLENDER	Blender が PATH 上にも標準のインストールフォルダーにもない場合に指定します。
COATINGLAB_LIBRARY	独自の仕上げ JSON を指定します。組み込みライブラリに統合されます。
COATINGLAB_WAIT_FOR	マシンを使用するプロセス名です。該当プロセスが実行中の場合、ベイクは待機します。

ツール

ツール	機能
list_finishes, read_finish	ライブラリと、注記および出典を含む仕上げを1つ取得します。
check_library, check_finish	ライブラリ、または独自の仕上げが物理的なルールに適合しているか確認します。
list_wear_levels, list_templates	摩耗レベルと、すぐに使えるバリアントセットを取得します。
spec_for_modellab	Model Lab のビルド用コーティング仕様を取得します。
validate_spec	仕様の問題を確認します。仕上げが割り当てられていないスロットや、誤った素材に施された仕上げなどが対象です。
bake	摩耗マスクをモデルのコピーにベイクします。
check_coating	各バリアントの摩耗がレベルに適合しているか、また摩耗が角に及んでいないかを確認します。
render_variants	ルック開発用のレンダーとシートを生成します。
engine_params	エンジンマテリアル用に、バリアントのスロットごとの値を取得します。

マスクと計算式

ベイク処理では頂点カラー Col に書き込みます。

チャンネル	意味
R	エッジ：平らな面では1、露出した鋭いエッジでは0
G	取り扱い：手で銃を扱う部分では1
B	擦れ：部品がスライドする線に沿って1
A	汚れ：表面が遮蔽されている部分、および銃口と排莢口の周囲で1

エンジンのマテリアルは src/coatinglab/coat.py の計算式に従います。摩耗レベルはしきい値です。レベルが高いほど、マスクの値が小さくてもすでに摩耗が現れます。グランジテクスチャは摩耗に変化を加えますが、摩耗そのものを生み出すことはありません。

推定値について

• すべての粗さの値。仕上げの表面をレンダリング時の粗さに対応付けるソースはありません。
• アルマイト処理、リン酸塩処理、ブルーイング、窒化処理、およびほとんどのセラミック仕上げの色。規格が定めているのは処理方法であり、色ではありません。OD グリーンとコヨーテは、FED-STD-595 の色番号に基づいています。
• 摩耗量。ソースは銃のどこが摩耗するかを示していますが、摩耗の速さは示していません。各レベルは、Model Lab の M4A1 がその範囲の中間に収まるよう設定されています。
• 手の摩耗ゾーンは球体です。丸型ハンドガードでは、サポートハンドによる摩耗は下面だけでなく上面にも及びます。

ライセンス

MIT