Neocortex Logo

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

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.

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 z Garry's Mod 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ę.

ZadanieSferaNarzędzie
NPC, encje, logika grySerwerEncje Lua
Wywoływanie Neocortex, przechowywanie klucza APISerwerHTTP(), http.Fetch, http.Post
Wysyłanie odpowiedzi do graczySerwer do klientaBiblioteka net
Napisy i HUDKlientchat.AddText lub własny panel HUD
Odtwarzanie głosuKlientsound.PlayURL
Komendy głosoweKlientNeocortex 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:

  1. 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ę.
  2. NPC prowadzący na scenie otwiera rundę.
  3. Gracze odpowiadają na czacie, a dodatek przekazuje każdą odpowiedź do silnika quizu przez /v3/quiz.
  4. Prowadzący ogłasza, kto ma rację, a silnik quizu zajmuje się punktacją i tablicą wyników.
  5. Między rundami twój dodatek wyświetla ranking na panelu HUD.

Zrzut ekranu z Garry's Mod 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
    })
end

Zasady 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:

  1. Utwórz folder dodatku z plikiem Lua po stronie serwera i encją NPC do zespawnowania.
  2. Zaprojektuj postacie w panelu Neocortex: sprzedawcę, prowadzącego quiz z zestawem pytań i zestaw komend dla pomocników.
  3. Wywołuj /v3/chat i /v3/quiz z serwera przez HTTP() i wysyłaj odpowiedzi do graczy biblioteką net.
  4. Trzymaj klucz API w pliku konfiguracyjnym po stronie serwera, nigdy w Lua klienta ani w pliku wgranym na Workshop.
  5. 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.

Podobne artykuły

Czytaj dalej