Neocortex Logo

Jak zbudować NPC AI w Godot | Poradnik 2026

Jak zbudować NPC AI w Godot w 2026: HTTPRequest i API modelu, SDK Neocortex dla Godot, model lokalny z NobodyWho i wtyczka Player2.

Sercan AltundasFounder of Neocortex

· 9 min czytania

Jak zbudować NPC AI w Godot w 2026: HTTPRequest i API modelu, SDK Neocortex dla Godot, model lokalny z NobodyWho i wtyczka Player2.

NPC AI w Godot budujesz, wysyłając to, co mówi gracz, do modelu językowego, a potem pokazując lub wypowiadając odpowiedź: przez własny węzeł HTTPRequest Godot i API modelu, przez SDK postaci albo przez dodatek, który uruchamia model na komputerze gracza. Godot nie ma własnej funkcji postaci AI, więc każda droga dokłada GDScript albo dodatek.

Ten poradnik jest dla programistów Godot 4, którzy chcą postaci odpowiadających własnymi słowami, a nie z drzewa dialogów. Opisuje cztery sposoby: HTTPRequest z API modelu, SDK Neocortex dla Godot, model lokalny z NobodyWho oraz wtyczkę Player2 AI NPC. Każdy ma swoje kroki, wymagania i koszt, a po nich są tabela porównawcza, wskazówki dla każdej metody i najczęstsze pytania.

4 sposoby na NPC AI w Godot

Wszystkie cztery zaczynają się od węzła w scenie, który reprezentuje postać, i wejścia dla gracza, czyli LineEdit lub mikrofonu. Różnią się tym, gdzie działa model, kto za niego płaci i ile GDScript trzeba napisać.

Metoda 1: HTTPRequest i API modelu

Ta droga używa tylko tego, co jest w Godot. Węzeł HTTPRequest to „węzeł zdolny do wysyłania żądań HTTP”, więc skrypt może wysłać linię gracza do dostawcy modelu i odczytać odpowiedź. Jako przykład używamy OpenAI Responses API.

Czego potrzebujesz: klucza API od dostawcy modelu i trochę GDScript.

  1. Utwórz klucz API. Dla OpenAI tworzysz go pod adresem platform.openai.com/api-keys.
  2. Dodaj węzeł HTTPRequest. Ustaw go jako dziecko sceny NPC i podłącz jego sygnał request_completed do funkcji w skrypcie NPC.
  3. Napisz postać. Trzymaj w stringu instrukcję systemową z imieniem postaci, rolą, tonem i granicami.
  4. Wyślij linię. Zbuduj ciało JSON z modelem, instrukcjami i wiadomością gracza, a potem wywołaj request() z adresem https://api.openai.com/v1/responses, nagłówkami Authorization: Bearer <key> i Content-Type: application/json, metodą POST i ciałem.
  5. Odczytaj odpowiedź. W obsłudze request_completed sparsuj ciało jako JSON i wstaw tekst do Label lub RichTextLabel nad NPC.
  6. Zachowaj historię. Trzymaj ostatnie tury w Array i wysyłaj je przy każdym żądaniu, bo model zapomina wszystko między wywołaniami.
  7. Dobuduj dodatki. Głos, synchronizacja ust i akcje to twoja praca: kolejne wywołania API do mowy i twoje reguły zamiany odpowiedzi na rozgrywkę.
  8. Chroń klucz. Dokumentacja Godot zaleca TLS i ostrzega przed wysyłaniem wrażliwych danych. Klucz w wyeksportowanej grze da się odczytać, więc przed wydaniem postaw własny serwer przed dostawcą.

Koszt: Godot jest darmowy. Płacisz stawki dostawcy za tokeny.

Gdzie to nie wystarcza: pamięć, głos, akcje, bezpieczeństwo i serwer z kluczem musisz zbudować i utrzymywać sam.

Metoda 2: SDK Neocortex dla Godot

