Neocortex Logo

Mod AI NPC do GTA 5: rozmawiający piesi i komendy głosowe

Zbuduj mod AI NPC do GTA 5 z Neocortex: piesi, którzy odpowiadają, pasażer oceniający Twoją jazdę, komendy głosowe i quiz w radiu w trybie fabularnym.

Neocortex TeamThe team behind Neocortex

· Zaktualizowano 23 paź 2026 · 6 min czytania

Zbuduj mod AI NPC do GTA 5 z Neocortex: piesi, którzy odpowiadają, pasażer oceniający Twoją jazdę, komendy głosowe i quiz w radiu w trybie fabularnym.

Jest 3 w nocy, wchodzisz do sklepu 24/7 z dwiema gwiazdkami poszukiwania i pistoletem w ręku, a sprzedawca mówi to samo zdanie, które mówi każdemu. Mod AI NPC do GTA 5 naprawia ten moment: sprzedawcy, przechodnie i pasażerowie odpowiadają na to, co naprawdę mówisz, i reagują na to, co właśnie zrobiłeś. Neocortex daje Twojemu modowi opartemu na Script Hook V postacie AI z głosami, akcjami i emocjami oraz komendy głosowe działające na urządzeniu, więc możesz zbudować to w trybie fabularnym bez uruchamiania własnego modelu językowego.

Zrzut ekranu z gry Grand Theft Auto V Enhanced Zrzut ekranu: Grand Theft Auto V Enhanced © Rockstar Games

Stos modu AI NPC do GTA 5 w skrócie

Mody do GTA 5 w trybie dla jednego gracza działają jako natywne wtyczki ładowane przez Script Hook V, który wczytuje pliki .asi i daje im dostęp do natywnych funkcji gry. Wydanie Script Hook V z lipca 2026 roku wymienia obsługiwane łatki zarówno dla GTA V Legacy, jak i GTA V Enhanced. Większość modów skryptowych jest napisana w C# na warstwie .NET:

NarzędzieCo dajeWydanie
ScriptHookVDotNet 3 (SHVDN)Standardowy host skryptów .NET. Aktualne łatki gry wymagają buildów nocnych, a nie ostatniego stabilnego wydania.Legacy
ScriptHookVDotNetEnhancedRozszerzony SHVDN, dzięki czemu skrypty napisane dla Legacy mogą działać na Enhanced bez zmianLegacy i Enhanced
LemonUIMenu w stylu NativeUI dla skryptów SHVDN 3, przydatne do ekranu ustawień lub podpowiedzi "porozmawiaj"Oba

Sprawdź notatki każdego projektu, aby zobaczyć, które buildy obsługuje Twój skrypt.

Skrypt to skompilowana klasa C# w folderze scripts z handlerem Tick, który działa co klatkę. Stamtąd odczytujesz gracza, pobliskich pieszych, pojazdy i poziom poszukiwania przez API SHVDN, a możesz zrobić wszystko, co potrafi .NET Framework: HttpClient do zapytań sieciowych, bibliotekę audio taką jak NAudio do odtwarzania głosu i ScriptSettings SHVDN do pliku .ini. Napisy pojawiają się na ekranie przez GTA.UI.Screen.ShowSubtitle, a menu obsługuje LemonUI.

Od zdarzenia w grze do wypowiedzi

Każda funkcja w tym wpisie działa na tej samej pętli. Skrypt odczytuje stan gry, wysyła go wraz z wypowiedzią gracza do postaci Neocortex (/v3/chat), pokazuje odpowiedź jako napisy, odtwarza głos z /v3/audio/generate lub /v3/audio/stream i wykonuje akcje, które postać zwróci. Zapytania sieciowe uruchamiaj poza wątkiem gry i przekazuj wyniki z powrotem do Tick, żeby gra nigdy się nie zatrzymywała.

Minimalne wywołanie czatu z skryptu SHVDN:

static readonly HttpClient Http = new HttpClient();

static async Task<string> AskCharacter(string apiKey, string characterId, string sessionId, string line, string gameEvent)
{
    var body = JsonConvert.SerializeObject(new {
        characterIds = new[] { characterId },
        message = line,
        playerId = "player-1",
        sessionId = sessionId,
        events = new[] { new { priority = 1, content = gameEvent } }
    });
    var req = new HttpRequestMessage(HttpMethod.Post, "https://api.neocortex.link/v3/chat");
    req.Headers.Add("x-api-key", apiKey); // read from the mod's .ini, never hard-coded
    req.Content = new StringContent(body, Encoding.UTF8, "application/json");
    var res = await Http.SendAsync(req);
    return await res.Content.ReadAsStringAsync(); // sessionId, messages[].lines, actions
}

