Ultimate Blender は何をしますか?
3つのパックを統合したオールインワンスキル:el4cteo(テスト済みbpyスクリプト + Blender 5.xルール)、arjun988(テクニカルアートディレクターワークフロー、90以上の専門家・スタイルガイド)、kevinbadi(プロダクトカメラアニメーション、Poly Haven、Meshy写真→3D、Three.js書き出し)。
このファイルの使い方:最初にこのファイルを読み、次にルーティングテーブル内のタスクに合致するガイドのみを開いてください。すべてのガイドを読み込まないでください。各ガイドには、各トピックに関するすべてのソースパックのセクションが含まれています。すべてのパスは、このスキルのフォルダ(<skill_root>)からの相対パスです。
1. ディレクターワークフロー(すべての新規アセット)
分析 → 計画 → ブリーフ → 実行 → 検証 → 納品
- 分析:アセットの目的(ヒーロー / 標準 / 背景)、ターゲット(ゲーム / シネマティック / ポートフォリオ / プロダクト動画)、プラットフォーム(モバイル / コンソール / PC / ウェブ / Roblox)、スタイル、アニメーション(静的 / リグ付き / アニメーション済み)、書き出し形式を分析します。
- 計画:ルーティングテーブル(セクション4)からガイドを選び、ポリゴンとテクスチャの予算(
refs/shared/polycount-budgets.md)を設定します。 - ブリーフ:簡単な編集以上の作業では、Blenderに触れる前に、アセット、予算、使用ガイド、フェーズ、書き出しターゲットをまとめた短い制作ブリーフを作成します。
- 実行:MCPまたはヘッドレス(セクション2)を通じて小さなステップで実行します。新しいコードを書く前に、バンドルされたスクリプトを使用してください。
- 検証:セクション5に従います。この手順は必須です。
- 納品:書き出し、数値とファイルパスを報告します。
参照画像が添付されていますか? refs/shared/reference-image-match.mdに従ってください。refs/shared/reference-analysis-template.mdに記入し、細部の前にカメラを合わせ、スクリーンショット比較を繰り返し、最後にrefs/shared/visual-match-checklist.mdと照合します。
完全なディレクタープレイブック(ブリーフ、マルチスキルレシピ、決定木を含む):refs/director-full.md。
命名規則:refs/shared/naming-conventions.md · パイプライン:refs/shared/asset-pipeline.md · MCP:refs/shared/mcp-integration.md、refs/shared/mcp-tools.md。
2. 実行
ライブ(blender-mcp execute_blender_code):小さなステップで作業し、必要なものだけを出力します。バンドルされたスクリプトを呼び出すには:
import sys, importlib; sys.path.insert(0, r"<skill_root>/scripts")
import qa_check; importlib.reload(qa_check); print(qa_check.run(objects=["Chair"]))
各MCP呼び出しは新しい名前空間で実行されるため、毎回再importしてください。スクリプトを編集した後にのみreloadを使用してください。
ヘッドレス(シェル、MCP不要)。スクリプトのJSONのみを出力します:
python <skill_root>/scripts/run_in_blender.py --blend in.blend <skill_root>/scripts/<script.py> -- --objects Chair --save out.blend
python <skill_root>/scripts/run_in_blender.py --expr "import bpy; print(len(bpy.data.objects))"
Windows:PowerShellを推奨します。Git Bashでは、MSYS_NO_PATHCONV=1をプレフィックスとして付け、$(cygpath -m ~/.claude/skills)/ultimate-blender/...を使用してください。blender.exeがPATHに含まれているか、パスを渡す必要があります。
セッションでの最初の呼び出し:scripts/env_report.py(バージョン、エンジン、GPU、アドオン、単位、カラーマネジメント)を実行してください。
Nodeヘルパー(kevinbadi; ポート9876でblender-mcpと通信):node <skill_root>/scripts/node/<name>.js --help。
3. Blender 5.x ルール(これらはどのガイドの古いアドバイスよりも優先されます)
- オペレーターよりデータAPI:
bpy.data、bmesh、mesh.attributes、およびnumpyを使用したforeach_get/setを使用してください。オペレーターはコンテキストを必要とし、バックグラウンドモードには3Dビューがありません。 - やむを得ないオペレーター:
with bpy.context.temp_override(object=ob, active_object=ob, selected_objects=[ob], selected_editable_objects=[ob]): bpy.ops...、その後{'FINISHED'}を確認してください。 - 編集モード:編集モード中は
ob.dataが古くなります。bmesh.from_edit_mesh+update_edit_meshを使用するか、最初にOBJECTモードに切り替えてください。 - ノード:名前はローカライズされるため、
type("BSDF_PRINCIPLED")で検索し、nameでは検索しないでください。 - Enum:
bl_rna.properties[p].enum_itemsから読み取ってください。動的enum(render.engine、view_transform)の場合は、try/except TypeError内で割り当ててください。 - エンジン:
BLENDER_EEVEE、CYCLES、BLENDER_WORKBENCH。GPU:scene.cycles.device="GPU"+ プリファレンスのcompute_device_type。 - 評価メッシュ:
ob.evaluated_get(dg).to_mesh()、その後必ずto_mesh_clear()を実行してください。matrix_worldを読み取る前にview_layer.update()を呼び出してください。 - 解放されたデータ:何かを削除または適用する前に名前を収集し、古いPython参照を再利用しないでください。
- 名前:「Cube.001」を信頼しないでください。明示的に名前を変更し、
bpy.data.objects[name]でオブジェクトを検索してください。 - スケール:1単位 = 1 m。ベベル、リギング、物理演算、ベイク、書き出しの前に回転とスケールを適用してください。
- ライブセッションはユーザーの作業です:
read_factory_settingsを実行したり、自分で作成していないデータを削除したりせず、破壊的なバッチ編集の前にバックアップ(save_as_mainfile(copy=True))を保存してください。 - バックグラウンドGPU:
gpu.init()(5.2以降)を呼び出してください。bglは存在しなくなりました。スカルプトモードは-bでクラッシュするため、scripts/sculpt_ops.pyを使用してください。 - 5.x APIの変更:
action.fcurves→ channelbags ·scene.node_tree→scene.compositing_node_group·material.use_nodesは非推奨 ·mod["Socket_2"]→mod.properties.inputs.Socket_2.value·BLENDER_EEVEE_NEXT→BLENDER_EEVEE· BooleanFAST→FLOAT· ボーンレイヤー → ボーンコレクション ·bl_info→blender_manifest.toml· 5.3:コンポジターエフェクトスタック、VSEEXPAND→RIPPLE。完全なテーブル:refs/blender-core/api-changes-5x.md。コードパターン:refs/blender-core/bpy-patterns.md。
4. ルーティング:タスク → ガイド(+ スクリプト)
| タスク | 開くファイル | 主要スクリプト |
|---|---|---|
| 単位、命名、コレクション、アセットライブラリ、バッチ/ヘッドレスパイプライン、アドオン/拡張機能 | guides/01-scene-pipeline.md | scene_audit, batch_process, assets/addon_template |
| ハードサーフェス、ベベル、ブーリアン、ウェイテッドノーマル、一般モデリング、プロシージャルモデリング | guides/02-modeling-hardsurface.md | apply_stack |
| プロップ、キットバッシュ、家具、車両、メカ、アーキビズ | guides/03-props-vehicles-archviz.md | apply_stack, build_pbr_material |
| スカルプティング、マルチレゾ、リメッシュ、クリーチャー、モンスター | guides/04-sculpting-creatures.md | sculpt_ops |
| 人間キャラクター、アーキタイプ、衣装、フェイスリグ、ARKit / バイシーム | guides/05-characters-clothing-face.md | garment, shapekeys |
| ヘアー、ファー、ヘアーカード | guides/06-hair-groom.md | groom |
| リトポロジー、UV展開、テクセル密度、UDIM、ライトマップUV | guides/07-retopology-uv.md | auto_retopo, uv_pack, texel_density |
| PBRマテリアル、ウェア&グライム、デカール、トリムシート、ベイク | guides/08-materials-texturing-baking.md | build_pbr_material, smart_material, decal, bake_maps |
| ジオメトリノード、プロシージャルジェネレーター、散布 | guides/09-geometry-nodes.md | gn_builder |
| 地形、バイオーム、モジュラーキット、植生、セットドレッシング | guides/10-environments-vegetation.md | terrain, scatter, kit_check |
| Rigify、スキニング、ゲーム用スケルトン、キーフレーム、NLA、モーションキャプチャリターゲット、ループ | guides/11-rigging-animation.md | rigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check |
| 剛体、布、流体、破壊、VFX、雨、雪、雷 | guides/12-simulation-vfx-weather.md | sim_setup, precipitation, surface_weather, lightning |
| ライティングリグ、HDRI、ルックデブ、カメラ、時間帯、フォグ、ムード | guides/13-lighting-camera-lookdev.md | turntable, scene_mood |
| Cycles/EEVEE設定、バッチレンダー、コンポジター | guides/14-rendering-compositing.md | render_batch |
| ポリゴン予算、LOD、ドローコール、コリジョンプロキシ | guides/15-optimization-lod-collision.md | mesh_stats, make_lods |
| Unity、Unreal、Godot、Roblox、Web/Three.js向けglTF/FBX/USD書き出し | guides/16-export-engines.md | export_asset, node/blender-threejs-export.js |
| 納品前のQA(必須) | guides/17-qa-review.md | qa_check, review_shots |
| ビデオシーケンサー編集、モーショントラッキング、カメラソルブ | guides/18-video-editing-tracking.md | vse_edit, track_camera |
| プロダクト動画:ターンテーブル、スローズーム、ドリー、クレーン、スピードランプループ、パーフェクトループ、プロダクトポリッシュ | guides/19-product-camera-animations.md | node/blender-product-polish.js, turntable.py |
| Poly Haven HDRI、テクスチャ、スタジオ/ショールームシーン、マテリアルバリエーション | guides/20-polyhaven-assets.md | node/polyhaven-*.js |
写真 → テクスチャ付き3Dモデル(Meshy API、MESHY_API_KEYが必要) | guides/21-image-to-3d.md | その後auto_retopo, qa_check |
| エンドツーエンドプレイブック(プロップ、キャラクター、Roblox、プロダクトショット) | guides/22-workflow-recipes.md | |
| オプションの外部WebSocketツールキット(Dev-GOMアドオン経由のMixamoリターゲット) | guides/23-websocket-toolkit.md | (バンドルされていません) |
スタイルの指示:これらのファイルから1セクションだけを開いてください。ファイル全体ではありません。
| スタイルのリクエスト | 開くファイル |
|---|---|
| スタイライズド、リアリスティック、ローポリ、アニメ/マンガ、ちび、カートゥーン、コミック、手描き、ピクセル、ボクセル、アイソメトリック、HD-2D、レトロ8/16ビット、ノワール、トゥーン/NPR、コンソール時代(PS1~PS5、CRT/VHS) | styles/art-styles.md |
| ホラー、PSXホラー、インディー、ファウンドフッテージ、ボディホラー、コズミックホラー、フォークホラー、マスコットホラー、リミナルスペース、ウィアードコア | styles/horror.md |
| ファンタジー、SF/パンク、終末もの、歴史もの、バイオーム、居心地の良い、ダーク/グリッティ、シュール、ブルータリスト、ネオン・レトロフューチャリズム | styles/worlds-moods.md |
| ジャンルアートディレクション:アクション、カード/アイドル、メトロイドヴァニア、ビジュアルノベル、オープンワールド、プラットフォーマー、レーシング、RPG、シューター、ソウルライク、ステルス、ストラテジー、サバイバル | styles/game-genres.md |
トピック別の詳細リファレンスはrefs/<元のスキル名>/にあり、ガイドから直接リンクされています。
5. 検証(「完了」と言う前に必須)
- 形容詞ではなく数値を報告してください:トライアングル数、オブジェクト数、マテリアル数、寸法(
ob.dimensions)、および書き出された出力ファイル。 - ジオメトリが変更された場合は、
scripts/qa_check.py(Zファイティング、分離パーツ、非マニフォールド、反転法線、スケール)を実行してください。 - 結果を確認してください:MCP
get_viewport_screenshot/look、またはヘッドレスscripts/review_shots.pyのコンタクトシート。 - ゲームアセットの場合は、
scripts/mesh_stats.pyをプラットフォーム予算に対して実行し、refs/shared/validation-checklist.mdを確認してください。 - 書き出されたファイルが存在し、サイズが0でないことを確認してください。