Neocortex to nasz produkt, więc czytaj tę sekcję z tą świadomością. Postać projektujesz w wizualnym edytorze w przeglądarce, a potem używasz jej w Godot przez dodatek open source (Apache 2.0). Osobowość, wiedza, emocje, głos i akcje są węzłami w edytorze; w Godot dodajesz gotowe węzły. Pełną listę znajdziesz na stronie NPC AI dla Godot.

Czego potrzebujesz: Godot 4.7 lub nowszego i konta Neocortex z kluczem API.

  1. Utwórz postać. W panelu otwórz Characters, kliknij Create New Character, wpisz nazwę i kliknij Create. Zbuduj ją w edytorze węzłów.
  2. Przetestuj w przeglądarce. Kliknij Play w prawym górnym rogu edytora.
  3. Utwórz klucz API. Otwórz API Keys w panelu.
  4. Zainstaluj dodatek. Pobierz najnowsze wydanie z https://github.com/neocortex-link/neocortex-godot-sdk/releases/latest i skopiuj addons/neocortex-godot-sdk do folderu addons w projekcie.
  5. Włącz go. Otwórz Project > Project Settings > Plugins i włącz Neocortex. Wklej klucz API w panelu Neocortex.
  6. Dodaj czat jednym krokiem. Wybierz Project > Tools > Neocortex > Complete Text Chat albo Complete Voice Chat. To dodaje działający czat do sceny; wybierz postać z listy w Inspectorze.
  7. Podłącz do gry. Użyj węzła NeocortexSmartAgent dla postaci, NeocortexAudioReceiver dla mikrofonu, NeocortexFaceAnimator do synchronizacji ust na blend shapes w stylu ARKit, NeocortexInteractable dla obiektów, które postać ma znać, i NeocortexEventLogger dla zdarzeń. Węzły akcji w edytorze wysyłają nazwy akcji, na które może reagować twój GDScript.
  8. Otwórz przykłady. Siedem scen przykładowych i launcher otwierają się z panelu Neocortex: Text Chat, Audio Chat, Actions, Interactables, Group Chat, Usage Gating i Quiz Show.

Limity, które warto znać: nagrywanie kończy się po 29 sekundach, dźwięki krótsze niż 0,15 sekundy nie są wysyłane, a żądania czatu przekraczają limit czasu po 30 sekundach.

Koszt: Starter kosztuje 9 €, Pro 29 € i Team 99 € miesięcznie przy płatności rocznej, albo 11 €, 35 € i 119 € przy płatności miesięcznej. Użycie komercyjne wymaga planu Pro lub Team. Zobacz cennik.

Gdzie to nie wystarcza: postacie działają w naszej chmurze, więc gra potrzebuje połączenia. Wyeksportowana gra zawiera klucz API, więc ustaw na nim limity użycia. Czat grupowy wymaga planu Pro lub Team, quiz wymaga Team, a nasza dokumentacja nie wylicza każdego celu eksportu.

Zacznij

Metoda 3: model lokalny z NobodyWho

NobodyWho to silnik inferencji open source, który uruchamia modele językowe na komputerze gracza, z dodatkiem do Godot. Jego readme mówi, że nie potrzeba „kluczy API” i nie ma ukrytych opłat.

Czego potrzebujesz: Godot 4.6 lub nowszego (według jego dokumentacji) i modelu w formacie GGUF.

  1. Zainstaluj go. W Godot otwórz zakładkę AssetLib, wyszukaj NobodyWho, pobierz i zaimportuj z zaznaczoną opcją Ignore asset root. Możesz też skopiować addons/nobodywho z wydania do projektu. Uruchom ponownie lub przeładuj edytor.
  2. Wybierz model. Działa każdy model GGUF. Readme proponuje na start Qwen3 0.6B; zdalne modele pobierają się i są zapisywane w pamięci podręcznej przy pierwszym użyciu.
  3. Utwórz czat. W skrypcie wywołaj await NobodyWhoChat.create(<model path>, {}).
  4. Zadaj pytanie. Wywołaj chat.ask(<player text>) i await na completed() wyniku. Dokumentacja mówi, by zawsze od razu czekać na zwrócona wartość.
  5. Napisz rolę. Podaj czatowi instrukcje postaci, zgodnie z sekcją Chat w dokumentacji NobodyWho.
  6. Sprawdź cele eksportu. NobodyWho obsługuje Godot na desktop i Androida. Nie ma eksportu na iOS ani web.

