AIに編集を手伝ってもらう

AIを接続すると、ワールド全体の制作や、モデル・配置・設定の変更を頼めます。最初のワールドでは、自動保存とPlayの操作を確認できます。制作した結果はScene Viewで見ながら、続きの修正を頼めます。

接続前に自動保存を確認する

AIに編集を頼む前に、画面が「保存済み」になっていることを確認してください。大きく変更する場合は、プロジェクトを複製しておくと元の状態を残せます。

MCP接続を開く

制作チャットの入力欄下にある「MCP接続」から開けます。ChatGPTへの接続前・接続中・接続後のどの状態でも表示します。対応するAIクライアントと接続状態を確認し、使うクライアントを選んで登録します。

MCP接続は制作チャットとは別の設定画面です。制作チャットの「MCP接続」から、ChatGPTのタブを開いたまま確認できます。設定画面を閉じても、制作チャットの入力内容と接続状態は残ります。

AIクライアントとの接続には、MCPという仕組みを使います。登録後に再読み込みなどを求められたら、画面の案内に従ってください。登録の操作が終わったら、接続状態の表示も確認します。

「MCP接続」を開くと、登録済みのサーバーを確認し、古い場合は現在のStudioに同梱された版へ自動更新します。未登録のクライアントや、明示的に無効にした接続は自動で登録・有効化しません。更新後はAIクライアントを再起動するか、MCPを再読み込みしてください。実行中の接続は、再起動または再読み込み後に切り替わります。自動更新に失敗した場合は、表示された原因を確認して「更新」から再試行できます。

AIサービスの契約、利用料金、モデルの選択は、XRift Studioのアプリ配布とは別に扱われます。

ChatGPTで現在のワールドを編集する

デスクトップ版では、ワールドを開いて画面下部のロボット型の「ChatGPTを開く」を押すと、制作チャットのタブが開きます。Node.jsのインストールやコマンド操作は不要です。チャットはScene Viewの横、Inspectorの上に開きます。チャット右上の「閉じる」か、タブの閉じるボタンで閉じられます。別のタブへ移ったりチャットを閉じたりしても、入力内容と接続処理、実行中の制作は残ります。同じアイコンから再び開けます。

会話中央の接続カードで「ChatGPTに接続」を押し、開いたブラウザでログインとChatGPTプランの利用許可を完了します。接続中・復元中の案内や、失敗時のエラーと再接続も同じ場所に表示します。Studioへ戻り、右上のアカウントアイコンから接続中のアカウントを確認します。ブラウザの応答受信メッセージだけでは、接続は完了していません。
入力欄の下で使用するモデルと「思考量」を選び、変更したい内容を2000文字以内で入力します。対応するモデルでは「低（速さ優先）」を初期値にします。低に対応しないモデルでは、モデル情報にある既定の思考量を使います。自分で選んだ値や保存済みの設定は保持します。「モデルの既定」を選ぶとモデル側の標準設定を使います。「低（速さ優先）」「中（標準）」「高（じっくり）」など、使える選択肢はモデルごとに変わります。思考量の情報がないモデルでは「モデルの既定」を使います。例：「選択したBoxを右へ1m移動してください」。選択中のEntityと現在のSceneの情報を参考にします。結果を見てから次の依頼を送ると、少しずつ編集を進められます。
Enterか、矢印の「依頼を送信」で送信すると、現在のSceneの編集と保存を進めます。Shift+Enterで改行できます。日本語入力の変換確定に使うEnterでは送信しません。依頼した内容を検証し、Sceneを少しずつ変更して、その都度保存します。名前・位置・回転・大きさの調整に加え、モデルの追加・差し替え、Material、Skybox、Audio Source、Colliderの設定を頼めます。「このEntityの位置と回転を保ってモデルを差し替えて」「BGMの音量を少し下げて」のように伝えてください。
「作業の記録」は折りたたまず、保存や変更の経過を順に表示します。「Fogの開始距離：10 → 30」「Skyboxの水平回転：0° → 45°」のように項目名と変更前後の値を確認できます。「考えています…」など、現在の進行状況と同じ文は重ねて表示しません。変更の記録がまだない間は、空の見出しも出しません。保存後は実際に反映した値を記録します。変更内容も折りたたまず、対象の項目名で表示します。設定は有効・無効、色、距離などの項目と値で確認できます。過去の依頼の記録も読めます。旧版で変更項目を残していなかった抽象的な記録は、保存件数と「変更項目の詳細記録なし」の案内にまとめます。チャットの変更内容と進行状況を読みながら、Scene View、Hierarchy、Inspectorで結果を確認します。結果のEntityを押すとInspectorで選択できます。反映が完了したらPlayで内容を確認してください。

