Explorador de Minecraft
Recorre tu mundo capa por capa sin abrir el juego
Aplicación de escritorio para macOS que lee los archivos de tu partida de Minecraft y te deja explorarla: mapa de superficie, corte por capas, visor 3D de chunks, buscador de recursos y estructuras, plan de minería con la densidad real de tu mundo, una copia local de la wiki y un bot que juega con tu personaje. El explorador es de solo lectura; el bot juega en copias de prueba de tu mundo.
Qué es
Una aplicación de escritorio que lee directamente los archivos de una partida de Minecraft y te deja recorrerla sin abrir el juego y sin tocarla. Sirve para planificar: saber a qué altura cavar, dónde están las estructuras, qué hay debajo de tu base y por dónde no vale la pena perder el tiempo.
No es un servicio ni sube nada a ningún lado: el servidor corre en tu propia
máquina y escucha solo en 127.0.0.1.
Qué hace
Ver el mundo. Mapa de superficie con los colores reales de los bloques —sacados de las texturas del propio juego— con relieve sombreado y océanos por profundidad. Vista capa por capa a cualquier altura, mapa de biomas, mapa topográfico y una vista de espacio transitable que marca dónde se puede caminar y dónde hay lava. Y un corte vertical entre dos puntos, como el plano de una mina.
Chunks. Cuadrícula con las coordenadas rotuladas y un visor 3D de un chunk completo, con WebGL escrito a mano: terreno, cuevas, vetas, cofres, criaturas y tu personaje marcado con una baliza que atraviesa el terreno. Las aristas del chunk se marcan en rojo y las secciones de 16 bloques en verde, y se puede navegar sección por sección.
Recursos. Los yacimientos se agrupan por vetas, no por bloques sueltos. El plan de minería calcula en qué franja de altura conviene cavar usando la densidad real de tu mundo, no la media teórica del juego, y avisa de cuánta lava hay en ese tramo.
Materiales. Pegás la lista de materiales de una construcción y te dice cuánto tenés ya en tus cofres y dónde está lo que falta: el yacimiento más cercano, el bioma donde crece esa madera o el rebaño más próximo.
Seguir la partida. Detecta cuándo el juego guarda y vuelve a escanear solo las regiones que cambiaron, siguiendo a tu personaje mientras jugás.
Consultar. Copia local de la wiki de Minecraft en español con casi 3.000 artículos, enlazada con lo que hay en tu mundo, y un panel con las guías de construcción de WBuilds.
Bot. Desde la 1.2.0 la aplicación trae adentro un bot que juega con tu personaje en Minecraft 26.3, con todo lo que necesita: su propio Node, el perfil de Fabric y los mods Fabric API, Minescript y Baritone, que se instalan solos sin pisar ningún mod tuyo. Muestra en vivo lo que hace, lo marca en el mapa y abre su panel completo: copias de prueba de tu mundo, abrir el juego, el piloto, la lista de materiales de una herramienta. Todo se configura desde la app, con cada ajuste explicado. También se ve completo lo que habla con LM Studio (el modelo local que elige qué hacer, opcional). El explorador en sí sigue sin escribir nunca en tu partida: el que juega es el bot, y en tu mundo real solo si lo permitís.
Cómo está hecho
El lector del formato Anvil, el indexador y el servidor son Python con NumPy y Pillow, sin más dependencias. La ventana es nativa (Swift + AppKit) con un WKWebView dentro, y el visor 3D es WebGL propio, sin librerías de terceros, para que todo funcione sin conexión.
Dos decisiones explican que sea rápido: cada capa de altura se guarda comprimida por separado, así que mover el deslizador de altura no descomprime el mundo entero; y los recursos se detectan con un único barrido del volumen para todos los tipos a la vez, en lugar de recorrerlo una vez por cada mineral.
Escanear un mundo de 17.000 chunks lleva unos 8 segundos.
Solo lectura
Es el requisito de partida. El explorador abre todos los archivos de la partida en modo lectura y no tiene ninguna función de escritura sobre ellos. Lo que escribe (índice, mapas, marcas) vive en la carpeta de datos de la aplicación. Trae un comando que compara un SHA-1 de cada archivo del mundo contra una huella anterior para comprobarlo.
El bot es otra cosa: juega, así que el mundo donde juega cambia. Por eso, por defecto, juega en copias de prueba que hace de tu mundo (tu mundo real solo lo lee para copiarlo) y hace una copia de seguridad antes de cada partida. En tu mundo real no juega salvo que lo actives a propósito en su configuración.
Requisitos del sistema
- Sistema operativo
- macOS 12 Monterey o posterior
- Procesador
- Apple Silicon (M1 o posterior)
- Memoria
- 8 GB (16 GB recomendados)
- Espacio en disco
- 150 MB la aplicación (con el bot), más ~250 MB por mundo escaneado
- Dependencias
- Herramientas de Línea de Comandos de Xcode
- Juego
- Minecraft Java Edition (formato Anvil)
- Para el bot
- Minecraft Java 26.3 instalado con TLauncher o el launcher oficial; LM Studio opcional
Recomendaciones
- Instalá las Herramientas de Línea de Comandos con `xcode-select --install` si no las tenés: la aplicación usa el Python que viene con ellas.
- El primer escaneo de un mundo tarda entre 10 y 40 segundos según su tamaño. Después arranca al instante.
- Podés dejarla abierta mientras jugás: el seguimiento en vivo detecta cuando el juego guarda y actualiza solo las regiones que cambiaron.
- Minecraft escribe al disco cada pocos minutos, así que el mapa va con ese retraso. Pausar la partida fuerza un guardado.
- Para mundos de más de 100 regiones conviene dejar el intervalo de seguimiento en 30 segundos o más.
El paquete va firmado en modo ad-hoc, sin certificado de desarrollador. La primera vez macOS puede pedir confirmación para abrirlo.
Compilada para Apple Silicon. En equipos Intel no arranca.
La aplicación abre los archivos de la partida siempre en modo lectura y nunca escribe dentro de la carpeta del mundo. Trae un comando que lo verifica con un SHA-1 por archivo.
Versiones publicadas
8 compilaciones- v1.4.1 Ultima 31 de octubre de 2026Descargar macOS arm64 · 57 MB
Repaso de todas las funcionalidades buscando lo que estuviera roto.
- El corte vertical no funcionaba nunca. Al marcar el segundo extremo, la funcion que apaga el modo de trazado borraba el primer punto justo antes de usarlo, asi que el dibujo reventaba y el panel se quedaba en "calculando..." para siempre, sin decir nada. Ahora traza, y si algo falla lo dice en vez de colgarse.
- El visor 3D recortaba a tu personaje. De entrada ensenaba los 80 bloques de arriba del chunk; si estabas minando a Y negativa, la cabecera decia "tu personaje esta aqui" y no se veia por ningun lado, ni siquiera pulsando "Mi chunk". El encuadre baja ahora hasta donde estes.
- El boton "todo" del visor no ensenaba todo: decia "Ver el chunk entero" y se quedaba en 80 de las 146 capas. Ahora va de la roca madre a la superficie.
- La tecla 3 hacia dos cosas a la vez: abria el panel de Chunks y encima lanzaba el visor 3D a pantalla completa. El visor pasa a la tecla V.
- La wiki prometia 1281 versiones de Java y listaba 600. Las 681 restantes no habia forma de alcanzarlas. Ahora salen todas.
- El filtro "Agua" del mapa no podia funcionar. El agua no se agrupa en vetas, de modo que el filtro daba cero siempre sin explicar por que. Aparece apagado y con el motivo, y se sigue pudiendo contar por capa en el plan de mineria.
- La casilla "Solo cerca de la capa actual" mentia. En Capa Y y en Espacio transitable el filtro se aplica siempre, pero la casilla se veia apagada: el panel decia "0 carbon" y nada en pantalla lo justificaba. Ahora se marca sola y dice que el modo la fuerza.
- El panel Mundo no decia que mundo era. Prometia "que mundo estas mirando y su escaneo" y solo ensenaba el modo, la dificultad y el spawn. Lleva ya el nombre, la version y la fecha del ultimo escaneo.
- Media interfaz hablaba ingles. Las listas de cofres y criaturas ponian "Chest", "Chicken" o "Polished diorite" en medio de un programa en castellano. Se traducen 1020 de los 1281 bloques del mundo: las reglas se componen a partir del material, asi que "polished_diorite" sale "Diorita pulida" sin tener que escribir las variantes una a una.
- Pedir algo a medias (una coordenada sin X, por ejemplo) devolvia un error 500 con la traza entera de Python. Ahora contesta 400 y dice que parametro falta.
- Los filtros de recursos se pueden usar con el teclado: eran divs que solo respondian al raton.
- Los botones de modo de mapa dicen cual esta activo tambien para un lector de pantalla, no solo por el color.
- Al pulsar "cambiar" para elegir otro mundo, la pantalla se quedaba en blanco mientras se recorrian las carpetas de guardados, que la primera vez puede llevar medio minuto. Ahora avisa de que esta buscando.
- Una tesela de una dimension que no existe contesta 404 en vez de 500.
- v1.4.0 31 de octubre de 2026Descargar macOS arm64 · 57 MB
Repaso completo de la interfaz y la correccion de fondo del terreno que faltaba.
- Las trece secciones que se apilaban en dos columnas fijas pasan a cinco tareas (Ver, Recursos, Chunks, Seguir, Mundo) en una barra lateral. Se abre una a la vez, con las teclas 1 a 5, y el resto del sitio es para el mapa: en una pantalla de 1680 px el mapa gana 200 px de ancho.
- El inspector de la derecha ya no esta siempre: aparece al elegir un punto y se cierra con Esc.
- Aspecto nuevo. Grafito calido y laton en vez de gris azulado y verde menta: el armazon se aparta y los unicos colores que destacan son los del mapa, que es el dato. Las cifras van todas en monoespaciada tabular, para que una coordenada no baile al pasar de 99 a 100.
- Las estructuras del mapa se ordenan por importancia. Una aldea o una fortaleza llevan nombre desde lejos; de las minas abandonadas y los tesoros, que salen a cientos, basta con la marca. Antes tapaban el mapa.
- Las listas se agrupan y se pliegan por tipo: nueve filas identicas que solo cambian en las coordenadas no son nueve datos, son uno.
- Los paneles vacios dicen que hacer en lugar de informar de que no hay nada.
- Faltaba terreno en el mapa, y era la causa de fondo de los bloques en negro. Minecraft 26.3 escribe la paleta de bloques de dos formas nuevas ademas de la de siempre, y como el juego solo reescribe un chunk cuando lo visitas, en un mismo mundo conviven las tres. El lector solo entendia la vieja y daba por aire todo lo que venia en las nuevas: hasta un 17% de las secciones en las zonas mas jugadas. Hay que volver a escanear el mundo para recuperarlo.
- El servidor contestaba 501 a una peticion HEAD, que es de lo mas corriente.
- v1.3.0 4 de octubre de 2026Descargar macOS arm64 · 57 MB
El bot reacciona como un jugador: ve lo que pasa 10 veces por segundo, decide
- El puente dentro del juego manda la posicion, la vida, los mobs y lo que hace Baritone 10 veces por segundo (antes, 1) y avisa al instante cuando al personaje le pegan, con quien le pego. El estado llega al panel en ~10 ms.
- Las ordenes largas (comer, pelear, cofres, crafteo) van en otro hilo: el estado sigue llegando mientras tanto y "parar" las corta en el medio. Una orden que llega tarde no se ejecuta.
- Lo que solo lee el juego ya no espera un cuadro por llamada: ordenar la barra de herramientas bajo de 3,6 s a menos de 1 s, e "ir" adonde ya estaba, de 11,5 s a 1,6 s.
- El final de cada tarea de Baritone se nota en medio segundo (antes, 1,5 s, y hasta 45 s si ya estaba en la meta).
- Sin pausa entre una accion y la siguiente decision (antes, 3 s fijos mas el modelo: 9 s de mediana parado).
- Lo claro (urgente, o 10 puntos de ventaja) se hace sin preguntar: 5-50 ms.
- Lo parejo lo elige qwen3-4b con una sola letra en una pasada, y de la misma respuesta salen las probabilidades de cada opcion, como hace Jev (el modelo de decisiones de TypeSafe, que solo existe en la nube). Si duda o no contesta en 3 s, sigue la prioridad. Antes escribia letra y motivo: 5,4 s de mediana.
- Pedido al modelo mas corto (~280 tokens, antes ~580) y con el sistema siempre igual adelante, para que LM Studio lo tenga en cache.
- Mientras juega el bot, Minecraft baja a 30 FPS (ajustable): el juego y el modelo comparten la GPU. Al soltar el control vuelven los tuyos.
- Ajuste para probar un modelo rapido primero (por ejemplo LFM2.5-1.2B) y escalar a qwen solo si duda. En la prueba no convino: viene apagado.
- La pestana LM Studio muestra la probabilidad de cada opcion.
- Reflejos con prioridad: uno mas urgente corta al que esta en marcha (deja de comer para huir de un creeper). Si muere, se corta todo.
- Nuevos: salir a respirar si se queda sin aire bajo el agua (se ahogo en la prueba) y salir de la lava.
- A un esqueleto solo lo va a buscar; de varios tiradores, un saqueador o una bruja se aleja.
- Pan primero: hacer pan (tambien con los fardos de heno), traer pan, trigo o fardos de un cofre, cosechar, sembrar o juntar semillas va siempre antes que cazar. Cazar queda como ultimo recurso y solo si ve animales o conoce un rebano (en la prueba fallo 4 veces buscando animales que no habia).
- Varios objetivos ya no cuentan con los mismos materiales, y un pico de oro no cuenta como de piedra (pica como el de madera).
- Lo que un objetivo saco de un cofre no se vuelve a guardar en el viaje siguiente, y el cofre se llena por stacks enteros sin pasarse: antes podia quedarse yendo y viniendo con los mismos adoquines.
- Pedirte algo es avisar y seguir con otra cosa (antes se quedaba un minuto quieto), y no lo repite por 10 minutos.
- Un objetivo que pidio una tarea vence a las 2 horas o cuando la tarea termina; uno que pediste vos no se pisa.
- Un despeje con unas pocas menas que piden un pico mejor las deja para despues y termina el resto; al 98% cuenta como hecho.
- Un paso de la obra que fallo 3 veces descansa 20 minutos (40, 80...) en lugar de quedar trabado para siempre.
- Al morir con el panel recien abierto, vuelve igual a buscar sus cosas.
- Si algo tapa una mesa o un cofre, lo usa igual sin apuntarle; y no intenta poner la mesa de crafteo en el lugar donde esta parado.
- Arar, sembrar y colocar esperan a que el juego confirme el bloque nuevo (con el puente rapido contaba "sembre 0" habiendo sembrado).
- La Mac no se duerme mientras el piloto juega.
- La app muestra el ritmo del bot (decisiones por minuto y cuanto tarda en decidir y en reaccionar).
- v1.2.2 3 de octubre de 2026Descargar macOS arm64 · 56 MB
Dos fallos que salieron al actualizar el mundo a Minecraft 26.3.
- Arreglado: el mapa pintaba de negro las zonas excavadas. El juego guarda en cada chunk un mapa de alturas, pero se queda viejo en cuanto se pica: sigue apuntando a la superficie de antes aunque ahi ya no quede nada. En GERMI afectaba al 11,7% de las columnas, justo por donde habia estado minando el bot. Ahora, cuando esa altura apunta a vacio, se busca en el propio terreno el bloque mas alto de verdad.
- Arreglado: todo el vidrio se quedaba sin color. Minecraft 26.3 cambio como declara las texturas y ahora algunas vienen como objeto ({"sprite": ..., "force_translucent": true}) en lugar de como texto; el lector solo entendia el formato viejo. Afectaba al cristal, al vidrio tintado y a los paneles.
- El catalogo de colores ahora recuerda con que version del juego se hizo y se rehace solo al cambiar de version, en vez de arrastrar el de la anterior. Con 26.3 pasa de 1.163 a 1.286 bloques.
- v1.2.1 28 de septiembre de 2026Descargar macOS arm64 · 56 MB
Ajuste para indicar donde esta TLauncher.
- Ajuste "Donde esta TLauncher" en Configuracion, Juego y mundos: la ruta a TLauncher.jar o TLauncher.app para el boton que lo abre. Vacio, lo busca solo en Aplicaciones, Descargas, el Escritorio y Documentos.
- Si no lo encuentra, el boton y la pestana Dependencias dicen que revisar. El bot abre el juego sin TLauncher: esto es solo para jugar a mano.
- El codigo del bot vive ahora en el mismo repositorio que el explorador.
- v1.2.0 28 de septiembre de 2026Descargar macOS arm64 · 56 MB
El bot viene dentro de la aplicacion y todo se configura desde ella.
- La aplicacion trae el bot adentro, con su propio Node: ya no hace falta instalar nada aparte para usar la seccion Bot. Queda corriendo aunque cierres la aplicacion y se reinicia solo si se cae.
- Trae tambien lo que necesita Minecraft: el perfil de Fabric 0.19.5 para 26.3 y los mods Fabric API, Minescript y Baritone. Se instalan solos al abrir el juego, sin pisar nunca un mod tuyo.
- Los datos del bot (configuracion, progreso, bitacoras) viven en la carpeta de datos de la aplicacion. La primera vez trae los que ya tenias.
- Funciona con TLauncher o con el launcher oficial de Minecraft.
- Pestana Configuracion: los 61 ajustes del bot, cada uno explicado, con cuando toma efecto y su valor por defecto. Los que tocan la seguridad de tus mundos van marcados.
- Pestana Que hace: el ciclo, las prioridades, los reflejos del vigia y las reglas de herramientas, cavado y seguridad, escritas con tus valores.
- Pestana Dependencias: que tiene esta Mac y que falta, con un boton para instalar lo que viene con la aplicacion.
- Pestana LM Studio: cada pedido al modelo y cada respuesta, completos: los mensajes, los parametros, el esquema de la respuesta, el JSON crudo, los tokens y el tiempo.
- La barra lateral muestra la comida y la huerta del bot.
- Abrir el juego usa tu copia de prueba mas reciente.
- v1.1.0 28 de septiembre de 2026Descargar macOS arm64 · 7.9 MB
Seccion Bot: el explorador se conecta al bot que juega con tu personaje.
- Seccion nueva en la barra lateral con lo que hace el bot en vivo: si el juego esta conectado, vida, hambre, posicion, hora y la tarea en curso.
- Botones para prender o apagar el piloto, ver al bot en el mapa y detener todo sin salir del explorador.
- El panel completo del bot a pantalla completa (menu Bot o Cmd Mayus B): volver a copiar el mundo de prueba desde el real, abrir el juego, el piloto, las herramientas con su desgaste y la lista de materiales de lo que falte, la obra y la bitacora.
- El bot aparece en el mapa en vivo, con la tarea que esta haciendo. Se puede ocultar en "Encima del mapa".
- Si el panel del bot esta apagado, el explorador lo arranca, y queda corriendo aunque cierres la aplicacion. Tambien se puede detener.
- Menu Bot en la barra de menus, con la opcion de elegir la carpeta del bot.
- El bot no viene dentro del explorador: es un programa aparte (Node, LM Studio y Minecraft 26.3 con Fabric, Baritone y Minescript). Si no esta en la Mac, la seccion lo dice y no hace nada mas.
- v1.0.0 9 de septiembre de 2026Descargar macOS arm64 · 7.8 MB
Primera version publicada.
- Mapa de superficie con los colores reales de los bloques, sacados de las texturas del propio juego, con relieve sombreado y oceanos por profundidad.
- Vista capa por capa: el corte horizontal a cualquier altura, con un control para dejar asomar las capas de debajo y ver las cuevas con profundidad.
- Mapa de biomas con leyenda, mapa topografico de alturas y una vista de espacio transitable que marca en verde donde se puede caminar y en naranja la lava.
- Corte vertical entre dos puntos, como el plano de una mina: estratos, cuevas, bolsas de agua y lava, y las vetas por el camino.
- Rejilla de chunks con las coordenadas rotuladas, que se van espaciando al alejarse, y limites de region cada 512 bloques.
- Panel para saltar a un chunk por coordenadas, con sus bloques, region, bioma y altura del terreno.
- Visor 3D de un chunk con WebGL propio, sin librerias de fuera: terreno, cuevas, vetas, cofres, criaturas y tu personaje marcado con una baliza que atraviesa el terreno.
- Brujula y lados rotulados con su punto cardinal y coordenada; aristas del chunk en rojo y division en cubos de 16 en verde, con navegacion seccion a seccion.
- Yacimientos agrupados por vetas, no por bloques sueltos, con su tamano y altura.
- Plan de mineria con la densidad real de tu mundo, no la media teorica del juego, y aviso de cuanta lava hay en el tramo elegido.
- Buscador de estructuras, cofres por su contenido, criaturas y vetas.
- Panel de materiales: pegas la lista de una construccion y dice cuanto tienes en cofres y donde esta lo que falta.
- Seguimiento en vivo que detecta cuando el juego guarda y vuelve a escanear solo las regiones que cambiaron.
- La camara puede seguir a tu personaje y la vista de capa, su altura.
- Copia local de es.minecraft.wiki (CC BY-NC-SA 3.0) con 2.968 articulos de bloques, objetos, entidades, encantamientos, biomas, estructuras y versiones, enlazada con lo que hay en tu mundo.
- Panel con las guias de construccion de wbuilds.app, servidas desde su web.
- Aplicacion nativa de macOS con Python y sus dependencias dentro del paquete.
- El mundo se abre siempre en modo lectura, y mc.py verificar lo comprueba con un SHA-1 por archivo.
Colaborar
Gracias por llegar hasta acá.
Explorador de Minecraft y el resto de estos proyectos los construyo por mi cuenta, en mis ratos libres y sin financiamiento de nadie. Si algo de todo esto te resultó útil, te sirvió para aprender o simplemente tenés ganas de que siga, podés invitarme un café.
Cualquier monto ayuda y se agradece de verdad. También suma compartirlo o escribirme para contarme qué le cambiarías.
- Mercado Pago
Escaneá para leer el alias Alias
germi.dev.mpTransferí al alias desde Mercado Pago o desde el homebanking de tu banco.
- Monero
Escaneá con tu billetera de Monero Dirección XMR
4A9Jxy1wi7sMzpFhzXxeQY7NtUMMxbGLKDqiRyqTAZozTKUZb4faaEPV5bBfDZ8i2UGo7xnpVepupXSWBJho8abgBtaLMkvDirección estándar de Monero. Copiala y pegala en tu billetera antes de enviar.