Community画像github.com

Asset Forge

テキストプロンプトや画像から、コンセプトアート、UIアイコン、イラスト、ゲーム用3Dモデル(.glb + PBRテクスチャ)をローカルかつ無料で生成します。ゲームアセットの作成、生成、再生成、修正、glbファイルの確認をユーザーが依頼した際に使用します。

Asset Forge とは?

このスキル(Asset Forge)は、ローカルマシンのGPU(ComfyUIベース、自動起動)を利用して、テキストプロンプトや画像からゲームアセットを生成できる強力なツールです。有料サービスにデータを送信することは一切なく、完全に無料で利用可能です。主に2種類のアウトプットを提供します。`generate_image`による2D画像(コンセプトアート、アイコン、イラスト)と、`generate_asset`によるゲームエンジンにそのままインポート可能な3Dモデル(.glb形式、PBRテクスチャ付き)です。 ワークフローは、まず`list_profiles`でプロファイルを選択し、ゲームプロジェクトフォルダ(`assetforge.json`でスタイル設定を一元管理)を指定して生成を実行します。3Dモデル生成の際は、まず画像のみを生成してユーザーの承認を得た後、非同期ジョブとして3Dモデル化を行う2段階プロセスを推奨しています。生成速度や品質はプロファイル(`prop_native_trellis2`、`character_native`など)やプリセット(`fast`、`standard`、`max`)、またGPUのVRAM容量に応じて調整されます。 CLI(`python forge.py`)またはMCPツールインターフェースから操作可能で、ジョブ管理、メッシュ品質チェック、プロファイルのカスタマイズなど、開発ワークフローに統合しやすい設計となっています。薄いパーツやスパイク状のメッシュなど、3D変換に失敗した場合のトラブルシューティングガイドも内蔵しており、`force`パラメータやパラメータ調整によるリカバリが可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Noamcelermajer/comfyui-text-to-3d-mcp/tree/main/skills/asset-forge

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Asset Forge は何をしますか?

Asset Forge は、このマシンのGPU(内部でComfyUIを使用、自動起動)上で、テキストから画像やゲーム対応の3Dモデルを生成します。有料サービスにデータが送信されることは一切ありません。

呼び出し方

利用可能な場合は、asset-forge MCPツールを優先してください: list_profiles, generate_image, generate_asset, get_job, check_mesh, models, forge_status

それ以外の場合は、Asset Forgeフォルダからコマンドラインを使用します。すべてのコマンドは1つのJSONオブジェクトを出力します。

python forge.py profiles
python forge.py image  <name> "<prompt>" -p icon --project <game folder>
python forge.py asset  <name> "<prompt>" -p prop_native_trellis2 --project <game folder>
python forge.py asset  <name> --image <picture> -p character_native --project <game folder>
python forge.py check  <model.glb>

終了コード 0 = 正常、2 = 完了したがメッシュチェックに失敗、1 = エラー

ワークフロー

  1. list_profilesでプロファイルを選択します。画像プロファイルは画像(concept_prop、concept_character、icon、illustration)を生成し、アセットプロファイルは3Dモデルを生成します(各3つのプリセットあり、下記参照)。小道具にはprop_native_trellis2、キャラクターにはcharacter_nativeを使用します(それぞれ約1分)。プロファイルを省略すると、小道具のデフォルトが使用されます。prop_lowpoly / character_lowpolyは、より低速なUltraTexパイプラインで、VRAM 12GB未満のカードでは代替として使用されます。ユーザーが明示的に要求した場合、またはGPUの性能が低い場合のみ使用してください。experimentalとマークされたプロファイルは、このマシンで検証されていません。使用する場合はその旨を伝えてください。
  2. 常にゲームプロジェクトフォルダ(project_dir / --project)を指定します。このフォルダ内のassetforge.jsonがアートスタイル、出力フォルダ、プロファイルごとの設定を提供するため、アセット間で一貫性が保たれます。プロジェクトにこのファイルがない場合は、作成を提案します(forge.py init <dir>)。
  3. 3Dモデルの場合、まず画像を承認します。 generate_assetをimage_only: trueで呼び出し(約1分)、画像を確認した後、image_onlyなしで再度呼び出します(デフォルトプロファイルで約1分、UltraTexで4~8分)。2回目の呼び出しは承認済み画像を再利用するため、プロンプトは不要です。
  4. 3Dジョブは非同期です。 generate_assetはジョブIDを返します。get_jobをwait_seconds: 50で繰り返し呼び出し、ステータスがqueuedまたはrunningでなくなるまで待機します。GPUは1つなので、アセットは一度に1つずつ実行します。
  5. 結果を確認します。 完了したジョブは、レンダリングされたプレビュー(正面と斜めからのビュー)とメッシュチェックを返します。プレビューを確認せずに成功を報告しないでください。

