Neocortex Logo

Addon PNJ IA pour Garry's Mod : PNJ intelligents et présentateur de quiz

Créez un addon PNJ IA pour Garry's Mod en Lua : des PNJ intelligents pour les serveurs bac à sable et roleplay, un présentateur de quiz multijoueur avec classement, et des commandes vocales.

Neocortex TeamThe team behind Neocortex

· 6 min de lecture

Créez un addon PNJ IA pour Garry's Mod en Lua : des PNJ intelligents pour les serveurs bac à sable et roleplay, un présentateur de quiz multijoueur avec classement, et des commandes vocales.

Un addon PNJ IA pour Garry's Mod est un addon Lua qui envoie ce que disent les joueurs à un personnage IA grâce à la fonction intégrée HTTP() du jeu, puis agit selon la réponse. Les serveurs Garry's Mod vivent de ce que les joueurs inventent, et des PNJ qui restent plantés là sont une occasion manquée. Avec Neocortex, les serveurs bac à sable et roleplay obtiennent des personnages qui parlent vraiment : un commerçant qui marchande, un présentateur de quiz qui anime un jeu pour tout le serveur, et des assistants qui suivent des commandes vocales. Neocortex fournit les personnages IA, les Conversation Flows, le moteur de quiz et les commandes vocales embarquées ; Lua les relie à votre serveur.

Capture d'écran en jeu de Garry's Mod Capture d'écran : Garry's Mod © Valve

Ce qui tourne sur le serveur et ce qui tourne sur le client

Les addons Garry's Mod sont des dossiers de scripts Lua et de contenus, installés dans garrysmod/addons ou abonnés via le Steam Workshop. Lua s'exécute dans deux domaines, et un addon PNJ IA se répartit proprement entre eux. Le wiki de Garry's Mod documente chaque fonction.

TâcheDomaineOutil
PNJ, entités, logique de jeuServeurEntités Lua
Appeler Neocortex, garder la clé APIServeurHTTP(), http.Fetch, http.Post
Envoyer les réponses aux joueursServeur vers clientLa bibliothèque net
Sous-titres et HUDClientchat.AddText ou un panneau HUD personnalisé
Lecture de la voixClientsound.PlayURL
Commandes vocalesClientNeocortex Voice Commands sur la machine du joueur

Quelques détails comptent. HTTP() lance une requête asynchrone avec une URL, une méthode, des en-têtes, un corps et des callbacks, et http.Fetch et http.Post l'enveloppent pour les cas simples ; le callback de succès se déclenche aussi pour les codes d'erreur, il faut donc toujours vérifier le code. sound.PlayURL lit des fichiers audio externes, servez donc la voix générée depuis un petit point d'accès que vous contrôlez, et les clients peuvent la diffuser sans jamais voir la clé API. Les modules natifs (gmsv_ pour le serveur, gmcl_ pour le client) vont dans garrysmod/lua/bin et se chargent avec require, mais ils ne peuvent pas être installés via un addon Workshop : tout ce qui est natif fait l'objet d'une installation séparée pour les joueurs ou les propriétaires de serveur.

Des PNJ de roleplay avec lesquels les joueurs peuvent parler

Sur un serveur roleplay, donnez à la ville son casting : un commerçant qui marchande et se souvient de ceux qui l'ont floué, un barman qui connaît le lore du serveur, un standardiste de police qui réagit à ce que les joueurs signalent. Chaque personnage reçoit une Personality, un réglage d'Emotion et une base de connaissances dans l'éditeur Neocortex, par exemple les règles de votre serveur, les lieux de la carte et votre économie.

