Neocortex Logo

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

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.

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 de Portal 2 durante o jogo 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çãoComo
Saindo do jogoO 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 jogoA 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.
LegendasO seu mapa mostra o texto da resposta com uma entidade game_text.
VozO 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 de Portal 2 durante o jogo 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

  1. Monte uma câmara de teste no Hammer com um arquivo VScript que imprime eventos marcados no console.
  2. 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.
  3. Escreva o aplicativo auxiliar: observe o console.log, chame /v3/chat, toque a voz e envie comandos de volta pela porta de console.
  4. 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.
  5. 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.

Artigos semelhantes

Continue lendo