| name | localgpt-gen |
| description | LocalGPT Gen 3Dワールド構築を Pi から操作。1-shot CLI でシーン生成・WorldGen pipeline・エクスポート。ユーザーが「3Dシーン」「ワールド構築」「レベルデザイン」「blockout」「LocalGPT Gen」に言及した時に活用。 |
LocalGPT Gen
LocalGPT Gen は Bevy エンジンによるリアルタイム3Dレベルデザインツール。pi-localgpt は localgpt-gen mcp-server --connect を 1ショット spawn で呼び出し、常駐プロセスを作らない。
前提
localgpt-gen がインストール済み（cargo install localgpt-gen）- localgpt-gen がインタラクティブモードで起動中（Bevy 窓あり）—
--connect リレーがこれに接続する
- 利用前に
localgpt_gen_status で binary + relay を確認
ツールカテゴリ
Design log
| 状況 | Tool |
|---|
| 過去の設計ログを検索 | localgpt_design_log_search または localgpt_memory_search |
| 検索結果の行範囲を読む | localgpt_memory_get（path + startLine/endLine） |
| 検索結果 ID で詳細を読む | localgpt_design_log_get |
| 長期設計ログとして保存 | localgpt_design_log_save |
| 日次ログに追記 | localgpt_design_log_log |
汎用
| 状況 | Tool |
|---|
| 到達性確認 | localgpt_gen_status または /localgpt:gen-status |
| 未ラップの gen tool | localgpt_gen_call（tool 名 + args を直接指定） |
Player & NPC
| 状況 | Tool |
|---|
| プレイヤー配置 | localgpt_gen_spawn_player |
| NPC 作成 | localgpt_gen_add_npc |
| NPC 会話設定 | localgpt_gen_npc_dialogue |
Interactions
| 状況 | Tool |
|---|
| トリガー追加 | localgpt_gen_add_trigger |
| テレポーター | localgpt_gen_add_teleporter |
| 収集アイテム | localgpt_gen_add_collectible |
| ドア追加 | localgpt_gen_add_door |
Physics
| 状況 | Tool |
|---|
| 物理設定 | localgpt_gen_set_physics |
| コライダー追加 | localgpt_gen_add_collider |
| 力・衝撃 | localgpt_gen_add_force |
| 重力設定 | localgpt_gen_set_gravity |
Terrain & Sky
| 状況 | Tool |
|---|
| 地形生成 | localgpt_gen_add_terrain |
| 水面追加 | localgpt_gen_add_water |
| 植生散布 | localgpt_gen_add_foliage |
| 空・大気設定 | localgpt_gen_set_sky |
Audio
| 状況 | Tool |
|---|
| 環境音 | localgpt_gen_set_ambience |
| 音源配置 | localgpt_gen_audio_emitter |
シーン操作
| 状況 | Tool |
|---|
| シーン全体を確認 | localgpt_gen_scene |
| エンティティ詳細 | localgpt_gen_entity |
| スクリーンショット | localgpt_gen_screenshot |
| プリミティブ配置 | localgpt_gen_spawn / localgpt_gen_spawn_batch |
| エンティティ変更 | localgpt_gen_modify / localgpt_gen_delete |
| カメラ・ライト・環境 | localgpt_gen_camera / localgpt_gen_light / localgpt_gen_environment |
| Undo / Redo | localgpt_gen_undo / localgpt_gen_redo |
| クリア | localgpt_gen_clear |
WorldGen pipeline（推奨フロー）
テキスト記述から構造化ワールドを構築するパイプライン:
localgpt_gen_plan_from_roblox_trend → Roblox トレンド要約を整形して BlockoutSpec JSON
localgpt_gen_plan_from_note → vault メモを整形して BlockoutSpec JSON
localgpt_gen_plan → 短いテキストから BlockoutSpec JSON
localgpt_gen_blockout → 地形 + リージョン + パス
localgpt_gen_navmesh → 歩行可能グリッド（任意）
localgpt_gen_populate → hero / medium / decorative 配置
localgpt_gen_evaluate → 注釈付きスクリーンショットで自己評価
localgpt_gen_refine → 自動 evaluate → adjust ループ
localgpt_gen_modify_blockout → リージョンの追加・移動・リサイズ
localgpt_gen_regenerate → blockout 変更後の再生成
補助: localgpt_gen_set_tier / localgpt_gen_set_role でエンティティに tier / role を付与。
Vault メモから plan する場合は docs/vault-note-plan-layout.md を参照。Roblox トレンド要約から prototype する場合は docs/roblox-trend-prototype.md を参照。短い説明文だけなら localgpt_gen_plan の方がシンプル。
エクスポート & World Skills
| 状況 | Tool |
|---|
| スクリーンショット出力（vault プロジェクト含む） | localgpt_gen_export_screenshot（path または world / session / vault_project） |
| glTF 出力 | localgpt_gen_export_gltf |
| HTML（Three.js）出力 | localgpt_gen_export_html |
| ワールド保存 | localgpt_gen_save |
| ワールド読込 | localgpt_gen_load |
| 再利用可能なプロンプトパック保存（vault プロジェクト） | localgpt_export_prompt_pack（name / description / vault_project、overwrite=true で差し替え） |
Design log ツール
全メモリ操作も MCP bridge 経由（要 localgpt-gen 起動）。
| 状況 | Tool |
|---|
| 過去の設計ログを検索 | localgpt_design_log_search または localgpt_memory_search |
| 検索結果の行範囲を読む | localgpt_memory_get（path + startLine/endLine） |
| 検索結果 ID で詳細を読む | localgpt_design_log_get |
| 長期設計ログとして保存 | localgpt_design_log_save |
| 日次ログに追記 | localgpt_design_log_log |
Design log 連携フロー
- 作業開始 →
localgpt_design_log_search または localgpt_memory_search で過去の記録を確認。必要なら localgpt_memory_get で検索ヒットの行範囲を読む
- テーマ・スタイル決定 →
localgpt_design_log_save
- セッション記録 →
localgpt_design_log_log
制約
- 1 call = 1 spawn — 各 tool call で短寿命プロセスが起動・終了
- リレー必須 — localgpt-gen が起動していないと全ツールが失敗
- 全ツール curated — 51 tool をカバー。不足時は
localgpt_gen_call で任意呼び出し
コマンド
/localgpt:get — 指定パスの行範囲を読み込み/localgpt:gen-status — binary + relay 状態確認
