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 = エラー
ワークフロー
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とマークされたプロファイルは、このマシンで検証されていません。使用する場合はその旨を伝えてください。- 常にゲームプロジェクトフォルダ(
project_dir/--project)を指定します。このフォルダ内のassetforge.jsonがアートスタイル、出力フォルダ、プロファイルごとの設定を提供するため、アセット間で一貫性が保たれます。プロジェクトにこのファイルがない場合は、作成を提案します(forge.py init <dir>)。 - 3Dモデルの場合、まず画像を承認します。
generate_assetをimage_only: trueで呼び出し(約1分)、画像を確認した後、image_onlyなしで再度呼び出します(デフォルトプロファイルで約1分、UltraTexで4~8分)。2回目の呼び出しは承認済み画像を再利用するため、プロンプトは不要です。 - 3Dジョブは非同期です。
generate_assetはジョブIDを返します。get_jobをwait_seconds: 50で繰り返し呼び出し、ステータスがqueuedまたはrunningでなくなるまで待機します。GPUは1つなので、アセットは一度に1つずつ実行します。 - 結果を確認します。 完了したジョブは、レンダリングされたプレビュー(正面と斜めからのビュー)とメッシュチェックを返します。プレビューを確認せずに成功を報告しないでください。
プリセット
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 collapsed | force: 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に適しているものを報告します。ダウンロードは大きいため、インストール前にユーザーに確認してください。