制作方法と素材を選ぶ

入力欄の「制作方法」で、次の方法を選べます。

AIにおまかせ：現在のAssets、外部素材、コード、UIKit、Blenderから用途に合う方法を選び、必要に応じて組み合わせます。Blenderが未導入でも、外部素材やコード・UIKitでの制作は利用できます。
素材ストア中心：現在のAssetsや素材ストアを使います。コードによる静的な形状の組み立てとBlenderでのモデル制作は行いません。
Blenderで制作：モデルをBlenderで制作します。端末にBlenderが必要です。未導入の場合は、導入後に「Blenderを再確認」を押してください。

外部素材は、利用できるストアの対応形式と利用条件を確認して取り込みます。目的に合うものを必要な範囲で使い、周囲との色・大きさ・質感も整えます。

依頼に合う全体の構成と制作方法を決め、必要な素材を選びます。現在のAssetsやコードで作れる形状を使い、足りない形や質感がある場合だけ、種類や用途を絞って外部素材を検索します。同じ公開カタログの確認は一定時間再利用し、複数の配布元を調べる場合も独立して読み込みます。候補と表示順を保ち、同じ一覧や説明の重複を抑えます。

コードから作ったものも、通常のEntityとしてHierarchyやInspectorから編集できます。制作の原本はプロジェクトに保存します。親のEntityをチャットへ添付して「家の窓を増やして」「街並みの屋根だけ変えて」のように頼むと、その原本を使って続きを作ります。手で調整した位置や材質、追加した子Entityは保持します。手動編集した部品を削除する必要がある場合は、Sceneを保って停止し、理由を表示します。

家1軒を詳しく仕上げる依頼と、街全体を作る依頼では、見る距離と必要な構造に合わせて細かさを変えます。制作後はSceneの描画画像を確認し、完了条件に足りない部分を直します。Studio独自の制作回数の上限は設けず、必要な編集と確認を制作チャットが進めます。

制作チャットは必要なSceneや素材の情報を読みながらStudioの通常の編集機能を呼びます。エラーがあれば内容を参考に修正します。保存済みの部分成果は、失敗や停止があっても残ります。

コードでの制作では、基本形状、直線の輪郭を押し出した形状、繰り返しの配置を組み合わせられます。対応しない表現を含むコードは反映せず、修正に必要な情報を表示します。木やベンチなど同じものを複数置く場合、制作チャットは一つをプレハブにして残りを配置します。元のEntityを直すと、すべての配置へ反映できます。詳しくはAIに繰り返し作ってもらうを参照してください。Blenderのモデルには曲線や回転面、角の丸み、輪郭の押し出しを使えます。各パーツにはUVを作るため、取り込んだテクスチャを通常のMaterial設定で割り当てられます。このChatGPT接続からの画像生成の自動呼び出しには、まだ対応していません。

Windowsでも制作処理はバックグラウンドで進み、別のシェルを開く必要はありません。進捗は制作チャット内で確認できます。

Blenderでモデルを制作している間は、制作チャットに実際の形状の途中画像が表示されます。最初と最後のパーツが完成したとき、長い制作では約10秒が経過した後のパーツ完成時に更新します。表示は直近4枚で、チャットを開き直すと画像は残りません。

ワールド全体を仕上げる

説明展示や教材は、読む距離、見出しと本文の大きさ、カードの余白、立体見本を組み合わせて作れます。「VRで2mほど離れて読める案内にして。長い文章は分け、見本の周りを歩けるようにして」のように、体験したい内容を伝えてください。コードで作る文字には太さ・整列・行間・字間も指定できます。Textの背景はBorder Radiusで角を丸められます。単位はmです。

@react-three/uikitのUIは、TSXのScriptとして作れます。「UIKitで角丸と余白のある案内を作って」のように依頼してください。ScriptテンプレートのUIKit Panelからも始められます。角丸、余白、間隔、Flexboxを使えます。UIKit Panelテンプレートは、Playを押さずに編集画面で表示できます。既存のScriptはInspectorの「スクリプトを表示する場面」で「編集中の表示と動作確認」を選んでください。Scriptのモジュールと表示用のRenderは編集時にも読み込みます。開始・更新処理と操作の確認はPlayで行います。UIKitの寸法は、全体の幅・高さがm、角丸や文字サイズなどがpxです。初期フォントは英字用のため、日本語を表示するときは対応するTTFをFontとして取り込み、ScriptのFontプロパティへ割り当てます。

