Neocortex Logo

Comment créer des PNJ IA dans Godot | Guide 2026

Comment créer des PNJ IA dans Godot en 2026 : HTTPRequest et une API de modèle, le SDK Godot de Neocortex, un modèle local avec NobodyWho, et le plugin Player2.

Sercan AltundasFounder of Neocortex

· 9 min de lecture

Comment créer des PNJ IA dans Godot en 2026 : HTTPRequest et une API de modèle, le SDK Godot de Neocortex, un modèle local avec NobodyWho, et le plugin Player2.

Vous créez un PNJ IA dans Godot en envoyant ce que dit le joueur à un modèle de langage, puis en affichant ou en prononçant la réponse : via le nœud HTTPRequest de Godot et une API de modèle, via un SDK de personnages, ou via un module complémentaire qui fait tourner un modèle sur la machine du joueur. Godot n'a pas de fonction de personnage IA en propre, donc chaque voie ajoute du GDScript ou un module complémentaire.

Ce guide s'adresse aux développeurs Godot 4 qui veulent des personnages qui répondent avec leurs propres mots, et non à partir d'un arbre de dialogue. Il couvre quatre méthodes : HTTPRequest avec une API de modèle, le SDK Godot de Neocortex, un modèle local avec NobodyWho, et le plugin Player2 pour PNJ IA. Chacune présente ses étapes, ce qu'elle demande et ce qu'elle coûte, suivies d'un tableau comparatif, de conseils valables pour toutes les méthodes et de questions fréquentes.

4 façons de créer des PNJ IA dans Godot

Les quatre méthodes commencent par un nœud de votre scène qui représente le personnage, et par une entrée pour le joueur, un LineEdit ou un micro. Elles diffèrent par l'endroit où tourne le modèle, par qui le paie et par la quantité de GDScript à écrire.

Méthode 1 : HTTPRequest et une API de modèle

Cette voie n'utilise que ce qui est livré avec Godot. Le nœud HTTPRequest est « un nœud capable d'envoyer des requêtes HTTP », donc un script peut envoyer la réplique du joueur à un fournisseur de modèles et lire la réponse. Nous prenons l'API Responses d'OpenAI comme exemple.

Ce qu'il vous faut : une clé API auprès d'un fournisseur de modèles et un peu de GDScript.

  1. Créer une clé API. Pour OpenAI, créez-la sur platform.openai.com/api-keys.
  2. Ajouter un nœud HTTPRequest. Faites-en un enfant de la scène de votre PNJ et connectez son signal request_completed à une fonction du script du PNJ.
  3. Écrire le personnage. Gardez une chaîne d'instructions système avec le nom, le rôle, le ton et les limites du personnage.
  4. Envoyer la réplique. Construisez un corps JSON avec le modèle, les instructions et le message du joueur, puis appelez request() avec https://api.openai.com/v1/responses, les en-têtes Authorization: Bearer <key> et Content-Type: application/json, la méthode POST et le corps.
  5. Lire la réponse. Dans le gestionnaire request_completed, analysez le corps comme du JSON et placez le texte dans un Label ou un RichTextLabel au-dessus du PNJ.
  6. Garder l'historique. Stockez les derniers échanges dans un Array et envoyez-les avec chaque requête ; le modèle oublie tout entre les appels.
  7. Ajouter le reste. La voix, la synchronisation labiale et les actions sont à votre charge : d'autres appels API pour la parole, et vos propres règles pour transformer les réponses en gameplay.
  8. Protéger la clé. La documentation de Godot recommande TLS et déconseille d'envoyer des informations sensibles. Une clé dans un jeu exporté peut être lue, donc placez votre propre serveur devant le fournisseur avant la sortie.

Coût : Godot est gratuit. Vous payez les tarifs par jeton du fournisseur.

Limites : la mémoire, la voix, les actions, la sécurité et le serveur de clés sont tous à construire et à maintenir par vos soins.

