NPCs que reagem a eventos do mundo: cidades que percebem
Faça NPCs reagirem a eventos do mundo com a Neocortex: envie o que acabou de acontecer, como uma ponte desabada ou um duelo vencido, e os personagens falam sobre isso dentro do papel.
Neocortex TeamThe team behind Neocortex
· 6 min de leitura

O jogador derruba um tirano, cavalga até a cidade seguinte, e a primeira pessoa que encontra diz "Que tempo bonito hoje." A Neocortex permite que você conte aos seus NPCs o que acabou de acontecer no mundo, então a cidade comenta o duelo, a tripulação amaldiçoa o ataque, e a próxima pessoa com quem o jogador conversa já ficou sabendo da notícia.
Como fica na prática
Dry Fork é uma cidade do boom da prata em um faroeste original. Em dez minutos, acontecem duas coisas. A ponte ferroviária sobre o desfiladeiro desaba, isolando a cidade do sul. Depois, o jogador vence um duelo na Main Street contra Silas Vane, o pistoleiro contratado pela companhia de mineração.
O jogo transforma as duas coisas em eventos. No saloon Lucky Dollar, três personagens já estão em um group chat: Hattie Brooks, dona do lugar; o Doc Ambrose, que remendou quase toda a cidade; e Ezra Pell, o jovem e nervoso telegrafista. Quando o jogador passa pela porta, o jogo adiciona um evento dizendo que o estranho que atirou em Vane acabou de entrar, e pede um turno ambiente:
Ezra: É ele. Foi ele quem fez aquilo. Hattie: Senta, Ezra. Quem enterrou o Silas Vane merece uma bebida de graça esta noite. Doc Ambrose: De graça até a companhia mandar alguém mais rápido. E com a ponte caída, eles vão ter que dar a volta toda para chegar aqui.
A fala de Hattie traz uma ação POUR_DRINK direcionada ao jogador, e o jogo desliza um copo pelo balcão.
Lá fora, na estrebaria, Juniper, o tratador de cavalos, é um personagem único, sem fazer parte de nenhum grupo. Ela ainda não disse nada. Quando o jogador se aproxima e pergunta se pode comprar um cavalo, o jogo envia os dois eventos junto com a mensagem do jogador, e ela começa falando da ponte: nenhum cavalo do estábulo consegue levá-los ao sul agora, mas ela conhece uma trilha pelo desfiladeiro para quem pagar o preço certo.
Como a Neocortex faz isso funcionar
- Eventos. Adicione uma lista
eventsa qualquer requisição de chat, com cada item tendo uma prioridade e uma frase simples: "a ponte ferroviária desabou", "o jogador venceu o duelo". Os personagens incorporam isso no que dizem em seguida. - Personagens individuais em todos os planos. Envie os eventos junto com a próxima mensagem do jogador, e o personagem reage na resposta. Isso funciona em todos os planos.
- Turnos ambientes. No group chat (planos Pro e Team), peça um turno sem mensagem do jogador, e o elenco discute a notícia entre si.
- Elenco dinâmico. O group chat comporta até seis personagens, e o elenco é a lista de IDs que você envia. Adicione um, e os outros o cumprimentam; remova um, e os demais percebem que ele saiu. Essa chegada costuma ser o melhor momento para pedir um turno ambiente.
- Ações. As reações também podem ser físicas. Os personagens devolvem ações como
POUR_DRINK,LOCK_DOORouRUN_AWAYcom um alvo, e o seu jogo as executa. - Emoções e vozes. Cada fala vem com uma tag de emoção e voz em streaming, então Ezra soa assustado e Hattie soa encantada.
- Memória da sessão. Os eventos chegam como parte de uma sessão. Guarde o
sessionId, e a conversa sobre o duelo continua lá na próxima vez que o jogador passar por ali.
Ideias para criar
Uma cidade que fofoca depois de uma luta com chefe. Depois que o jogador mata a bruxa do pântano, o seu jogo decide quem ouviu o quê. O padre recebe o evento como aconteceu. O bêbado perto do poço recebe "alguém diz que o estranho virou um corvo e voou para longe". O jogador anda pela cidade e ouve a história mudar de boca em boca.
Uma torcida de estádio que acompanha a partida. Em um jogo de futebol, coloque três torcedores de cada setor das arquibancadas em um group chat. Envie eventos como "o time da casa marcou no minuto 89" ou "o árbitro expulsou o capitão", e peça turnos ambientes entre as jogadas, para que a torcida perto da câmera do jogador discuta a decisão.
Uma equipe de base depois de um ataque. Em um jogo de sobrevivência em colônia, invasores queimaram a estufa durante a noite. De manhã, a equipe troca acusações no café da manhã em um turno ambiente, o engenheiro devolve REPAIR apontado para a estufa, e a cozinheira pergunta ao jogador o que ele pretende fazer sobre a comida.
Uma cidade que lê os jornais. Em um jogo de detetive, todas as manhãs o seu jogo envia uma ou duas manchetes como eventos. Comerciantes, motoristas de táxi e testemunhas as mencionam quando o jogador para para conversar, o que faz a cidade parecer acompanhar o caso também.
Como construir
Os eventos funcionam em qualquer lugar onde a Neocortex funciona: o Unity SDK, o plugin para Unreal Engine, o addon para Godot e a Web API de qualquer engine ou jogo para web.
- Escolha os momentos que importam. Liste as mudanças no mundo que merecem uma reação: mortes, vitórias, desastres, grandes escolhas do jogador.
- Escreva cada evento como uma frase curta do ponto de vista do mundo, do jeito que uma testemunha falaria.
- Decida quem ouve o quê. O seu jogo escolhe quais personagens recebem quais eventos, e é assim que surgem boatos, segredos e notícias que faltam.
- Envie os eventos com a próxima mensagem do jogador para personagens individuais, em qualquer plano.
- Peça um turno ambiente para grupos quando algo grande acontece ou alguém entra (Pro e Team).
- Descarte eventos antigos depois que forem comentados, para que a cidade siga em frente.
Enviando eventos do mundo junto com a mensagem do jogador:
const res = await fetch("https://api.neocortex.link/v3/chat", {
method: "POST",
headers: {
"x-api-key": apiKey, // load from your own config, never hard-code it
"Content-Type": "application/json",
},
body: JSON.stringify({
characterIds: [juniper],
message: playerLine,
sessionId, // empty on the first message, then the one you got back
events: [
{ priority: 1, content: "The railway bridge over the gulch collapsed" },
{ priority: 1, content: "The player won a duel against Silas Vane on Main Street" },
],
}),
});
const { sessionId: next, messages } = await res.json();
playReply(messages); // your helper: voice, emotion, actionsResuma, não transmita tudo. "O jogador venceu o duelo" dá a um personagem algo sobre o que falar; quarenta eventos sobre tiros individuais dão a ele só ruído.
Os eventos do mundo são uma parte dos nossos casos de uso de NPCs de IA, IA ambiente e comandos por voz. Para as conversas que preenchem o tempo entre os grandes momentos, leia conversas ambientes de NPCs, e para reações ao vivo em uma corrida ou partida, veja comentaristas de IA para esportes e corridas. As páginas de registro de eventos e de personagens dinâmicos, além da documentação de group chat, trazem os detalhes. Comece com um evento e um personagem que se importe com ele.
Verificado em outubro de 2026.
Perguntas frequentes
Como fazer NPCs reagirem ao que acontece no mundo do jogo?
Envie o evento a eles. Com a Neocortex você adiciona eventos a uma requisição de chat como uma lista de itens, cada um com uma prioridade e uma frase simples, como "a ponte desabou", e os personagens levam isso em conta nas próximas respostas.
NPCs podem reagir a eventos sem que o jogador converse com eles?
No group chat, sim. Nos planos Pro e Team da Neocortex, você pede um turno ambiente sem mensagem do jogador, e os personagens discutem a notícia entre si. Um personagem individual reage quando o jogador fala com ele de novo, em todos os planos.
NPCs percebem quando alguém entra ou sai de uma conversa?
Sim. No group chat da Neocortex, o elenco é a lista de IDs de personagens que você envia. Adicione um personagem e os outros o cumprimentam; remova um, e os demais reconhecem que ele saiu.
Devo enviar todos os eventos do jogo aos meus NPCs?
Não. Envie resumos curtos dos momentos que importam, como "o jogador venceu o duelo", em vez de cada quadro da luta. Eventos menos numerosos e mais claros dão aos personagens da Neocortex algo específico sobre o que falar.






