Ejecuta agentes LLM como jugadores de Minecraft mediante Mineflayer, con sesiones persistentes, entornos aislados de shell por agente y equipos multiagente.
mindcraft-bots/mindcraft
Bots de Minecraft controlados por LLM, creados con Mineflayer, donde cada agente de IA juega y puede chatear con los jugadores.
- Estrellas
- 5,968
- Forks
- 986
- Issues abiertos
- 63
- Último commit
- hace 10 días
¿Qué es?
Mindcraft es un framework para ejecutar agentes de IA dentro de Minecraft Java Edition. Conecta un modelo de lenguaje grande a un bot creado con Mineflayer, para que el agente perciba el mundo, chatee con los jugadores y realice acciones dentro del juego, como recolectar recursos y fabricar objetos.
Los agentes se configuran mediante perfiles JSON que especifican el modelo de chat, un modelo de código independiente, un modelo de visión opcional y ajustes de embeddings y voz, además de prompts de personalidad y ejemplos. El proyecto es compatible con muchos proveedores de LLM, como OpenAI, Gemini, Anthropic, DeepSeek y modelos locales mediante Ollama. Puede ejecutarse en un mundo de LAN en localhost o conectarse a servidores en línea con una cuenta de Microsoft, e incluye un ejecutor de tareas para objetivos predefinidos.
La generación de código viene desactivada de forma predeterminada porque permite que el LLM escriba y ejecute código en tu máquina. El README recomienda ejecutarlo en Docker antes de conectarlo a cualquier servidor remoto.
Funciones clave
- 01Conecta LLM a bots de Mineflayer que juegan a Minecraft Java Edition.
- 02Es compatible con muchos proveedores de modelos, como OpenAI, Gemini, Anthropic, DeepSeek y Ollama.
- 03Permite asignar modelos distintos para chat, programación, visión y embeddings.
- 04Ejecuta tareas predefinidas con objetivos de inventario y destino mediante un archivo JSON de tareas.
- 05Puede ejecutar varios agentes a la vez desde archivos de perfil independientes.
Casos de uso
- Investigar la colaboración entre varios agentes LLM en un entorno de juego con interacción física.
- Experimentar con el comportamiento de distintos LLM como personajes dentro del juego.
- Crear tareas de Minecraft guionizadas o guiadas por objetivos para evaluar el rendimiento de los agentes.
- Ejecutar agentes de Minecraft con modelos locales mediante Ollama, sin llamadas a API externas.
Inicio rápido
- 1
Instala Node.js (se recomienda v18 o v20 LTS)
- 2
Descarga la última versión o clona el repositorio
- 3
Cambia el nombre de keys.example.json a keys.json y añade una clave de API
- 4
Instala las dependencias desde el directorio del proyecto
npm install
Antes de usarlo
- Se necesita una clave de API de un proveedor de LLM compatible; OpenAI es el proveedor predeterminado.
- Se necesita una instalación de Minecraft Java Edition; se admiten versiones hasta la v1.21.11.
- Si se activa la opción de programación, un LLM puede escribir y ejecutar código en tu máquina. Por ello, no debes conectarte a servidores públicos con esta opción activada.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es mindcraft?
- Bots de Minecraft controlados por LLM, creados con Mineflayer, donde cada agente de IA juega y puede chatear con los jugadores. Mindcraft es un framework para ejecutar agentes de IA dentro de Minecraft Java Edition. Conecta un modelo de lenguaje grande a un bot creado con Mineflayer, para que el agente perciba el mundo, chatee con los jugadores y realice acciones dentro del juego, como recolectar recursos y fabricar objetos.
- ¿mindcraft es gratuito? ¿Qué licencia tiene?
- mindcraft es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿mindcraft sigue mantenido?
- Mantenimiento activo. El último commit de mindcraft fue el 27 oct 2026.
- ¿Para qué puedo usar mindcraft?
- Investigar la colaboración entre varios agentes LLM en un entorno de juego con interacción física. Experimentar con el comportamiento de distintos LLM como personajes dentro del juego. Crear tareas de Minecraft guionizadas o guiadas por objetivos para evaluar el rendimiento de los agentes. Ejecutar agentes de Minecraft con modelos locales mediante Ollama, sin llamadas a API externas.
- ¿Cómo se instala mindcraft?
- Instala Node.js (se recomienda v18 o v20 LTS) Descarga la última versión o clona el repositorio Cambia el nombre de keys.example.json a keys.json y añade una clave de API Instala las dependencias desde el directorio del proyecto: npm install
- ¿Dónde consigo mindcraft?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/mindcraft-bots/mindcraft
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Unity ML-Agents Toolkit permite usar juegos y simulaciones de Unity como entornos para entrenar agentes de IA mediante aprendizaje por refuerzo e imitación.
API de JavaScript para crear bots de Minecraft que se conectan a servidores, se mueven, excavan, fabrican objetos, chatean e interactúan con el mundo.
Panel web multiusuario para desplegar y administrar servidores de Minecraft y juegos de Steam en varias máquinas, con instancias en Docker o como procesos.
Modelo multimodal de pesos abiertos y 9B parámetros para comprensión visual, razonamiento espacial, uso de herramientas por agentes e investigación en IA corporeizada, basado en Qwen3.5 y C-RADIOv4-H.
Framework de entrenamiento para LLM, VLM, modelos de difusión y modelos corporizados en GPU NVIDIA y XPU Kunlun, basado en Megatron-LM y backends nativos de torch.