Méthode 2 : le SDK Godot de Neocortex

Neocortex est notre produit, gardez-le à l'esprit en lisant cette section. Vous concevez le personnage dans un éditeur visuel dans le navigateur, puis vous l'utilisez dans Godot grâce à un module complémentaire open source (Apache 2.0). La personnalité, les connaissances, les émotions, la voix et les actions sont des nœuds dans l'éditeur ; dans Godot, vous ajoutez des nœuds prêts à l'emploi. La page Godot AI NPC donne la liste complète.

Ce qu'il vous faut : Godot 4.7 ou plus récent, et un compte Neocortex avec une clé API.

  1. Créer le personnage. Dans le tableau de bord, ouvrez Characters, cliquez sur Create New Character, saisissez un nom et cliquez sur Create. Construisez-le dans l'éditeur de nœuds.
  2. Le tester dans le navigateur. Cliquez sur Play en haut à droite de l'éditeur.
  3. Créer une clé API. Ouvrez API Keys dans le tableau de bord.
  4. Installer le module. Téléchargez la dernière version depuis https://github.com/neocortex-link/neocortex-godot-sdk/releases/latest et copiez addons/neocortex-godot-sdk dans le dossier addons de votre projet.
  5. L'activer. Ouvrez Project > Project Settings > Plugins et activez Neocortex. Collez votre clé API dans le panneau Neocortex.
  6. Ajouter un chat en une étape. Choisissez Project > Tools > Neocortex > Complete Text Chat ou Complete Voice Chat. Cela ajoute un chat fonctionnel à la scène ; choisissez le personnage dans la liste déroulante de l'Inspecteur.
  7. Le brancher à votre jeu. Utilisez le nœud NeocortexSmartAgent pour le personnage, NeocortexAudioReceiver pour le micro, NeocortexFaceAnimator pour la synchronisation labiale sur les blend shapes de style ARKit, NeocortexInteractable pour les objets que le personnage doit connaître, et NeocortexEventLogger pour les événements survenus. Les nœuds d'action dans l'éditeur envoient des noms d'action que votre GDScript peut exploiter.
  8. Ouvrir les exemples. Sept scènes d'exemple et un lanceur s'ouvrent depuis le panneau Neocortex : Text Chat, Audio Chat, Actions, Interactables, Group Chat, Usage Gating et Quiz Show.

Limites à connaître : l'enregistrement s'arrête à 29 secondes, les sons de moins de 0,15 seconde ne sont pas envoyés, et les requêtes de chat expirent après 30 secondes.

Coût : Starter coûte 9 €, Pro 29 € et Team 99 € par mois facturés annuellement, ou 11 €, 35 € et 119 € facturés mensuellement. L'usage commercial nécessite Pro ou Team. Voir tarifs.

Limites : les personnages tournent dans notre cloud, donc le jeu a besoin d'une connexion. Un jeu exporté embarque sa clé API, donc fixez-y des limites d'usage. Le chat de groupe nécessite Pro ou Team, le quiz nécessite Team, et notre documentation ne liste pas toutes les cibles d'export.

Commencer

Méthode 3 : un modèle local avec NobodyWho

NobodyWho est un moteur d'inférence open source qui fait tourner des modèles de langage sur la machine du joueur, avec un module complémentaire Godot. Son readme indique qu'il ne nécessite « aucune clé API » et n'a pas de frais cachés.

