Neocortex Logo

Аддон AI NPC для Garry's Mod: умные NPC и ведущий викторины

Создайте аддон AI NPC для Garry's Mod на Lua: умные NPC для песочниц и ролевых серверов, ведущего многопользовательской викторины с таблицей лидеров и голосовые команды.

Neocortex TeamThe team behind Neocortex

· 6 мин чтения

Создайте аддон AI NPC для Garry's Mod на Lua: умные NPC для песочниц и ролевых серверов, ведущего многопользовательской викторины с таблицей лидеров и голосовые команды.

Аддон AI NPC для Garry's Mod - это аддон на Lua, который отправляет то, что говорят игроки, AI-персонажу через встроенную в игру функцию HTTP() и выполняет действия по ответу. Серверы Garry's Mod держатся на том, что придумывают игроки, и NPC, которые просто стоят на месте, - упущенная возможность. С Neocortex песочницы и ролевые серверы получают персонажей, которые действительно разговаривают: торговца, который торгуется, ведущего викторины, который проводит игру для всего сервера, и помощников, которые слушаются голосовых команд. Neocortex добавляет AI-персонажей, Conversation Flow, движок викторин и голосовые команды на устройстве; Lua связывает их с вашим сервером.

Скриншот из игры Garry's Mod Скриншот: Garry's Mod © Valve

Что работает на сервере, а что на клиенте

Аддоны Garry's Mod - это папки с Lua-скриптами и контентом, которые устанавливаются в garrysmod/addons или подписываются через Steam Workshop. Lua работает в двух областях, и аддон AI NPC четко делится между ними. Вики Garry's Mod документирует каждую функцию.

ЗадачаОбластьИнструмент
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, с которыми игроки могут говорить

На ролевом сервере дайте городу труппу: торговца, который торгуется и помнит, кто его обманул, бармена, который знает лор сервера, диспетчера полиции, который реагирует на сообщения игроков. Каждый персонаж получает Personality, настройку Emotion и базу знаний в редакторе Neocortex, например правила вашего сервера, локации карты и вашу экономику.

Игроки нажимают использование на NPC и пишут в чат. Ваш аддон отправляет сообщение вместе с ближайшими объектами (прилавок магазина, торговый автомат, дверь тюрьмы) и недавними событиями («игрока арестовали», «звонит сигнализация банка»). Персонаж отвечает с тегом эмоции в каждой строке и действиями вроде { "name": "OPEN_DOOR", "targetId": "jail_door" }, которые аддон выполняет на сервере.

Групповой чат (тарифы Pro и Team) собирает до шести персонажей в одном разговоре, так что банда NPC может спорить с игроком сразу. Conversation Flow может вести длинную сцену, например брифинг ограбления в ролевой игре, и возвращать ключевые слова контрольных точек (flowState), на которые реагирует аддон.

Проводим викторину

Движок викторин (тариф Team) превращает сцену, кнопки и табло в серверное событие:

  1. Вы составляете набор вопросов в панели управления Neocortex: вечер викторин для сервера, викторина по лору для новых ролевиков или проверка знания правил, которую новые игроки должны пройти, чтобы получить работу.
  2. NPC-ведущий на сцене открывает раунд.
  3. Игроки отвечают в чате, а аддон направляет каждый ответ в движок викторин через /v3/quiz.
  4. Ведущий объявляет, кто прав, а движок викторин занимается подсчетом очков и таблицей лидеров.
  5. Между раундами ваш аддон выводит положение игроков на HUD-панели.

Скриншот из игры Garry's Mod Скриншот: Garry's Mod © Valve

Помощники, которые слушаются голосовых команд

Дайте каждому игроку NPC-помощника, который слушает: «следуй за мной», «жди здесь», «охраняй дверь», «принеси два ящика». В панели управления Neocortex вы описываете набор команд как акторов, действия и объекты: актор «helper», действия «follow», «wait», «guard» и «bring», объекты «me», «door» и «crate».