HierarchyやScene ViewでEntityを右クリックし、「チャットに送る」を選ぶと、対象を添付して制作チャットを開きます。下書きは保持します。「AIで作り替える…」では、対象と仕上げの依頼文が入り、制作方法が「AIにおまかせ」になります。Primitiveに加え、Textや空のEntityにも使えます。モデル内部の参照ノードでは、元のEntityを選んでください。「希望する仕上がり」の文が選択されるので、好みの雰囲気や用途に書き換えて送信します。位置や既存のしかけを保ち、変更した表示が重ならないように依頼します。右クリックの操作だけでは制作を始めません。方法を指定したい場合は、送信前に「制作方法」を変更できます。

全体の見た目を試すときは、次のように依頼できます。

今のワールドを、VRで歩いて学べるXRift Studioの案内ラウンジに仕上げてください。入口、3つの体験コーナー、休憩場所を作り、白・深い青・ミントを基調に揃えてください。説明UIは@react-three/uikitで角丸・余白・見出しの強弱を付け、日本語対応フォントを使って2〜3mから読めるようにしてください。家具や質感には利用条件を確認した外部素材も使い、独自の形が必要な部分だけコードやBlenderで補ってください。既存のしかけと編集済みの内容を保ち、Skyboxと照明も整えてください。VR・WebGLの負荷を考慮し、保存後にPlayと実際の表示を確認して、未確認の点を教えてください。

ワールド全体の制作では、Skyboxと照明も構成に合わせて考えます。Skyboxの背景と、画像で照らすIBLは別の設定です。Ambient Lightは有効にしてから色と強さを調整します。軽さを重視する場合は「WebGLとVR向けに、影を落とすライトやポストエフェクトを少なくして」と伝えられます。文字の読みやすさは想定する距離から確認し、実機での操作や滑らかさは描画負荷の確認と合わせて試してください。

制作する範囲に合わせて、詳しく作る場所と全体の完了条件を決めます。家1軒を主役にする依頼では、屋根や入口など必要な構造を詳しく作ります。街全体の依頼では、道・区画・建物の大きさと配置を揃え、同じモデルも共有します。背景の建物すべてに内装を作るような、依頼に必要のない作業は増やしません。

「公園を作ってください」のように場所全体を頼むと、園路、植栽、休憩場所、照明などを含む全体を考えて制作します。選択中のEntityだけに作業を限定せず、未編集の初期配置の床や箱は必要に応じて置き換えます。編集済みの作品や添付した対象は保持するため、作り直したい範囲がある場合は依頼に含めてください。

最初の結果から全体がまとまるように、主な形状・通路・材質・照明を一緒に作ります。すべての素材を調べ終わるまで待つ工程や、一つずつ部品だけを完成させる工程を一律には設けません。保存後は見える範囲と元の完成条件を確認し、必要な部分を直します。

ワールドや周囲の環境をまとめて作る場合は、通常の依頼でも作業を保存しながら続きを進めます。一つの制作セッションが必要な操作を選び、独立した読み取りをまとめて進めます。最初の依頼に対して必要な作業を進め、保存結果とSceneの描画画像を確認して仕上げます。画像だけでは確認できない操作や通行のしやすさは、PlayやXRiftでも試してください。

見直しでは、最初の完了条件を一つずつ、同じ保存済みSceneと新しい画像で確認します。一部だけを見て全体を完了とはせず、見えない・確認できない条件は残します。元の条件にない内装や装飾を追加し続けず、足りない条件に関係する作業だけを進めます。

完了条件を満たしたら終了します。Studio独自のターン数・ツール回数・制作時間による停止はありません。ChatGPT側の利用枠や通信・個別操作のタイムアウトは引き続き適用されます。長い依頼では使用量や待ち時間が増えるため、途中で止めたい場合は「制作を停止」を押してください。追加指示を受け取るタイミングは、送信欄で選べます。

「制作を停止」を押すと以降の処理を止め、実行中の処理が終了するまで待ちます。停止前に保存した変更は残ります。会話履歴を保存できない場合は、次の推論や変更を始めず、保存エラーを表示します。Studioを再起動した場合も、実行中だった依頼を自動では再開しません。

停止要求が受け付けられた後も、実行中の処理が終了するまでは停止処理中です。終了を確認してから次の依頼を送ってください。保存済みの結果を見て送信待ちの「再試行」を押すと、新しい実行として始まり、前の失敗・停止の記録も残ります。再試行では現在のSceneを読み直して作業を進めます。

制作チャットの実行