プリセット

generate_assetにpresetを渡します(コマンドラインでは--preset)。アセットの用途に応じて選択し、使用したプリセットを明示します。

プリセット使用用途コスト
fastブロッキングアウト、背景の雑多なオブジェクト、遠距離またはモバイル向けアセット:最も低いトライアングル数(小道具で約800、キャラクターで約4,000)。1~2分
standardデフォルト。小道具3,000トライアングル、キャラクター12,000トライアングル。約1分(ネイティブ、実測値);4~5分(UltraTex)
maxカメラが近づくヒーローアセット:完全な形状解像度と最大のテクスチャ詳細(小道具8,000トライアングル)。最長;未測定

ネイティブのfastとすべてのmaxの時間は推定値です。ネイティブstandardは6つの被写体で実測されました。VRAM 16GB未満のカードでは一部の設定が自動的に制限され、結果にはlimited_by_vramとして表示されます。

同じ名前に対してプリセットやパラメータを変更すると、モデルは再生成されますが、コンセプト画像は再利用されます。同一設定の場合はキャッシュされた結果が返されます。

スタイルプリセット

セット全体で一貫した外観にするには、style_presetを渡します(IDはlist_profiles -> stylesにあります):realistic_pbr、hand_painted、toon、lowpoly_flat、voxel。同じゲームのすべてのアセットに同じものを使用するか、プロジェクトのassetforge.jsonに一度設定します。これらは実験的機能です。その旨を伝え、プレビューを確認してください。*_nativeプロファイルはスタイル設定を最も多く反映します。結果のstyle_ignoredには、プロファイルが適用できなかったスタイルがリストされます。

プロンプトの書き方

  • 被写体のみを記述します:それが何か、素材、色、摩耗、プロポーション。プロファイルがフレーミング、照明、背景を追加します。
  • アセットは1つにつき1オブジェクト。ペアや、オブジェクトとバラバラの破片は別々のアセットにします。
  • 太い方が繊細より勝ります。細いワイヤー、ケージ、レース、実際の穴、髪の毛のように細いスパイクは3D化の工程で壊れます。太い取っ手、チェーンの代わりに頑丈な棒、穴の代わりに彫刻された模様を指定してください。
  • キャラクター:人物と服装のみで、手持ちアイテムは含めません。武器は小道具として作成します。

結果が failed_check になった場合

ファイルは書き込まれますが、そのまま使用すべきではありません。problemsが原因を説明します。

問題修正方法
shattered mesh薄いパーツが壊れました。force: trueとparams: {"thin": 0.9}を指定して再実行します。それでも失敗する場合は、より厚く頑丈なパーツで画像を再生成します。
spiky mesh新しいseedとともにforce: trueを指定して再実行します。
decimation failed / mesh collapsedforce: trueを指定して再実行します。繰り返す場合は、trisを増やします。
flat sheet画像が平坦として認識されました。プロンプトに「bulky, deep, solid」を含めて画像を再生成します。

force: trueをプロンプトと一緒に指定すると画像も再生成されます。プロンプトなしでforce: trueを指定すると画像は保持され、3D工程のみがやり直されます。

カスタマイズ

  • プロジェクトごと:assetforge.json(スタイル、出力フォルダ、profiles.<id>.params)を編集します。
  • 呼び出しごと:params(例:{"tris": 5000})。list_profilesで各プロファイルが受け付けるパラメータを確認できます。
  • 新しいプロファイル:プロジェクトのassetforge_profiles/フォルダに、既存のプロファイルをextendsする小さなJSONファイルを配置します。詳細はAsset Forgeフォルダ内のREADMEを参照してください。
  • モデルとハードウェア:modelsツールは、各プロファイルが必要とするもの、不足しているもの、このGPUに適しているものを報告します。ダウンロードは大きいため、インストール前にユーザーに確認してください。

関連スキル