Zachowaj zwrócony sessionId i wyślij go z następną wiadomością, aby postać pamiętała rozmowę.

Trzy kolejne elementy działają na tej pętli:

  • Conversation Flows prowadzą dłuższe spotkanie przez etapy, które projektujesz, i zwracają słowa kluczowe checkpointów (flowState), na które reaguje Twój skrypt, na przykład przekazując graczowi znacznik trasy, gdy nieznajomy mu zaufa.
  • Silnik quizów obsługuje zestawy pytań, punktację i tablice wyników przez /v3/quiz.
  • Komendy głosowe działające na urządzeniu zamieniają wypowiedziane frazy na akcje w grze bez rundy przez chmurę. Neocortex Voice Commands działa na maszynie gracza, a zestaw komend projektujesz w panelu jako aktorów, akcje i obiekty (aktor "dispatcher", akcja "send", obiekt "taxi"). Tryb push-to-talk lub stałe nasłuchiwanie, w wielu językach.

Co zbudować w Los Santos

Sprzedawca, który zauważa. Wróćmy do sklepu 24/7: Twój skrypt wysyła postaci sprzedawcy krótką listę zdarzeń ("gracz ma 2 gwiazdki poszukiwania", "gracz trzyma pistolet", "syreny policyjne w pobliżu") wraz z wypowiedzią gracza. Sprzedawca odpowiada w roli, z tagiem emocji, który Twój mod może zamienić na animację, i może zwrócić akcję, taką jak { "name": "OPEN_REGISTER" } albo { "name": "CALL_POLICE" }, którą Twój skrypt wykonuje. Ten sam wzorzec obejmuje ulicznego sprzedawcę na Vespucci Beach albo joggera w Mirror Park: jedna postać na archetyp, każda z własną osobowością i wiedzą o okolicy.

Pasażer z opiniami o Twojej jeździe. Strumieniuj zdarzenia z jazdy: otarcia, przejechane czerwone światła, 190 km/h na Senora Freeway, trzecia kraksa w minutę. Towarzysz komentuje, śmieje się, narzeka i prosi o wyjście, gdy go przestraszysz, a akcje takie jak CHANGE_STATION albo GET_OUT pozwalają mu coś z tym zrobić. W planach Pro i Team czat grupowy obejmuje do sześciu postaci w jednej rozmowie, więc dwóch pasażerów może kłócić się o trasę, gdy prowadzisz.

Komendy głosowe. Gracz po prostu mówi: "zamów mi taksówkę", "wezwij wsparcie", "następna stacja", "wyłącz radio i ustaw znacznik do domu". Twój skrypt otrzymuje dopasowane komendy i je wykonuje, kilka na zdanie, jeśli trzeba.

Prowadzący quiz w radiu. Na długie przejazdy zbuduj oryginalną postać prowadzącego radio, który przeprowadza quiz o Los Santos przez silnik quizów (plan Team). Gracz odpowiada głosem, rozpoznawanie mowy zamienia to na tekst, a API prowadzi wynik.

Zrzut ekranu z gry Grand Theft Auto V Enhanced Zrzut ekranu: Grand Theft Auto V Enhanced © Rockstar Games

Tylko tryb fabularny

Polityka Rockstar dotycząca modów na PC w trybie dla jednego gracza mówi, że Take-Two generalnie nie podejmuje działań wobec niekomercyjnych modów dla jednego gracza, które szanują prawa osób trzecich, i wyklucza usługi online, nowe historie, misje i mapy. Nowsze wytyczne modderskie Rockstar obejmują wszystkie jego gry i idą dalej:

  • Nie ruszaj fabuły Rockstar. Nie rozszerzaj ani nie zmieniaj jego historii, misji i postaci. Żadnych nowych dialogów dla Michaela, Franklina czy Trevora.
  • Nie ruszaj głosów Rockstar. Nie modyfikuj ani nie wykorzystuj ponownie jego nagrań głosowych. Każdej postaci AI nadaj oryginalny głos Neocortex zaprojektowany z opisu tekstowego albo taki, do którego masz prawa, nigdy klon aktora głosowego Rockstar.
  • Multiplayer działa tylko przez Creator Platform Rockstar i nigdzie indziej, a każdy mod poza tą platformą musi pozostać ściśle niekomercyjny.

