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

У Half-Life 2 есть ИИ отряда, который слушает нажатия клавиш, и мир, полный людей, которые говорят только то, что разрешает сценарий. Повстанцы идут за вами, но вы не можете им ничего сказать; горожане разговаривают, но никогда не говорят о том, что только что произошло. Мод Half-Life 2 с ИИ-NPC исправляет оба недостатка: повстанцы реагируют на ваши приказы вслух, напарник рассказывает о бое, который вы только что пережили, а сюжетные сцены меняются в зависимости от выбора игрока. Neocortex добавляет ИИ-персонажей, потоки диалога, викторины и голосовые команды на устройстве, а Source SDK 2013 даёт код, чтобы всё это подключить.
Скриншот: 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 © 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.
От пустой карты до говорящего отряда
- Настройте Source SDK 2013. Для сюжетного мода выберите ветку
singleplayerили Mapbase, соберите её и запустите пустую тестовую карту. - Создайте персонажей в панели Neocortex: напарника, лидера ячейки с потоком диалога, викторину для терминала и набор команд для отряда.
- Вызывайте API из DLL игры в рабочем потоке и используйте
sessionIdиз каждого ответа повторно. - Храните API-ключ в конфигурационном файле, который заполняет игрок, и никогда не прописывайте его в коде мода, который вы распространяете.
- Подключите субтитры, голос и действия, затем сопоставьте голосовые команды с существующим кодом отряда.
- Тестируйте в одиночной игре на одной карте, прежде чем масштабировать до полной кампании.
Как работают голосовые команды в моде, читайте в статье голосовые команды на устройстве для модов игр. Для 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 бесплатного мода можно создать и протестировать в браузерном редакторе.






