Neocortex Logo

Мод Half-Life 2 с ИИ-NPC: отряд и напарники по голосу

Планируем мод Half-Life 2 с ИИ-NPC на Source SDK 2013: отряд повстанцев, которым вы отдаёте приказы голосом, напарник, который отвечает, сюжетные сцены убежища и терминал с викториной.

Neocortex TeamThe team behind Neocortex

· 6 мин чтения

Планируем мод Half-Life 2 с ИИ-NPC на Source SDK 2013: отряд повстанцев, которым вы отдаёте приказы голосом, напарник, который отвечает, сюжетные сцены убежища и терминал с викториной.

У Half-Life 2 есть ИИ отряда, который слушает нажатия клавиш, и мир, полный людей, которые говорят только то, что разрешает сценарий. Повстанцы идут за вами, но вы не можете им ничего сказать; горожане разговаривают, но никогда не говорят о том, что только что произошло. Мод Half-Life 2 с ИИ-NPC исправляет оба недостатка: повстанцы реагируют на ваши приказы вслух, напарник рассказывает о бое, который вы только что пережили, а сюжетные сцены меняются в зависимости от выбора игрока. Neocortex добавляет ИИ-персонажей, потоки диалога, викторины и голосовые команды на устройстве, а Source SDK 2013 даёт код, чтобы всё это подключить.

Скриншот игры Half-Life 2 Скриншот: Half-Life 2 © Valve

Голосовые приказы для отряда повстанцев

Half-Life 2 уже позволяет отправить отряд в точку и вернуть его обратно. Голосовые команды заменяют нажатие клавиши речью: "move up" (вперёд), "hold here" (стоять здесь), "take cover behind the car" (укрыться за машиной), "regroup on me" (собраться возле меня).

В панели управления Neocortex вы описываете набор команд как исполнителей, действия и объекты: исполнитель "squad", действия "move", "hold" и "cover", объекты вроде "me", "car" и "door". Игроки говорят естественно, а мод мгновенно получает совпавшие команды, включая несколько действий и количеств в одном предложении: "two of you watch the door, the rest follow me". Ваш код сопоставляет их с существующим кодом отряда.

Работает с нажатием для разговора или постоянным прослушиванием, на нескольких языках, и выполняется на компьютере игрока, поэтому приказы доходят прямо посреди перестрелки, без поездки в облако.

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

Пример: Мара Венн и убежище

Напарник. Создайте оригинального напарника, например Мару Венн, бывшего полевого медика, которая присоединилась к сопротивлению после закрытия своей клиники. Ваш мод отправляет вопрос игрока вместе с тем, что знает игра: ближайшие объекты (баррикада, ящик с патронами, радио) и недавние события ("два бойца отряда выбыли", "игрок пошёл по левому тоннелю", "здоровье ниже 30"). Мара отвечает голосом, с тегом эмоции в каждой реплике, и может вернуть действия, например передать аптечку или открыть ворота, о которых спросил игрок.

Отряд спорит. Групповой чат (тарифы Pro и Team) позволяет до шести персонажам делить один разговор, поэтому весь отряд может спорить о следующем шаге.

Подвал. Мара ведёт игрока в подвальное убежище, где ему нужно заслужить доверие настороженного лидера ячейки, прежде чем тот расскажет маршрут из города. Поток диалога задаёт этапы: знакомство, доказательство того, на чьей вы стороне, сделка, маршрут. Персонаж направляет разговор через эти этапы, как бы игрок ни формулировал, а API возвращает ключевые слова контрольных точек, например TRUST_EARNED или ROUTE_SHARED. Ваш мод реагирует, открывая скрытую дверь или создавая проводника, который выведет игрока наружу.

Терминал. В углу терминал тренирует новобранцев: каких вражеских юнитов избегать, как подавать сигналы отряду, какие припасы брать с собой. Движок викторин Neocortex (тариф Team) ведёт вопросы и подсчёт очков, а верная серия может наградить игрока патронами или коротким путём.

Скриншот игры Half-Life 2 Скриншот: Half-Life 2 © Valve

Ветки Source SDK 2013 для мода Half-Life 2 с ИИ-NPC

Half-Life 2 работает на движке Source. Мод - это папка со своим gameinfo.txt, контентом и двумя библиотеками C++, собранными из кода Valve: серверная DLL для ИИ NPC, отрядов и игровой логики, и клиентская DLL для HUD, панелей VGUI и локальных эффектов. Сначала выберите базу:

БазаЧто содержитСостояние
Source SDK 2013 ветка singleplayerКод одиночной игры Half-Life 2Без обновлений кода с 2015 года; работает на 32-битной Source SDK Base 2013 Singleplayer
Source SDK 2013, ветка masterКод многопользовательской игрыОбновлена в феврале 2025 года кодом игры Team Fortress 2 и 64-битными сборками; Valve продолжает вносить в неё изменения
MapbaseБаза от сообщества для модов одиночной игрыВерсия 8.0 вышла в июле 2025 года, добавив новые сущности, исправления и реализацию VScript для скриптов карт

Для сюжетного мода вроде описанного выше убежища начинайте с ветки singleplayer или с Mapbase.

