Neocortex Logo

Mod IA pour Portal 2 : une IA de chambre de test qui parle et des commandes vocales

Créez un mod IA pour Portal 2 : une IA sarcastique de chambre de test qui réagit à vos essais, des chambres pilotées à la voix et un quiz scientifique, relié depuis VScript.

Neocortex TeamThe team behind Neocortex

· 6 min de lecture

Créez un mod IA pour Portal 2 : une IA sarcastique de chambre de test qui réagit à vos essais, des chambres pilotées à la voix et un quiz scientifique, relié depuis VScript.

Les scripts de carte de Portal 2 ne peuvent pas accéder à Internet. C'est le seul problème que chaque mod IA pour Portal 2 doit résoudre, et la réponse est une petite application d'aide qui fonctionne à côté du jeu. Une fois celle-ci en place, votre chambre de test peut avoir sa propre IA qui parle, ce qui convient à un jeu où une voix dans les murs vous juge : une chambre qui remarque que vous ratez le même saut cinq fois et qui a quelque chose à dire à ce sujet, une chambre que vous contrôlez en parlant, et un quiz qui n'ouvre la sortie que pour les bonnes réponses. Neocortex fournit le personnage IA, les Conversation Flows, les quiz et les commandes vocales sur l'appareil.

Capture en jeu de Portal 2 Capture d'écran : Portal 2 © Valve

Pourquoi un mod IA pour Portal 2 a-t-il besoin d'une application d'aide ?

Les cartes de Portal 2 se créent dans Hammer avec les Portal 2 Authoring Tools et se partagent sur le Steam Workshop. La logique de carte repose sur les entrées-sorties d'entités et sur VScript, qui est du Squirrel dans Portal 2. VScript peut lire et déplacer des entités, suivre le joueur et afficher dans la console, mais il n'a aucun accès réseau ni HTTP.

La carte fait donc ce qu'elle peut faire, à savoir signaler et réagir, et une application d'aide locale s'occupe de la discussion avec Neocortex. L'application d'aide peut être écrite dans n'importe quel langage disposant d'un client HTTP.

Comment les événements sortent-ils du jeu puis reviennent-ils ?

SensFonctionnement
Hors du jeuVotre VScript affiche des lignes balisées (un événement, un état de la chambre) dans la console. Lancer Portal 2 avec -condebug écrit la sortie de la console dans un fichier console.log que l'application d'aide peut surveiller. Voir les options de ligne de commande de Valve.
Vers le jeuL'option de lancement -netconport ouvre un port de console qui permet à l'application d'aide de renvoyer des commandes, par exemple un appel script vers le VScript de votre carte. Gardez ce port sur votre propre machine.
Sous-titresVotre carte affiche le texte de la réponse avec une entité game_text.
VoixL'application d'aide joue la voix du personnage via la sortie audio du PC.

Côté Neocortex, l'application d'aide lit l'état du jeu dans le journal de la console et l'envoie avec le message du joueur à un personnage via /v3/chat. La carte affiche la réponse en sous-titres, l'application d'aide joue la voix depuis /v3/audio/generate ou /v3/audio/stream, et les actions renvoyées par le personnage reviennent vers la carte sous forme de commandes de console. Les Conversation Flows renvoient des mots-clés de point de contrôle (flowState) auxquels la carte réagit, par exemple pour ouvrir le test suivant, et le moteur de quiz fait tourner des jeux de questions-réponses via /v3/quiz.

Que peut faire une IA de chambre de test ?

Créez un superviseur original plutôt que d'emprunter celui du jeu : PROCTOR-7, une intelligence de l'installation rétrogradée à la gestion d'une seule chambre, et qui ne le vit pas bien. Donnez-lui un paramètre Personality, un réglage Emotion et une base de connaissances sur la solution de votre chambre, son histoire et ses petits griefs.

Votre carte signale ce qui se passe : « le joueur est tombé dans le goo », « troisième lancer raté sur le panneau B », « cube posé sur le mauvais bouton », « le joueur est resté immobile pendant 40 secondes ». L'application d'aide envoie ces éléments comme événements avec chaque message, et PROCTOR-7 commente à voix haute, avec une balise d'émotion sur chaque réplique : CURIOUS quand vous essayez quelque chose de nouveau, ANGRY quand vous contournez la solution prévue.

Il peut aussi renvoyer des actions, comme un { "name": "SPAWN_CUBE", "targetId": "dropper_01" } lâché à contrecœur après assez d'échecs, que votre carte exécute comme indice.

Un Conversation Flow peut transformer toute la chambre en histoire : introduction, premier test, un « dysfonctionnement » que le joueur doit expliquer à PROCTOR-7, puis un test final. Chaque mot-clé de point de contrôle renvoyé par l'API ouvre la partie suivante de la carte.

Capture en jeu de Portal 2 Capture d'écran : Portal 2 © Valve

Le joueur peut-il résoudre une chambre en parlant ?

Oui. Construisez une chambre que le joueur résout en lui parlant. Dans le tableau de bord Neocortex, vous concevez un jeu de commandes sous forme d'acteurs, d'actions et d'objets : acteur « chamber », actions « raise », « lower », « drop » et « extend », objets « platform », « cube » et « bridge ».