Koszt: za darmo do użytku komercyjnego na licencji EUPL-1.2. Jeśli zmienisz własny kod NobodyWho, zmiany muszą być udostępnione jako open source.

Gdzie to nie wystarcza: szybkość i jakość odpowiedzi zależą od sprzętu gracza i rozmiaru modelu, a model zwiększa rozmiar pobierania. Funkcje głosowe są wymienione dla silnika; sprawdź, czy wiązanie do Godot je ma, zanim je zaplanujesz.

Metoda 4: wtyczka Player2 AI NPC

Player2 to aplikacja desktopowa z lokalnymi API dla gier i modów. Jego wtyczka do Godot „korzysta z darmowych API AI z aplikacji Player2” i łączy się, gdy aplikacja jest uruchomiona.

Czego potrzebujesz: Godot 4.5 (jak podano w Asset Library), identyfikatora klienta dewelopera Player2 i aplikacji Player2.

  1. Zainstaluj wtyczkę. Pobierz ją z Godot Asset Library lub z GitHub i przeciągnij folder addons do projektu.
  2. Dodaj identyfikator klienta. Utwórz go pod adresem player2.game/profile/developer i wpisz w Project Settings > Player2 > Game Key.
  3. Dodaj węzeł NPC. Dodaj do sceny węzeł Player2 AI NPC i edytuj opis agenta.
  4. Podłącz czat. Wywołaj funkcję chat węzła z tekstem gracza i podłącz sygnał chat_received, by pokazywać odpowiedzi. Wywołaj notify, by poinformować agenta o zdarzeniach w świecie.
  5. Dodaj głos. Ustaw Voice ID w Character Config albo dodaj węzeł Player2TTS; do wejścia mowy dodaj Player2STT i włącz wejście audio w Project Settings > Audio.
  6. Uruchom Player2. Otwórz aplikację Player2; wtyczka połączy się automatycznie.

Koszt: darmowy dla twórców, według stron Player2. Wtyczka ma licencję GPLv3.

Gdzie to nie wystarcza: strona Player2 mówi, że lokalne API działają przy otwartej aplikacji, więc zaplanuj, co zobaczą gracze bez niej. Sprawdź licencję GPLv3 względem swojego projektu.

Cztery metody w porównaniu

CzynnikHTTPRequest i APISDK NeocortexNobodyWhoWtyczka Player2
Gdzie zdefiniowana jest postaćStringi w GDScriptWizualny edytor węzłów w przeglądarceTwój GDScriptOpis węzła w Godot
Gdzie działa modelChmura dostawcyChmura NeocortexUrządzenie graczaPrzez aplikację Player2
Wersja Godot4.x z HTTPRequest4.7 lub nowsza4.6 lub nowsza4.5 wg listy
GłosZbuduj samemuWbudowany, z synchronizacją ustWymieniony dla silnikaWęzły TTS i STT
Licencja dodatkuNie jest potrzebnaApache 2.0EUPL-1.2GPLv3
Koszt startowyStawki za tokeny dostawcyOd 9 € miesięcznieZa darmoZa darmo dla twórców
Potrzebne umiejętnościGDScript, HTTP, serwerKopiowanie dodatku, dodawanie węzłówGDScript, wybór modeluDodanie węzła

