Come creare NPC IA in Godot | Guida 2026
Come creare NPC IA in Godot nel 2026: HTTPRequest e un'API di modelli, l'SDK Godot di Neocortex, un modello locale con NobodyWho e il plugin Player2.
Sercan AltundasFounder of Neocortex
· 9 min di lettura

Crei un NPC IA in Godot inviando a un modello linguistico ciò che dice il giocatore, e mostrando o pronunciando la risposta: con il nodo HTTPRequest di Godot e un'API di modelli, con un SDK per personaggi, oppure con un add-on che esegue un modello sul computer del giocatore. Godot non ha una funzione propria per i personaggi IA, quindi ogni strada aggiunge GDScript o un add-on.
Questa guida è per sviluppatori Godot 4 che vogliono personaggi che rispondono con parole proprie invece che da un albero di dialogo. Copre quattro modi: HTTPRequest con un'API di modelli, l'SDK Godot di Neocortex, un modello locale con NobodyWho e il plugin Player2 AI NPC. Ogni modo include i passaggi, ciò che richiede e il costo, seguiti da una tabella di confronto, consigli validi per ogni metodo e domande frequenti.
4 modi per creare NPC IA in Godot
Tutti e quattro iniziano con un nodo nella scena che rappresenta il personaggio e un input per il giocatore, una LineEdit o un microfono. Si differenziano per dove gira il modello, chi ne paga l'uso e quanto GDScript scrivi.
Metodo 1: HTTPRequest e un'API di modelli
Questa strada usa solo ciò che è incluso in Godot. Il nodo HTTPRequest è "un nodo capace di inviare richieste HTTP", quindi uno script può inviare la battuta del giocatore a un fornitore di modelli e leggere la risposta. Come esempio usiamo l'API Responses di OpenAI.
Cosa serve: una chiave API di un fornitore di modelli e un po' di GDScript.
- Crea una chiave API. Per OpenAI, creala su platform.openai.com/api-keys.
- Aggiungi un nodo HTTPRequest. Rendilo figlio della scena del tuo NPC e collega il segnale
request_completeda una funzione dello script dell'NPC. - Scrivi il personaggio. Tieni una stringa di istruzioni di sistema con nome, ruolo, tono e limiti del personaggio.
- Invia la battuta. Costruisci un corpo JSON con il modello, le istruzioni e il messaggio del giocatore, poi chiama
request()conhttps://api.openai.com/v1/responses, le intestazioniAuthorization: Bearer <key>eContent-Type: application/json, il metodo POST e il corpo. - Leggi la risposta. Nel gestore di
request_completed, interpreta il corpo come JSON e metti il testo in una Label o in una RichTextLabel sopra l'NPC. - Conserva la cronologia. Salva i turni recenti in un Array e inviali con ogni richiesta; il modello dimentica tutto tra una chiamata e l'altra.
- Costruisci il resto. Voce, lip sync e azioni sono lavoro tuo: altre chiamate API per il parlato e regole tue per trasformare le risposte in gameplay.
- Proteggi la chiave. La documentazione di Godot consiglia TLS e sconsiglia di inviare dati sensibili. Una chiave in un gioco esportato può essere letta, quindi metti un tuo server davanti al fornitore prima della pubblicazione.
Costo: Godot è gratuito. Paghi le tariffe a token del fornitore.
Dove non basta: memoria, voce, azioni, sicurezza e il server per le chiavi sono tutti da costruire e mantenere da te.
Metodo 2: L'SDK Godot di Neocortex
Neocortex è il nostro prodotto, quindi leggi questa sezione tenendolo presente. Progetti il personaggio in un editor visivo nel browser, poi lo usi in Godot tramite un add-on open source (Apache 2.0). Personalità, conoscenze, emozioni, voce e azioni sono nodi nell'editor; in Godot aggiungi nodi già pronti. La pagina sugli NPC IA per Godot contiene l'elenco completo.
Cosa serve: Godot 4.7 o successivo e un account Neocortex con una chiave API.
- Crea il personaggio. Nella dashboard, apri Characters, clicca Create New Character, inserisci un nome e clicca Create. Costruiscilo nell'editor a nodi.
- Provalo nel browser. Clicca Play in alto a destra nell'editor.
- Crea una chiave API. Apri API Keys nella dashboard.
- Installa l'add-on. Scarica l'ultima release da
https://github.com/neocortex-link/neocortex-godot-sdk/releases/lateste copiaaddons/neocortex-godot-sdknella cartellaaddonsdel progetto. - Abilitalo. Apri Project > Project Settings > Plugins e abilita Neocortex. Incolla la chiave API nel dock Neocortex.
- Aggiungi una chat in un passaggio. Scegli Project > Tools > Neocortex > Complete Text Chat oppure Complete Voice Chat. Questo aggiunge una chat funzionante alla scena; scegli il personaggio dal menu a tendina dell'Inspector.
- Collegalo al gioco. Usa il nodo
NeocortexSmartAgentper il personaggio,NeocortexAudioReceiverper il microfono,NeocortexFaceAnimatorper il lip sync sulle blend shape in stile ARKit,NeocortexInteractableper gli oggetti che il personaggio deve conoscere eNeocortexEventLoggerper gli eventi accaduti. I nodi azione nell'editor inviano nomi di azioni su cui il tuo GDScript può agire. - Apri gli esempi. Dal dock Neocortex si aprono sette scene di esempio e un launcher: Text Chat, Audio Chat, Actions, Interactables, Group Chat, Usage Gating e Quiz Show.
Limiti da conoscere: la registrazione si ferma dopo 29 secondi, i suoni più brevi di 0,15 secondi non vengono inviati e le richieste di chat scadono dopo 30 secondi.
Costo: Starter costa 9 €, Pro 29 € e Team 99 € al mese con fatturazione annuale, oppure 11 €, 35 € e 119 € con fatturazione mensile. L'uso commerciale richiede Pro o Team. Vedi prezzi.
Dove non basta: i personaggi girano nel nostro cloud, quindi il gioco ha bisogno di una connessione. Un gioco esportato porta con sé la sua chiave API, quindi imposta limiti di utilizzo. La chat di gruppo richiede Pro o Team, il quiz richiede Team, e la nostra documentazione non elenca ogni destinazione di esportazione.
Metodo 3: Un modello locale con NobodyWho
NobodyWho è un motore di inferenza open source che esegue modelli linguistici sul computer del giocatore, con un add-on per Godot. Il suo readme dice che non servono "chiavi API" e che non ci sono costi nascosti.
Cosa serve: Godot 4.6 o successivo (secondo la sua documentazione Godot) e un modello in formato GGUF.
- Installalo. In Godot, apri la scheda AssetLib, cerca NobodyWho, scaricalo e importalo con l'opzione Ignore asset root selezionata. Oppure copia
addons/nobodywhoda una release nel progetto. Riavvia o ricarica l'editor. - Scegli un modello. Funziona qualsiasi modello GGUF. Il readme suggerisce Qwen3 0.6B per iniziare; i modelli remoti si scaricano e vengono messi in cache al primo uso.
- Crea la chat. In uno script, chiama
await NobodyWhoChat.create(<model path>, {}). - Fai una domanda. Chiama
chat.ask(<player text>)e usaawaitsulcompleted()del risultato. La documentazione dice di usare sempre await subito sul valore restituito. - Scrivi il ruolo. Dai alla chat le istruzioni del personaggio, seguendo la sezione Chat della documentazione di NobodyWho.
- Controlla le piattaforme. NobodyWho supporta Godot su desktop e Android. Non ha esportazioni per iOS o web.
Costo: gratuito per uso commerciale con licenza EUPL-1.2. Se modifichi il codice di NobodyWho stesso, quelle modifiche devono essere rese open source.
Dove non basta: la velocità e la qualità della risposta dipendono dall'hardware del giocatore e dalla dimensione del modello, e il modello aumenta il download. Le funzioni vocali sono elencate per il motore; verifica se il binding Godot le include prima di contarci.
Metodo 4: Il plugin Player2 AI NPC
Player2 è un'app desktop con API locali per giochi e mod. Il suo plugin Godot "usa API IA gratuite dall'app Player2" e si connette quando l'app è aperta.
Cosa serve: Godot 4.5 (come indicato nell'Asset Library), un ID client da sviluppatore Player2 e l'app Player2.
- Installa il plugin. Scaricalo dalla Godot Asset Library o da GitHub, e trascina la cartella
addonsnel progetto. - Aggiungi il tuo ID client. Crealo su player2.game/profile/developer e inseriscilo in Project Settings > Player2 > Game Key.
- Aggiungi il nodo NPC. Aggiungi un nodo Player2 AI NPC alla scena e modifica la descrizione dell'agente.
- Collega la chat. Chiama la funzione
chatdel nodo con il testo del giocatore e collega il suo segnalechat_receivedper mostrare le risposte. Chiamanotifyper informare l'agente degli eventi del mondo. - Aggiungi la voce. Imposta un Voice ID nel Character Config oppure aggiungi un nodo
Player2TTS; per l'input vocale, aggiungiPlayer2STTe abilita l'input audio in Project Settings > Audio. - Avvia Player2. Apri l'app Player2; il plugin si connette automaticamente.
Costo: gratuito per i creatori, secondo le pagine di Player2. Il plugin è GPLv3.
Dove non basta: il sito di Player2 dice che le sue API locali funzionano con l'app aperta, quindi pianifica cosa vedranno i giocatori senza l'app. Verifica la licenza GPLv3 rispetto al tuo progetto.
I quattro metodi a confronto
| Fattore | HTTPRequest e un'API | SDK Neocortex | NobodyWho | Plugin Player2 |
|---|---|---|---|---|
| Dove si definisce il personaggio | Stringhe in GDScript | Editor visivo a nodi nel browser | Il tuo GDScript | Descrizione del nodo in Godot |
| Dove gira il modello | Cloud del fornitore | Cloud di Neocortex | Dispositivo del giocatore | Tramite l'app Player2 |
| Versione di Godot | 4.x con HTTPRequest | 4.7 o successiva | 4.6 o successiva | 4.5 indicata |
| Voce | Da costruire da sé | Inclusa, con lip sync | Elencata per il motore | Nodi TTS e STT |
| Licenza dell'add-on | Non necessaria | Apache 2.0 | EUPL-1.2 | GPLv3 |
| Costo iniziale | Tariffe a token del fornitore | Da 9 € al mese | Gratuito | Gratuito per i creatori |
| Competenze richieste | GDScript, HTTP, un server | Copiare un add-on, aggiungere nodi | GDScript, scelta del modello | Aggiungere un nodo |
HTTPRequest dà il controllo completo con più codice. NobodyWho è la strada offline, legata all'hardware del giocatore. Neocortex tiene i personaggi in un editor ospitato con voce, lip sync ed esempi. Player2 è il nodo più rapido da aggiungere e dipende dalla sua app.
Consigli per risultati migliori in Godot
Queste abitudini aiutano con ogni metodo.
- Tieni le chiavi fuori dagli export. Tutto ciò che è in un progetto esportato può essere letto. Tieni fuori dal controllo di versione i file di impostazione con le chiavi, e usa un server o limiti di utilizzo per giocatore e per personaggio.
- Mostra che l'NPC ha sentito il giocatore. Passa a un'animazione di "pensiero" o mostra un'etichetta nel momento in cui parte la richiesta, così l'attesa della risposta non sembra mai un gioco bloccato.
- Racconta al personaggio la scena. Passa oggetti vicini ed eventi recenti con ogni messaggio, così l'NPC parla della stanza in cui si trova.
- Lascia che sia il GDScript a decidere sulle azioni. Tieni una breve lista delle azioni che un personaggio può richiedere, e controllane ognuna nel codice prima che venga eseguita.
- Usa un albero di dialogo per la trama. Tieni le battute che fanno avanzare la storia in un add-on di dialoghi scritti e usa il personaggio IA per tutto il resto. Il nostro articolo sui plugin Godot elenca gli add-on per la parte scritta.
Scegliere il metodo giusto per Godot
HTTPRequest e un'API di modelli fanno al caso tuo se non vuoi add-on, vuoi il controllo completo di ogni richiesta e puoi far girare un piccolo server per la chiave.
L'SDK Neocortex fa al caso tuo se vuoi progettare i personaggi visivamente, provarli nel browser e avere voce, lip sync, azioni ed esempi in Godot 4.7, con lo stesso personaggio utilizzabile in Unity e Unreal Engine.
NobodyWho fa al caso tuo se il gioco deve funzionare offline senza costi di esercizio, su desktop o Android.
Il plugin Player2 fa al caso tuo se i tuoi giocatori usano già l'app Player2, o se stai facendo un prototipo e vuoi il minor numero di passaggi.
Per altre scelte, vedi i migliori strumenti per NPC IA in Godot, e se stai ancora scegliendo il motore, Godot vs Unity.
Domande frequenti
Posso creare NPC IA in Godot gratis?
Sì. NobodyWho è gratuito e fa girare il modello in locale, Player2 è gratuito per i creatori. Un'API di modelli che richiami da sola addebita a token.
Godot ha NPC IA integrati?
No. Godot ti offre il nodo HTTPRequest per le chiamate web, ma nessun modello linguistico né un sistema per personaggi. Il nostro articolo Godot AI copre ciò che esiste intorno al motore.
Quale versione di Godot mi serve?
Neocortex richiede Godot 4.7 o successivo, NobodyWho 4.6 o successivo, e il plugin Player2 indica 4.5. HTTPRequest fa parte di Godot 4.
Un NPC IA in Godot può funzionare offline?
Sì, con un modello locale come NobodyWho su desktop o Android. Le strade nel cloud, incluso Neocortex, richiedono una connessione.
L'SDK Godot di Neocortex è open source?
Sì. È rilasciato con licenza Apache 2.0, e il codice è su GitHub in neocortex-link/neocortex-godot-sdk. Segnalazioni di bug e idee sono benvenute lì.
Gli NPC IA in Godot funzionano nelle esportazioni web?
Dipende dalla strada. NobodyWho non ha un'esportazione web. Per i giochi browser fuori da Godot, Neocortex ha anche una Web SDK.






