Neocortex Logo

Portal 2 AI Mod:話すテスト・チャンバーのAIと音声コマンド

Portal 2のAI modを作ります。失敗を皮肉るテスト・チャンバーのAI、音声で操作するチャンバー、サイエンスクイズを、VScriptからつないで実現します。

Neocortex TeamThe team behind Neocortex

· 6分で読めます

Portal 2のAI modを作ります。失敗を皮肉るテスト・チャンバーのAI、音声で操作するチャンバー、サイエンスクイズを、VScriptからつないで実現します。

Portal 2のマップのスクリプトは、インターネットに接続できません。Portal 2のAI modはすべて、この問題を解決しなければなりません。その答えは、ゲームのそばで動く小さなヘルパーアプリです。 これが用意できれば、テスト・チャンバーに話すAIを持たせられます。壁の中の声に評価されるというゲームの雰囲気にも合います。同じジャンプに5回失敗したことに気づき、それについて何か言うチャンバー、話しかけて操作するチャンバー、正解したときだけ出口が開くクイズなどです。Neocortexは、AIキャラクター、Conversation Flows、クイズ、デバイス上で動くボイスコマンドを提供します。

Portal 2のゲーム内のスクリーンショット スクリーンショット:Portal 2 © Valve

Portal 2のAI modにヘルパーアプリが必要な理由は?

Portal 2のマップは、Portal 2 Authoring ToolsのHammerで作られ、Steam Workshopで共有されます。マップのロジックは、エンティティのI/OとVScriptです。Portal 2のVScriptはSquirrelです。VScriptはエンティティを読み、動かし、プレイヤーを追跡し、コンソールに出力できますが、ネットワークやHTTPのアクセスはありません。

そのため、マップにできることは、状況を報告し、反応することです。Neocortexとの通信は、ローカルのヘルパーアプリが行います。ヘルパーは、HTTPクライアントを備えた任意の言語で書けます。

ゲームからイベントを出し、また戻すには?

方向方法
ゲームから出すVScriptが、タグ付きの行(イベントやチャンバーの状態)をコンソールに出力します。-condebug を付けてPortal 2を起動すると、コンソールの出力が、ヘルパーが監視できる console.log ファイルに書き込まれます。Valveのコマンドラインオプションをご覧ください。
ゲームに戻す-netconport の起動オプションでコンソールのポートが開き、ヘルパーからコンソールコマンドを送り返せます。たとえば、マップのVScriptへの script 呼び出しです。そのポートは、ご自身のマシン内に留めてください。
字幕マップは game_text エンティティで返答のテキストを表示します。
音声ヘルパーは、キャラクターの声をPCの音声出力で再生します。

Neocortex側では、ヘルパーがコンソールのログからゲームの状態を読み取り、プレイヤーのメッセージとともに /v3/chat を通じてキャラクターに送ります。マップは返答を字幕として表示し、ヘルパーは /v3/audio/generate または /v3/audio/stream から声を再生します。キャラクターが返したアクションは、コンソールコマンドとしてマップに戻ります。Conversation Flowsは、マップが反応するチェックポイントのキーワード(flowState)を返します。たとえば、次のテストを開くといった反応です。クイズエンジンは、/v3/quiz を通じて問答ゲームを進めます。

テスト・チャンバーのAIには何ができるか?

ゲームのものを借りる代わりに、オリジナルの監視役を作ってください。PROCTOR-7は、チャンバー1つの管理に格下げされた施設の知能で、その立場に不満を持っています。性格、感情の設定、そしてチャンバーの解法、その歴史、些細な不満についての知識ベースを与えてください。

マップは起きたことを報告します。「プレイヤーがゴーの中に落ちた」「パネルBでの3回目の失敗したフリング」「キューブが間違ったボタンに置かれた」「プレイヤーが40秒間立ち止まっている」などです。ヘルパーはそれらを、各メッセージとともにイベントとして送ります。PROCTOR-7は、すべてのセリフに感情タグを付けて、音声でコメントします。新しいことを試すとCURIOUS、想定された解法を壊すとANGRYです。

アクションを返すこともできます。たとえば、十分に失敗が続いた後に、しぶしぶ返す { "name": "SPAWN_CUBE", "targetId": "dropper_01" } があります。マップはそれをヒントとして実行します。

Conversation Flowは、チャンバー全体を1つの物語にできます。導入、最初のテスト、プレイヤーがPROCTOR-7と話しながら対処する「誤作動」、最後のテストです。APIが返す各チェックポイントのキーワードが、マップの次のパートを開きます。

Portal 2のゲーム内のスクリーンショット スクリーンショット:Portal 2 © Valve

プレイヤーは話すことでチャンバーを解けるか?

はい。プレイヤーが話しかけることで解けるチャンバーを作れます。Neocortexのダッシュボードで、アクター、アクション、オブジェクトの組み合わせとしてコマンドのセットを設計します。たとえば、アクター「chamber」、アクション「raise」「lower」「drop」「extend」、オブジェクト「platform」「cube」「bridge」です。

