Neocortex Logo

Addon de NPC de IA para Garry's Mod: NPCs inteligentes e apresentador de quiz

Crie um addon de NPC de IA para Garry's Mod em Lua: NPCs inteligentes para servidores de sandbox e roleplay, um apresentador de quiz multijogador com ranking e comandos de voz.

Neocortex TeamThe team behind Neocortex

· 6 min de leitura

Crie um addon de NPC de IA para Garry's Mod em Lua: NPCs inteligentes para servidores de sandbox e roleplay, um apresentador de quiz multijogador com ranking e comandos de voz.

Um addon de NPC de IA para Garry's Mod é um addon em Lua que envia o que os jogadores dizem a um personagem de IA pela função HTTP() integrada do jogo e age de acordo com a resposta. Os servidores de Garry's Mod vivem do que os jogadores inventam, e NPCs que apenas ficam parados são uma oportunidade perdida. Com a Neocortex, os servidores de sandbox e roleplay ganham personagens que realmente conversam: um lojista que negocia, um apresentador de quiz que conduz um jogo para o servidor inteiro e ajudantes que seguem comandos de voz. A Neocortex fornece os personagens de IA, os Conversation Flows, o motor de quiz e os comandos de voz no dispositivo; o Lua os conecta ao seu servidor.

Captura de tela do Garry's Mod durante o jogo Captura de tela: Garry's Mod © Valve

O que roda no servidor e o que roda no cliente

Addons do Garry's Mod são pastas com scripts Lua e conteúdo, instaladas em garrysmod/addons ou assinadas pela Steam Workshop. O Lua roda em dois ambientes, e um addon de NPC de IA se divide bem entre eles. A wiki do Garry's Mod documenta todas as funções.

TarefaAmbienteFerramenta
NPCs, entidades, lógica do jogoServidorEntidades Lua
Chamar a Neocortex, guardar a chave de APIServidorHTTP(), http.Fetch, http.Post
Enviar respostas aos jogadoresServidor para clienteA biblioteca net
Legendas e HUDClientechat.AddText ou um painel de HUD próprio
Reprodução de vozClientesound.PlayURL
Comandos de vozClienteNeocortex Voice Commands na máquina do jogador

Alguns detalhes importam. HTTP() dispara uma requisição assíncrona com uma URL, método, cabeçalhos, corpo e callbacks, e http.Fetch e http.Post a encapsulam para casos simples; o callback de sucesso também é chamado para códigos de erro, então sempre verifique o código. sound.PlayURL reproduz arquivos de som externos, então sirva a voz gerada a partir de um pequeno endpoint que você controla, e os clientes podem transmiti-la sem nunca ver a chave de API. Módulos nativos (gmsv_ para o servidor, gmcl_ para o cliente) vão em garrysmod/lua/bin e são carregados com require, mas não podem ser instalados por um addon da Workshop, então qualquer coisa nativa é uma instalação separada para os jogadores ou para o dono do servidor.

NPCs de roleplay com quem os jogadores podem conversar

Em um servidor de roleplay, dê à cidade um elenco: um lojista que negocia e lembra de quem o deixou no prejuízo, um barman que conhece o lore do servidor, um despachante da polícia que reage ao que os jogadores relatam. Cada personagem recebe uma Personality, uma configuração de Emotion e uma base de Knowledge no editor da Neocortex, como as regras do seu servidor, os locais do mapa e a sua economia.

Os jogadores apertam o botão de uso no NPC e digitam no chat. O seu addon envia a mensagem junto com objetos próximos (o balcão da loja, a máquina de venda, a porta da cadeia) e eventos recentes ("um jogador foi preso", "o alarme do banco está tocando"). O personagem responde com uma tag de emoção em cada linha e com ações como { "name": "OPEN_DOOR", "targetId": "jail_door" }, que o addon executa no servidor.

O chat em grupo (planos Pro e Team) coloca até seis personagens em uma mesma conversa, então um bando de NPCs pode discutir com um jogador ao mesmo tempo. Um Conversation Flow pode conduzir uma cena mais longa, como um briefing de assalto em roleplay, e devolver palavras-chave de checkpoint (flowState) às quais o addon reage.

Organizando uma noite de quiz

O motor de quiz (plano Team) transforma um palco, alguns botões de resposta e um placar em um evento do servidor:

  1. Você monta o conjunto de perguntas no painel da Neocortex: uma noite de trivia do servidor, um quiz de lore para novos roleplayers ou uma checagem das regras que os novos jogadores precisam passar antes de conseguir um emprego.
  2. Um NPC apresentador no palco abre a rodada.
  3. Os jogadores respondem no chat, e o addon encaminha cada resposta ao motor de quiz por /v3/quiz.
  4. O apresentador anuncia quem acertou, e o motor de quiz cuida da pontuação e do ranking.
  5. Entre as rodadas, o seu addon mostra a classificação em um painel de HUD.

