Neocortex Logo

Mod de NPC com IA para Minecraft: aldeões que falam

Crie um mod de NPC com IA para Minecraft no Fabric ou no NeoForge com a Neocortex: aldeões que conversam e negociam, quizzes para a sala de aula e comandos de voz para um NPC ajudante.

Neocortex TeamThe team behind Neocortex

· 6 min de leitura

Crie um mod de NPC com IA para Minecraft no Fabric ou no NeoForge com a Neocortex: aldeões que conversam e negociam, quizzes para a sala de aula e comandos de voz para um NPC ajudante.

Resposta rápida: sim, na Java Edition. Um mod de NPC com IA para Minecraft no Fabric ou no NeoForge pode enviar o que um aldeão vê e ouve para um personagem da Neocortex, e depois transformar a resposta em legendas, voz e trocas.

Os aldeões do Minecraft resmungam, arrastam os pés e negociam por um menu fixo, e os modders tentam fazê-los falar há anos. Com a Neocortex, cada aldeão ganha uma personalidade, uma memória do jogador e uma voz, e age de acordo com o que é dito. Some os Conversation Flows, um motor de quiz e comandos de voz no dispositivo, e o mesmo mod pode rodar uma aula ou um ajudante que segue ordens faladas.

Captura de tela do Minecraft durante o jogo Captura de tela: Minecraft © Mojang Studios

Fabric ou NeoForge

Os mods da Java Edition são arquivos jar Java carregados por um mod loader. Qualquer um dos dois loaders principais funciona para um aldeão falante:

LoaderFabricNeoForge
EstiloLeve e modular, com a biblioteca Fabric APICompleto
DocumentaçãoDocumentação para desenvolvedoresDocumentação
Configuração do projetoGerador de template de modGerador de mod

Os dois acompanham de perto as novas versões. O Minecraft 26.1 e os mais recentes rodam em Java 25, e desde a 26.1 o jogo vem sem ofuscação, então os mods trabalham com os nomes do próprio Mojang. Os mods costumam ser publicados no Modrinth ou no CurseForge. Mods da comunidade já adicionam companheiros de IA por chat ao Minecraft; o que vem a seguir mostra como é um mod da Neocortex.

Lado do servidor ou lado do cliente?

Onde o código roda importa mais do que o loader que você escolhe.

O servidor é dono dos aldeões, dos inventários e das trocas, e é o lugar natural para chamar uma API web. O HttpClient embutido do Java cuida das chamadas de rede, e o Gson já vem com o jogo para JSON.

O cliente é dono do microfone, das legendas (uma linha do chat ou um overlay de HUD) e da reprodução de áudio, que pode usar as próprias APIs de áudio do Java para uma resposta em WAV.

Então a divisão típica é: o servidor envia cada conversa de aldeão para a Neocortex pelo /v3/chat e executa as ações que voltam, enquanto o cliente toca a voz de /v3/audio/generate ou /v3/audio/stream e escuta os comandos de voz.

Uma chamada de chat em Java

Uma chamada de chat mínima de um mod para Fabric ou NeoForge, enviada fora da thread principal:

JsonObject body = new JsonObject();
JsonArray ids = new JsonArray();
ids.add(config.characterId());
body.add("characterIds", ids);
body.addProperty("message", playerText);
body.addProperty("playerId", player.getStringUUID());
body.addProperty("sessionId", sessionId); // "" on the first call

HttpRequest req = HttpRequest.newBuilder(URI.create("https://api.neocortex.link/v3/chat"))
    .header("x-api-key", config.apiKey())
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body.toString()))
    .build();

HTTP.sendAsync(req, HttpResponse.BodyHandlers.ofString()).thenAccept(res -> {
    JsonObject reply = JsonParser.parseString(res.body()).getAsJsonObject();
    sessionId = reply.get("sessionId").getAsString();
    // messages[0].lines -> subtitles; actions -> run them back on the server thread
});

Os personagens por trás dessa chamada são criados em um editor visual de nós, com nós de personalidade, emoção, conhecimento, idioma e voz. Até seis personagens podem compartilhar uma mesma conversa nos planos Pro e Team, o suficiente para um conselho de vila. Para saber como isso se compara com outras plataformas de personagens com IA, veja a nossa página de comparação.

Captura de tela do Minecraft durante o jogo Captura de tela: Minecraft © Mojang Studios

Três NPCs para um mod de NPC com IA no Minecraft

O bibliotecário e o fazendeiro

Um bibliotecário que se lembra de que você salvou a vila de um ataque e, por causa disso, oferece um preço melhor naquele livro encantado. Um fazendeiro que reclama da cratera deixada por um creeper no seu campo de trigo e pede que você a conserte antes de vender cenouras para você.

O seu mod envia os fatos junto com cada mensagem: a profissão do aldeão, as esmeraldas do jogador, a reputação, os blocos próximos e eventos recentes como "ataque derrotado". O personagem responde com texto, uma tag de emoção e ações como { "name": "OFFER_TRADE", "targetId": "enchanted_book" }. O seu mod abre a tela de troca com essa oferta, então a conversa e a economia continuam ligadas.

