Executa agentes LLM como jogadores de Minecraft via Mineflayer, com sessões persistentes, sandboxes de shell individuais e equipes de múltiplos agentes.
152+38 esta semana13JavaScriptMITAtualizado há 8 dias
mindcraft-bots/mindcraft
Bots de Minecraft controlados por LLMs, feitos com Mineflayer, em que cada agente de IA joga e pode conversar com os jogadores.
- Estrelas
- 5,972
- Forks
- 985
- Issues abertas
- 63
- Último commit
- há 11 dias
O que é?
O Mindcraft é um framework para executar agentes de IA dentro do Minecraft Java Edition. Ele conecta um modelo de linguagem de grande porte a um bot feito com Mineflayer, permitindo que o agente perceba o mundo, converse com os jogadores e realize ações no jogo, como coletar recursos e fabricar itens.
Os agentes são configurados por meio de perfis JSON que definem o modelo de chat, um modelo de código separado, um modelo de visão opcional, configurações de embeddings e voz, além de prompts de personalidade e exemplos. O projeto oferece suporte a vários provedores de LLM, incluindo OpenAI, Gemini, Anthropic, DeepSeek e modelos locais via Ollama. Ele pode ser executado em um mundo de LAN no localhost ou conectado a servidores online com uma conta Microsoft, e inclui um executor de tarefas para objetivos predefinidos.
A geração de código vem desativada por padrão, pois permite que o LLM escreva e execute código na sua máquina. O README recomenda executá-lo no Docker antes de conectar a qualquer servidor remoto.
Recursos principais
- 01Conecta LLMs a bots do Mineflayer que jogam Minecraft Java Edition.
- 02Oferece suporte a vários provedores de modelos, incluindo OpenAI, Gemini, Anthropic, DeepSeek e Ollama.
- 03Permite escolher modelos separados para chat, programação, visão e embeddings.
- 04Executa tarefas predefinidas com objetivos de inventário e alvos por meio de um arquivo JSON de tarefas.
- 05Pode executar vários agentes ao mesmo tempo usando arquivos de perfil separados.
Casos de uso
- Pesquisar a colaboração entre vários agentes de LLM em um ambiente de jogo com interação incorporada.
- Experimentar como diferentes LLMs se comportam como personagens dentro do jogo.
- Criar tarefas de Minecraft com scripts ou objetivos para avaliar o desempenho dos agentes.
- Executar agentes de Minecraft com modelos locais via Ollama, sem chamadas a APIs externas.
Início rápido
- 1
Instale o Node.js (recomenda-se a v18 ou v20 LTS)
- 2
Baixe a versão mais recente ou clone o repositório
- 3
Renomeie keys.example.json para keys.json e adicione uma chave de API
- 4
Instale as dependências no diretório do projeto
npm install
Antes de usar
- É necessária uma chave de API de um provedor de LLM compatível; o OpenAI é o padrão.
- É necessária uma instalação do Minecraft Java Edition; há suporte até a v1.21.11.
- Com a programação ativada, um LLM pode escrever e executar código na sua máquina. Portanto, não se conecte a servidores públicos com essa opção ativada.
Em coleções
Tópicos
Perguntas frequentes
- O que é mindcraft?
- Bots de Minecraft controlados por LLMs, feitos com Mineflayer, em que cada agente de IA joga e pode conversar com os jogadores. O Mindcraft é um framework para executar agentes de IA dentro do Minecraft Java Edition. Ele conecta um modelo de linguagem de grande porte a um bot feito com Mineflayer, permitindo que o agente perceba o mundo, converse com os jogadores e realize ações no jogo, como coletar recursos e fabricar itens.
- mindcraft é gratuito? Qual é a licença?
- mindcraft é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- mindcraft ainda é mantido?
- Manutenção ativa. O último commit de mindcraft foi em 27 de out. de 2026.
- Para que posso usar mindcraft?
- Pesquisar a colaboração entre vários agentes de LLM em um ambiente de jogo com interação incorporada. Experimentar como diferentes LLMs se comportam como personagens dentro do jogo. Criar tarefas de Minecraft com scripts ou objetivos para avaliar o desempenho dos agentes. Executar agentes de Minecraft com modelos locais via Ollama, sem chamadas a APIs externas.
- Como instalar mindcraft?
- Instale o Node.js (recomenda-se a v18 ou v20 LTS) Baixe a versão mais recente ou clone o repositório Renomeie keys.example.json para keys.json e adicione uma chave de API Instale as dependências no diretório do projeto: npm install
- Onde consigo mindcraft?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mindcraft-bots/mindcraft
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
O Unity ML-Agents Toolkit permite usar jogos e simulações Unity como ambientes para treinar agentes de IA com aprendizado por reforço e por imitação.
IA e Machine Learning#reinforcement-learning#unity#deep-reinforcement-learning#imitation-learning#game-ai
19,8 mil+24 esta semana4,5 milC#OtherAtualizado há 8 dias
Uma API JavaScript para criar bots de Minecraft capazes de entrar em servidores, se mover, minerar, fabricar itens, conversar e interagir com o mundo.
7,7 mil+42 esta semana1,5 milJavaScriptMITAtualizado há 11 dias
Painel web multiusuário para implantar e gerenciar servidores de Minecraft e jogos Steam em várias máquinas, com instâncias em Docker ou como processos.
5 mil604TypeScriptApache-2.0Bem mantidoAtualizado há 6 dias
Um modelo multimodal de pesos abertos com 9 bilhões de parâmetros para compreensão visual, raciocínio espacial, uso de ferramentas por agentes e pesquisa em IA incorporada, baseado em Qwen3.5 e C-RADIOv4-H.
3,1 mil517PythonApache-2.0Atualizado há 2 meses
Framework para treinar LLMs, VLMs, modelos de difusão e modelos incorporados em GPUs NVIDIA e XPUs Kunlun, baseado no Megatron-LM e em backends nativos do torch.
826+49 esta semana67PythonApache-2.0Atualizado há 14 horas