Mod de IA para Portal 2: una IA parlante y comandos de voz
Crea un mod de IA para Portal 2: una IA sarcástica de cámaras de prueba que reacciona a tus intentos, cámaras controladas por voz y un quiz de ciencia, conectados desde VScript.
Neocortex TeamThe team behind Neocortex
· 6 min de lectura

Los scripts de los mapas de Portal 2 no pueden acceder a internet. Ese es el único problema que todo mod de IA para Portal 2 tiene que resolver, y la respuesta es una pequeña aplicación auxiliar que se ejecuta junto al juego. Una vez instalada, tu cámara de pruebas puede tener su propia IA parlante, lo que encaja con un juego sobre ser juzgado por una voz en las paredes: una cámara que se da cuenta de que fallas el mismo salto cinco veces y tiene algo que decir al respecto, una cámara que controlas hablando, y un quiz que solo abre la salida con respuestas correctas. Neocortex aporta el personaje de IA, los Conversation Flows, los quizzes y los comandos de voz en el propio dispositivo.
Captura: Portal 2 © Valve
¿Por qué un mod de IA para Portal 2 necesita una aplicación auxiliar?
Los mapas de Portal 2 se construyen en Hammer con las Portal 2 Authoring Tools y se comparten en el Steam Workshop. La lógica del mapa son las entradas y salidas de entidades más VScript, que en Portal 2 es Squirrel. VScript puede leer y mover entidades, seguir al jugador e imprimir en la consola, pero no tiene acceso a red ni a HTTP.
Así que el mapa hace lo que puede: informar y reaccionar, y una aplicación auxiliar local se encarga de hablar con Neocortex. El asistente puede escribirse en cualquier lenguaje con un cliente HTTP.
¿Cómo salen los eventos del juego y vuelven a entrar?
| Dirección | Cómo |
|---|---|
| Hacia fuera del juego | Tu VScript imprime líneas etiquetadas (un evento, un estado de la cámara) en la consola. Si inicias Portal 2 con -condebug, la salida de la consola se escribe en un archivo console.log que el asistente puede vigilar. Consulta las opciones de línea de comandos de Valve. |
| Hacia dentro del juego | La opción de inicio -netconport abre un puerto de consola que permite al asistente enviar comandos de consola, por ejemplo una llamada script al VScript de tu mapa. Mantén ese puerto en tu propia máquina. |
| Subtítulos | Tu mapa muestra el texto de la respuesta con una entidad game_text. |
| Voz | El asistente reproduce la voz del personaje por la salida de audio del PC. |
Por el lado de Neocortex, el asistente lee el estado del juego desde el registro de la consola y lo envía junto con el mensaje del jugador a un personaje mediante /v3/chat. El mapa muestra la respuesta como subtítulos, el asistente reproduce la voz desde /v3/audio/generate o /v3/audio/stream, y las acciones que devuelve el personaje vuelven al mapa como comandos de consola. Los Conversation Flows devuelven palabras clave de punto de control (flowState) a las que reacciona el mapa, como abrir la siguiente prueba, y el motor de quizzes ejecuta juegos de preguntas y respuestas mediante /v3/quiz.
¿Qué puede hacer una IA de cámara de pruebas?
Crea un supervisor original en lugar de tomar prestado el del juego: PROCTOR-7, una inteligencia de la instalación a la que degradaron para dirigir una sola cámara y que no está nada contenta con ello. Dale una Personality, un ajuste de Emotion y una Knowledge base sobre la solución de tu cámara, su historia y sus pequeños agravios.
Tu mapa informa de lo que ocurre: "el jugador cayó en el líquido", "tercer lanzamiento fallido en el panel B", "cubo colocado en el botón equivocado", "el jugador lleva 40 segundos quieto". El asistente envía esos eventos con cada mensaje, y PROCTOR-7 comenta con voz, con una etiqueta de emoción en cada línea: CURIOUS cuando pruebas algo nuevo, ANGRY cuando rompes la solución prevista.
También puede devolver acciones, como un reticente { "name": "SPAWN_CUBE", "targetId": "dropper_01" } tras suficientes fallos, que tu mapa ejecuta como una pista.
Un Conversation Flow puede convertir toda la cámara en una historia: introducción, primera prueba, una "avería" que el jugador tiene que explicar a PROCTOR-7, y una prueba final. Cada palabra clave de punto de control que devuelve la API abre la siguiente parte del mapa.
Captura: Portal 2 © Valve
¿Puede el jugador resolver una cámara hablando?
Sí. Crea una cámara que el jugador resuelve hablando con ella. En el panel de Neocortex diseñas un conjunto de comandos como actores, acciones y objetos: actor "chamber", acciones "raise", "lower", "drop" y "extend", objetos "platform", "cube" y "bridge".
Los jugadores hablan de forma natural, y el asistente recibe los comandos coincidentes al instante, incluidas varias acciones y cantidades en una sola frase: "tira dos cubos y eleva la plataforma". Funciona con pulsar para hablar o con escucha permanente, en varios idiomas, y Neocortex Voice Commands se ejecuta en el equipo del jugador sin ida y vuelta a la nube, lo que importa cuando el momento de un lanzamiento depende de ello.
Voice Commands es un SDK con licencia: contacta con nosotros para obtener una licencia de Voice Commands.
La misma cámara puede poner a prueba el conocimiento en lugar de los reflejos. Un personaje locutor hace preguntas de física creadas en el panel de Neocortex: momento lineal, gravedad, por qué un portal conserva tu velocidad. El motor de quizzes (plan Team) gestiona las preguntas y la puntuación; cada respuesta correcta activa un segmento más del puente de luz, y una incorrecta deja caer un cubo al líquido.
¿Funciona en Portal 2: Community Edition?
Portal 2: Community Edition es una versión de Portal 2 mantenida por la comunidad, sobre Strata Source, una bifurcación con licencia oficial de la rama del motor de CS:GO. Entró en beta abierta en Steam el 17 de abril de 2026, es gratis para quienes poseen Portal 2, y añade un port nativo de 64 bits, scripting en AngelScript, interfaz Panorama, un sistema de addons y su propio Workshop.
Sigue siendo una beta, así que revisa su documentación para saber qué puede hacer su scripting. El patrón de la aplicación auxiliar funciona allí de todos modos.
¿Puedes publicarlo en el Workshop?
Las condiciones del Workshop de Valve se aplican al mapa, y la aplicación auxiliar es una descarga aparte que los jugadores eligen ejecutar. Limita las funciones de IA y de voz a cámaras para un jugador, nunca las uses para obtener ventaja en cooperativo con jugadores que no lo hayan aceptado, y que cada jugador use su propia clave de API de Neocortex.
Crea tu primera cámara parlante
- Construye una cámara de pruebas en Hammer con un archivo VScript que imprima eventos etiquetados en la consola.
- Diseña tu personaje en el panel de Neocortex: la Personality y el Knowledge de PROCTOR-7, un Conversation Flow para la cámara, un quiz y un conjunto de comandos.
- Escribe la aplicación auxiliar: vigila
console.log, llama a/v3/chat, reproduce la voz y envía comandos de vuelta por el puerto de consola. - Guarda la clave de API en el archivo de configuración del asistente, que rellena el jugador, nunca escrita en el código de una versión que compartas.
- Prueba en un jugador con las opciones de inicio configuradas, y después publica el mapa en el Workshop y el asistente por separado.
Para la parte de voz, lee comandos de voz en el dispositivo para mods de juegos. Para mods a nivel de motor en Source, consulta nuestra guía del mod de NPC con IA de Half-Life 2, y para un juego de Source cuyos scripts pueden llamar a la API directamente, nuestra guía del mod de IA de Titanfall 2. Y si más adelante quieres a PROCTOR-7 en un juego independiente, el mismo personaje de Neocortex funciona a través de nuestra integración con Unity.
Versiones de herramientas y enlaces revisados en octubre de 2026. Las herramientas de modding cambian a menudo; consulta la página de cada proyecto para la versión más reciente.
Preguntas frecuentes
¿Se puede añadir un personaje de IA a Portal 2?
Sí, con una pequeña aplicación auxiliar. Los scripts de los mapas de Portal 2 no pueden acceder a internet, así que el mapa imprime eventos en la consola y una aplicación auxiliar local los pasa a un personaje de IA. Neocortex aporta el personaje, su voz y sus respuestas, y el asistente las devuelve al juego.
¿Puede VScript de Portal 2 hacer peticiones HTTP?
No. VScript en Portal 2 es Squirrel ejecutándose dentro del mapa, sin acceso a red. El patrón habitual es registrar eventos en la consola, leerlos desde una aplicación auxiliar y dejar que esa aplicación llame a APIs web como la de Neocortex.
¿Puedo controlar una cámara de pruebas de Portal 2 con la voz?
Sí. Una aplicación auxiliar puede escuchar el micrófono y enviar comandos coincidentes al juego, como elevar una plataforma o dejar caer un cubo. Neocortex Voice Commands hace la coincidencia en el PC del jugador, así que funciona sin conexión y responde al instante.
¿Qué es Portal 2: Community Edition?
Portal 2: Community Edition es una versión de Portal 2 mantenida por la comunidad, sobre el motor Strata Source, en beta abierta en Steam desde abril de 2026 y gratis para quienes poseen Portal 2. Añade AngelScript, la interfaz Panorama y un sistema de addons, y el patrón de aplicación auxiliar para Neocortex funciona allí también.
¿Puedo publicar una cámara de pruebas con IA en el Steam Workshop?
Puedes publicar el mapa en el Workshop como de costumbre, pero la aplicación auxiliar hay que compartirla por separado, por ejemplo en GitHub. Cada jugador la ejecuta con su propia clave de API de Neocortex, que puede obtener en el editor del navegador.






