Neocortex Logo

Addon NPC IA per Garry's Mod: NPC intelligenti e quiz

Costruisci un addon NPC IA per Garry's Mod in Lua: NPC intelligenti per server sandbox e roleplay, un conduttore di quiz multigiocatore con classifica e comandi vocali.

Neocortex TeamThe team behind Neocortex

· 6 min di lettura

Costruisci un addon NPC IA per Garry's Mod in Lua: NPC intelligenti per server sandbox e roleplay, un conduttore di quiz multigiocatore con classifica e comandi vocali.

Un addon NPC IA per Garry's Mod è un addon in Lua che invia ciò che dicono i giocatori a un personaggio IA tramite la funzione integrata del gioco HTTP() e agisce in base alla risposta. I server di Garry's Mod vivono di ciò che i giocatori inventano, e gli NPC che stanno fermi sono un'occasione sprecata. Con Neocortex, i server sandbox e roleplay ottengono personaggi che parlano davvero: un negoziante che tratta sul prezzo, un presentatore di quiz che gestisce un gioco per tutto il server, e aiutanti che seguono comandi vocali. Neocortex fornisce i personaggi IA, le Conversation Flow, il motore dei quiz e i comandi vocali sul dispositivo; Lua li collega al tuo server.

Screenshot in gioco di Garry's Mod Screenshot: Garry's Mod © Valve

Cosa gira sul server e cosa sul client

Gli addon di Garry's Mod sono cartelle di script Lua e contenuti, installate in garrysmod/addons o sottoscritte tramite lo Steam Workshop. Lua gira in due realm, e un addon NPC IA si divide in modo pulito tra i due. La wiki di Garry's Mod documenta ogni funzione.

CompitoRealmStrumento
NPC, entità, logica di giocoServerEntità Lua
Chiamare Neocortex, custodire la chiave APIServerHTTP(), http.Fetch, http.Post
Inviare le risposte ai giocatoriDal server al clientLa libreria net
Sottotitoli e HUDClientchat.AddText o un pannello HUD personalizzato
Riproduzione della voceClientsound.PlayURL
Comandi vocaliClientNeocortex Voice Commands sul computer del giocatore

Alcuni dettagli contano. HTTP() avvia una richiesta asincrona con URL, metodo, header, corpo e callback, mentre http.Fetch e http.Post la incapsulano per i casi semplici; la callback di successo scatta anche per i codici di errore, quindi controlla sempre il codice. sound.PlayURL riproduce file audio esterni, quindi servi la voce generata da un piccolo endpoint che controlli: i client possono riprodurla in streaming senza mai vedere la chiave API. I moduli nativi (gmsv_ per il server, gmcl_ per il client) vanno in garrysmod/lua/bin e si caricano con require, ma non si possono installare tramite un addon del Workshop, quindi qualsiasi componente nativo è un'installazione separata per i giocatori o per i proprietari del server.

NPC di roleplay con cui i giocatori possono parlare

Su un server di roleplay, dai alla città un cast: un negoziante che tratta e ricorda chi l'ha fregato, un barista che conosce la lore del server, un agente di polizia che reagisce a ciò che i giocatori segnalano. Ogni personaggio riceve una Personality, un'impostazione di Emotion e una Knowledge base nell'editor Neocortex, come le regole del tuo server, le località della mappa e la tua economia.

I giocatori premono use sull'NPC e scrivono in chat. Il tuo addon invia il messaggio insieme agli oggetti vicini (il banco del negozio, il distributore, la porta della prigione) e agli eventi recenti ("un giocatore è stato arrestato", "l'allarme della banca sta suonando"). Il personaggio risponde con un tag di emozione su ogni riga e con azioni come { "name": "OPEN_DOOR", "targetId": "jail_door" } che l'addon esegue sul server.

La group chat (piani Pro e Team) mette fino a sei personaggi in una stessa conversazione, così una banda di NPC può discutere con un giocatore tutti insieme. Una Conversation Flow può guidare una scena più lunga, come il briefing di una rapina di roleplay, e restituire parole chiave di checkpoint (flowState) a cui l'addon reagisce.

Organizzare una serata quiz

Il motore dei quiz (piano Team) trasforma un palco, dei buzzer e un tabellone dei punteggi in un evento del server:

  1. Costruisci il set di domande nella dashboard Neocortex: una serata di quiz sul server, un quiz sulla lore per i nuovi roleplayer, o un controllo delle regole che i nuovi giocatori devono superare prima di ottenere un lavoro.
  2. Un NPC presentatore sul palco apre il round.
  3. I giocatori rispondono in chat, e l'addon instrada ogni risposta al motore dei quiz tramite /v3/quiz.
  4. Il presentatore annuncia chi ha ragione, e il motore dei quiz gestisce punteggi e classifica.
  5. Tra un round e l'altro, il tuo addon disegna la classifica su un pannello HUD.