Les joueurs appuient sur utiliser près du PNJ et tapent dans le chat. Votre addon envoie le message accompagné des objets proches (le comptoir du magasin, le distributeur, la porte de la prison) et des événements récents (« un joueur a été arrêté », « l'alarme de la banque sonne »). Le personnage répond avec une balise d'émotion sur chaque ligne, et avec des actions comme { "name": "OPEN_DOOR", "targetId": "jail_door" } que l'addon exécute sur le serveur.

Le chat de groupe (forfaits Pro et Team) place jusqu'à six personnages dans une même conversation, si bien qu'un groupe de PNJ peut se disputer avec un joueur en même temps. Un Conversation Flow peut guider une scène plus longue, comme un briefing de braquage en roleplay, et renvoyer des mots-clés de point de contrôle (flowState) auxquels l'addon réagit.

Organiser une soirée quiz

Le moteur de quiz (forfait Team) transforme une scène, quelques buzzers et un tableau des scores en événement pour le serveur :

  1. Vous construisez l'ensemble de questions dans le tableau de bord Neocortex : une soirée de questions-réponses pour le serveur, un quiz sur le lore pour les nouveaux roleplayers, ou un contrôle des règles que les nouveaux joueurs doivent réussir avant d'obtenir un métier.
  2. Un PNJ hôte sur la scène ouvre la manche.
  3. Les joueurs répondent dans le chat, et l'addon transmet chaque réponse au moteur de quiz via /v3/quiz.
  4. L'hôte annonce qui a juste, et le moteur de quiz gère le score et le classement.
  5. Entre les manches, votre addon affiche le classement sur un panneau HUD.

Capture d'écran en jeu de Garry's Mod Capture d'écran : Garry's Mod © Valve

Des assistants qui suivent les commandes vocales

Donnez à chaque joueur un PNJ assistant qui écoute : « suis-moi », « attends ici », « garde la porte », « apporte deux caisses ». Dans le tableau de bord Neocortex, vous concevez un jeu de commandes sous forme d'acteurs, d'actions et d'objets : acteur « helper », actions « follow », « wait », « guard » et « bring », objets « me », « door » et « crate ».

Les joueurs parlent naturellement, et l'addon reçoit instantanément les commandes reconnues, y compris plusieurs actions et quantités dans une même phrase. Cela fonctionne en push-to-talk ou en écoute permanente, dans plusieurs langues, sans aller-retour vers le cloud. Comme cela tourne sur la machine du joueur, le côté client envoie les commandes reconnues au serveur.

Voice Commands est un SDK sous licence : contactez-nous pour une licence Voice Commands.

Le code de l'addon PNJ IA pour Garry's Mod

Tout ce qui touche à l'API s'exécute côté serveur. Le serveur lit l'état du jeu et l'envoie avec le message du joueur à un personnage Neocortex via /v3/chat, puis affiche la réponse en sous-titres, joue la voix issue de /v3/audio/generate ou /v3/audio/stream, et exécute les actions renvoyées par le personnage :

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

Règles de bonne conduite pour les PNJ IA

Les serveurs Garry's Mod fixent leurs propres règles : n'exécutez donc des addons PNJ IA que sur des serveurs que vous possédez ou dont le propriétaire est d'accord, et indiquez aux joueurs qu'ils parlent à une IA. Suivez les règles du Steam Workshop lorsque vous publiez, et assurez-vous que chaque propriétaire de serveur utilise sa propre clé API Neocortex. Ajoutez un délai d'attente par joueur pour empêcher quelqu'un de spammer le PNJ.

L'essentiel pour les propriétaires de serveur

Cinq étapes vous mènent d'un dossier vide à un PNJ qui parle :

  1. Créez un dossier d'addon avec un fichier Lua côté serveur et une entité PNJ qu'on peut faire apparaître.
  2. Concevez vos personnages dans le tableau de bord Neocortex : un commerçant, un présentateur de quiz avec un ensemble de questions, et un jeu de commandes pour les assistants.
  3. Appelez /v3/chat et /v3/quiz depuis le serveur avec HTTP(), et envoyez les réponses aux joueurs avec la bibliothèque net.
  4. Gardez la clé API dans un fichier de configuration côté serveur, jamais dans le Lua client ni dans un envoi Workshop.
  5. Testez sur un serveur d'écoute local avec un ami avant de le lancer sur un serveur public.

Commencez par le commerçant. Un personnage, un appel HTTP() et un hook de chat suffisent pour montrer à vos joueurs ce que fait un PNJ Neocortex, et le quiz s'appuie sur le même code serveur. Pour comprendre comment fonctionnent les commandes vocales sur la machine du joueur, lisez commandes vocales embarquées pour mods de jeux. Pour les mods de moteur Source, voyez notre guide mod PNJ IA pour Half-Life 2.

Versions des outils et liens vérifiés en octobre 2026. Les outils de modding changent souvent ; consultez la page de chaque projet pour la dernière version.

Questions fréquentes

Peut-on ajouter des PNJ IA à Garry's Mod ?

Oui. Les addons Garry's Mod s'écrivent en Lua, et le jeu dispose d'une fonction HTTP() intégrée ; un addon côté serveur peut donc envoyer ce que disent les joueurs à un personnage IA et agir selon la réponse. Neocortex fournit le personnage, sa voix et les actions qu'il renvoie.

Un addon Garry's Mod peut-il appeler une API web ?

Oui. La fonction globale HTTP() et les fonctions d'aide http.Fetch et http.Post envoient des requêtes asynchrones depuis le serveur ou le client. Pour un addon PNJ IA, effectuez les appels côté serveur afin que votre clé API Neocortex n'atteigne jamais les joueurs.

Comment organiser un jeu-concours sur un serveur Garry's Mod ?

Faites apparaître un PNJ hôte, acheminez les réponses des joueurs dans le chat vers un moteur de quiz et affichez les scores sur un panneau HUD. Le moteur de quiz Neocortex gère les questions, le score et le classement, si bien que votre addon ne s'occupe que de la scène et du chat.

Les PNJ de Garry's Mod peuvent-ils suivre des commandes vocales ?

Oui, avec un composant côté client. Neocortex Voice Commands tourne sur le PC de chaque joueur et transforme des phrases comme "follow me" ou "guard the door" en commandes que votre addon reçoit instantanément, hors ligne. Comme cela tourne sur la machine du joueur, les joueurs installent la partie vocale en plus de l'addon Workshop.

Où garder la clé API sur un serveur Garry's Mod ?

Uniquement sur le serveur, par exemple dans un fichier du dossier de données du serveur que votre addon lit au démarrage. Ne placez jamais la clé dans du Lua côté client ni dans un envoi Workshop, car chaque joueur télécharge ces fichiers.

Articles similaires

À lire aussi