Dodatek AI NPC do Garry's Mod: NPC i prowadzący quiz
Zbuduj dodatek AI NPC do Garry's Mod w Lua: inteligentne NPC na serwery sandbox i roleplay, prowadzącego quiz dla wielu graczy z tablicą wyników i komendy głosowe.
Neocortex TeamThe team behind Neocortex
· 6 min czytania

Dodatek AI NPC do Garry's Mod to dodatek w Lua, który wysyła to, co mówią gracze, do postaci AI przez wbudowaną w grę funkcję HTTP() i reaguje na odpowiedź. Serwery Garry's Mod żyją tym, co gracze sami wymyślą, a NPC, które tylko stoją, to zmarnowana szansa.
Dzięki Neocortex serwery sandbox i roleplay dostają postacie, które naprawdę rozmawiają: sprzedawcę, który się targuje, prowadzącego quiz, który prowadzi grę dla całego serwera, i pomocników reagujących na komendy głosowe. Neocortex dostarcza postacie AI, Conversation Flow, silnik quizu i komendy głosowe działające na urządzeniu; Lua łączy je z twoim serwerem.
Zrzut ekranu: Garry's Mod © Valve
Co działa na serwerze, a co na kliencie
Dodatki do Garry's Mod to foldery ze skryptami Lua i zawartością, instalowane w garrysmod/addons albo subskrybowane przez Steam Workshop. Lua działa w dwóch sferach, a dodatek AI NPC dzieli się między nie czysto. Wiki Garry's Mod dokumentuje każdą funkcję.
| Zadanie | Sfera | Narzędzie |
|---|---|---|
| NPC, encje, logika gry | Serwer | Encje Lua |
| Wywoływanie Neocortex, przechowywanie klucza API | Serwer | HTTP(), http.Fetch, http.Post |
| Wysyłanie odpowiedzi do graczy | Serwer do klienta | Biblioteka net |
| Napisy i HUD | Klient | chat.AddText lub własny panel HUD |
| Odtwarzanie głosu | Klient | sound.PlayURL |
| Komendy głosowe | Klient | Neocortex Voice Commands na komputerze gracza |
Kilka szczegółów ma znaczenie. HTTP() uruchamia asynchroniczne żądanie z adresem URL, metodą, nagłówkami, treścią i callbackami, a http.Fetch i http.Post opakowują je w prostych przypadkach; callback sukcesu wywoła się też dla kodów błędów, więc zawsze sprawdzaj kod. sound.PlayURL odtwarza zewnętrzne pliki dźwiękowe, więc generowany głos podawaj z małego endpointu, który kontrolujesz, a klienci mogą go strumieniować, nigdy nie widząc klucza API. Moduły natywne (gmsv_ dla serwera, gmcl_ dla klienta) trafiają do garrysmod/lua/bin i ładują się przez require, ale nie da się ich zainstalować przez dodatek z Workshopu, więc wszystko natywne to osobna instalacja dla graczy lub właścicieli serwera.
Postacie roleplay, z którymi gracze mogą rozmawiać
Na serwerze roleplay daj miastu obsadę: sprzedawcę, który się targuje i pamięta, kto go oszukał, barmana, który zna lore serwera, dyspozytora policji, który reaguje na zgłoszenia graczy. Każda postać dostaje w edytorze Neocortex osobowość, ustawienie emocji i bazę wiedzy, na przykład regulamin serwera, lokacje z mapy i twoją ekonomię.
Gracze naciskają use na NPC i piszą na czacie. Twój dodatek wysyła wiadomość razem z pobliskimi obiektami (ladą sklepu, automatem, drzwiami więzienia) i ostatnimi zdarzeniami („gracz został aresztowany”, „dzwoni alarm banku”). Postać odpowiada znacznikiem emocji w każdej linii oraz akcjami, takimi jak { "name": "OPEN_DOOR", "targetId": "jail_door" }, które dodatek uruchamia na serwerze.
Czat grupowy (plany Pro i Team) pozwala połączyć w jednej rozmowie do sześciu postaci, więc banda NPC może kłócić się z graczem naraz. Conversation Flow może prowadzić dłuższą scenę, na przykład odprawę przed napadem w roleplay, i zwracać słowa kluczowe punktów kontrolnych (flowState), na które reaguje dodatek.
Prowadzenie wieczoru quizowego
Silnik quizu (plan Team) zamienia scenę, kilka przycisków i tablicę wyników w wydarzenie serwerowe:
- Układasz zestaw pytań w panelu Neocortex: wieczór ciekawostek o serwerze, quiz z lore dla nowych graczy roleplay albo sprawdzian z regulaminu, który nowi gracze muszą zdać, zanim dostaną pracę.
- NPC prowadzący na scenie otwiera rundę.
- Gracze odpowiadają na czacie, a dodatek przekazuje każdą odpowiedź do silnika quizu przez
/v3/quiz. - Prowadzący ogłasza, kto ma rację, a silnik quizu zajmuje się punktacją i tablicą wyników.
- Między rundami twój dodatek wyświetla ranking na panelu HUD.
Zrzut ekranu: Garry's Mod © Valve
Pomocnicy, którzy słuchają komend głosowych
Daj każdemu graczowi pomocnika NPC, który słucha: „follow me”, „wait here”, „guard the door”, „bring two crates”. W panelu Neocortex projektujesz zestaw komend jako aktorów, akcje i obiekty: aktor „helper”, akcje „follow”, „wait”, „guard” i „bring”, obiekty „me”, „door” i „crate”.
Gracze mówią naturalnie, a dodatek natychmiast dostaje dopasowane komendy, także kilka akcji i ilości w jednym zdaniu. Działa z push-to-talk lub z ciągłym nasłuchem, w wielu językach, bez rundy do chmury. Ponieważ działa na komputerze gracza, strona kliencka wysyła dopasowane komendy na serwer.
Voice Commands to licencjonowany SDK: skontaktuj się z nami, aby uzyskać licencję Voice Commands.
Kod dodatku AI NPC do Garry's Mod
Wszystko, co dotyka API, działa po stronie serwera. Serwer odczytuje stan gry i wysyła go wraz 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 uruchamia akcje, które zwróci postać:
-- Server realm only: the key stays in garrysmod/data and never reaches players.
local apiKey = string.Trim(file.Read("neocortex_key.txt", "DATA") or "")
local function AskNPC(ply, text, sessionId, onReply)
HTTP({
url = "https://api.neocortex.link/v3/chat",
method = "POST", type = "application/json",
headers = { ["x-api-key"] = apiKey },
body = util.TableToJSON({
characterIds = { "CHARACTER_ID" },
message = text,
playerId = ply:SteamID64(),
sessionId = sessionId or ""
}),
success = function(code, body)
local data = util.JSONToTable(body)
if code == 200 and data then onReply(data) end -- data.sessionId, data.messages
end,
failed = function(reason) print("[Neocortex] " .. reason) end
})
endZasady dla NPC AI
Serwery Garry's Mod ustalają własne zasady, więc uruchamiaj dodatki AI NPC tylko na serwerach, które należą do ciebie, albo tam, gdzie właściciel się zgodził, i mów graczom, że rozmawiają z AI. Przy publikacji przestrzegaj zasad Steam Workshop i upewnij się, że każdy właściciel serwera używa własnego klucza API Neocortex. Dodaj cooldown na gracza, aby jeden gracz nie zalewał NPC wiadomościami.
Podsumowanie dla właścicieli serwerów
Pięć kroków prowadzi od pustego folderu do mówiącego NPC:
- Utwórz folder dodatku z plikiem Lua po stronie serwera i encją NPC do zespawnowania.
- Zaprojektuj postacie w panelu Neocortex: sprzedawcę, prowadzącego quiz z zestawem pytań i zestaw komend dla pomocników.
- Wywołuj
/v3/chati/v3/quizz serwera przezHTTP()i wysyłaj odpowiedzi do graczy bibliotekąnet. - Trzymaj klucz API w pliku konfiguracyjnym po stronie serwera, nigdy w Lua klienta ani w pliku wgranym na Workshop.
- Testuj na lokalnym serwerze listen z kolegą, zanim uruchomisz go na publicznym serwerze.
Zacznij od sprzedawcy. Jedna postać, jedno wywołanie HTTP() i hook czatu wystarczą, by pokazać graczom, co potrafi NPC Neocortex, a quiz buduje na tym samym kodzie serwera. Jak działają komendy głosowe na komputerze gracza, przeczytasz we wpisie komendy głosowe na urządzeniu do modów gier. Dla modów na silniku Source zobacz nasz przewodnik mod AI NPC do Half-Life 2.
Wersje narzędzi i linki sprawdzone w październiku 2026. Narzędzia do modowania często się zmieniają; sprawdź stronę każdego projektu, aby poznać najnowsze wydanie.
Najczęściej zadawane pytania
Czy można dodać NPC AI do Garry's Mod?
Tak. Dodatki do Garry's Mod pisze się w Lua, a gra ma wbudowaną funkcję HTTP(), więc dodatek po stronie serwera może wysłać to, co mówią gracze, do postaci AI i zareagować na odpowiedź. Neocortex dostarcza postać, jej głos i akcje, które zwraca.
Czy dodatek do Garry's Mod może wywoływać zewnętrzne API?
Tak. Globalna funkcja HTTP() oraz pomocnicze http.Fetch i http.Post wykonują asynchroniczne żądania z serwera lub klienta. Przy dodatku AI NPC wykonuj wywołania na serwerze, aby twój klucz API Neocortex nigdy nie trafił do graczy.
Jak przeprowadzić quiz na serwerze Garry's Mod?
Zespawnuj NPC prowadzącego, przekieruj odpowiedzi graczy z czatu do silnika quizu i pokaż wyniki na panelu HUD. Silnik quizu Neocortex prowadzi pytania, punktację i tablicę wyników, więc twój dodatek obsługuje tylko scenę i czat.
Czy NPC w Garry's Mod mogą reagować na komendy głosowe?
Tak, dzięki komponentowi po stronie klienta. Neocortex Voice Commands działa na komputerze każdego gracza i zamienia wyrażenia w rodzaju „follow me” czy „guard the door” w komendy, które dodatek natychmiast odbiera, bez połączenia z internetem. Ponieważ działa na komputerze gracza, gracze instalują część głosową obok dodatku z Workshopu.
Gdzie przechowywać klucz API na serwerze Garry's Mod?
Tylko po stronie serwera, na przykład w pliku w folderze danych serwera, który dodatek odczytuje przy starcie. Nigdy nie umieszczaj klucza w Lua po stronie klienta ani w pliku wgranym na Workshop, bo każdy gracz pobiera te pliki.






