Neocortex Logo

Mod de NPCs com IA para Half-Life 2: esquadrão por voz

Planeje um mod de NPCs com IA para Half-Life 2 no Source SDK 2013: um esquadrão rebelde que você comanda por voz, um companheiro que responde, cenas de história no esconderijo e um terminal de quiz.

Neocortex TeamThe team behind Neocortex

· 6 min de leitura

Planeje um mod de NPCs com IA para Half-Life 2 no Source SDK 2013: um esquadrão rebelde que você comanda por voz, um companheiro que responde, cenas de história no esconderijo e um terminal de quiz.

O Half-Life 2 tem uma IA de esquadrão que escuta teclas, e um mundo cheio de pessoas que só dizem o que o roteiro permite. Os rebeldes seguem você, mas você não consegue dar ordens a eles; os cidadãos falam, mas nunca sobre o que acabou de acontecer. Um mod de NPCs com IA para Half-Life 2 resolve as duas coisas: rebeldes que reagem às suas ordens em voz alta, um companheiro que fala sobre a luta que você acabou de sobreviver e cenas de história que se dobram às escolhas do jogador. A Neocortex adiciona os personagens de IA, os Conversation Flows, os quizzes e os comandos de voz no dispositivo, e o Source SDK 2013 fornece o código para conectar tudo.

Captura de tela do Half-Life 2 no jogo Captura de tela: Half-Life 2 © Valve

Ordens por voz para um esquadrão rebelde

O Half-Life 2 já permite mandar o seu esquadrão para um ponto e chamá-lo de volta. Os comandos de voz trocam a tecla por fala: "avance", "segure aqui", "se abrigue atrás do carro", "reagrupe comigo".

No painel da Neocortex você desenha o conjunto de comandos como atores, ações e objetos: ator "esquadrão", ações "mover", "segurar" e "abrigar", objetos como "eu", "carro" e "porta". Os jogadores falam naturalmente, e o mod recebe os comandos reconhecidos na hora, inclusive várias ações e quantidades em uma só frase: "dois de vocês vigiam a porta, o resto me segue". O seu código os mapeia para o código de esquadrão que já existe.

Funciona com pressionar para falar ou com escuta contínua, em vários idiomas, e roda na máquina do jogador, então as ordens chegam no meio de um tiroteio sem uma ida e volta à nuvem.

Os Voice Commands são um SDK licenciado: fale conosco para uma licença de Voice Commands.

Exemplo prático: Mara Venn e o esconderijo

O companheiro. Crie um companheiro original, digamos Mara Venn, uma ex-médica de campo que entrou para a resistência depois que a clínica dela foi fechada. O seu mod envia a pergunta do jogador junto com o que o jogo sabe: objetos próximos (a barricada, a caixa de munição, o rádio) e eventos recentes ("dois membros do esquadrão caídos", "o jogador pegou o túnel da esquerda", "vida abaixo de 30"). Mara responde em voz, com uma tag de emoção em cada fala, e pode devolver ações como entregar um kit médico ou abrir o portão que o jogador pediu.

O esquadrão discute. O group chat (planos Pro e Team) permite que até seis personagens compartilhem uma conversa, então o esquadrão inteiro pode discutir o próximo movimento.

O porão. Mara leva o jogador a um esconderijo no porão, onde ele precisa conquistar a confiança de um líder cauteloso de célula antes de ele revelar a rota para sair da cidade. Um Conversation Flow define as etapas: apresentações, provar de que lado você está, o acordo, a rota. O personagem conduz a conversa por essas etapas, não importa como o jogador se expresse, e a API devolve palavras-chave de checkpoint como TRUST_EARNED ou ROUTE_SHARED. O seu mod reage abrindo a porta escondida ou fazendo surgir o guia que tira você da cidade.

O terminal. No canto, um terminal treina novos recrutas: quais unidades inimigas evitar, como sinalizar ao esquadrão, que suprimentos levar. O motor de quiz da Neocortex (plano Team) executa as perguntas e a pontuação, e uma sequência de acertos pode recompensar o jogador com munição ou um atalho.

Captura de tela do Half-Life 2 no jogo Captura de tela: Half-Life 2 © Valve

Ramos do Source SDK 2013 para um mod de NPCs com IA no Half-Life 2

O Half-Life 2 roda no Source. Um mod é uma pasta com o seu próprio gameinfo.txt, conteúdo e duas bibliotecas C++ compiladas a partir do código da Valve: uma DLL de servidor para a IA dos NPCs, os esquadrões e a lógica do jogo, e uma DLL de cliente para o HUD, os painéis VGUI e os efeitos locais. Escolha a base antes de qualquer coisa:

