Neocortex Logo

Garry's Mod AI NPCアドオン: スマートNPCとクイズ司会

Lua で Garry's Mod の AI NPC アドオンを作ります。サンドボックスとロールプレイのサーバー向けのスマート NPC、リーダーボード付きのマルチプレイヤークイズ司会、音声コマンドを解説します。

Neocortex TeamThe team behind Neocortex

· 6分で読めます

Lua で Garry's Mod の AI NPC アドオンを作ります。サンドボックスとロールプレイのサーバー向けのスマート NPC、リーダーボード付きのマルチプレイヤークイズ司会、音声コマンドを解説します。

Garry's Mod の AI NPC アドオンは、プレイヤーの発言を、ゲームに組み込まれた HTTP() 関数を通じて AI キャラクターに送り、返答に応じて動く Lua アドオンです。Garry's Mod のサーバーは、プレイヤーが作り出すものによって成り立っています。そのため、ただ立っているだけの NPC は、もったいない機会です。 Neocortex を使うと、サンドボックスとロールプレイのサーバーでも、実際に話すキャラクターを置けます。値切り交渉をする店主、サーバー全体のゲームを進行するクイズ番組の司会、音声コマンドに従う助手などです。Neocortex は AI キャラクター、Conversation Flows、クイズエンジン、デバイス上の音声コマンドを提供します。Lua がそれらをサーバーに接続します。

Garry's Mod のゲーム内スクリーンショット スクリーンショット: Garry's Mod © Valve

サーバーで動く部分とクライアントで動く部分

Garry's Mod のアドオンは、Lua スクリプトとコンテンツのフォルダで、garrysmod/addons にインストールするか、Steam Workshop から購読して使います。Lua は 2 つのレルムで動き、AI NPC アドオンはその 2 つにきれいに分かれます。すべての関数は Garry's Mod の wiki に文書化されています。

役割レルムツール
NPC、エンティティ、ゲームロジックサーバーLua エンティティ
Neocortex の呼び出し、API キーの保持サーバーHTTP()、http.Fetch、http.Post
プレイヤーへの返答の送信サーバーからクライアントnet ライブラリ
字幕と HUDクライアントchat.AddText またはカスタムの HUD パネル
音声の再生クライアントsound.PlayURL
音声コマンドクライアントプレイヤーのマシン上の Neocortex Voice Commands

いくつかの詳細が重要です。HTTP() は、URL、メソッド、ヘッダー、本文、コールバックを指定して非同期リクエストを開始します。http.Fetch と http.Post は、単純な場合のためにそれをラップしたものです。成功のコールバックは、エラーのステータスコードでも呼ばれるため、必ずコードを確認してください。sound.PlayURL は外部のサウンドファイルを再生するため、生成された音声は、自分で管理する小さなエンドポイントから配信します。そうすればクライアントは、API キーを見ることなく音声をストリーミングできます。ネイティブモジュール (サーバー用の gmsv_、クライアント用の gmcl_) は garrysmod/lua/bin に置き、require で読み込みます。ただし、Workshop のアドオンではインストールできないため、ネイティブなものはプレイヤーやサーバーの管理者が別途インストールする必要があります。

プレイヤーが話しかけられるロールプレイのNPC

ロールプレイのサーバーでは、街に登場人物を配置します。値切り交渉をする店主は、誰が支払いを踏み倒したかを覚えています。バーテンダーはサーバーの世界観を知っています。警察の通信係は、プレイヤーが報告した内容に反応します。各キャラクターには、Neocortex エディタで Personality、Emotion の設定、Knowledge ベースを設定します。Knowledge には、サーバーのルール、マップの場所、経済の仕組みなどを入れます。

プレイヤーは NPC に対して使用キーを押し、チャットで入力します。アドオンは、そのメッセージを、近くのオブジェクト (店のカウンター、自動販売機、牢屋の扉) や最近の出来事 (「プレイヤーが逮捕された」「銀行の警報が鳴っている」) と一緒に送ります。キャラクターは、各セリフに感情タグを付けて返答し、{ "name": "OPEN_DOOR", "targetId": "jail_door" } のようなアクションも返します。アドオンはそれをサーバー上で実行します。

グループチャット (Pro と Team のプラン) を使うと、最大 6 体のキャラクターを 1 つの会話に入れられます。そのため、NPC のギャングがプレイヤーとまとめて言い争うことができます。Conversation Flow は、ロールプレイの強盗作戦の説明のような長い場面を導き、チェックポイントのキーワード (flowState) を返します。アドオンはそれに反応します。

クイズナイトの開催

クイズエンジン (Team プラン) は、ステージ、ブザー、スコアボードを、サーバーのイベントに変えます。

  1. Neocortex のダッシュボードで問題のセットを作ります。サーバーのトリビアナイト、新しいロールプレイヤー向けの世界観クイズ、新しいプレイヤーが仕事に就く前に合格すべきルールチェックなどです。
  2. ステージ上のホスト NPC がラウンドを開始します。
  3. プレイヤーはチャットで回答し、アドオンが各回答を /v3/quiz を通してクイズエンジンに送ります。
  4. ホストが正解者を発表し、クイズエンジンがスコアとリーダーボードを処理します。
  5. ラウンドの合間に、アドオンが HUD パネルに順位を表示します。

Garry's Mod のゲーム内スクリーンショット スクリーンショット: Garry's Mod © Valve

音声コマンドに従う助手