一つの制作セッションが設計・制作・配置・確認を直接進めます。実装方法などは制作チャットが選び、依頼された通常の制作や検証のたびに承認を求めません。重要な未決定事項だけ利用者へ確認します。必要なツールを制作チャットが検索し、独立した読み取りをまとめられます。編集は競合を確認しながら順番に反映します。

制作結果を確認する

完成の検証記録がない通常の応答は「応答済み」と表示し、確認の呼び出しがなかったことだけで失敗扱いにはしません。通信や編集の実際のエラーは、保存済みの変更を保持して案内します。

制作は、Sceneの読み取り、編集、保存、見直しを繰り返して進めます。保存件数だけで完了にはせず、Sceneの整合性と実際の描画画像を確認します。編集した後は、以前の画像を完成の確認に使いません。

処理の経過は「作業の記録」で確認できます。制作中は応答途中の文章も表示します。接続の再試行や会話の要約中には、その状態を表示します。会話を要約した後も、現在の依頼・条件・承認・回答を参照して続きを進めます。「この依頼の実行情報」ではAIが応答した回数、操作を呼び出した回数、使用量（トークン）を確認できます。回数は利用状況の表示で、制作の停止上限ではありません。失敗や停止があっても、保存済みの変更は残ります。結果をScene Viewで確認し、必要に応じて次の依頼で続きを作ってください。スクリプトや複数人での動作はPlayやXRiftでも確認してください。

/goalで全体を作り込む

長めの制作をまとめて頼む場合は、先頭に/goalと目標を書きます。

/goal 湖畔の休憩所を作ってください。建物、家具、植栽、空と照明を揃え、配置と細部を見直して仕上げてください。

元の目標に対して制作と見直しを続けます。Studio側で固定した制作回数や実行時間の上限はありません。途中で止める場合は「制作を停止」を押してください。実行中の処理が終わるまで停止処理中になり、保存済みの結果は保持されます。

チャットを広く表示する

ログを読み返すときは、チャット上部の「チャットを広く」を押します。Scene Viewを小さくし、チャットを右側いっぱいに表示します。HierarchyとInspectorは一時的に隠れます。「Sceneを広く」で元の表示へ戻せます。切り替えても入力、添付、会話、実行中の制作は残ります。スマートフォン幅では、もともとのチャット全面表示を使います。

入力候補を使う

接続済みのチャットで入力欄が空のときは、入力欄に候補を1件だけ表示します。直前の完了結果や、添付中のEntity・Materialに合わせた候補を端末上で作ります。

入力欄でTabを単独で押すと候補を入力でき、関連するEntityやMaterialも添付されます。候補の挿入では送信しません。文面や添付を確認して必要に応じて編集し、Enterで送信してください。

候補の横の×ボタンか、入力欄でEscapeを押すと閉じられます。同じ結果と添付のままなら、チャットを開き直しても閉じた状態を保ちます。Shift+Tabと↑・↓は通常の操作に使えます。入力途中や日本語の変換中は、通常の入力操作を続けられます。制作中、送信待ちがあるとき、未接続、質問や変更内容の確認待ち、失敗・停止・変更の取り消し後は候補を表示しません。制作前の質問では、Tabで項目へ移動し、Spaceで回答を選びます。

制作中に追加指示を送る

会話と送信待ちの依頼は、同じ領域でスクロールできます。ウィンドウの高さが足りないときはチャット全体もスクロールし、確認ボタンや入力欄へ移動できます。

制作中も入力できます。「今の制作に反映」は、現在の応答と操作が終わったところで追加指示を受け取ります。「終了後に実行」は、現在の制作が終わってから同じ会話で実行します。進行中の依頼と同じモデル・思考量・制作方法を使い、添付したEntityとMaterialも追加指示に含めます。

追加指示は受信の確認後に入力欄から消えます。送信できなかった場合や送信中に書き足した内容は入力欄に残します。会話には受信待ち・受信済み・未反映の状態を表示します。停止や終了までに受信されなかった追加指示は「入力欄に戻す」から再送できます。別のSceneやチャットへ追加指示を送ることはできません。

/planや/goalで始める新しい依頼は、これまでどおり送信待ちに入り、モデル・思考量・添付・制作方法を依頼ごとに保持します。処理を始めるときに最新のSceneを読むため、先の依頼の結果や手動編集を踏まえて進められます。

接続待ち、モデル未選択、Playや素材の読み込み中は、理由を表示して送信を保留します。質問への回答や、変更内容の反映・破棄を待っている間も、次の依頼を保留します。制作を停止した場合や失敗した場合は、後の依頼を自動で送信しません。失敗した依頼も残るので、内容を確認し「再開」か「再試行」を押してください。不要な依頼は一覧の取り消しボタンで外せます。予約したモデルが使えなくなった場合は、現在の選択で「送信設定を更新」できます。