Um professor na frente da sala

Em um servidor Java usado por uma turma, um NPC professor fica na frente de uma construção e explica um tema com palavras simples. Envie as anotações da aula em PDF para o nó Knowledge do personagem e ele responde com base nelas.

Depois ele aplica um quiz: portas lógicas de redstone, biomas e climas, ou vocabulário para uma aula de idiomas, em qualquer um dos mais de 20 idiomas. O motor de quiz (plano Team) cuida das perguntas, da pontuação e de um ranking pela /v3/quiz, e o seu mod entrega um bloco de recompensa ou abre uma porta quando um aluno passa. Os Conversation Flows também servem para aulas guiadas: o professor leva os alunos por checkpoints, e o seu mod abre a próxima sala a cada palavra-chave flowState.

Pip, o ajudante que escuta

Dê ao seu mod um NPC ajudante chamado Pip, e desenhe um conjunto de comandos com atores ("Pip", "todos"), ações ("seguir", "esperar", "cortar", "minerar", "trazer") e objetos ("eu", "toras de carvalho", "ferro", "aquela árvore").

"Traga-me dezesseis toras de carvalho" chega como um comando só, com a quantidade anexada. "Corte aquela árvore e depois me siga" chega como dois. A biblioteca Voice Commands da Neocortex reconhece as frases no PC do jogador, sem ida e volta à nuvem, então o Pip reage no instante em que você para de falar, até no meio de uma luta. Nosso post sobre comandos de voz no dispositivo para mods de jogos aprofunda o lado da voz.

Checklist do primeiro aldeão

  1. Escolha um loader. Configure um projeto de mod para Fabric ou NeoForge pelo gerador oficial.
  2. Crie os personagens no painel da Neocortex: um por profissão de aldeão, um professor com as anotações da aula e um conjunto de perguntas para o quiz. Teste-os no navegador.
  3. Desenhe um conjunto de comandos para o seu NPC ajudante, com algumas frases de exemplo por ação.
  4. Conecte a partir do mod. Chame o /v3/chat de forma assíncrona, reutilize o sessionId e associe as ações devolvidas ao código do jogo.
  5. Guarde a chave de API em um arquivo de configuração que o jogador ou o administrador do servidor preenche, nunca fixa no código de um mod compartilhado.
  6. Teste primeiro em um mundo para um jogador, com pressionar para falar, antes de convidar uma turma.

Voice Commands é um SDK licenciado: fale conosco para obter uma licença de Voice Commands.

Servidores, salas de aula e jogo limpo

Mantenha o mod gratuito e siga as Diretrizes de Uso do Minecraft e o EULA da Mojang. Use-o em mundos para um jogador ou em servidores privados em que todos os jogadores tenham aceitado, nunca em servidores públicos contra as regras deles. Para salas de aula, confira as regras da sua escola sobre dados de alunos antes de conectar qualquer serviço online. Cada jogador ou servidor usa a sua própria chave de API da Neocortex.

Resumindo

Escolha um loader, mantenha a chamada de API no servidor e comece com uma profissão de aldeão. Quando o bibliotecário conversar e negociar pela Neocortex, o professor e o Pip reaproveitam as mesmas peças.

Construindo para um jogo mais aconchegante? Veja o nosso guia sobre o mod de aldeão com IA para Stardew Valley, ou navegue por todos os jogos no índice de mods de NPC com IA e comandos de voz.

Versões de 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 com IA ao Minecraft?

Sim, na Java Edition. Um mod para Fabric ou NeoForge pode enviar o que um aldeão vê e ouve para um serviço de IA e mostrar a resposta no jogo. Os personagens da Neocortex respondem no personagem e devolvem ações, como abrir uma troca, que o seu mod executa.

Os aldeões do Minecraft podem falar com IA?

Um mod pode dar a cada profissão de aldeão o seu próprio personagem da Neocortex, então um bibliotecário, um fazendeiro e um clérigo falam de maneiras diferentes. O mod envia as esmeraldas do jogador, a reputação e os blocos próximos com cada mensagem, e o aldeão responde e oferece trocas por meio de ações.

Professores podem usar NPCs com IA em salas de aula do Minecraft?

Em um servidor da Java Edition, sim. Um NPC professor criado com a Neocortex pode explicar um tema a partir de anotações de aula enviadas e aplicar quizzes pontuados com ranking. O Minecraft Education é uma edição separada, então os mods para Fabric e NeoForge não se aplicam a ela.

Posso controlar um NPC do Minecraft com a minha voz?

Sim. O Neocortex Voice Commands roda no PC do jogador, reconhece frases naturais como "traga-me dezesseis toras de carvalho" offline e entrega ao mod do cliente o comando e a quantidade. O Voice Commands é um SDK licenciado, então fale conosco para obter uma licença.

Artigos semelhantes

Continue lendo