Addon de NPC de IA para Garry's Mod: NPC inteligentes y un presentador de concursos
Crea un addon de NPC de IA para Garry's Mod en Lua: NPC inteligentes para servidores sandbox y de rol, un presentador de concursos multijugador con clasificación y comandos de voz.
Neocortex TeamThe team behind Neocortex
· 6 min de lectura

Un addon de NPC de IA para Garry's Mod es un addon en Lua que envía lo que dicen los jugadores a un personaje de IA mediante la función integrada HTTP() del juego, y actúa según la respuesta. Los servidores de Garry's Mod viven de lo que inventan los jugadores, y los NPC que solo se quedan quietos son una oportunidad desaprovechada.
Con Neocortex, los servidores sandbox y de rol consiguen personajes que de verdad hablan: un tendero que regatea, un presentador de concursos que dirige un juego para todo el servidor y ayudantes que siguen comandos de voz. Neocortex aporta los personajes de IA, los Conversation Flows, el motor de concursos y los comandos de voz en el dispositivo; Lua los conecta con tu servidor.
Captura: Garry's Mod © Valve
Qué se ejecuta en el servidor y qué en el cliente
Los addons de Garry's Mod son carpetas con scripts de Lua y contenido, que se instalan en garrysmod/addons o se suscriben a través del Steam Workshop. Lua se ejecuta en dos reinos, y un addon de NPC de IA se reparte limpiamente entre ellos. El wiki de Garry's Mod documenta cada función.
| Tarea | Reino | Herramienta |
|---|---|---|
| NPC, entidades, lógica del juego | Servidor | Entidades Lua |
| Llamar a Neocortex, guardar la clave de API | Servidor | HTTP(), http.Fetch, http.Post |
| Enviar respuestas a los jugadores | Del servidor al cliente | La biblioteca net |
| Subtítulos y HUD | Cliente | chat.AddText o un panel HUD propio |
| Reproducción de voz | Cliente | sound.PlayURL |
| Comandos de voz | Cliente | Neocortex Voice Commands en el equipo del jugador |
Hay algunos detalles que importan. HTTP() lanza una petición asíncrona con una URL, un método, cabeceras, un cuerpo y callbacks, y http.Fetch y http.Post la envuelven para casos sencillos; el callback de éxito también se activa con códigos de estado de error, así que comprueba siempre el código. sound.PlayURL reproduce archivos de sonido externos, así que sirve la voz generada desde un pequeño endpoint que controles, y los clientes pueden reproducirla sin ver nunca la clave de API. Los módulos nativos (gmsv_ para el servidor, gmcl_ para el cliente) van en garrysmod/lua/bin y se cargan con require, pero no se pueden instalar a través de un addon del Workshop, así que todo lo nativo es una instalación aparte para los jugadores o los dueños del servidor.
NPC de rol con los que los jugadores pueden hablar
En un servidor de rol, dale a la ciudad un reparto: un tendero que regatea y recuerda quién no le pagó, un camarero que conoce el lore del servidor, un despachante de policía que reacciona a lo que denuncian los jugadores. Cada personaje recibe una Personality, un ajuste de Emotion y una base de Knowledge en el editor de Neocortex, con cosas como las reglas de tu servidor, los lugares del mapa y tu economía.
Los jugadores pulsan use sobre el NPC y escriben en el chat. Tu addon envía el mensaje junto con los objetos cercanos (el mostrador de la tienda, la máquina expendedora, la puerta de la cárcel) y los eventos recientes ("han arrestado a un jugador", "suena la alarma del banco"). El personaje responde con una etiqueta de emoción en cada línea y con acciones como { "name": "OPEN_DOOR", "targetId": "jail_door" } que el addon ejecuta en el servidor.
El chat de grupo (planes Pro y Team) reúne hasta seis personajes en una misma conversación, así que una banda de NPC puede discutir con un jugador a la vez. Un Conversation Flow puede dirigir una escena más larga, como un informe previo a un atraco de rol, y devolver palabras clave de checkpoint (flowState) a las que el addon reacciona.
Organizar una noche de concursos
El motor de concursos (plan Team) convierte un escenario, unos pulsadores y un marcador en un evento del servidor:
- Creas el conjunto de preguntas en el panel de Neocortex: una noche de trivial para el servidor, un concurso de lore para nuevos jugadores de rol o una prueba de reglas que los nuevos jugadores deben superar antes de conseguir un trabajo.
- Un NPC presentador en el escenario abre la ronda.
- Los jugadores responden en el chat, y el addon envía cada respuesta al motor de concursos a través de
/v3/quiz. - El presentador anuncia quién acierta, y el motor de concursos se encarga de la puntuación y de la clasificación.
- Entre rondas, tu addon dibuja la clasificación en un panel HUD.
Captura: Garry's Mod © Valve
Ayudantes que siguen comandos de voz
Dale a cada jugador un NPC ayudante que escuche: "sígueme", "espera aquí", "vigila la puerta", "trae dos cajas". En el panel de Neocortex diseñas un conjunto de comandos como actores, acciones y objetos: actor "helper", acciones "follow", "wait", "guard" y "bring", y objetos "me", "door" y "crate".
Los jugadores hablan con naturalidad, y el addon recibe los comandos reconocidos al instante, incluidas varias acciones y cantidades en una sola frase. Funciona con pulsar para hablar o con escucha continua, en varios idiomas, sin ir y volver a la nube. Como se ejecuta en el equipo del jugador, la parte de cliente envía los comandos reconocidos al servidor.
Voice Commands es un SDK con licencia: contáctanos para obtener una licencia de Voice Commands.
El código del addon de NPC de IA para Garry's Mod
Todo lo que toca la API se ejecuta en el servidor. El servidor lee el estado del juego y lo envía con el mensaje del jugador a un personaje de Neocortex mediante /v3/chat, después 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:
-- 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
})
endNormas de la casa para los NPC de IA
Los servidores de Garry's Mod establecen sus propias normas, así que ejecuta los addons de NPC de IA solo en servidores que sean tuyos o donde el dueño esté de acuerdo, y di a los jugadores que están hablando con una IA. Sigue las normas del Steam Workshop al publicar, y asegúrate de que cada dueño de servidor use su propia clave de API de Neocortex. Añade un enfriamiento por jugador para que nadie pueda saturar al NPC.
En resumen para los dueños de servidores
Cinco pasos te llevan de una carpeta vacía a un NPC que habla:
- Crea una carpeta de addon con un archivo Lua del servidor y una entidad de NPC que se pueda generar.
- Diseña tus personajes en el panel de Neocortex: un tendero, un presentador de concursos con un conjunto de preguntas y un conjunto de comandos para los ayudantes.
- Llama a
/v3/chaty/v3/quizdesde el servidor conHTTP(), y envía las respuestas a los jugadores con la bibliotecanet. - Guarda la clave de API en un archivo de configuración del servidor, nunca en el Lua del cliente ni en una subida al Workshop.
- Prueba en un servidor local de escucha con un amigo antes de ejecutarlo en un servidor público.
Empieza por el tendero. Un personaje, una llamada a HTTP() y un hook de chat bastan para mostrar a tus jugadores lo que puede hacer un NPC de Neocortex, y el concurso se construye sobre el mismo código del servidor. Para saber cómo funcionan los comandos de voz en el equipo del jugador, lee comandos de voz en el dispositivo para mods de juegos. Para mods a nivel de motor de Source, consulta nuestra guía del mod de NPC de IA de Half-Life 2.
Versiones de herramientas y enlaces revisados en octubre de 2026. Las herramientas de modding cambian con frecuencia; consulta la página de cada proyecto para la versión más reciente.
Preguntas frecuentes
¿Se pueden añadir NPC de IA a Garry's Mod?
Sí. Los addons de Garry's Mod se escriben en Lua y el juego tiene una función HTTP() integrada, así que un addon del lado del servidor puede enviar lo que dicen los jugadores a un personaje de IA y actuar según la respuesta. Neocortex aporta el personaje, su voz y las acciones que devuelve.
¿Puede un addon de Garry's Mod llamar a una API web?
Sí. La función global HTTP() y los ayudantes http.Fetch y http.Post hacen peticiones asíncronas desde el servidor o el cliente. Para un addon de NPC de IA, haz las llamadas en el servidor para que tu clave de API de Neocortex nunca llegue a los jugadores.
¿Cómo organizo un concurso en un servidor de Garry's Mod?
Genera un NPC presentador, envía las respuestas del chat de los jugadores a un motor de concursos y muestra las puntuaciones en un panel HUD. El motor de concursos de Neocortex se encarga de las preguntas, la puntuación y la clasificación, así que tu addon solo gestiona el escenario y el chat.
¿Pueden los NPC de Garry's Mod seguir comandos de voz?
Sí, con un componente del lado del cliente. Neocortex Voice Commands se ejecuta en el PC de cada jugador y convierte frases como "sígueme" o "vigila la puerta" en comandos que tu addon recibe al instante, sin conexión. Como se ejecuta en el equipo del jugador, los jugadores instalan la parte de voz junto con el addon del Workshop.
¿Dónde guardo la clave de API en un servidor de Garry's Mod?
Solo en el servidor, por ejemplo en un archivo de la carpeta de datos del servidor que tu addon lee al arrancar. Nunca pongas la clave en el Lua del cliente ni en una subida al Workshop, porque todos los jugadores descargan esos archivos.