Ce qu'il vous faut : Godot 4.6 ou plus récent (selon sa documentation Godot), et un modèle au format GGUF.

  1. L'installer. Dans Godot, ouvrez l'onglet AssetLib, recherchez NobodyWho, téléchargez-le et importez-le en cochant Ignore asset root. Vous pouvez aussi copier addons/nobodywho depuis une version dans le dossier de votre projet. Redémarrez ou rechargez l'éditeur.
  2. Choisir un modèle. Tout modèle GGUF fonctionne. Le readme propose Qwen3 0,6B pour commencer ; les modèles distants se téléchargent et se mettent en cache à la première utilisation.
  3. Créer le chat. Dans un script, appelez await NobodyWhoChat.create(<model path>, {}).
  4. Poser une question. Appelez chat.ask(<player text>) et attendez completed() du résultat avec await. La documentation précise qu'il faut toujours attendre la valeur renvoyée immédiatement.
  5. Écrire le rôle. Donnez au chat les instructions de votre personnage, en suivant la section Chat de la documentation NobodyWho.
  6. Vérifier vos cibles. NobodyWho prend en charge Godot sur ordinateur et Android. Il n'a pas d'export iOS ni web.

Coût : gratuit pour un usage commercial sous EUPL-1.2. Si vous modifiez le code de NobodyWho lui-même, ces modifications doivent être publiées en open source.

Limites : la vitesse et la qualité des réponses dépendent du matériel du joueur et de la taille du modèle, et le modèle alourdit le téléchargement. Les fonctions vocales sont listées pour le moteur ; vérifiez si la liaison Godot les propose avant de les prévoir.

Méthode 4 : le plugin Player2 pour PNJ IA

Player2 est une application de bureau avec des API locales pour les jeux et les mods. Son plugin Godot « utilise des API IA gratuites de l'application Player2 » et se connecte lorsque l'application est ouverte.

Ce qu'il vous faut : Godot 4.5 (comme indiqué sur l'Asset Library), un identifiant client développeur Player2 et l'application Player2.

  1. Installer le plugin. Récupérez-le depuis l'Asset Library de Godot ou depuis GitHub, et glissez le dossier addons dans votre projet.
  2. Ajouter votre identifiant client. Créez-en un sur player2.game/profile/developer et saisissez-le sous Project Settings > Player2 > Game Key.
  3. Ajouter le nœud PNJ. Ajoutez un nœud Player2 AI NPC à la scène et modifiez la description de l'agent.
  4. Connecter le chat. Appelez la fonction chat du nœud avec le texte du joueur et connectez son signal chat_received pour afficher les réponses. Appelez notify pour informer l'agent des événements du monde.
  5. Ajouter la voix. Définissez un Voice ID dans la Character Config ou ajoutez un nœud Player2TTS ; pour la saisie vocale, ajoutez Player2STT et activez l'entrée audio sous Project Settings > Audio.
  6. Lancer Player2. Ouvrez l'application Player2 ; le plugin se connecte automatiquement.

Coût : gratuit pour les créateurs, selon les pages de Player2. Le plugin est sous GPLv3.

Limites : le site de Player2 indique que ses API locales fonctionnent quand l'application est ouverte, donc prévoyez ce que voient les joueurs qui n'ont pas l'application. Vérifiez la licence GPLv3 par rapport à votre projet.

Les quatre méthodes comparées

CritèreHTTPRequest et une APISDK NeocortexNobodyWhoPlugin Player2
Où le personnage est définiChaînes dans le GDScriptÉditeur visuel de nœuds dans le navigateurVotre GDScriptDescription du nœud dans Godot
Où tourne le modèleCloud du fournisseurCloud NeocortexAppareil du joueurVia l'application Player2
Version de Godot4.x avec HTTPRequest4.7 ou plus récent4.6 ou plus récent4.5 indiqué
VoixÀ construire vous-mêmeIncluse, avec synchronisation labialeIndiquée pour le moteurNœuds TTS et STT
Licence du moduleAucune nécessaireApache 2.0EUPL-1.2GPLv3
Coût de départTarifs par jeton du fournisseurÀ partir de 9 € par moisGratuitGratuit pour les créateurs
Compétences requisesGDScript, HTTP, un serveurCopier un module, ajouter des nœudsGDScript, choix du modèleAjouter un nœud