プレイヤーは自然に話し、ヘルパーは一致したコマンドを瞬時に受け取ります。1つの文に複数のアクションや数量が入っていても対応します。たとえば「drop two cubes and raise the platform」です。プッシュトゥトークと常時待ち受けの両方に対応し、複数の言語で使えます。Neocortex Voice Commandsはプレイヤーのマシン上で動き、クラウドを経由しないため、フリングのタイミングが重要な場面でも役立ちます。

Voice Commandsはライセンス付きのSDKです。Voice Commandsのライセンスについてはお問い合わせください。

同じチャンバーで、反射神経ではなく知識を試すこともできます。アナウンサーのキャラクターが、Neocortexのダッシュボードで作られた物理の質問をします。運動量、重力、なぜポータルを通っても速度が保たれるのか、といった質問です。クイズエンジン(Teamプラン)が、質問と採点を行います。正解するごとに光の橋のセグメントが1つ増え、不正解だとキューブがゴーの中に落ちます。

Portal 2: Community Editionでも動くか?

Portal 2: Community Editionは、コミュニティが保守しているPortal 2のバージョンで、CS:GOエンジンのブランチを公式にライセンスされたフォークであるStrata Source上で動きます。2026年4月17日にSteamでオープンベータに入りました。Portal 2の所有者は無料で利用でき、ネイティブの64ビット版、AngelScriptのスクリプト、PanoramaによるUI、アドオンシステム、独自のWorkshopが加わります。

まだベータ版なので、スクリプトでできることは、ドキュメントで確認してください。どちらにしても、ヘルパーアプリの方式はそこでも動きます。

Workshopで公開できるか?

ValveのWorkshopの規約はマップに適用されます。ヘルパーアプリは別のダウンロードで、プレイヤーが実行するかどうかを選びます。AIと音声の機能は、シングルプレイヤーのチャンバーに限ってください。参加に同意していないプレイヤーとのCo-opで、有利になるために使ってはいけません。また、各プレイヤーがご自身のNeocortex APIキーを使うようにしてください。

最初の話すチャンバーを作る

  1. テスト・チャンバーを作る。 Hammerで、タグ付きのイベントをコンソールに出力するVScriptファイルを使って作ります。
  2. キャラクターを設計する。 Neocortexのダッシュボードで、PROCTOR-7の性格と知識、チャンバー用のConversation Flow、クイズ、コマンドのセットを作ります。
  3. ヘルパーアプリを書く。 console.log を監視し、/v3/chat を呼び出し、声を再生し、コンソールポート経由でコマンドを送り返します。
  4. APIキーはヘルパーの設定ファイルに保存する。 プレイヤーが入力するもので、共有するビルドに直接書き込まないでください。
  5. 起動オプションを設定し、シングルプレイヤーでテストする。 その後、マップをWorkshopで、ヘルパーを別々に公開します。

音声の部分については、ゲームmodのためのデバイス上のボイスコマンドをお読みください。Sourceエンジンのエンジンレベルのmodについては、Half-Life 2 AI NPC modのガイドをご覧ください。スクリプトからAPIを直接呼び出せるSourceのゲームについては、Titanfall 2 AI modのガイドがあります。将来PROCTOR-7をスタンドアロンのゲームで使いたい場合は、同じNeocortexのキャラクターがUnity連携で動きます。

ツールのバージョンとリンクは2026年10月に確認しています。modツールは頻繁に変わるため、最新のリリースは各プロジェクトのページで確認してください。

よくある質問

Portal 2にAIキャラクターを追加できますか?

はい。小さなヘルパーアプリを使います。Portal 2のマップのスクリプトはインターネットに接続できないため、マップがイベントをコンソールに出力し、ローカルのヘルパーアプリがそれをAIキャラクターに渡します。Neocortexがキャラクター、その声、返答を提供し、ヘルパーがそれをゲームに送り返します。

Portal 2のVScriptはHTTPリクエストを送れますか?

いいえ。Portal 2のVScriptは、マップの内部で動くSquirrelで、ネットワークにはアクセスできません。よくある方法は、イベントをコンソールに記録し、ヘルパーアプリがそれを読み取り、そのアプリがNeocortexなどのWeb APIを呼び出すことです。

声でPortal 2のテスト・チャンバーを操作できますか?

はい。ヘルパーアプリはマイクを聞き、一致したコマンド(プラットフォームを上げる、キューブを落とすなど)をゲームに送れます。Neocortex Voice CommandsはプレイヤーのPC上で一致を行うため、オフラインでも動き、瞬時に反応します。

Portal 2: Community Editionとは何ですか?

Portal 2: Community Editionは、Strata Sourceエンジン上でコミュニティが保守しているPortal 2のバージョンです。2026年4月からSteamでオープンベータになっており、Portal 2の所有者は無料で利用できます。AngelScriptやPanorama UI、アドオンシステムが加わり、Neocortex向けのヘルパーアプリの方式もそこで動きます。

話すAIのテスト・チャンバーをSteam Workshopで公開できますか?

マップは通常どおりWorkshopで公開できます。ただし、ヘルパーアプリは別に共有する必要があります(たとえばGitHubで)。各プレイヤーは、ご自身のNeocortex APIキーを使ってそれを実行します。そのAPIキーは、ブラウザのエディターで取得できます。

関連記事

こちらもおすすめ