チャットを閉じても送信待ちと入力中の下書きは残ります。別のSceneやチャットへ移った依頼は保留し、元のSceneやチャットへ戻って再開できます。送信待ちはStudioを開いている間だけ保持します。終了すると未送信の依頼は消えます。

相談と生成には選択したChatGPTアカウントの利用枠を使用します。XRiftへのログインとは別です。接続情報はOSの安全な保存先に保管し、Studioの起動時に復元します。復元中は完了を待ってください。期限切れなどで復元できない場合は再接続します。「接続を解除」すると保存した接続情報も消え、別アカウントにログインできます。接続情報をプロジェクトやMCPの応答へ含めません。

制作中のプロジェクトにある素材と、素材ストアの内蔵カタログを使えます。Poly Haven、ambientCG、AI LOWPOLY PROPS、音蔵は、必要な種類だけ検索します。外部素材が不要な位置・音量などの調整では、全ストアの検索を待ちません。ストアごとに対応する種類から候補を選びます。

Studioの制作チャットでの画像生成は未対応で、既存画像の取り込みや素材検索を利用できます。

Light、Text、Collider、Rigid Bodyなどの基本Componentと、Mirror、ScreenShareDisplay、TagBoardなどの公式XRift Componentの追加・設定・取り外しを頼めます。既存Entityへの追加と、Component用の新しいEntityの作成に対応します。追加候補と変更できる項目はMCPと共通の定義を使い、同じ編集・検証・保存処理を通します。TransformはEntityに必須のため取り外せません。画面共有や複数人での同期は、実際の利用環境で動作を確認してください。

Entityの削除を依頼すると、変更内容に対象名と配下を含む削除件数を表示します。Modelの一部であるEntityは、通常の手動操作と同じく非表示にします。削除・非表示も「この依頼の変更を戻す」で復元できます。後から加えた編集を上書きする場合は、復元を停止して理由を表示します。素材ファイルやプロジェクトの削除は行いません。

制作に必要な重要な希望や対象が決まっていない場合は、最大3ページの確認を表示します。制作途中に確認が必要になった場合は、そこまでの変更を保存してから回答を待ちます。選択肢か「その他（自由入力）」で回答し、「次へ」「前へ」で見直せます。最後に「回答して進める」を押すまでは追加の制作を進めません。すでに保存した変更は残り、回答後も同じ依頼の保存件数と利用状況を引き継ぎます。「この依頼を終了」は続きを止め、保存済みの内容を保持します。回答は会話へ残り、同じモデル・添付・制作方法で編集を進めます。

Skyboxの候補は3つに限定せず、十分な素材があるときは6〜12候補を表示します。Sceneの雰囲気や用途、依頼に合う順に並び、名前の下のサムネイルで見比べられます。素材集から追加できる素材も、提案名や変更内容の下にプレビューを表示します。素材集と同じ描画や画像を使い、画像を取得できない場合はその状態を表示します。提案や結果のプレビューは会話履歴にも残ります。

Materialも、使える素材から最大12候補を比べて選べます。「この箱だけ」「添付した2つをそれぞれ違う質感に」「Scene全体の質感を整えたい」のように、変更する範囲を指定してください。複数の対象に同じMaterialをまとめて使う必要はなく、対象ごとに違う候補を選べます。候補を比べたい依頼では、回答がそろうまで変更しません。

全体をまとめて変えるときは「Scene全体のMaterialを候補から選んで一括変更して」と依頼してください。候補を1つ選ぶと、Scene内の有効なMesh Rendererの全スロットへまとめて反映します。Entityごとに選び直す必要はなく、多数のEntityでも1回の変更として保存します。「この依頼の変更を戻す」でまとめて元に戻せます。形状・配置と元の共有Materialは保ちます。

Entityへの割り当てを変える場合は、指定した対象だけを変更し、元の共有Materialを保ちます。AssetsのMaterial自体を編集する依頼では、そのMaterialを使っているほかのEntityにも反映されます。変更範囲が決まっていない場合は、先に確認します。

大きい依頼でも、全体の構成を作って保存し、足りない部分を見直します。制作が止まった後に続きの依頼を送ると、保存した結果と会話を踏まえて次の作業へ進みます。件数を数えたり、EntityのJSONを作ったりする必要はありません。同じ素材を使う配置では素材を共有し、テクスチャ・材質・ライセンス情報と一緒に保存します。

