Mod PNJ IA Half-Life 2 : escouades et compagnons à la voix
Planifiez un mod PNJ IA pour Half-Life 2 sur Source SDK 2013 : une escouade rebelle que vous commandez à la voix, un compagnon qui répond, des scènes d'histoire et un terminal de quiz.
Neocortex TeamThe team behind Neocortex
· 6 min de lecture

Half-Life 2 possède une IA d'escouade qui obéit aux touches du clavier, et un monde peuplé de gens qui ne disent jamais que ce que le script autorise. Les rebelles vous suivent, mais vous ne pouvez rien leur dire ; les citoyens parlent, mais jamais de ce qui vient de se passer. Un mod PNJ IA pour Half-Life 2 corrige les deux : des rebelles qui réagissent à vos ordres à voix haute, un compagnon qui parle du combat que vous venez de survivre, et des scènes d'histoire qui s'adaptent aux choix du joueur. Neocortex ajoute les personnages IA, les Conversation Flows, les quiz et les commandes vocales embarquées, et Source SDK 2013 vous fournit le code pour les intégrer.
Capture d'écran : Half-Life 2 © Valve
Ordres vocaux pour une escouade rebelle
Half-Life 2 vous permet déjà d'envoyer votre escouade à un point et de la rappeler. Les commandes vocales remplacent la touche par la parole : « avance », « tiens ici », « mets-toi à couvert derrière la voiture », « regroupez-vous sur moi ».
Dans le tableau de bord Neocortex, vous concevez le jeu de commandes sous forme d'acteurs, d'actions et d'objets : acteur « squad », actions « move », « hold » et « cover », objets comme « me », « car » et « door ». Les joueurs parlent naturellement, et le mod reçoit instantanément les commandes reconnues, y compris plusieurs actions et quantités dans une seule phrase : « deux d'entre vous surveillent la porte, les autres me suivent ». Votre code les associe au code d'escouade existant.
Cela fonctionne en push-to-talk ou en écoute permanente, dans plusieurs langues, et s'exécute sur la machine du joueur, donc les ordres passent en pleine fusillade sans aller-retour dans le cloud.
Voice Commands est un SDK sous licence : contactez-nous pour une licence Voice Commands.
Exemple détaillé : Mara Venn et la planque
Le compagnon. Créez un compagnon original, disons Mara Venn, ancienne infirmière de terrain qui a rejoint la résistance après la fermeture de sa clinique. Votre mod envoie la question du joueur avec ce que le jeu connaît : les objets proches (la barricade, la caisse de munitions, la radio) et les événements récents (« deux membres de l'escouade à terre », « le joueur a pris le tunnel de gauche », « santé sous 30 »). Mara répond à voix haute, avec une balise d'émotion sur chaque réplique, et peut renvoyer des actions comme remettre une trousse de soins ou ouvrir la porte que le joueur a demandée.
L'escouade répond. Le chat de groupe (forfaits Pro et Team) permet à jusqu'à six personnages de partager une même conversation, donc toute l'escouade peut débattre de la prochaine manœuvre.
La cave. Mara conduit le joueur jusqu'à une planque en sous-sol, où il doit gagner la confiance d'un chef de cellule méfiant avant qu'il ne lui révèle l'itinéraire pour quitter la ville. Un Conversation Flow définit les étapes : présentations, prouver de quel côté vous êtes, le marché, l'itinéraire. Le personnage guide la conversation à travers elles, quelle que soit la formulation du joueur, et l'API renvoie des mots-clés de point de contrôle comme TRUST_EARNED ou ROUTE_SHARED. Votre mod réagit en ouvrant la porte cachée ou en faisant apparaître le guide qui vous fait sortir.
Le terminal. Dans un coin, un terminal entraîne les nouvelles recrues : quelles unités ennemies éviter, comment signaler à l'escouade, quelles fournitures emporter. Le moteur de quiz Neocortex (forfait Team) gère les questions et le score, et une série de bonnes réponses peut récompenser le joueur avec des munitions ou un raccourci.
Capture d'écran : Half-Life 2 © Valve
Les branches de Source SDK 2013 pour un mod PNJ IA Half-Life 2
Half-Life 2 tourne sur Source. Un mod est un dossier avec son propre gameinfo.txt, son contenu, et deux bibliothèques C++ compilées à partir du code de Valve : une DLL serveur pour l'IA des PNJ, les escouades et la logique de jeu, et une DLL client pour le HUD, les panneaux VGUI et les effets locaux. Choisissez d'abord la base :
| Base | Ce qu'elle contient | État |
|---|---|---|
Source SDK 2013 branche singleplayer | Le code solo de Half-Life 2 | Aucune mise à jour de code depuis 2015 ; fonctionne sur le Source SDK Base 2013 Singleplayer en 32 bits |
Source SDK 2013 branche master | Le code multijoueur | Mise à jour en février 2025 avec le code de jeu de Team Fortress 2 et des builds 64 bits ; Valve continue de le mettre à jour |
| Mapbase | Une base maintenue par la communauté pour les mods solo | La version 8.0 est sortie en juillet 2025, avec de nouvelles entités, des corrections et une implémentation VScript pour les scripts de cartes |
Pour un mod d'histoire comme la planque ci-dessus, partez de la branche singleplayer ou de Mapbase.
Appeler Neocortex depuis une DLL Source
Les en-têtes du SDK incluent l'interface HTTP de Steamworks, et beaucoup de moddeurs ajoutent plutôt libcurl. Dans les deux cas, exécutez les requêtes sur un thread de travail et renvoyez les résultats à la boucle de jeu. Un appel de chat depuis la DLL client ou serveur, avec libcurl :
// bodyJson: {"characterIds":["CHARACTER_ID"],"message":"Where now?","playerId":"player-1",
// "sessionId":"","events":[{"priority":1,"content":"Two squad members down"}]}
std::string AskCompanion(const std::string& apiKey, const std::string& bodyJson)
{
std::string response;
CURL* curl = curl_easy_init();
curl_slist* headers = curl_slist_append(nullptr, "Content-Type: application/json");
headers = curl_slist_append(headers, ("x-api-key: " + apiKey).c_str());
curl_easy_setopt(curl, CURLOPT_URL, "https://api.neocortex.link/v3/chat");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, bodyJson.c_str());
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, AppendToString); // appends bytes to response
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_perform(curl);
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
return response; // sessionId, lines with emotions, actions and flowState
}Le mod lit l'état du jeu et l'envoie avec le message du joueur à un personnage Neocortex via /v3/chat, affiche la réponse sous forme de sous-titres, joue la voix issue de /v3/audio/generate ou /v3/audio/stream, et exécute les actions renvoyées par le personnage. Les Conversation Flows renvoient des mots-clés de point de contrôle (flowState) dans la même réponse, le moteur de quiz passe par /v3/quiz, et les commandes vocales embarquées transforment les phrases prononcées en actions de jeu sans aller-retour dans le cloud, Neocortex Voice Commands s'exécutant sur la machine du joueur.
Pour l'interface, les panneaux VGUI de la DLL client peuvent afficher les sous-titres et un écran de quiz. Les sous-titres et les soundscripts de Source sont conçus pour des répliques préécrites ; les réponses IA en direct ont donc généralement leur propre panneau de sous-titres, et l'audio généré est enregistré dans un fichier puis joué par le moteur.
Avant de publier : la licence du Source 1 SDK
La licence du Source 1 SDK ne permet de distribuer des mods que gratuitement ; les mods gratuits peuvent être publiés sur Steam. Gardez les mods PNJ IA en solo, ne les utilisez jamais sur des serveurs multijoueurs contrairement à leurs règles, et demandez à chaque joueur d'utiliser sa propre clé API Neocortex.
De la carte vide à l'escouade qui parle
- Installez Source SDK 2013. Choisissez la branche
singleplayerou Mapbase pour un mod d'histoire, compilez-la et lancez une carte de test vide. - Concevez vos personnages dans le tableau de bord Neocortex : un compagnon, un chef de cellule avec un Conversation Flow, un quiz pour le terminal et un jeu de commandes pour l'escouade.
- Appelez l'API depuis votre DLL de jeu sur un thread de travail, et réutilisez le
sessionIdde chaque réponse. - Gardez la clé API dans un fichier de configuration que le joueur renseigne, jamais codée en dur dans un mod que vous partagez.
- Branchez les sous-titres, la voix et les actions, puis associez les commandes vocales au code d'escouade existant.
- Testez en solo sur une carte avant de passer à une campagne complète.
Pour voir comment fonctionnent les commandes vocales dans un mod, lisez commandes vocales embarquées pour les mods de jeu. Pour GoldSrc, consultez notre guide mod PNJ IA Half-Life, et pour les serveurs bac à sable Source, l'article PNJ IA et addon de quiz pour Garry's Mod. Mara et son escouade peuvent être testés dès aujourd'hui dans l'éditeur Neocortex, bien avant la compilation de la première carte.
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 à Half-Life 2 ?
Oui. Les mods Half-Life 2 sont construits avec le Source SDK 2013 de Valve, qui donne accès à l'ensemble du code C++ du jeu, donc un mod peut appeler une API web et agir selon la réponse. Neocortex fournit le personnage IA, sa voix et les actions qu'il renvoie, et votre mod les exécute.
Faut-il utiliser la branche solo ou multijoueur de Source SDK 2013 ?
Les mods d'histoire partent généralement de la branche solo ou d'une base communautaire qui en dérive, comme Mapbase. La branche multijoueur a reçu une mise à jour importante avec la prise en charge 64 bits en 2025 et reste maintenue, mais son code cible les jeux multijoueurs. Neocortex fonctionne avec les deux, car c'est une simple API web.
Peut-on commander les rebelles de Half-Life 2 à la voix ?
Oui, avec un mod. Half-Life 2 possède déjà du code de commande d'escouade, et un mod peut le déclencher à partir de la parole. Neocortex Voice Commands reconnaît les phrases naturelles sur le PC du joueur, donc « avance », « tiens ici » et « regroupez-vous » atteignent votre code instantanément et hors ligne.
Peut-on vendre un mod Half-Life 2 avec des personnages IA ?
Non. La licence du Source 1 SDK ne permet de distribuer des mods que gratuitement, même si les mods gratuits peuvent être publiés sur Steam. Vous pouvez construire et tester la partie Neocortex d'un mod gratuit dans l'éditeur du navigateur.