各プレイヤーに、話を聞いてくれる助手 NPC を付けます。「ついてきて」「ここで待って」「扉を守って」「箱を 2 つ持ってきて」などに反応します。Neocortex のダッシュボードでは、コマンドのセットをアクター、アクション、オブジェクトとして設計します。アクターは「helper」、アクションは「follow」「wait」「guard」「bring」、オブジェクトは「me」「door」「crate」です。

プレイヤーは自然に話し、アドオンは一致したコマンドをすぐに受け取ります。1 つの文に複数のアクションや数量が含まれていても対応します。プッシュトゥトークと常時待機の両方に対応し、複数の言語で動き、クラウドとの往復もありません。プレイヤーのマシン上で動くため、クライアント側が一致したコマンドをサーバーに送ります。

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

Garry's Mod AI NPCアドオンのコード

API に触れる処理はすべてサーバー側で実行されます。サーバーはゲームの状態を読み取り、それをプレイヤーのメッセージと一緒に /v3/chat を通して Neocortex のキャラクターに送ります。返答は字幕として表示し、音声は /v3/audio/generate または /v3/audio/stream から再生し、キャラクターが返したアクションを実行します。

-- Server realm only: the key stays in garrysmod/data and never reaches players.
local apiKey = string.Trim(file.Read("neocortex_key.txt", "DATA") or "")
local function AskNPC(ply, text, sessionId, onReply)
    HTTP({
        url = "https://api.neocortex.link/v3/chat",
        method = "POST", type = "application/json",
        headers = { ["x-api-key"] = apiKey },
        body = util.TableToJSON({
            characterIds = { "CHARACTER_ID" },
            message = text,
            playerId = ply:SteamID64(),
            sessionId = sessionId or ""
        }),
        success = function(code, body)
            local data = util.JSONToTable(body)
            if code == 200 and data then onReply(data) end -- data.sessionId, data.messages
        end,
        failed = function(reason) print("[Neocortex] " .. reason) end
    })
end

AI NPCのハウスルール

Garry's Mod のサーバーは、独自のルールを設けています。そのため、AI NPC アドオンは自分が所有するサーバー、または管理者の同意があるサーバーでのみ実行し、AI と話していることをプレイヤーに伝えてください。公開するときは Steam Workshop のルールに従い、各サーバーの管理者が自分の Neocortex API キーを使うようにしてください。プレイヤーごとのクールダウンを追加し、1 人のプレイヤーが NPC を連投できないようにしてください。

サーバー管理者への最後のまとめ

空のフォルダから話す NPC までは、5 つの手順で進みます。

  1. アドオンのフォルダを作る。 サーバー側の Lua ファイルと、スポーン可能な NPC エンティティを入れます。
  2. Neocortex のダッシュボードでキャラクターを設計する。 店主、問題セットを持つクイズの司会、助手のコマンドセットを作ります。
  3. HTTP() でサーバーから /v3/chat と /v3/quiz を呼び出し、 net ライブラリでプレイヤーに返答を送ります。
  4. API キーはサーバー側の設定ファイルに保存し、 クライアントの Lua や Workshop のアップロードには決して入れません。
  5. 公開サーバーで動かす前に、 友人とローカルのリッスンサーバーでテストします。

まずは店主から始めてください。1 体のキャラクター、1 回の HTTP() 呼び出し、チャットのフックがあれば、Neocortex の NPC にできることをプレイヤーに示せます。クイズ番組も同じサーバーのコードを土台にしています。プレイヤーのマシンで音声コマンドがどう動くかは、ゲームモッド向けのデバイス上の音声コマンドで確認できます。エンジンレベルの Source モッドについては、Half-Life 2 の AI NPC モッドのガイドをご覧ください。

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

よくある質問

Garry's Mod に AI NPC を追加できますか?

はい。Garry's Mod のアドオンは Lua で書かれており、ゲームには組み込みの HTTP() 関数があります。そのため、サーバー側のアドオンでプレイヤーの発言を AI キャラクターに送り、返答に応じて動けます。Neocortex はキャラクター、その音声、返されるアクションを提供します。

Garry's Mod のアドオンから Web API を呼び出せますか?

はい。グローバルな HTTP() 関数と、http.Fetch、http.Post のヘルパーで、サーバーまたはクライアントから非同期のリクエストを送れます。AI NPC アドオンでは、Neocortex の API キーがプレイヤーに届かないよう、呼び出しはサーバーで行ってください。

Garry's Mod のサーバーでクイズ番組を開くには?

ホストの NPC をスポーンさせ、プレイヤーのチャットの回答をクイズエンジンに渡し、スコアを HUD パネルに表示します。Neocortex のクイズエンジンが問題、採点、リーダーボードを処理するため、アドオンが扱うのはステージとチャットだけです。

Garry's Mod の NPC は音声コマンドに従えますか?

はい。クライアント側のコンポーネントを使います。Neocortex Voice Commands は各プレイヤーの PC で動き、「"follow me"」や「"guard the door"」のような言葉を、アドオンがすぐに受け取れるコマンドに変換します。オフラインでも動作します。プレイヤーのマシンで動くため、プレイヤーは Workshop のアドオンと一緒に音声の部分もインストールします。

Garry's Mod のサーバーで API キーはどこに保存すればよいですか?

サーバー側だけに保存してください。たとえば、アドオンが起動時に読み込む、サーバーのデータフォルダ内のファイルです。キーをクライアント側の Lua や Workshop のアップロードに入れてはいけません。それらのファイルは、すべてのプレイヤーがダウンロードするためです。

関連記事

こちらもおすすめ