手でSceneを編集してから次の依頼を送っても、その時点のEntity、配置、素材を読み直して制作できます。ChatGPTが考えている間に編集した場合も、最新のSceneから内容を考え直します。制作中の変更対象を手で編集した場合は、その編集と保存済みの制作結果を保持し、未完了の作業を考え直して続けます。チャットには考え直している状況を表示します。

HierarchyからEntityを制作チャットへドラッグすると、入力欄の上に名前付きの添付として表示します。複数選択したEntityもまとめて添付でき、各添付の「添付を外す」で解除できます。添付したEntityと配下のEntityは、送信時点の状態から優先してAIへ渡します。大きな階層は送信量に応じて一部を参照します。Entityを複製したり、移動したりする操作ではありません。送信待ちの依頼にも添付を保持し、送信後の会話に対象名を残します。添付だけでは送信せず、変更したい内容を入力して送ってください。

AssetsのMaterialも制作チャットへドラッグして添付できます。複数選択したMaterialをまとめて添付するか、ドラッグを重ねて追加してください。入力欄の上でMaterial名を確認し、不要なものは解除できます。添付は最大16件で、Entityと一緒に使えます。「このMaterialを緑色にして、Roughnessを0.8に変更して」のように依頼すると、送信時点の設定を参考に、同じMaterial自体を編集して保存します。色、粗さ、金属感、透明度、発光、両面表示などを変更でき、同じMaterialを使うEntityに反映されます。結果はSceneと作業の記録で確認でき、「この依頼の変更を戻す」で戻せます。未指定のテクスチャやShaderは保ちます。添付は下書き・送信待ち・会話に引き継ぎ、削除されたMaterialの依頼は送信を保留します。

ここに表示する値は、現在のScene設定と連動しています。調整は通常のシーン設定と同じ処理で描画へ反映し、自動保存します。使っているSkyboxの画像やShader、変更していない設定は保ちます。手動調整はエディターの「元に戻す」で取り消せます。保存当時の設定値と作業記録は書き換えません。制作中・確認待ち・取り消した結果では編集欄を表示せず、Play中や素材の読み込み中は操作できません。

制作内容に素材や設定の不足がある場合も、保存済みの変更を保ち、利用できる素材と現在のSceneから未完了の作業を考え直します。制作チャットが正式ツールの検証結果を読んで修正します。保存先や接続の問題で制作を続けられない場合は、原因を表示して停止します。

反映前の確認を待っている対象を手で編集した場合は、新しい変更内容を表示します。内容をもう一度確認して「変更を反映」を押すか、「変更を破棄」を押してください。手動編集が続いて制作を止めた場合は、編集が落ち着いてから次の依頼を送ると、最新のSceneから再開できます。

チャット上部の「新しいチャット」で相談を分け、「制作チャットの履歴」から切り替えられます。履歴は端末に最大20チャット、各30件保存します。「チャットの操作」から名前の変更、作業履歴の全体コピー、履歴の削除ができます。履歴を削除してもSceneは変わりません。再起動すると確認待ちの依頼は終了しますが、相談と結果は残り、続きの依頼を送れます。

モデル制作と配置は一連の依頼として伝えられます。既存のModelを指定するか、Blenderで作る内容を伝え、個数・位置・回転・大きさを指定してください。制作チャットが正式ツールでモデルを取得・制作して配置し、必要に応じて実際の寸法を確認します。依頼全体に固定した16配置の上限はありません。座標の提案だけを頼む場合は、その希望も伝えてください。R3Fによる形状制作も利用できます。

「会話の流れ」には制作チャットの依頼・操作・応答を表示します。完了したAI応答の「ここから別の案を始める」で、その時点の会話から別案のチャットを作れます。現在のSceneは変わりません。新しい依頼では分岐した会話と現在のSceneを使います。通常の続きやPlanの承認、質問への回答も制作チャットの同じ履歴へ追加します。失敗した依頼でも履歴を保持し、未完了の操作を完了済みとして再開しません。以前のワールド状態を復元する操作ではないため、作品も別案として残す場合はプロジェクトの複製を利用してください。制作チャットの詳細履歴は端末のアプリデータに保存します。チャット削除時に、他の分岐が参照しない詳細履歴も削除します。

追加機能を使う場合は、「制作に使う追加機能」にnpm:package-name@1.2.3形式で、信頼する提供元の正確なバージョンを1行ずつ登録し、「追加機能の設定を保存」を押します。最大8件を登録でき、次の制作で必要なものを自動導入します。登録済みの同じバージョンは再利用します。導入スクリプトは実行しませんが、拡張コード自体はStudioと同じOS権限で動きます。Planでは読み込みません。導入や読込に失敗した場合は設定を修正または無効化して再試行してください。

