Neocortex Logo

Mod Half-Life 2 z AI NPC: squad i towarzysze sterowani głosem

Zaplanuj mod Half-Life 2 z AI NPC na Source SDK 2013: oddział rebeliantów, którym wydajesz głosowe rozkazy, towarzysz, który odpowiada, momenty fabularne w kryjówce i terminal z quizem.

Neocortex TeamThe team behind Neocortex

· 6 min czytania

Zaplanuj mod Half-Life 2 z AI NPC na Source SDK 2013: oddział rebeliantów, którym wydajesz głosowe rozkazy, towarzysz, który odpowiada, momenty fabularne w kryjówce i terminal z quizem.

Half-Life 2 ma AI oddziału, które reaguje na naciśnięcia klawiszy, i świat pełen ludzi, którzy mówią tylko to, na co pozwala skrypt. Rebelianci idą za Tobą, ale nie możesz im nic powiedzieć; mieszkańcy rozmawiają, ale nigdy o tym, co właśnie się wydarzyło. Mod Half-Life 2 z AI NPC naprawia oba problemy: rebelianci reagują na Twoje rozkazy wypowiadane na głos, towarzysz mówi o walce, którą właśnie przeżyłeś, a sceny fabularne zmieniają się w zależności od wyborów gracza. Neocortex dodaje postacie AI, Conversation Flows, quizy i głosowe polecenia na urządzeniu, a Source SDK 2013 daje kod, który to wszystko łączy.

Zrzut ekranu z gry Half-Life 2 Zrzut ekranu: Half-Life 2 © Valve

Głosowe rozkazy dla oddziału rebeliantów

Half-Life 2 już pozwala wysłać oddział w wyznaczone miejsce i ściągnąć go z powrotem. Polecenia głosowe zastępują naciśnięcie klawisza mową: „move up”, „hold here”, „take cover behind the car”, „regroup on me”.

W panelu Neocortex projektujesz zestaw poleceń jako aktorów, działania i obiekty: aktor „squad”, działania „move”, „hold” i „cover”, obiekty takie jak „me”, „car” i „door”. Gracze mówią naturalnie, a mod natychmiast otrzymuje dopasowane polecenia, także wiele działań i liczb w jednym zdaniu: „two of you watch the door, the rest follow me”. Twój kod przypisuje je do istniejącego kodu oddziału.

Działa z trybem push-to-talk lub ciągłym nasłuchem, w wielu językach i działa na maszynie gracza, więc rozkazy docierają w środku walki bez opóźnienia na przejście do chmury.

Voice Commands to licencjonowany SDK: skontaktuj się z nami w sprawie licencji Voice Commands.

Przykład: Mara Venn i kryjówka

Towarzysz. Stwórz oryginalnego towarzysza, na przykład Marę Venn, byłą medyk polową, która dołączyła do ruchu oporu po zamknięciu swojej kliniki. Twój mod wysyła pytanie gracza razem z tym, co wie gra: pobliskie obiekty (barykada, skrzynia z amunicją, radio) i ostatnie zdarzenia („dwóch członków oddziału poległo”, „gracz wybrał lewy tunel”, „zdrowie poniżej 30”). Mara odpowiada głosem, z tagiem emocji w każdej linii, i może zwrócić działania, takie jak przekazanie apteczki albo otwarcie bramy, o którą prosił gracz.

Oddział się sprzecza. Czat grupowy (plany Pro i Team) pozwala do sześciu postaci dzielić jedną rozmowę, więc cały oddział może się kłócić o następny ruch.

Piwnica. Mara prowadzi gracza do piwnicznej kryjówki, gdzie musi zdobyć zaufanie ostrożnego dowódcy komórki, zanim ten zdradzi trasę wyjścia z miasta. Conversation Flow określa etapy: przedstawienie się, udowodnienie, po której jesteś stronie, układ, trasa. Postać prowadzi przez nie rozmowę, bez względu na to, jak gracz formułuje wypowiedzi, a API zwraca słowa kluczowe punktów kontrolnych, takie jak TRUST_EARNED czy ROUTE_SHARED. Mod reaguje, otwierając ukryte drzwi albo pojawiając się przewodnik, który wyprowadzi Cię na zewnątrz.

Terminal. W rogu terminal ćwiczy nowych rekrutów: których jednostek wroga unikać, jak sygnalizować oddziałowi, co zabrać ze sobą. Silnik quizów Neocortex (plan Team) prowadzi pytania i punktację, a serią poprawnych odpowiedzi można nagrodzić gracza amunicją albo skrótem.

Zrzut ekranu z gry Half-Life 2 Zrzut ekranu: Half-Life 2 © Valve

Gałęzie Source SDK 2013 dla modu Half-Life 2 z AI NPC

Half-Life 2 działa na silniku Source. Mod to folder z własnym gameinfo.txt, zawartością i dwiema bibliotekami C++ zbudowanymi z kodu Valve: DLL serwera dla AI NPC, oddziałów i logiki gry oraz DLL klienta dla HUD, paneli VGUI i lokalnych efektów. Najpierw wybierz bazę:

BazaCo zawieraStan
Gałąź Source SDK 2013 singleplayerKod gry Half-Life 2 dla jednego graczaBez aktualizacji kodu od 2015; działa na 32-bitowym Source SDK Base 2013 Singleplayer
Gałąź master Source SDK 2013Kod wieloosobowyZaktualizowana w lutym 2025 o kod gry Team Fortress 2 i kompilacje 64-bitowe; Valve nadal wprowadza tu zmiany
MapbaseBaza utrzymywana przez społeczność dla modów dla jednego graczaWersja 8.0 wydana w lipcu 2025, z nowymi encjami, poprawkami i implementacją VScript do skryptów map

