Neocortex Logo

Half-Life 2 AI NPC MOD: 音声で命令する分隊とコンパニオン

Source SDK 2013 で Half-Life 2 の AI NPC MOD を計画する: 音声で指示する反乱軍の分隊、話しかけ返すコンパニオン、隠れ家のストーリーの場面、クイズ端末。

Neocortex TeamThe team behind Neocortex

· 6分で読めます

Source SDK 2013 で Half-Life 2 の AI NPC MOD を計画する: 音声で指示する反乱軍の分隊、話しかけ返すコンパニオン、隠れ家のストーリーの場面、クイズ端末。

Half-Life 2 の分隊 AI は、キー入力に反応します。周りの人々は、スクリプトが許す言葉しか口にしません。反乱軍はあなたについてきますが、あなたは何も指示できません。市民は話しかけてきますが、たった今起きたことについては決して話しません。 Half-Life 2 の AI NPC MOD は、この両方を改善します。命令に声で反応する反乱軍、たった今切り抜けた戦いについて話すコンパニオン、プレイヤーの選択によって変わるストーリーの場面です。Neocortex は AI キャラクター、会話フロー、クイズ、端末内の音声コマンドを提供し、Source SDK 2013 はそれらを組み込むためのコードを提供します。

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

反乱軍の分隊への音声の命令

Half-Life 2 では、すでに分隊を地点へ送ったり呼び戻したりできます。音声コマンドは、キー入力を音声に置き換えます。「前に出ろ」「ここで待て」「車の陰に隠れろ」「私のところに集まれ」といった具合です。

Neocortex のダッシュボードでは、コマンドの一覧を、主体、動作、対象として設計します。たとえば、主体は「分隊」、動作は「移動」「待機」「援護」、対象は「私」「車」「ドア」です。プレイヤーは自然に話し、MOD は一致したコマンドをすぐに受け取ります。1つの文の中の複数の動作や数量にも対応します。「二人はドアを見張り、残りは私について来い」といった具合です。あなたのコードが、それを既存の分隊のコードに対応づけます。

プッシュトゥトークと常時待機のどちらでも使え、複数の言語に対応し、プレイヤーのマシン上で動きます。そのため、銃撃戦の最中でも、クラウドとの往復なしで命令が届きます。

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

実例: Mara Venn と隠れ家

コンパニオン。 オリジナルのコンパニオン、Mara Venn を作ります。診療所が閉鎖された後に反乱軍に加わった、元の野戦医です。MOD は、プレイヤーの質問を、ゲームが把握している情報とともに送ります。近くのオブジェクト (バリケード、弾薬箱、無線機) と、最近の出来事 ("分隊員が2人倒れた"、"プレイヤーが左のトンネルに入った"、"体力が30を下回った") です。Mara は音声で答え、どの行にも感情タグを付けます。医療キットを渡したり、プレイヤーが頼んだ門を開けたりするアクションも返せます。

分隊が言い返す。 グループチャット (Pro と Team のプラン) では、最大6体のキャラクターが1つの会話を共有できるため、分隊全体で次の動きについて言い合えます。

地下室。 Mara はプレイヤーを地下室の隠れ家に案内します。そこでは、用心深い細胞のリーダーの信頼を得なければ、彼が街を出る道を教えてくれません。会話フローが場面を定義します。自己紹介、どちら側の人間かの証明、取引、ルートです。キャラクターは、プレイヤーがどう言い回そうと、会話をこの流れに沿って進めます。API は TRUST_EARNED や ROUTE_SHARED のようなチェックポイントのキーワードを返します。MOD は、隠し扉を開けたり、あなたを外へ導く案内人を出現させたりして反応します。

端末。 部屋の隅では、端末が新兵を訓練します。避けるべき敵の部隊、分隊への合図の出し方、持つべき補給品などです。Neocortex のクイズエンジン (Team プラン) が問題と採点を担当し、正解が続けばプレイヤーに弾薬や近道を与えられます。

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

Half-Life 2 の AI NPC MOD のための Source SDK 2013 のブランチ

Half-Life 2 は Source 上で動きます。MOD は、独自の gameinfo.txt、コンテンツ、Valve のコードから作られた2つの C++ ライブラリからなるフォルダーです。NPC の AI、分隊、ゲームロジックのためのサーバー DLL と、HUD、VGUI パネル、ローカルの演出のためのクライアント DLL です。何よりも先に、ベースを選んでください。

ベース含まれるもの状態
Source SDK 2013 の singleplayer ブランチHalf-Life 2 のシングルプレイヤー用のコード2015年以降コードの更新なし。32 ビットの Source SDK Base 2013 Singleplayer で動作
Source SDK 2013 の master ブランチマルチプレイヤー用のコード2025年2月に Team Fortress 2 のゲームコードと 64 ビットのビルドで更新。Valve は今も更新を続けている
Mapbaseシングルプレイヤー MOD 向けに、コミュニティが管理するベースバージョン 8.0 は 2025年7月に公開。新しいエンティティ、修正、マップのスクリプト用の VScript の実装を追加

上の隠れ家のようなストーリー型の MOD なら、singleplayer ブランチか Mapbase から始めてください。

Source DLL から Neocortex を呼び出す