チャット右上の「出力をコピー」で、表示中の会話、変更内容、作業記録、エラー、案内文、「この依頼の変更を戻す」などの操作名をまとめてコピーできます。設定項目と作業記録の本文も含みます。入力中の依頼は含みません。出力の文字を選択して一部だけコピーすることもできます。出力欄にフォーカスしてCtrl+A（MacではCommand+A）を押すと、出力欄の文字をまとめて選択できます。

保存件数の横にある「この依頼の変更を戻す」は、その依頼で反映したSceneとAssetsの変更をまとめて戻して保存します。個別の設定だけを戻す操作ではありません。その後に別の編集が入っている場合は、上書きを防ぐため戻せません。戻すための控えはStudioを開いている間だけ保持します。ダウンロードした素材ファイルとチャット履歴は残ります。

Assetsで取り込んだ素材を確認し、通常のモデル・Material・Audioと同じように編集できます。変更内容の検証や保存に失敗した場合は、反映を停止してエラーを残します。素材の取り込みや配置の途中で失敗した場合も、保存済みの結果は残ります。制作中の停止ボタンは以降の処理を止めるため、反映済みの内容は元に戻しません。生成中に別の作品やSceneへ移動した場合は、その移動先に結果を適用せず停止します。Playや素材の読み込みが始まった場合も反映を止めます。公開や外部アセット購入は行いません。

生成に失敗した場合は、パネルのエラーと通知を確認し、再接続やモデル変更、依頼を短くしての再試行を行ってください。生成の完了は、見た目や動作の品質を保証するものではありません。

MCPからも接続状態の確認、接続・解除、モデル一覧の取得、生成を行えます。ブラウザでの許可は本人が行います。接続開始はconnect_chatgpt、状態確認はget_chatgpt_connectionです。list_chatgpt_modelsでモデルと対応する思考量を確認し、generate_chatgpt_worldのreasoningEffortへ対応する値だけを渡します。省略時は対応するlowを優先し、非対応ならモデル情報にある既定の思考量を使います。思考量の情報を確認できない場合は、モデル側の標準設定に任せます。

Studioの制作チャットは送信すると編集を進めます。MCP/APIでは、mode: "plan"で反映前のPlanだけを作り、apply_chatgpt_planで後から反映することもできます。この確認待ちがStudioに表示された場合は「変更を反映」または「変更を破棄」を選べます。確認後に対象が編集された場合は、最新のSceneで新しいPlanを作り、確認待ちに戻します。別のワールドを作る場合はtarget: "new"を指定します。返されたIDをget_chatgpt_generationへ渡して、工程、保存済みの件数、確認待ち、完了・停止・失敗を確認してください。cancel_chatgpt_generationは未反映のPlanの破棄や制作の停止に使います。反映後はget_editor_contextで状態を取得し、capture_scene_viewで実物を確認します。

会話の一覧はlist_chatgpt_sessions、全文はget_chatgpt_session、作成・切り替え・名前変更・削除はmanage_chatgpt_sessionを使います。続きの依頼ではgenerate_chatgpt_worldにsessionIdを渡します。戻せる依頼はrevert_chatgpt_generationで戻せます。モデルだけを設定する場合はset_entity_modelを使うと、既存Entityの名前・位置・回転・大きさを保てます。

MCPで制作の上限と完成条件を使う

外部AIクライアントも、Studioの制作チャットと共通の制作方針を使います。get_world_authoring_guideのtopic: "overview"で制作方法を確認し、使う方法に合わせてr3f・assets・blenderの詳細を取得できます。利用者が追加のスキルやソースコードを用意する必要はありません。

コードでまとまった形状を作る場合は、apply_r3f_sceneで制作原本を保存して反映します。更新前に原本の親Entityをget_entity_componentsで読み、r3fAuthoring.sourceから現在の原本を取得します。同じ親Entityを指定して完全な修正版を渡すと、対象の部分を更新できます。Studioの制作チャットと同様に、手で調整した位置や材質を保ち、競合する変更は反映前に止めます。汎用のComponentコードの取り込みは、新規取り込み用の別の操作です。

外部AIクライアントでワールド全体を制作する場合は、begin_world_authoringで設計図と完成条件を保存します。再接続時はget_world_authoringで制作の状態と次の操作を読みます。小さな直接編集で、この制作を始める必要はありません。