BaseO que contémSituação
Source SDK 2013 ramo singleplayerO código do Half-Life 2 para um jogadorSem atualização de código desde 2015; roda no Source SDK Base 2013 Singleplayer de 32 bits
Source SDK 2013 ramo masterO código multijogadorAtualizado em fevereiro de 2025 com o código do jogo Team Fortress 2 e builds de 64 bits; a Valve ainda faz commits nele
MapbaseUma base mantida pela comunidade para mods de um jogadorVersão 8.0 lançada em julho de 2025, com novas entidades, correções e uma implementação de VScript para scripts de mapa

Para um mod de história como o do esconderijo acima, comece pelo ramo singleplayer ou pelo Mapbase.

Chamando a Neocortex a partir de uma DLL do Source

Os cabeçalhos do SDK incluem a interface HTTP da Steamworks, e muitos modders adicionam a libcurl no lugar. Em qualquer caso, execute as requisições em uma thread de trabalho e devolva os resultados ao loop do jogo. Uma chamada de chat a partir da DLL de cliente ou 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
}

O mod lê o estado do jogo e o envia junto com a mensagem do jogador para um personagem da Neocortex por meio de /v3/chat, 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. Os Conversation Flows devolvem palavras-chave de checkpoint (flowState) na mesma resposta, o motor de quiz funciona por /v3/quiz, e os comandos de voz no dispositivo transformam frases faladas em ações do jogo sem uma ida e volta à nuvem, com o Neocortex Voice Commands rodando na máquina do jogador.

Para a interface, os painéis VGUI da DLL de cliente podem mostrar legendas e uma tela de quiz. As legendas de fechamento e os soundscripts do Source foram feitos para falas pré-escritas, então as respostas de IA ao vivo costumam ter o próprio painel de legendas, com o áudio gerado salvo em um arquivo e tocado pelo motor.

Antes de publicar: a licença do Source SDK 1

A licença do Source SDK 1 permite distribuir mods apenas de graça; mods gratuitos podem ser publicados na Steam. Mantenha os mods de NPCs com IA para um jogador, nunca os use em servidores multijogador contra as regras e faça com que cada jogador use a própria chave de API da Neocortex.

Do mapa vazio ao esquadrão que fala

  1. Configure o Source SDK 2013. Escolha o ramo singleplayer ou o Mapbase para um mod de história, compile e abra um mapa de teste vazio.
  2. Crie os seus personagens no painel da Neocortex: um companheiro, um líder de célula com um Conversation Flow, um quiz para o terminal e um conjunto de comandos para o esquadrão.
  3. Chame a API a partir da DLL do jogo em uma thread de trabalho e reutilize o sessionId de cada resposta.
  4. Guarde a chave de API em um arquivo de configuração que o jogador preenche, nunca escrita diretamente em um mod que você compartilhe.
  5. Conecte legendas, voz e ações, e depois mapeie os comandos de voz para o código de esquadrão que já existe.
  6. Teste em um jogador em um mapa antes de partir para uma campanha completa.

Para ver como os comandos de voz funcionam em um mod, leia comandos de voz no dispositivo para mods de jogos. Para GoldSrc, veja o nosso guia do mod de NPCs com IA para Half-Life, e para servidores sandbox do Source, o post sobre o addon de NPCs com IA e quiz para o Garry's Mod. A Mara e o esquadrão dela podem ser testados hoje no editor do navegador da Neocortex, muito antes de o primeiro mapa compilar.

Versões das ferramentas e links verificados em outubro de 2026. As ferramentas de modding mudam com frequência; confira a página de cada projeto para ver o lançamento mais recente.

Perguntas frequentes

Dá para adicionar NPCs com IA ao Half-Life 2?

Sim. Os mods do Half-Life 2 são construídos com o Source SDK 2013 da Valve, que oferece o código C++ completo do jogo, então um mod pode chamar uma API web e agir de acordo com a resposta. A Neocortex fornece o personagem de IA, a voz dele e as ações que ele devolve, e o seu mod as executa.

Devo usar o ramo singleplayer ou multiplayer do Source SDK 2013?

Mods de história costumam começar pelo ramo singleplayer ou por uma base da comunidade construída sobre ele, como o Mapbase. O ramo multiplayer recebeu uma grande atualização com suporte a 64 bits em 2025 e continua mantido, mas o código dele é voltado para jogos multijogador. A Neocortex funciona com qualquer um dos dois, porque é uma API web simples.

Dá para comandar os rebeldes do Half-Life 2 por voz?

Dá, com um mod. O Half-Life 2 já tem código de comando de esquadrão, e um mod pode acioná-lo a partir da fala. O Neocortex Voice Commands reconhece frases naturais no PC do jogador, então "avance", "segure aqui" e "reagrupe" chegam ao seu código na hora e sem internet.

Dá para vender um mod do Half-Life 2 com personagens de IA?

Não. A licença do Source SDK 1 permite distribuir mods apenas de graça, embora mods gratuitos possam ser publicados na Steam. Você pode construir e testar o lado da Neocortex de um mod gratuito no editor do navegador.

Artigos semelhantes

Continue lendo