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

Garry's Mod の AI NPC アドオンは、プレイヤーの発言を、ゲームに組み込まれた HTTP() 関数を通じて AI キャラクターに送り、返答に応じて動く Lua アドオンです。Garry's Mod のサーバーは、プレイヤーが作り出すものによって成り立っています。そのため、ただ立っているだけの NPC は、もったいない機会です。
Neocortex を使うと、サンドボックスとロールプレイのサーバーでも、実際に話すキャラクターを置けます。値切り交渉をする店主、サーバー全体のゲームを進行するクイズ番組の司会、音声コマンドに従う助手などです。Neocortex は AI キャラクター、Conversation Flows、クイズエンジン、デバイス上の音声コマンドを提供します。Lua がそれらをサーバーに接続します。
スクリーンショット: 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 プラン) は、ステージ、ブザー、スコアボードを、サーバーのイベントに変えます。
- Neocortex のダッシュボードで問題のセットを作ります。サーバーのトリビアナイト、新しいロールプレイヤー向けの世界観クイズ、新しいプレイヤーが仕事に就く前に合格すべきルールチェックなどです。
- ステージ上のホスト NPC がラウンドを開始します。
- プレイヤーはチャットで回答し、アドオンが各回答を
/v3/quizを通してクイズエンジンに送ります。 - ホストが正解者を発表し、クイズエンジンがスコアとリーダーボードを処理します。
- ラウンドの合間に、アドオンが HUD パネルに順位を表示します。
スクリーンショット: 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
})
endAI NPCのハウスルール
Garry's Mod のサーバーは、独自のルールを設けています。そのため、AI NPC アドオンは自分が所有するサーバー、または管理者の同意があるサーバーでのみ実行し、AI と話していることをプレイヤーに伝えてください。公開するときは Steam Workshop のルールに従い、各サーバーの管理者が自分の Neocortex API キーを使うようにしてください。プレイヤーごとのクールダウンを追加し、1 人のプレイヤーが NPC を連投できないようにしてください。
サーバー管理者への最後のまとめ
空のフォルダから話す NPC までは、5 つの手順で進みます。
- アドオンのフォルダを作る。 サーバー側の Lua ファイルと、スポーン可能な NPC エンティティを入れます。
- Neocortex のダッシュボードでキャラクターを設計する。 店主、問題セットを持つクイズの司会、助手のコマンドセットを作ります。
HTTP()でサーバーから/v3/chatと/v3/quizを呼び出し、netライブラリでプレイヤーに返答を送ります。- API キーはサーバー側の設定ファイルに保存し、 クライアントの Lua や Workshop のアップロードには決して入れません。
- 公開サーバーで動かす前に、 友人とローカルのリッスンサーバーでテストします。
まずは店主から始めてください。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 のアップロードに入れてはいけません。それらのファイルは、すべてのプレイヤーがダウンロードするためです。