制作中は変更や画像確認の回数、進展なし、連続失敗、経過時間をまとめて数えます。既定は変更256回、画像確認8回、進展なし3回、連続失敗3回、経過時間15分です。上限に達すると新しい変更を止めますが、状態の読取や撮影は続けられます。AIクライアント内部の推論回数はStudioから確認できないため、この回数には含めません。

MCPでも、Sceneが変わらない同じ操作や、以前のSceneへ戻る繰り返しを記録します。手動編集を挟んだ場合は、その後の状態から確認します。上限で停止した操作を繰り返し送らず、保存済みの結果と残作業を読んでから制作方針を見直してください。

変更後は最新のSceneを保存し、スポーン視点と俯瞰の両方からcapture_scene_viewで撮影します。AIが画像と元の完成条件を一つずつ見比べ、合否と具体的な理由をreview_world_authoringへ残し、complete_world_authoringで保存と確認の状態を検査します。古い画像、抜けた条件、未確認の条件、保存待ちがあれば完了にはなりません。画像では確かめられない操作や複数人での動作は、実際の利用環境で確認してください。

cancel_world_authoringで制作を停止できます。実行中のMCP操作が終わってから停止要求を処理し、その後の変更を止めます。Sceneや素材、保存済みファイルは残り、停止した制作の画像と判定を完成の証拠には使いません。次の目標を始める前に、保存済みの結果と残りの作業を確認してください。

MCPの制作が実行中、または上限で停止している間は、StudioのChatGPTで別の制作を開始・再開できません。MCP側を停止または完了してから切り替えてください。ChatGPTが制作している間も、MCP側で新たな制作を開始できません。

全体の制作と部分修正を使い分ける

新しく作る場合は「木陰で休める公園を作ってください」のように、完成した場所や使い方を伝えてください。部分修正では「入口を広げて」「選んだ球を右へ1m移動して」のように、対象と変更内容を伝えます。結果を見てから次の依頼を送ると、意図に合わせて編集を進められます。

変更後はHierarchyとInspectorで対象を確認し、Playで見た目や動作を確かめます。意図した結果にならなければ、取り消せる操作は元に戻すか、バックアップを開いてください。

依頼に含めること

作りたい見た目、変更してよい範囲、残したいものを伝えてください。公開や削除など、戻しにくい操作を頼む場合は、依頼に明記します。

AIが完了を報告しても、保存や公開の状態は画面で確認してください。説明と実際の結果が一致しているかを確かめます。

接続できないとき

「MCP接続」の状態表示を確認し、必要に応じてクライアントの再起動や登録をやり直してください。原因が分からない場合は、復旧と問い合わせを参照してください。認証情報や秘密のキーは、問い合わせに含めないでください。

Primitiveで配置や大きさを決めた後、Hierarchyの対象をチャットへ添付して「このEntityをBlender製のモデルに置き換えて」と依頼できます。Mesh Rendererを持つEntityの見た目を置き換え、名前・Transform・親子関係・ほかのComponentを保ちます。Mesh Rendererが複数ある場合は、置き換える対象を確認します。自動フィットのBox Colliderは、新しいモデルの大きさに合わせて更新します。

Skyboxなどの素材を選ぶ質問では、候補名と実際のカタログやAssetsのサムネイルを見比べて選べます。画像がない候補には「プレビューなし」と表示します。選んだ候補は回答とともに次の制作へ引き継ぎます。

制作前の質問では、Tabで各候補と「その他（自由入力）」へ移動し、Spaceで選択できます。Shift+Tabで戻れます。ページを進めると最初の候補へフォーカスが移ります。最後に「回答して進める」で回答を送信します。

「空も仕上げて」「夕方のSkyboxと柔らかい環境光にして」のように、Skybox・環境光・Fogをまとめて依頼できます。露出、Bloom、色調、カメラ、風、重力、グリッドやスナップなどのScene設定も調整できます。指定していない設定とEntityは保ち、「この依頼の変更を戻す」で復元できます。アプリのログイン・更新・権限設定は、このScene編集の対象に含みません。

開発中に画面とアプリ本体の更新が揃っていない場合は、作品を保存してXRift Studioを再起動してから再試行してください。

応答の読みやすさ

制作チャットは、Yomiyasuをもとにした日本語の文章方針を使います。回答だけでなく、進捗、制作プラン、確認質問、完了報告、エラー時の案内にも同じ方針を使います。結果や次の操作を先に伝え、必要な専門用語には説明を添えます。未確認の内容は確認済みと書かず、権限や条件も保つ方針です。追加の登録は不要です。Yomiyasuの校正スクリプトによる自動検査は行いません。