Mod de IA para Portal 2: IA falante e comandos de voz
Crie um mod de IA para Portal 2: uma IA sarcástica de câmara de teste que reage às suas tentativas, câmaras controladas por voz e um quiz de ciência, conectados pelo VScript.
Neocortex TeamThe team behind Neocortex
· 6 min de leitura

Os scripts de mapa do Portal 2 não conseguem acessar a internet. Esse é o único problema que todo mod de IA para Portal 2 precisa resolver, e a resposta é um pequeno aplicativo auxiliar que roda ao lado do jogo. Depois que ele está no lugar, a sua câmara de teste pode ter a própria IA falante, o que combina com um jogo sobre ser julgado por uma voz nas paredes: uma câmara que percebe você falhando o mesmo salto cinco vezes e tem algo a dizer sobre isso, uma câmara que você controla falando, e um quiz que só abre a saída para respostas certas. A Neocortex fornece o personagem de IA, os Fluxos de Conversa, os quizzes e os comandos de voz no próprio dispositivo.
Captura de tela: Portal 2 © Valve
Por que um mod de IA para Portal 2 precisa de um aplicativo auxiliar?
Os mapas de Portal 2 são feitos no Hammer com as Portal 2 Authoring Tools e compartilhados na Oficina da Steam. A lógica do mapa é entrada e saída de entidades mais o VScript, que no Portal 2 é Squirrel. O VScript pode ler e mover entidades, acompanhar o jogador e imprimir no console, mas não tem acesso à rede nem a HTTP.
Assim, o mapa faz o que consegue: relatar e reagir, e um aplicativo auxiliar local faz a comunicação com a Neocortex. O auxiliar pode ser escrito em qualquer linguagem com um cliente HTTP.
Como os eventos saem do jogo e voltam?
| Direção | Como |
|---|---|
| Saindo do jogo | O seu VScript imprime linhas marcadas (um evento, um estado da câmara) no console. Abrir o Portal 2 com -condebug grava a saída do console em um arquivo console.log que o auxiliar pode observar. Veja as opções de linha de comando da Valve. |
| Voltando ao jogo | A opção de inicialização -netconport abre uma porta de console que permite ao auxiliar enviar comandos de volta, por exemplo uma chamada script para o VScript do seu mapa. Mantenha essa porta na sua própria máquina. |
| Legendas | O seu mapa mostra o texto da resposta com uma entidade game_text. |
| Voz | O auxiliar toca a voz do personagem pela saída de áudio do PC. |
Do lado da Neocortex, o auxiliar lê o estado do jogo no log do console e envia junto com a mensagem do jogador para um personagem por meio de /v3/chat. O mapa mostra a resposta como legendas, o auxiliar toca a voz de /v3/audio/generate ou /v3/audio/stream, e as ações que o personagem devolve voltam ao mapa como comandos de console. Os Fluxos de Conversa devolvem palavras-chave de checkpoint (flowState) às quais o mapa reage, como abrir o próximo teste, e o motor de quiz executa jogos de perguntas e respostas por meio de /v3/quiz.
O que uma IA de câmara de teste pode fazer?
Crie um supervisor original em vez de tomar emprestado o do jogo: o PROCTOR-7, uma inteligência da instalação que foi rebaixada para cuidar de uma única câmara e não está nada feliz com isso. Dê a ele uma Personalidade, uma configuração de Emoção e uma base de Conhecimento sobre a solução da sua câmara, a história dela e as suas pequenas queixas.
O seu mapa informa o que acontece: "jogador caiu na gosma", "terceiro lançamento falho no painel B", "cubo colocado no botão errado", "jogador parado há 40 segundos". O auxiliar envia esses dados como eventos junto com cada mensagem, e o PROCTOR-7 comenta em voz, com uma tag de emoção em cada linha: CURIOUS quando você tenta algo novo, ANGRY quando você quebra a solução pretendida.
Ele também pode devolver ações, como um relutante { "name": "SPAWN_CUBE", "targetId": "dropper_01" } depois de falhas suficientes, que o seu mapa executa como uma dica.
Um Fluxo de Conversa pode transformar a câmara inteira em uma história: introdução, primeiro teste, uma "falha" que o jogador precisa guiar o PROCTOR-7 para resolver, e um teste final. Cada palavra-chave de checkpoint que a API devolve abre a parte seguinte do mapa.
Captura de tela: Portal 2 © Valve
O jogador consegue resolver uma câmara falando?
Sim. Monte uma câmara que o jogador resolve conversando com ela. No painel da Neocortex, você desenha um conjunto de comandos como atores, ações e objetos: ator "câmara", ações "elevar", "abaixar", "soltar" e "estender", objetos "plataforma", "cubo" e "ponte".
Os jogadores falam naturalmente, e o auxiliar recebe os comandos reconhecidos na hora, inclusive várias ações e quantidades em uma frase: "solte dois cubos e eleve a plataforma". Funciona com pressionar para falar ou escuta contínua, em vários idiomas, e os Comandos de Voz da Neocortex rodam na máquina do jogador, sem ida e volta à nuvem, o que importa quando o tempo de um lançamento depende disso.
Os Comandos de Voz são um SDK licenciado: fale conosco para obter uma licença de Comandos de Voz.
A mesma câmara pode testar conhecimento em vez de reflexos. Um personagem apresentador faz perguntas de física criadas no painel da Neocortex: momento linear, gravidade, por que um portal mantém a sua velocidade. O motor de quiz (plano Team) executa as perguntas e a pontuação; cada resposta certa acende mais um segmento da ponte de luz, e uma errada deixa um cubo cair na gosma.
Funciona no Portal 2: Community Edition?
O Portal 2: Community Edition é uma versão do Portal 2 mantida pela comunidade, sobre o Strata Source, um fork licenciado oficialmente do ramo da engine do CS:GO. Entrou em beta aberto na Steam em 17 de abril de 2026, é grátis para quem possui o Portal 2 e acrescenta um port nativo de 64 bits, scripting em AngelScript, interface Panorama, um sistema de addons e uma Oficina própria.
Ele ainda está em beta, então confira a documentação dele para ver o que o scripting pode fazer. O padrão do aplicativo auxiliar funciona ali de qualquer forma.
Dá para publicar na Oficina?
As regras da Oficina da Valve se aplicam ao mapa, e o aplicativo auxiliar é um download separado que os jogadores escolhem executar. Restrinja os recursos de IA e de voz a câmaras para um jogador, nunca os use para obter vantagem no cooperativo com jogadores que não optaram por isso, e faça cada jogador usar a própria chave de API da Neocortex.
Crie a sua primeira câmara falante
- Monte uma câmara de teste no Hammer com um arquivo VScript que imprime eventos marcados no console.
- Desenhe o seu personagem no painel da Neocortex: a Personalidade e o Conhecimento do PROCTOR-7, um Fluxo de Conversa para a câmara, um quiz e um conjunto de comandos.
- Escreva o aplicativo auxiliar: observe o
console.log, chame/v3/chat, toque a voz e envie comandos de volta pela porta de console. - Guarde a chave de API no arquivo de configuração do auxiliar, preenchido pelo jogador, nunca fixada no código de uma versão que você compartilha.
- Teste em um jogador com as opções de inicialização definidas, depois publique o mapa na Oficina e o auxiliar separadamente.
Para o lado da voz, leia comandos de voz no próprio dispositivo para mods de jogos. Para mods no nível da engine na Source, veja o nosso guia do mod de NPC com IA para Half-Life 2, e para um jogo da Source cujos scripts podem chamar a API diretamente, o nosso guia do mod de IA para Titanfall 2. E se você quiser o PROCTOR-7 em um jogo independente depois, o mesmo personagem da Neocortex funciona pela nossa integração com a Unity.
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 a versão mais recente.
Perguntas frequentes
Dá para adicionar um personagem de IA ao Portal 2?
Sim, com um pequeno aplicativo auxiliar. Os scripts de mapa do Portal 2 não acessam a internet, então o mapa imprime eventos no console e um aplicativo auxiliar local os repassa a um personagem de IA. A Neocortex fornece o personagem, a voz e as respostas, e o auxiliar as envia de volta ao jogo.
O VScript do Portal 2 consegue fazer requisições HTTP?
Não. O VScript no Portal 2 é Squirrel rodando dentro do mapa, sem acesso à rede. O padrão comum é registrar eventos no console, lê-los em um aplicativo auxiliar e deixar esse aplicativo chamar APIs web como a da Neocortex.
Posso controlar uma câmara de teste do Portal 2 com a minha voz?
Sim. Um aplicativo auxiliar pode escutar o microfone e enviar comandos reconhecidos para o jogo, como elevar uma plataforma ou soltar um cubo. Os Comandos de Voz da Neocortex fazem o reconhecimento no PC do jogador, então funcionam offline e respondem na hora.
O que é o Portal 2: Community Edition?
O Portal 2: Community Edition é uma versão do Portal 2 mantida pela comunidade, sobre a engine Strata Source, em beta aberto na Steam desde abril de 2026 e grátis para quem possui o Portal 2. Ele acrescenta AngelScript, interface Panorama e um sistema de addons, e o padrão de aplicativo auxiliar para a Neocortex funciona ali também.
Posso publicar uma câmara de teste com IA na Oficina da Steam?
Você pode publicar o mapa na Oficina normalmente, mas o aplicativo auxiliar precisa ser compartilhado separadamente, por exemplo no GitHub. Cada jogador o executa com a própria chave de API da Neocortex, que pode ser obtida no editor do navegador.