Вызов Neocortex из DLL Source

Заголовки SDK включают интерфейс HTTP от Steamworks, но многие моддеры подключают вместо него libcurl. В любом случае выполняйте запросы в рабочем потоке и передавайте результаты обратно в игровой цикл. Вызов чата из клиентской или серверной DLL с использованием libcurl:

// bodyJson: {"characterIds":["CHARACTER_ID"],"message":"Where now?","playerId":"player-1",
//            "sessionId":"","events":[{"priority":1,"content":"Two squad members down"}]}
std::string AskCompanion(const std::string& apiKey, const std::string& bodyJson)
{
    std::string response;
    CURL* curl = curl_easy_init();
    curl_slist* headers = curl_slist_append(nullptr, "Content-Type: application/json");
    headers = curl_slist_append(headers, ("x-api-key: " + apiKey).c_str());
    curl_easy_setopt(curl, CURLOPT_URL, "https://api.neocortex.link/v3/chat");
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, bodyJson.c_str());
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, AppendToString); // appends bytes to response
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
    curl_easy_perform(curl);
    curl_slist_free_all(headers);
    curl_easy_cleanup(curl);
    return response; // sessionId, lines with emotions, actions and flowState
}

Мод читает состояние игры и отправляет его вместе с сообщением игрока ИИ-персонажу Neocortex через /v3/chat, показывает ответ как субтитры, проигрывает голос из /v3/audio/generate или /v3/audio/stream и выполняет действия, которые вернул персонаж. Потоки диалога возвращают ключевые слова контрольных точек (flowState) в том же ответе, движок викторин работает через /v3/quiz, а голосовые команды на устройстве превращают произнесённые фразы в игровые действия без поездки в облако: Neocortex Voice Commands работает на компьютере игрока.

Для интерфейса панели VGUI в клиентской DLL могут показывать субтитры и экран викторины. Закрытые субтитры и soundscripts Source созданы для заранее записанных реплик, поэтому живые ответы ИИ обычно получают собственную панель субтитров, а сгенерированный звук сохраняется в файл и проигрывается через движок.

Перед выпуском: лицензия Source 1 SDK

Лицензия Source 1 SDK позволяет распространять моды только бесплатно; бесплатные моды можно публиковать в Steam. Держите моды с ИИ-NPC однопользовательскими, никогда не используйте их на многопользовательских серверах против правил и пусть каждый игрок использует собственный API-ключ Neocortex.

От пустой карты до говорящего отряда

  1. Настройте Source SDK 2013. Для сюжетного мода выберите ветку singleplayer или Mapbase, соберите её и запустите пустую тестовую карту.
  2. Создайте персонажей в панели Neocortex: напарника, лидера ячейки с потоком диалога, викторину для терминала и набор команд для отряда.
  3. Вызывайте API из DLL игры в рабочем потоке и используйте sessionId из каждого ответа повторно.
  4. Храните API-ключ в конфигурационном файле, который заполняет игрок, и никогда не прописывайте его в коде мода, который вы распространяете.
  5. Подключите субтитры, голос и действия, затем сопоставьте голосовые команды с существующим кодом отряда.
  6. Тестируйте в одиночной игре на одной карте, прежде чем масштабировать до полной кампании.

Как работают голосовые команды в моде, читайте в статье голосовые команды на устройстве для модов игр. Для GoldSrc смотрите наше руководство ИИ-NPC мод для Half-Life, а для песочниц на Source - статью ИИ-NPC и дополнение с викториной для Garry's Mod. Мару и её отряд можно протестировать уже сегодня в браузерном редакторе Neocortex, задолго до того, как скомпилируется первая карта.

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

Частые вопросы

Можно ли добавить ИИ-NPC в Half-Life 2?

Да. Моды Half-Life 2 создаются на Source SDK 2013 от Valve, который даёт полный код игры на C++, поэтому мод может вызывать веб-API и действовать по ответу. Neocortex предоставляет ИИ-персонажа, его голос и действия, которые он возвращает, а ваш мод их выполняет.

Использовать ветку singleplayer или multiplayer у Source SDK 2013?

Сюжетные моды обычно начинают с ветки singleplayer или с базы от сообщества, построенной на ней, например Mapbase. Ветка multiplayer получила большое обновление с поддержкой 64-битных сборок в 2025 году и продолжает поддерживаться, но её код рассчитан на многопользовательские игры. Neocortex работает с любой из них, потому что это обычный веб-API.

Можно ли отдавать приказы повстанцам Half-Life 2 голосом?

Да, с помощью мода. В Half-Life 2 уже есть код команд отряда, и мод может запускать его речью. Neocortex Voice Commands распознаёт естественные фразы на компьютере игрока, поэтому "move up", "hold here" и "regroup" доходят до вашего кода мгновенно и офлайн.

Можно ли продавать мод Half-Life 2 с ИИ-персонажами?

Нет. Лицензия Source 1 SDK позволяет распространять моды только бесплатно, хотя бесплатные моды можно публиковать в Steam. Сторону Neocortex бесплатного мода можно создать и протестировать в браузерном редакторе.

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

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