HTTPRequest daje pełną kontrolę przy największej ilości kodu. NobodyWho to droga offline, związana ze sprzętem gracza. Neocortex trzyma postacie w hostowanym edytorze, z głosem, synchronizacją ust i przykładami. Player2 to najszybszy węzeł do dodania i zależy od swojej aplikacji.

Wskazówki dla lepszych wyników w Godot

Te nawyki pomagają w każdej metodzie.

  1. Trzymaj klucze poza eksportem. Wszystko w wyeksportowanym projekcie da się odczytać. Trzymaj pliki ustawień z kluczami poza kontrolą wersji i używaj serwera lub limitów użycia na gracza i na postać.
  2. Pokaż, że NPC usłyszał gracza. Przełącz się na animację „myślenia” albo podpisz moment rozpoczęcia żądania, by czekanie na odpowiedź nigdy nie wyglądało jak zawieszona gra.
  3. Powiedz postaci o scenie. Przekazuj obok wiadomości pobliskie obiekty i ostatnie zdarzenia, żeby NPC mówił o pokoju, w którym stoi.
  4. Niech GDScript podejmuje ostateczną decyzję o akcjach. Trzymaj krótką listę akcji, o które postać może poprosić, i sprawdzaj każdą w kodzie, zanim się wykona.
  5. Dla fabuły używaj drzewa dialogów. Linie, które popychają historię, trzymaj w dodatku do dialogów skryptowanych, a postać AI używaj do wszystkiego wokół nich. Nasz wpis o wtyczkach do Godot wymienia dodatki dla części skryptowanej.

Jak wybrać metodę w Godot

HTTPRequest i API modelu pasują, jeśli nie chcesz dodatków, chcesz pełnej kontroli nad każdym żądaniem i możesz uruchomić mały serwer na klucz.

SDK Neocortex pasuje, jeśli chcesz projektować postacie wizualnie, testować je w przeglądarce i mieć głos, synchronizację ust, akcje i przykłady w Godot 4.7, przy czym ta sama postać działa też w Unity i Unreal Engine.

NobodyWho pasuje, jeśli gra musi działać offline bez bieżących kosztów, na desktopie lub Androidzie.

Wtyczka Player2 pasuje, jeśli twoi gracze już używają aplikacji Player2 albo prototypujesz i chcesz najmniej kroków.

Więcej wyborów znajdziesz w najlepszych narzędziach NPC AI dla Godot, a jeśli wciąż wybierasz silnik, zobacz Godot vs Unity.

Często zadawane pytania

Czy mogę zbudować NPC AI w Godot za darmo?

Tak. NobodyWho jest darmowy i uruchamia model lokalnie, a Player2 jest darmowy dla twórców. API modelu, które wywołujesz sam, pobiera opłatę za token.

Czy Godot ma wbudowane NPC AI?

Nie. Godot daje węzeł HTTPRequest do wywołań sieciowych, ale nie ma modelu językowego ani systemu postaci. Nasz wpis Godot AI omawia to, co istnieje wokół silnika.

Jakiej wersji Godot potrzebuję?

Neocortex wymaga Godot 4.7 lub nowszego, NobodyWho 4.6 lub nowszego, a wtyczka Player2 podaje 4.5. HTTPRequest jest częścią Godot 4.

Czy NPC AI w Godot może działać offline?

Tak, z modelem lokalnym, takim jak NobodyWho, na desktopie lub Androidzie. Trasy chmurowe, w tym Neocortex, wymagają połączenia.

Czy SDK Neocortex dla Godot jest open source?

Tak. Jest wydany na licencji Apache 2.0, a kod jest na GitHub pod neocortex-link/neocortex-godot-sdk. Zgłoszenia błędów i pomysły są tam mile widziane.

Czy NPC AI w Godot działa w eksportach web?

Zależy od drogi. NobodyWho nie ma eksportu web. Do gier w przeglądarce spoza Godot Neocortex ma też Web SDK.

Podobne artykuły

Czytaj dalej