Les joueurs parlent naturellement, et l'application d'aide reçoit instantanément les commandes reconnues, y compris plusieurs actions et quantités dans une même phrase : « drop two cubes and raise the platform ». Cela fonctionne avec pression d'un bouton pour parler ou écoute permanente, dans plusieurs langues, et Neocortex Voice Commands s'exécute sur la machine du joueur sans aller-retour dans le cloud, ce qui compte quand le timing d'un lancer en dépend.

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

La même chambre peut tester des connaissances plutôt que des réflexes. Un personnage présentateur pose des questions de physique construites dans le tableau de bord Neocortex : la quantité de mouvement, la gravité, pourquoi un portail conserve votre vitesse. Le moteur de quiz (offre Team) gère les questions et le score ; chaque bonne réponse alimente un segment de pont lumineux de plus, et une mauvaise fait tomber un cube dans le goo.

Cela fonctionne-t-il dans Portal 2: Community Edition ?

Portal 2: Community Edition est une version de Portal 2 maintenue par la communauté, sur Strata Source, un fork sous licence officielle de la branche du moteur de CS:GO. Elle est entrée en bêta ouverte sur Steam le 17 avril 2026, est gratuite pour les propriétaires de Portal 2, et ajoute un portage natif 64 bits, le scripting AngelScript, une interface Panorama, un système d'addons et son propre Workshop.

C'est encore une bêta, donc vérifiez sa documentation pour savoir ce que son scripting permet. Le principe de l'application d'aide fonctionne tout de même là-bas.

Peut-on publier le mod sur le Workshop ?

Les conditions du Workshop de Valve s'appliquent à la carte, et l'application d'aide est un téléchargement distinct que les joueurs choisissent d'utiliser. Réservez les fonctions IA et vocales aux chambres solo, n'utilisez jamais ces fonctions pour gagner un avantage en coopération avec des joueurs qui n'ont pas choisi de les activer, et faites en sorte que chaque joueur utilise sa propre clé d'API Neocortex.

Créez votre première chambre qui parle

  1. Construisez une chambre de test dans Hammer avec un fichier VScript qui affiche des événements balisés dans la console.
  2. Concevez votre personnage dans le tableau de bord Neocortex : la Personality et les connaissances de PROCTOR-7, un Conversation Flow pour la chambre, un quiz et un jeu de commandes.
  3. Écrivez l'application d'aide : surveillez console.log, appelez /v3/chat, jouez la voix et renvoyez les commandes via le port de console.
  4. Gardez la clé d'API dans le fichier de configuration de l'application d'aide, que le joueur remplit, jamais codée en dur dans une version que vous partagez.
  5. Testez en solo avec les options de lancement définies, puis publiez la carte sur le Workshop et l'application d'aide séparément.

Pour le volet voix, lisez commandes vocales sur l'appareil pour les mods de jeux. Pour les mods au niveau du moteur sur Source, consultez notre guide mod PNJ IA pour Half-Life 2, et pour un jeu Source dont les scripts peuvent appeler l'API directement, notre guide mod IA pour Titanfall 2. Et si vous voulez plus tard que PROCTOR-7 apparaisse dans un jeu autonome, le même personnage Neocortex fonctionne via notre intégration Unity.

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 un personnage IA à Portal 2 ?

Oui, avec une petite application d'aide. Les scripts de carte de Portal 2 ne peuvent pas accéder à Internet : la carte affiche donc les événements dans la console, et une application d'aide locale les transmet à un personnage IA. Neocortex fournit le personnage, sa voix et ses réponses, et l'application d'aide les renvoie dans le jeu.

Le VScript de Portal 2 peut-il faire des requêtes HTTP ?

Non. Le VScript de Portal 2 est du Squirrel exécuté dans la carte, sans accès réseau. Le schéma habituel consiste à écrire les événements dans la console, à les lire depuis une application d'aide et à laisser cette application appeler des API web comme celle de Neocortex.

Peut-on contrôler une chambre de test de Portal 2 à la voix ?

Oui. Une application d'aide peut écouter le microphone et envoyer des commandes reconnues dans le jeu, comme élever une plateforme ou lâcher un cube. Neocortex Voice Commands fait la reconnaissance sur le PC du joueur, donc cela fonctionne hors ligne et réagit instantanément.

Qu'est-ce que Portal 2: Community Edition ?

Portal 2: Community Edition est une version de Portal 2 maintenue par la communauté, sur le moteur Strata Source, en bêta ouverte sur Steam depuis avril 2026 et gratuite pour les propriétaires de Portal 2. Elle ajoute AngelScript, une interface Panorama et un système d'addons, et le principe d'application d'aide pour Neocortex y fonctionne aussi.

Peut-on publier une chambre de test IA sur le Steam Workshop ?

Vous pouvez publier la carte sur le Workshop comme d'habitude, mais l'application d'aide doit être partagée séparément, par exemple sur GitHub. Chaque joueur la fait tourner avec sa propre clé d'API Neocortex, que vous pouvez obtenir dans l'éditeur web.

Articles similaires

À lire aussi