Half-Life AI NPC MOD: 話す科学者と音声コマンド
HL SDKまたはXash3D FWGSでHalf-Life AI NPC MODを作ります。話しかけられる科学者と警備員、警備員への音声コマンド、ブラックメサの安全クイズを扱います。
Neocortex TeamThe team behind Neocortex
· 7分で読めます

ブラックメサの科学者に本当の質問ができたら、何を話してくれるでしょうか。ベースゲームでは、新しいことは何もありません。科学者も警備員も、録音された台詞をいくつか持っているだけです。 Half-Life AI NPC MODは、それを変えます。ゲームのDLLがプレイヤーの発言をAIキャラクターに送り、返答を音声と字幕で再生します。Neocortexを使えば、スクリプトされた見せ場のための会話フロー、クイズエンジン、警備員のためのオンデバイスの音声コマンドも使えます。
スクリーンショット: Half-Life © Valve
ValveのSDKとXash3D FWGS
現在、2つのコードベースが使われており、Half-Life AI NPC MODはどちらでも動きます。
| ValveのHalf-Life SDK | hlsdk-portable付きのXash3D FWGS | |
|---|---|---|
| 内容 | クライアントとサーバーのライブラリの公式ソース | Half-Lifeと互換性のあるオープンソースのエンジンと、FWGSのクロスプラットフォーム版SDK |
| 動作環境 | GoldSrc | Windows、Linux、BSD、Android。hlsdk-portableはGoldSrcとXash3D向けにビルドされます |
| 状況 | Valveが2024年10月に、その月のSteamのパッチに合わせて最後に更新 | 活発に開発されています |
| ビルド | クライアントとサーバーのDLL | 同じDLLをCMakeまたはwafでビルド。任意のバグ修正や、いくつかのコミュニティのMODは別のブランチとして保持されています |
| ゲームのデータ | Steamで持っているコピー | 自分が持っているゲームコピーのvalveフォルダー |
ValveのSDKのライセンスでは、MODの配布は無料の場合に限られます。
GoldSrcのMODの中身
Half-LifeはGoldSrcで動きます。MODはvalveの隣にあるフォルダーで、マップ、モデル、サウンド、そして2つのコンパイル済みC++ライブラリを含みます。1つはゲームロジック、NPCのAI、トリガーのためのサーバーDLL、もう1つはHUD、エフェクト、ローカルのサウンドのためのクライアントDLLです。
GoldSrcには組み込みのHTTPクライアントがないため、MODでそれをリンクします。WindowsではWinHTTP、LinuxまたはXash3D版も対象にする場合はlibcurlを使います。リクエストはワーカースレッドで実行し、結果をゲームのループに戻してください。返答を待っている間もゲームが止まりません。
字幕には、クライアントDLLでカスタムのHUD要素を描くか、手早く始めたい場合はサーバーからgame_textメッセージを送ります。音声には、WAV音声をリクエストし、MODのサウンドフォルダーに保存して、クライアントで再生します。必要に応じて、エンジンが受け付ける形式に変換してください。
キャストを紹介する
Dr. Ilse Marek と Officer Dale Ruiz
ベースゲームのキャストを流用せず、自分のキャストを作りましょう。Dr. Ilse Marekは睡眠不足の分光測定の研究者で、この3日間、研究室を出ていません。Officer Dale Ruizは同じ検問所に9年勤めており、トラムの時刻表について意見があります。
Neocortexのエディターで、それぞれにPersonality、Emotionの設定、Knowledgeベースを与えてください。研究室の手順、テストチャンバーについての噂、誰が誰に借金があるか、などです。
MODは、各メッセージに文脈を付けて送ります。近くのオブジェクト(研究室のドア、網膜スキャナー、ヘルスチャージャー)と、最近の出来事(「照明が落ちた」「プレイヤーがバールを持っている」)です。キャラクターは音声で答え、すべての台詞にはCURIOUSやANGRYのような感情のタグが付きます。それを表情やアニメーションに対応させられます。また、{ "name": "OPEN_DOOR", "targetId": "lab_door_03" }のような行動を返すこともできます。ゲームのDLLは、プレイヤーがボタンを押したのとまったく同じように、そのドアを作動させます。
口頭の命令を聞く警備員
クラシックなHalf-Lifeの警備員は、使用キーを押すとすでにプレイヤーについてきます。音声コマンドを使えば、プレイヤーは話すことで同じことができます。「ついてこい」「ここで待て」「ドアを開けろ」などです。
Neocortexのダッシュボードでは、コマンドのセットを、アクター、行動、オブジェクトとして設計します。たとえば、アクターは「guard」、行動は「follow」「wait」「open」、オブジェクトは「me」と「door」です。プレイヤーは自然に話し、MODは一致したコマンドをすぐに受け取ります。1つの文にいくつものコマンドがあっても対応します。「Ruiz、ドアを開けてここで待て」は2つのコマンドとして届きます。プッシュトゥトークでも常時リスニングでも動き、複数の言語に対応し、クラウドへの往復なしでプレイヤーのマシン上で動きます。
Voice CommandsはライセンスされたSDKです。Voice Commandsのライセンスについてはお問い合わせください。
安全担当官と案内のクイズ
案内の部屋をゲームにしましょう。安全担当官のキャラクターが、Neocortexのダッシュボードで作った短いクイズを出します。試料が封じ込めから逃げたらどうするか、どの色のバッジが放射線の許可を示すか、廊下を走ってよいのはいつか、などです。
クイズエンジン(Teamプラン)が質問を出し、プレイヤーの回答を確認して、スコアを記録します。合格すれば、MODは次のエリアへのドアを開けます。不合格なら、担当官はあなたを安全に関するスライドショーに戻して、もう一度見させます。
スクリーンショット: Half-Life © Valve
Neocortexが担当する部分
- 会話。 MODはゲームの状態(近くにいるのは誰か、いま何が起きたか)を読み取り、それをプレイヤーのメッセージと一緒に、
/v3/chatを通してNeocortexのキャラクターに送ります。返答は字幕として表示し、/v3/audio/generateまたは/v3/audio/streamから音声を再生し、キャラクターが返した行動を実行します。 - 会話フロー。 分岐するストーリーの見せ場です。たとえば、科学者に保管室を開けさせる場面などです。キャラクターがプレイヤーをその流れに導き、APIはMODが反応するチェックポイントのキーワードを返します。
- クイズ。 クイズエンジンは、
/v3/quizを通して、スコアを含む質疑応答のゲームを動かします。 - 音声コマンド。 オンデバイスの音声コマンドは、話されたフレーズをクラウドへの往復なしでゲームの行動に変えます。Neocortex Voice Commandsは、プレイヤーのマシン上で動きます。
キャラクターはビジュアルのノードエディターで作ります(Personality、Emotion、Knowledge、World、Objects、Actions、Voiceなど)。C++を1行書く前に、ブラウザでテストできます。ほかのAIキャラクターツールとの比較は、私たちの比較記事をご覧ください。
Half-Life AI NPC MODは販売できますか?
いいえ。ValveのHalf-Life SDKのライセンスでは、MODをソースとバイナリの形で配布できますが、それは無料の場合に限られます。商用利用については、Valveに問い合わせるよう求められます。
AI NPC MODはシングルプレイヤーに限り、マルチプレイヤーのサーバーではルールに反して使わないでください。また、各プレイヤーには自分のNeocortex APIキーを使ってもらってください。
最初のマップを段階的に作る
- SDKをセットアップする。 Valveのhalflife SDKまたはhlsdk-portableをクローンし、空のテストMODのためにクライアントとサーバーのDLLをビルドします。
- Neocortexのダッシュボードでキャラクターをデザインする。 科学者、警備員、クイズを持つ安全担当官、警備員のためのコマンドのセットを作ります。
- HTTPクライアントをゲームのDLLに追加する。 ワーカースレッドで
/v3/chatを呼び出し、各返答のsessionIdを再利用します。 - APIキーは設定ファイルに置く。 プレイヤーが記入するファイルにし、共有するMODにハードコーディングしないでください。
- 字幕、音声、行動をつなぐ。 そのあと、警備員のための音声コマンドを追加します。
- シングルプレイヤーで、小さな1つのマップでテストする。 キャンペーン全体を組み立てる前に行ってください。
さらに進みたい場合は、ゲームMOD向けのオンデバイス音声コマンドの仕組みをお読みください。同じ考え方をSourceで見たい場合は、Half-Life 2 AI NPC MODのガイドをご覧ください。ゲームごとのガイドはすべて、AI NPCと音声コマンドのMODの一覧にあります。どれも同じように始まります。C++を書く前に、1体のNeocortexキャラクターをブラウザでテストするところからです。
ツールのバージョンとリンクは2026年10月に確認しました。MODのツールは頻繁に変わるため、最新のリリースは各プロジェクトのページで確認してください。
よくある質問
Half-LifeにAI NPCを追加できますか?
はい。Half-LifeのMODは、ValveのHalf-Life SDKからビルドされたC++のゲームDLLなので、MODはプレイヤーの言葉をWeb APIに送り、その答えを再生できます。Neocortexは、AIキャラクター、その音声、返される行動を提供し、MODがそれをゲーム内で実行します。
2026年にHalf-LifeのMODを作るには何が必要ですか?
GitHubのValveのhalflife SDK、C++コンパイラー、そしてSteam版のHalf-Lifeです。より多くのプラットフォーム向けにビルドするため、Xash3D FWGSとhlsdk-portableのフォークを使う人も多くいます。AI NPCの会話を追加するには、Neocortexのアカウントを作成し、ブラウザでキャラクターをデザインしてください。
Half-LifeのMODで音声コマンドを使えますか?
はい。MODはマイクを聞き、話されたフレーズを、警備員についてこさせるなどのゲームのコードに対応させられます。Neocortex Voice Commandsが、プレイヤーのPC上で聞き取りと照合を行うため、コマンドはオフラインでも動き、すぐに反応します。
AI NPCのあるHalf-LifeのMODを販売できますか?
いいえ。ValveのHalf-Life SDKのライセンスでは、MODの配布は無料の場合に限られ、商用利用はValveに問い合わせるよう求められます。無料で配布するMODについては、Neocortex側をブラウザエディターで作ってテストできます。
AI NPC MODはXash3D FWGSで動きますか?
動きます。Xash3D FWGSは、Half-Lifeと互換性のあるオープンソースのエンジンで、hlsdk-portableはGoldSrcとXash3Dの両方のゲームコードをビルドします。Neocortexは単純なWeb APIなので、同じMODのコードをどちらのエンジンからでも呼び出せます。