Wytyczne mówią też, że nie są licencją, więc opisują to, co Rockstar toleruje, a nie przyznają praw. Buduj więc rozmowy w tle, towarzyszy, komendy głosowe i quizy z oryginalnymi postaciami, a nie nowe misje fabularne. GTA Online nigdy nie może być modowane: trzymaj mod w trybie fabularnym, zachowaj go za darmo i niech każdy gracz używa własnego klucza API Neocortex.

Dalsze kroki

  1. Zainstaluj Script Hook V i host skryptów .NET dla swojej edycji: SHVDN w buildzie nocnym dla Legacy, ScriptHookVDotNetEnhanced dla Enhanced. Dodaj LemonUI, jeśli chcesz menu.
  2. Zaprojektuj postać w wizualnym edytorze Neocortex: osobowość, wiedzę o Los Santos, głos i akcje, które może zwrócić. Przetestuj ją w przeglądarce.
  3. Dodaj Conversation Flow, quiz lub zestaw komend głosowych, jeśli Twój pomysł tego wymaga.
  4. Połącz się ze skryptu przez HttpClient, pokazuj odpowiedzi jako napisy i odtwarzaj dźwięk.
  5. Trzymaj klucz API w pliku .ini, który wypełnia gracz, aby każdy używał własnego klucza.
  6. Testuj w trybie fabularnym, zanim cokolwiek udostępnisz.

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

Ta sama metoda działa w innych grach Rockstar. Są o tym nasze poradniki o Red Dead Redemption 2, GTA San Andreas i Vice City oraz GTA 4, a nasz wpis o modzie AI NPC do GTA 6 zastanawia się, dokąd to może pójść dalej. O części głosowej przeczytaj nasz wpis o komendach głosowych działających na urządzeniu w modach, a o tym, jak Neocortex wypada na tle konkurencji, na naszej stronie porównań. Zacznij od jednego sprzedawcy w jednym sklepie, a Neocortex zajmie się resztą rozmowy.

Wersje narzędzi i linki sprawdzono w październiku 2026 roku. Narzędzia modderskie zmieniają się często, więc sprawdź stronę każdego projektu, by zobaczyć najnowsze wydanie.

Najczęstsze pytania

Czy można dodać AI NPC do GTA 5?

Tak, w trybie fabularnym. Skrypt .NET dla Script Hook V może odczytać, co dzieje się wokół gracza, wysłać to do postaci AI przez webowe API i pokazać odpowiedź jako napisy. Neocortex dostarcza postać, jej głos i akcje, które zwraca, a Twój mod zajmuje się tylko logiką gry.

Czy mod AI do GTA 5 działa na wydaniu Enhanced?

Script Hook V obsługuje aktualne łatki Legacy i Enhanced, a ScriptHookVDotNetEnhanced uruchamia skrypty .NET na obu wydaniach. Mod Neocortex potrzebuje tylko HTTP, tekstu i audio, więc ten sam skrypt może działać na Legacy i Enhanced.

Czy mogę sterować GTA 5 głosem?

Tak. Skrypt może przypisać wypowiedziane frazy do akcji w grze, na przykład wezwania taksówki albo zmiany radia. Neocortex Voice Commands działa na komputerze gracza, rozumie naturalne sformułowania i zwraca dopasowaną komendę od razu, bez rundy przez chmurę.

Czy mod AI NPC może spowodować bana w GTA 5?

Polityka Rockstar dla modów na PC toleruje niekomercyjne mody dla jednego gracza, ale GTA Online jest poza zasięgiem, a modowanie go może skutkować banem konta. Wytyczne modderskie Rockstar z 2026 roku ograniczają modowanie multiplayer do Creator Platform i wykluczają nowe dialogi dla jego postaci oraz wykorzystanie głosów jego aktorów. Trzymaj każdy mod Neocortex w trybie fabularnym, używaj oryginalnych postaci i głosów i nigdy nie ładuj go w GTA Online.

Ile kosztuje Neocortex dla modderów GTA 5?

Płatne plany zaczynają się od 9 € miesięcznie i obejmują postacie AI, Conversation Flows i API. Postacie możesz testować w przeglądarce, zanim napiszesz jakikolwiek kod moda.

Podobne artykuły

Czytaj dalej