Mod de NPC de IA para Half-Life 2: escuadrones por voz
Planifica un mod de NPC de IA para Half-Life 2 sobre Source SDK 2013: un escuadrón rebelde al que das órdenes por voz, un compañero que responde, escenas de historia en el refugio y un terminal de preguntas.
Neocortex TeamThe team behind Neocortex
· 6 min de lectura

Half-Life 2 tiene una IA de escuadrón que escucha las pulsaciones de teclas, y un mundo lleno de personas que solo dicen lo que permite el guion. Los rebeldes te siguen, pero no puedes decirles nada; los ciudadanos hablan, pero nunca de lo que acaba de pasar. Un mod de NPC de IA para Half-Life 2 arregla las dos cosas: rebeldes que reaccionan a tus órdenes en voz alta, un compañero que habla de la pelea que acabas de sobrevivir y escenas de historia que se doblan según las decisiones del jugador. Neocortex añade los personajes de IA, los flujos de conversación, los cuestionarios y los comandos de voz en el dispositivo, y Source SDK 2013 te da el código para conectarlos.
Captura: Half-Life 2 © Valve
Órdenes de voz para un escuadrón rebelde
Half-Life 2 ya te permite enviar a tu escuadrón a un punto y llamarlo de vuelta. Los comandos de voz sustituyen la pulsación de tecla por el habla: "avanza", "mantén posición aquí", "cúbrete detrás del coche", "reagrupaos conmigo".
En el panel de Neocortex defines el conjunto de comandos como actores, acciones y objetos: el actor "escuadrón", las acciones "mover", "mantener" y "cubrir", y objetos como "yo", "coche" y "puerta". Los jugadores hablan de forma natural, y el mod recibe al instante los comandos reconocidos, incluidos varios actos y cantidades en una sola frase: "dos de vosotros vigilad la puerta, el resto sígueme". Tu código los traduce al código de escuadrón que ya existe.
Funciona con pulsar para hablar o con escucha permanente, en varios idiomas, y se ejecuta en el equipo del jugador, así que las órdenes llegan en mitad de un tiroteo sin ir y volver a la nube.
Comandos de voz es un SDK con licencia: contacta con nosotros para obtener una licencia de Comandos de voz.
Ejemplo práctico: Mara Venn y el refugio
El compañero. Crea un compañero original, por ejemplo Mara Venn, una antigua médica de campo que se unió a la resistencia cuando cerraron su clínica. Tu mod envía la pregunta del jugador junto con lo que sabe el juego: objetos cercanos (la barricada, la caja de munición, la radio) y eventos recientes ("dos miembros del escuadrón caídos", "el jugador tomó el túnel de la izquierda", "salud por debajo de 30"). Mara responde con voz y con una etiqueta de emoción en cada línea, y puede devolver acciones como entregar un botiquín o abrir la puerta por la que pregunta el jugador.
El escuadrón discute. El chat de grupo (planes Pro y Team) permite que hasta seis personajes compartan una conversación, así que todo el escuadrón puede discutir cuál es el siguiente movimiento.
El sótano. Mara lleva al jugador a un refugio en un sótano, donde tiene que ganarse la confianza de un líder de célula desconfiado antes de que comparta la ruta para salir de la ciudad. Un flujo de conversación define los momentos: las presentaciones, demostrar de qué lado estás, el trato y la ruta. El personaje guía la conversación por ellos sea cual sea la forma en que el jugador lo plantee, y la API devuelve palabras clave de punto de control como TRUST_EARNED o ROUTE_SHARED. Tu mod reacciona abriendo la puerta oculta o generando al guía que te saca de allí.
El terminal. En una esquina, un terminal entrena a los nuevos reclutas: qué unidades enemigas evitar, cómo señalar al escuadrón, qué suministros llevar. El motor de cuestionarios de Neocortex (plan Team) lleva las preguntas y la puntuación, y una racha de aciertos puede premiar al jugador con munición o con un atajo.
Captura: Half-Life 2 © Valve
Ramas de Source SDK 2013 para un mod de NPC de IA en Half-Life 2
Half-Life 2 funciona sobre Source. Un mod es una carpeta con su propio gameinfo.txt, contenido y dos bibliotecas en C++ compiladas a partir del código de Valve: una DLL de servidor para la IA de los NPC, los escuadrones y la lógica del juego, y una DLL de cliente para el HUD, los paneles VGUI y los efectos locales. Elige la base antes que nada:
| Base | Qué contiene | Estado |
|---|---|---|
Rama singleplayer de Source SDK 2013 | El código de un jugador de Half-Life 2 | Sin actualizaciones de código desde 2015; funciona sobre el Source SDK Base 2013 Singleplayer de 32 bits |
Rama master de Source SDK 2013 | El código multijugador | Actualizada en febrero de 2025 con el código de juego de Team Fortress 2 y compilaciones de 64 bits; Valve sigue confirmando cambios en ella |
| Mapbase | Una base mantenida por la comunidad para mods de un jugador | La versión 8.0 salió en julio de 2025, con nuevas entidades, correcciones y una implementación de VScript para scripts de mapas |
Para un mod de historia como el del refugio de arriba, parte de la rama singleplayer o de Mapbase.
Llamar a Neocortex desde una DLL de Source
Las cabeceras del SDK incluyen la interfaz HTTP de Steamworks, pero muchos modders añaden libcurl en su lugar. En cualquier caso, ejecuta las peticiones en un hilo de trabajo y devuelve los resultados al bucle del juego. Una llamada de chat desde la DLL de cliente o de servidor, usando 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
}El mod lee el estado del juego y lo envía junto con el mensaje del jugador a un personaje de Neocortex mediante /v3/chat, muestra la respuesta como subtítulos, reproduce la voz desde /v3/audio/generate o /v3/audio/stream, y ejecuta las acciones que devuelve el personaje. Los flujos de conversación devuelven palabras clave de punto de control (flowState) en la misma respuesta, el motor de cuestionarios funciona a través de /v3/quiz, y los comandos de voz en el dispositivo convierten las frases habladas en acciones del juego sin ir y volver a la nube, con Neocortex Voice Commands ejecutándose en el equipo del jugador.
Para la interfaz, los paneles VGUI de la DLL de cliente pueden mostrar subtítulos y una pantalla de cuestionario. Los subtítulos cerrados y los soundscripts de Source están pensados para líneas creadas de antemano, así que las respuestas de IA en directo suelen necesitar su propio panel de subtítulos, con el audio generado guardado en un archivo y reproducido a través del motor.
Antes de publicar: la licencia del SDK de Source 1
La licencia del SDK de Source 1 solo permite distribuir mods gratuitos; los mods gratuitos pueden publicarse en Steam. Mantén los mods de NPC de IA para un jugador, nunca los uses en servidores multijugador contra sus normas, y haz que cada jugador use su propia clave de API de Neocortex.
De un mapa vacío a un escuadrón que habla
- Configura Source SDK 2013. Elige la rama
singleplayero Mapbase para un mod de historia, compílalo y lanza un mapa de prueba vacío. - Diseña tus personajes en el panel de Neocortex: un compañero, un líder de célula con un flujo de conversación, un cuestionario para el terminal y un conjunto de comandos para el escuadrón.
- Llama a la API desde la DLL de tu juego en un hilo de trabajo y reutiliza el
sessionIdde cada respuesta. - Guarda la clave de API en un archivo de configuración que el jugador rellena, nunca escrita en el código de un mod que compartas.
- Conecta los subtítulos, la voz y las acciones, y después asigna los comandos de voz al código de escuadrón que ya existe.
- Prueba en un jugador en un mapa antes de escalar a una campaña completa.
Para ver cómo funcionan los comandos de voz en un mod, lee comandos de voz en el dispositivo para mods de juegos. Para GoldSrc, consulta nuestra guía de mod de NPC de IA para Half-Life, y para los servidores de pruebas de Source, la entrada sobre el mod de NPC de IA y el complemento de cuestionarios para Garry's Mod. Mara y su escuadrón se pueden probar hoy en el editor del navegador de Neocortex, mucho antes de que compile el primer mapa.
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 última versión.
Preguntas frecuentes
¿Se pueden añadir NPC de IA a Half-Life 2?
Sí. Los mods de Half-Life 2 se construyen con Source SDK 2013 de Valve, que te da el código completo del juego en C++, así que un mod puede llamar a una API web y actuar según la respuesta. Neocortex aporta el personaje de IA, su voz y las acciones que devuelve, y tu mod las ejecuta.
¿Debo usar la rama de un jugador o la multijugador de Source SDK 2013?
Los mods de historia suelen partir de la rama de un jugador o de una base de la comunidad construida sobre ella, como Mapbase. La rama multijugador recibió una gran actualización con soporte de 64 bits en 2025 y sigue mantenida, pero su código está orientado a juegos multijugador. Neocortex funciona con cualquiera de las dos, porque es una API web sencilla.
¿Puedo dar órdenes por voz a los rebeldes de Half-Life 2?
Sí, con un mod. Half-Life 2 ya tiene código de órdenes de escuadrón, y un mod puede activarlo a partir del habla. Neocortex Voice Commands reconoce frases naturales en el PC del jugador, así que "avanza", "mantén posición aquí" y "reagrupaos" llegan a tu código al instante y sin conexión.
¿Puedo vender un mod de Half-Life 2 con personajes de IA?
No. La licencia del SDK de Source 1 solo permite distribuir mods gratuitos, aunque los mods gratuitos pueden publicarse en Steam. Puedes crear y probar la parte de Neocortex de un mod gratuito en el editor del navegador.