Captura de tela do Garry's Mod durante o jogo Captura de tela: Garry's Mod © Valve

Ajudantes que seguem comandos de voz

Dê a cada jogador um NPC ajudante que escuta: "me siga", "espere aqui", "guarde a porta", "traga duas caixas". No painel da Neocortex, você define um conjunto de comandos como atores, ações e objetos: ator "helper", ações "follow", "wait", "guard" e "bring", objetos "me", "door" e "crate".

Os jogadores falam naturalmente, e o addon recebe os comandos reconhecidos na hora, inclusive várias ações e quantidades em uma mesma frase. Funciona com pressionar para falar ou com escuta contínua, em vários idiomas, sem ida e volta à nuvem. Como roda na máquina do jogador, o lado do cliente envia os comandos reconhecidos ao servidor.

Voice Commands é um SDK licenciado: entre em contato para obter uma licença de Voice Commands.

O código do addon de NPC de IA para Garry's Mod

Tudo que toca a API roda no lado do servidor. O servidor lê o estado do jogo e o envia junto com a mensagem do jogador para um personagem da Neocortex por /v3/chat, depois mostra a resposta como legendas, reproduz a voz de /v3/audio/generate ou /v3/audio/stream e executa as ações que o personagem devolve:

-- 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
    })
end

Regras da casa para NPCs de IA

Os servidores de Garry's Mod definem suas próprias regras, então rode addons de NPC de IA apenas em servidores que você administra ou nos quais o dono concorda, e diga aos jogadores que eles estão conversando com uma IA. Siga as regras da Steam Workshop quando publicar, e garanta que cada dono de servidor use a sua própria chave de API da Neocortex. Adicione um cooldown por jogador para que um jogador não consiga fazer spam no NPC.

Resumo para donos de servidor

Cinco passos levam você de uma pasta vazia a um NPC falante:

  1. Crie uma pasta de addon com um arquivo Lua do servidor e uma entidade de NPC que possa ser criada.
  2. Crie os seus personagens no painel da Neocortex: um lojista, um apresentador de quiz com um conjunto de perguntas e um conjunto de comandos para os ajudantes.
  3. Chame /v3/chat e /v3/quiz a partir do servidor com HTTP(), e envie as respostas aos jogadores com a biblioteca net.
  4. Guarde a chave de API em um arquivo de configuração do servidor, nunca no Lua do cliente nem em um upload da Workshop.
  5. Teste em um servidor de escuta local com um amigo antes de rodar em um servidor público.

Comece pelo lojista. Um personagem, uma chamada de HTTP() e um hook de chat bastam para mostrar aos seus jogadores o que um NPC da Neocortex é capaz de fazer, e o show de quiz se apoia no mesmo código do servidor. Para entender como os comandos de voz funcionam na máquina do jogador, leia comandos de voz no dispositivo para mods de jogos. Para mods de engine em Source, veja nosso guia do mod de NPC de IA para Half-Life 2.

Versões das ferramentas e links verificados em outubro de 2026. Ferramentas de modding mudam com frequência; confira a página de cada projeto para a versão mais recente.

Perguntas frequentes

Dá para adicionar NPCs de IA ao Garry's Mod?

Sim. Os addons do Garry's Mod são escritos em Lua e o jogo tem a função HTTP() integrada, então um addon do lado do servidor pode enviar o que os jogadores dizem a um personagem de IA e agir de acordo com a resposta. A Neocortex fornece o personagem, a voz dele e as ações que ele devolve.

Um addon de Garry's Mod pode chamar uma API web?

Sim. A função global HTTP() e os auxiliares http.Fetch e http.Post fazem requisições assíncronas a partir do servidor ou do cliente. Para um addon de NPC de IA, faça as chamadas no servidor para que a sua chave de API da Neocortex nunca chegue aos jogadores.

Como faço um show de quiz em um servidor de Garry's Mod?

Crie um NPC apresentador, encaminhe as respostas do chat dos jogadores para um motor de quiz e mostre as pontuações em um painel de HUD. O motor de quiz da Neocortex executa as perguntas, a pontuação e o ranking, então o seu addon só cuida do palco e do chat.

Os NPCs do Garry's Mod podem seguir comandos de voz?

Sim, com um componente do lado do cliente. O Neocortex Voice Commands roda no PC de cada jogador e transforma frases como "follow me" ou "guard the door" em comandos que o seu addon recebe na hora, offline. Como roda na máquina do jogador, os jogadores instalam a parte de voz junto com o addon da Workshop.

Onde guardo a chave de API em um servidor de Garry's Mod?

Apenas no servidor, por exemplo em um arquivo na pasta de dados do servidor que o seu addon lê na inicialização. Nunca coloque a chave no Lua do cliente nem em um upload da Workshop, já que todo jogador baixa esses arquivos.

Artigos semelhantes

Continue lendo