Screenshot in gioco di Garry's Mod Screenshot: Garry's Mod © Valve

Aiutanti che seguono i comandi vocali

Dai a ogni giocatore un NPC aiutante che ascolta: "seguimi", "aspetta qui", "fai la guardia alla porta", "porta due casse". Nella dashboard Neocortex progetti un set di comandi come attori, azioni e oggetti: attore "helper", azioni "follow", "wait", "guard" e "bring", oggetti "me", "door" e "crate".

I giocatori parlano in modo naturale, e l'addon riceve subito i comandi riconosciuti, anche più azioni e quantità in una sola frase. Funziona con push-to-talk o con ascolto continuo, in più lingue, senza un viaggio di andata e ritorno nel cloud. Poiché gira sul computer del giocatore, il lato client invia al server i comandi riconosciuti.

Voice Commands è un SDK con licenza: contattaci per una licenza di Voice Commands.

Il codice dell'addon NPC IA per Garry's Mod

Tutto ciò che tocca l'API gira lato server. Il server legge lo stato di gioco e lo invia con il messaggio del giocatore a un personaggio Neocortex tramite /v3/chat, poi mostra la risposta come sottotitoli, riproduce la voce da /v3/audio/generate o /v3/audio/stream ed esegue le azioni che il personaggio restituisce:

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

Regole della casa per gli NPC IA

I server di Garry's Mod stabiliscono le proprie regole, quindi esegui gli addon NPC IA solo su server che possiedi o dove il proprietario è d'accordo, e dì ai giocatori che stanno parlando con un'IA. Segui le regole dello Steam Workshop quando pubblichi, e assicurati che ogni proprietario di server usi la propria chiave API Neocortex. Aggiungi un cooldown per giocatore, così un giocatore non può spammare l'NPC.

In sintesi per i proprietari di server

Cinque passi ti portano da una cartella vuota a un NPC che parla:

  1. Crea una cartella per l'addon con un file Lua lato server e un'entità NPC spawnabile.
  2. Progetta i tuoi personaggi nella dashboard Neocortex: un negoziante, un presentatore di quiz con un set di domande, e un set di comandi per gli aiutanti.
  3. Chiama /v3/chat e /v3/quiz dal server con HTTP(), e invia le risposte ai giocatori con la libreria net.
  4. Conserva la chiave API in un file di configurazione lato server, mai nel Lua client né in un upload sul Workshop.
  5. Prova su un listen server locale con un amico prima di lanciarlo su un server pubblico.

Inizia dal negoziante. Un personaggio, una chiamata HTTP() e un hook della chat bastano a mostrare ai giocatori cosa sa fare un NPC Neocortex, e il quiz show si appoggia sullo stesso codice server. Per capire come funzionano i comandi vocali sul computer del giocatore, leggi comandi vocali sul dispositivo per mod di gioco. Per le mod a livello di motore Source, vedi la nostra guida alla mod NPC IA per Half-Life 2.

Versioni degli strumenti e link verificati a ottobre 2026. Gli strumenti per le mod cambiano spesso; controlla la pagina di ciascun progetto per l'ultima release.

Domande frequenti

Si possono aggiungere NPC IA a Garry's Mod?

Sì. Gli addon di Garry's Mod sono scritti in Lua e il gioco ha una funzione HTTP() integrata, quindi un addon lato server può inviare ciò che dicono i giocatori a un personaggio IA e agire in base alla risposta. Neocortex fornisce il personaggio, la sua voce e le azioni che restituisce.

Un addon di Garry's Mod può chiamare un'API web?

Sì. La funzione globale HTTP() e gli helper http.Fetch e http.Post fanno richieste asincrone dal server o dal client. Per un addon NPC IA, fai le chiamate sul server, così la tua chiave API Neocortex non raggiunge mai i giocatori.

Come organizzo un quiz show su un server di Garry's Mod?

Crea un NPC presentatore, instrada le risposte in chat dei giocatori a un motore di quiz e mostra i punteggi su un pannello HUD. Il motore di quiz Neocortex gestisce domande, punteggi e classifica, quindi il tuo addon si occupa solo del palco e della chat.

Gli NPC di Garry's Mod possono seguire comandi vocali?

Sì, con un componente lato client. Neocortex Voice Commands gira sul PC di ogni giocatore e trasforma frasi come "seguimi" o "fai la guardia alla porta" in comandi che il tuo addon riceve subito, anche offline. Poiché gira sul computer del giocatore, i giocatori installano la parte vocale insieme all'addon del Workshop.

Dove conservo la chiave API su un server di Garry's Mod?

Solo sul server, per esempio in un file nella cartella dati del server che il tuo addon legge all'avvio. Non mettere mai la chiave nel Lua client né in un upload sul Workshop, perché ogni giocatore scarica quei file.

Articoli simili

Continua a leggere