Dla modu fabularnego, jak wspomniana kryjówka, zacznij od gałęzi singleplayer albo Mapbase.

Wywoływanie Neocortex z DLL Source

Nagłówki SDK zawierają interfejs HTTP Steamworks, a wielu moderów dodaje zamiast tego libcurl. Tak czy inaczej uruchamiaj żądania w osobnym wątku i przekazuj wyniki z powrotem do pętli gry. Wywołanie czatu z DLL klienta lub serwera, przy użyciu 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
}

Mod odczytuje stan gry i wysyła go razem z wiadomością gracza do postaci Neocortex przez /v3/chat, pokazuje odpowiedź jako napisy, odtwarza głos z /v3/audio/generate lub /v3/audio/stream i wykonuje działania zwrócone przez postać. Conversation Flows zwracają słowa kluczowe punktów kontrolnych (flowState) w tej samej odpowiedzi, silnik quizów działa przez /v3/quiz, a polecenia głosowe na urządzeniu zamieniają wypowiedziane frazy w działania gry bez opóźnienia na przejście do chmury, przy czym Neocortex Voice Commands działa na maszynie gracza.

Do interfejsu można użyć paneli VGUI w DLL klienta, które pokażą napisy i ekran quizu. Systemowe napisy zamknięte i soundscripts Source są stworzone dla wcześniej przygotowanych kwestii, więc żywe odpowiedzi AI zwykle dostają własny panel napisów, a wygenerowany dźwięk zapisuje się do pliku i odtwarza przez silnik.

Przed wydaniem: licencja Source 1 SDK

Licencja Source 1 SDK pozwala rozpowszechniać mody tylko za darmo; darmowe mody można publikować na Steam. Mody z AI NPC trzymaj w trybie dla jednego gracza, nigdy nie używaj ich na serwerach wieloosobowych wbrew ich zasadom i niech każdy gracz używa własnego klucza API Neocortex.

Od pustej mapy do mówiącego oddziału

  1. Skonfiguruj Source SDK 2013. Wybierz gałąź singleplayer albo Mapbase dla modu fabularnego, zbuduj ją i uruchom pustą mapę testową.
  2. Zaprojektuj postacie w panelu Neocortex: towarzysza, dowódcę komórki z Conversation Flow, quiz dla terminala i zestaw poleceń dla oddziału.
  3. Wywołuj API z DLL gry w osobnym wątku i używaj ponownie sessionId z każdej odpowiedzi.
  4. Trzymaj klucz API w pliku konfiguracyjnym, który wypełnia gracz, nigdy nie wpisując go na stałe w udostępnianym modzie.
  5. Podłącz napisy, głos i działania, a następnie przypisz polecenia głosowe do istniejącego kodu oddziału.
  6. Testuj w trybie dla jednego gracza na jednej mapie, zanim rozbudujesz to do pełnej kampanii.

Jak działają polecenia głosowe w modach, przeczytasz we wpisie polecenia głosowe na urządzeniu w modach do gier. Dla GoldSrc zobacz nasz przewodnik mod Half-Life AI NPC, a dla piaskownic serwerów Source wpis Garry's Mod AI NPC i dodatek z quizem. Mara i jej oddział można przetestować już dziś w przeglądarkowym edytorze Neocortex, na długo zanim pierwsza mapa się skompiluje.

Wersje narzędzi i linki sprawdzone w październiku 2026. Narzędzia do modowania często się zmieniają; sprawdź stronę każdego projektu, by znaleźć najnowsze wydanie.

Najczęstsze pytania

Czy można dodać AI NPC do Half-Life 2?

Tak. Mody Half-Life 2 buduje się na Source SDK 2013, który daje pełny kod gry C++, więc mod może wywołać webowe API i zareagować na odpowiedź. Neocortex dostarcza postać AI, jej głos i zwracane działania, a Twój mod je wykonuje.

Czy użyć gałęzi singleplayer czy multiplayer Source SDK 2013?

Mody fabularne zwykle zaczynają się od gałęzi singleplayer albo bazy społecznościowej na niej opartej, takiej jak Mapbase. Gałąź wieloosobowa dostała w 2025 roku dużą aktualizację z obsługą 64-bitową i jest nadal utrzymywana, ale jej kod jest przeznaczony dla gier wieloosobowych. Neocortex działa z każdą z nich, bo jest zwykłym webowym API.

Czy mogę wydawać rozkazy rebeliantom w Half-Life 2 głosem?

Tak, za pomocą moda. Half-Life 2 ma już kod poleceń oddziału, a mod może go uruchomić na podstawie mowy. Neocortex Voice Commands dopasowuje naturalne frazy na komputerze gracza, więc „move up”, „hold here” i „regroup” trafiają do Twojego kodu natychmiast i bez połączenia z internetem.

Czy mogę sprzedawać mod Half-Life 2 z postaciami AI?

Nie. Licencja Source 1 SDK pozwala rozpowszechniać mody tylko za darmo, choć darmowe mody można publikować na Steam. Część Neocortex darmowego moda możesz zbudować i przetestować w przeglądarkowym edytorze.

Podobne artykuły

Czytaj dalej