HTTPRequest donne le contrôle total, pour le plus de code. NobodyWho est la voie hors ligne, liée au matériel du joueur. Neocortex garde les personnages dans un éditeur hébergé avec voix, synchronisation labiale et exemples. Player2 est le nœud le plus rapide à ajouter, et il dépend de son application.

Conseils pour de meilleurs résultats dans Godot

Ces bonnes pratiques valent pour toutes les méthodes.

  1. Gardez les clés hors des exports. Tout ce qui se trouve dans un projet exporté peut être lu. Gardez les fichiers de réglages contenant des clés hors du contrôle de version, et utilisez un serveur ou des limites d'usage par joueur et par personnage.
  2. Montrez que le PNJ a entendu le joueur. Passez à une animation « réflexion » ou affichez un libellé dès que la requête démarre, pour qu'une attente de réponse ne ressemble jamais à un jeu figé.
  3. Parlez au personnage de la scène. Transmettez les objets proches et les événements récents avec chaque message, pour que le PNJ parle de la pièce dans laquelle il se trouve.
  4. Laissez le GDScript trancher pour les actions. Gardez une courte liste des actions qu'un personnage peut demander, et vérifiez chacune dans le code avant son exécution.
  5. Utilisez un arbre de dialogue pour l'intrigue. Gardez les répliques qui font avancer l'histoire dans un module de dialogue scénarisé, et confiez au personnage IA tout ce qui les entoure. Notre article sur les plugins Godot recense les modules pour la partie scénarisée.

Choisir la bonne méthode pour Godot

HTTPRequest et une API de modèle vous conviennent si vous ne voulez aucun module complémentaire, un contrôle total de chaque requête, et si vous pouvez faire tourner un petit serveur pour la clé.

Le SDK Neocortex vous convient si vous voulez concevoir les personnages visuellement, les tester dans un navigateur, et obtenir voix, synchronisation labiale, actions et exemples dans Godot 4.7, avec le même personnage utilisable dans Unity et Unreal Engine.

NobodyWho vous convient si le jeu doit fonctionner hors ligne sans coût d'exploitation, sur ordinateur ou Android.

Le plugin Player2 vous convient si vos joueurs utilisent déjà l'application Player2, ou si vous prototypez et voulez le moins d'étapes possible.

Pour plus de choix, voir les meilleurs outils de PNJ IA pour Godot, et si vous hésitez encore sur un moteur, Godot vs Unity.

Questions fréquentes

Peut-on créer des PNJ IA dans Godot gratuitement ?

Oui. NobodyWho est gratuit et fait tourner le modèle localement, et Player2 est gratuit pour les créateurs. Une API de modèle que vous appelez vous-même facture au jeton.

Godot intègre-t-il des PNJ IA ?

Non. Godot vous donne le nœud HTTPRequest pour les appels web, mais ni modèle de langage ni système de personnages. Notre article Godot AI présente ce qui existe autour du moteur.

Quelle version de Godot faut-il ?

Neocortex nécessite Godot 4.7 ou plus récent, NobodyWho 4.6 ou plus récent, et le plugin Player2 indique 4.5. HTTPRequest fait partie de Godot 4.

Un PNJ IA dans Godot peut-il fonctionner hors ligne ?

Oui, avec un modèle local comme NobodyWho sur ordinateur ou Android. Les voies cloud, dont Neocortex, nécessitent une connexion.

Le SDK Godot de Neocortex est-il open source ?

Oui. Il est publié sous Apache 2.0, et le code source se trouve sur GitHub à neocortex-link/neocortex-godot-sdk. Les rapports de bugs et les idées y sont les bienvenus.

Les PNJ IA dans Godot fonctionnent-ils dans les exports web ?

Cela dépend de la voie. NobodyWho n'a pas d'export web. Pour les jeux navigateur hors Godot, Neocortex propose aussi un SDK Web.

Articles similaires

À lire aussi