Игроки говорят естественно, а аддон мгновенно получает распознанные команды, включая несколько действий и количеств в одном предложении. Работает с push-to-talk или постоянным прослушиванием, на нескольких языках, без облачного обращения. Поскольку работает на компьютере игрока, клиентская часть отправляет распознанные команды на сервер.

Voice Commands - лицензируемый SDK: свяжитесь с нами, чтобы получить лицензию Voice Commands.

Код аддона AI NPC для Garry's Mod

Все, что касается API, работает на стороне сервера. Сервер читает состояние игры и отправляет его вместе с сообщением игрока персонажу Neocortex через /v3/chat, затем показывает ответ в виде субтитров, воспроизводит голос из /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 только на серверах, которыми вы владеете, или там, где владелец согласен, и сообщайте игрокам, что они говорят с ИИ. Соблюдайте правила Steam Workshop при публикации и следите, чтобы каждый владелец сервера использовал свой API-ключ Neocortex. Добавьте кулдаун на игрока, чтобы один игрок не забрасывал NPC сообщениями.

Итоги для владельцев серверов

Пять шагов переводят вас от пустой папки к говорящему NPC:

  1. Создайте папку аддона с серверным Lua-файлом и сущностью NPC, которую можно создать.
  2. Спроектируйте персонажей в панели управления Neocortex: торговца, ведущего викторины с набором вопросов и набор команд для помощников.
  3. Вызывайте /v3/chat и /v3/quiz с сервера через HTTP() и отправляйте ответы игрокам с помощью библиотеки net.
  4. Храните API-ключ в серверном файле конфигурации, никогда в клиентском Lua или в загрузке Workshop.
  5. Тестируйте на локальном listen-сервере с другом, прежде чем запускать на публичном сервере.

Начните с торговца. Одного персонажа, одного вызова HTTP() и хука чата достаточно, чтобы показать игрокам, что умеет NPC Neocortex, а викторина строится на том же серверном коде. Чтобы понять, как работают голосовые команды на компьютере игрока, прочитайте голосовые команды на устройстве для игровых модов. Для модов на уровне движка Source см. наше руководство по AI NPC мода для Half-Life 2.

Версии инструментов и ссылки проверены в октябре 2026 года. Инструменты для модов меняются часто; проверяйте актуальный релиз на странице каждого проекта.

Часто задаваемые вопросы

Можно ли добавить AI NPC в Garry's Mod?

Да. Аддоны Garry's Mod пишутся на Lua, а в игре есть встроенная функция HTTP(), поэтому серверный аддон может отправлять то, что говорят игроки, AI-персонажу и выполнять действия по ответу. Neocortex предоставляет персонажа, его голос и действия, которые он возвращает.

Может ли аддон Garry's Mod обращаться к веб-API?

Да. Глобальная функция HTTP() и помощники http.Fetch и http.Post делают асинхронные запросы с сервера или клиента. Для аддона AI NPC делайте вызовы на сервере, чтобы ваш API-ключ Neocortex никогда не попадал к игрокам.

Как провести викторину на сервере Garry's Mod?

Поставьте NPC-ведущего, направьте ответы игроков из чата в движок викторин и выводите очки на HUD-панели. Движок викторин Neocortex ведет вопросы, подсчет очков и таблицу лидеров, поэтому ваш аддон отвечает только за сцену и чат.

Могут ли NPC в Garry's Mod слушаться голосовых команд?

Да, с клиентским компонентом. Neocortex Voice Commands работает на ПК каждого игрока и превращает фразы вроде «следуй за мной» или «охраняй дверь» в команды, которые ваш аддон получает мгновенно, без интернета. Поскольку работает на компьютере игрока, игроки устанавливают голосовую часть вместе с аддоном из Workshop.

Где хранить API-ключ на сервере Garry's Mod?

Только на сервере, например в файле в папке данных сервера, который ваш аддон читает при запуске. Никогда не кладите ключ в клиентский Lua или в загрузку Workshop, потому что каждый игрок скачивает эти файлы.

Похожие статьи

Читайте также