Neocortex Logo

Half-Life AI NPC MOD: 話す科学者と音声コマンド

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

Neocortex TeamThe team behind Neocortex

· 7分で読めます

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

ブラックメサの科学者に本当の質問ができたら、何を話してくれるでしょうか。ベースゲームでは、新しいことは何もありません。科学者も警備員も、録音された台詞をいくつか持っているだけです。 Half-Life AI NPC MODは、それを変えます。ゲームのDLLがプレイヤーの発言をAIキャラクターに送り、返答を音声と字幕で再生します。Neocortexを使えば、スクリプトされた見せ場のための会話フロー、クイズエンジン、警備員のためのオンデバイスの音声コマンドも使えます。

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

ValveのSDKとXash3D FWGS

現在、2つのコードベースが使われており、Half-Life AI NPC MODはどちらでも動きます。

ValveのHalf-Life SDKhlsdk-portable付きのXash3D FWGS
内容クライアントとサーバーのライブラリの公式ソースHalf-Lifeと互換性のあるオープンソースのエンジンと、FWGSのクロスプラットフォーム版SDK
動作環境GoldSrcWindows、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 ゲーム内のスクリーンショット スクリーンショット: 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キーを使ってもらってください。

最初のマップを段階的に作る

  1. SDKをセットアップする。 Valveのhalflife SDKまたはhlsdk-portableをクローンし、空のテストMODのためにクライアントとサーバーのDLLをビルドします。
  2. Neocortexのダッシュボードでキャラクターをデザインする。 科学者、警備員、クイズを持つ安全担当官、警備員のためのコマンドのセットを作ります。
  3. HTTPクライアントをゲームのDLLに追加する。 ワーカースレッドで/v3/chatを呼び出し、各返答のsessionIdを再利用します。
  4. APIキーは設定ファイルに置く。 プレイヤーが記入するファイルにし、共有するMODにハードコーディングしないでください。
  5. 字幕、音声、行動をつなぐ。 そのあと、警備員のための音声コマンドを追加します。
  6. シングルプレイヤーで、小さな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のコードをどちらのエンジンからでも呼び出せます。

関連記事

こちらもおすすめ