SDK のヘッダーには Steamworks の HTTP インターフェースが含まれますが、多くの MOD 制作者は代わりに libcurl を追加します。どちらでも、リクエストは作業スレッドで実行し、結果はゲームのループに戻してください。libcurl を使い、クライアントかサーバーの DLL からチャットを呼び出す例は次のとおりです。

// bodyJson: {"characterIds":["CHARACTER_ID"],"message":"Where now?","playerId":"player-1",
//            "sessionId":"","events":[{"priority":1,"content":"Two squad members down"}]}
std::string AskCompanion(const std::string& apiKey, const std::string& bodyJson)
{
    std::string response;
    CURL* curl = curl_easy_init();
    curl_slist* headers = curl_slist_append(nullptr, "Content-Type: application/json");
    headers = curl_slist_append(headers, ("x-api-key: " + apiKey).c_str());
    curl_easy_setopt(curl, CURLOPT_URL, "https://api.neocortex.link/v3/chat");
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, bodyJson.c_str());
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, AppendToString); // appends bytes to response
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
    curl_easy_perform(curl);
    curl_slist_free_all(headers);
    curl_easy_cleanup(curl);
    return response; // sessionId, lines with emotions, actions and flowState
}

MOD はゲームの状態を読み取り、プレイヤーのメッセージとともに /v3/chat を通して Neocortex のキャラクターに送ります。返答は字幕として表示し、音声は /v3/audio/generate か /v3/audio/stream から再生し、キャラクターが返したアクションを実行します。会話フローは、同じ返答の中でチェックポイントのキーワード (flowState) を返します。クイズエンジンは /v3/quiz を通して動きます。端末内の音声コマンドは、話されたフレーズをゲームのアクションに変えます。クラウドとの往復はありません。Neocortex の Voice Commands は、プレイヤーのマシン上で動きます。

UI には、クライアント DLL の VGUI パネルで字幕やクイズの画面を表示できます。Source の クローズドキャプション と サウンドスクリプト は、事前に作られたセリフのためのものです。そのため、リアルタイムの AI の返答には、通常、独自の字幕パネルを用意します。生成された音声はファイルに保存し、エンジンを通して再生します。

公開前に: Source 1 SDK のライセンス

Source 1 SDK のライセンスでは、MOD を無償でのみ配布できます。無償の MOD は Steam で公開できます。AI NPC の MOD はシングルプレイヤーのままにし、ライセンスの規定に反してマルチプレイヤーのサーバーで使わないでください。また、各プレイヤーが自分の Neocortex API キーを使うようにしてください。

空のマップから話す分隊まで

  1. Source SDK 2013 を準備する。 ストーリー型の MOD なら singleplayer ブランチか Mapbase を選び、ビルドして、空のテストマップを起動します。
  2. キャラクターを設計する Neocortex のダッシュボードで、コンパニオン、会話フローを持つ細胞のリーダー、端末のクイズ、分隊の命令の一覧を作ります。
  3. ゲームの DLL から API を呼び出す。 作業スレッドで実行し、各返答の sessionId を再利用します。
  4. API キーは設定ファイルに保管する。 プレイヤーが入力する形にし、配布する MOD には直接書き込まないでください。
  5. 字幕、音声、アクションをつなぐ。 その後、音声コマンドを既存の分隊のコードに対応づけます。
  6. シングルプレイヤーでテストする。 1つのマップで確かめてから、キャンペーン全体に広げてください。

MOD で音声コマンドがどう動くかは、ゲーム MOD の端末内音声コマンド をお読みください。GoldSrc については、Half-Life の AI NPC MOD のガイドを、Source のサンドボックスサーバーについては、Garry's Mod の AI NPC とクイズのアドオン の記事をご覧ください。Mara と分隊は、最初のマップがコンパイルされるずっと前に、今すぐ Neocortex のブラウザエディターでテストできます。

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

よくある質問

Half-Life 2 に AI NPC を追加できますか?

はい。Half-Life 2 の MOD は Valve の Source SDK 2013 で作られます。これは C++ のゲームコード全体を提供するため、MOD は Web API を呼び出し、その返答に基づいて行動できます。Neocortex は AI キャラクター、その音声、返すアクションを提供し、MOD がそれらを実行します。

Source SDK 2013 のシングルプレイヤーとマルチプレイヤーのどちらのブランチを使うべきですか?

ストーリー型の MOD は、通常、シングルプレイヤーのブランチか、そこから作られた Mapbase などのコミュニティのベースから始めます。マルチプレイヤーのブランチは 2025年に 64 ビット対応を含む大きな更新を受け、今も管理されていますが、そのコードはマルチプレイヤーのゲーム向けです。Neocortex はどちらでも動きます。単純な Web API だからです。

Half-Life 2 の反乱軍に音声で命令できますか?

はい。MOD を使えば可能です。Half-Life 2 にはすでに分隊の命令のコードがあり、MOD は音声からそれを呼び出せます。Neocortex の Voice Commands は、プレイヤーの PC 上で自然な言い回しを照合するため、「move up」「hold here」「regroup」などがあなたのコードにすぐに、オフラインで届きます。

AI キャラクターを使った Half-Life 2 の MOD を販売できますか?

いいえ。Source 1 SDK のライセンスでは、MOD を無償でのみ配布できます。ただし、無償の MOD は Steam で公開できます。無償の MOD の Neocortex 側は、ブラウザのエディターで構築とテストができます。

関連記事

こちらもおすすめ