Plugin de Minecraft BlueMap

🔌 Acerca de BlueMap

BlueMap es una herramienta de mapas para Minecraft que lee los archivos del mundo del servidor y genera modelos 3D y un visor web interactivo. Puede ejecutarse como plugin o mod del servidor (plugin para Spigot/Paper o Sponge, mod para Fabric/Forge) o como un renderizador de línea de comandos independiente. Cuando se instala en un servidor en funcionamiento, BlueMap renderiza de forma asíncrona para no bloquear el hilo principal del servidor.

🎯 Propósito

BlueMap ofrece una representación tridimensional de un mundo de Minecraft accesible desde el navegador para que administradores y jugadores puedan explorar el terreno, localizar estructuras e inspeccionar construcciones sin entrar al servidor. Está dirigido a operadores de servidores que necesitan un mapa visual actualizado para administración, navegación o exhibición a la comunidad.

⚙️ Características

• Genera modelos 3D de la superficie del mundo y los muestra en un visor web basado en navegador.
• Funciona como plugin/mod (Spigot/Paper, Sponge, Fabric, Forge) o como una herramienta CLI independiente.
• Renderizado asíncrono para evitar bloquear el hilo principal del servidor Minecraft.
• Compatibilidad con resource packs y data packs para personalizar texturas, modelos de bloques y colores de biomas usados en los renderizados.
• Compatibilidad con varios backends de almacenamiento y administración de mapas mediante comandos (load, unload, list, delete, etc.).
• Compatibilidad con marcadores y una API para que plugins de terceros añadan o gestionen marcadores en los mapas.
• Comandos de recarga y control del renderizado en tiempo de ejecución (reload, iniciar/detener renderizado, actualizar/purgar mapas, congelar/descongelar mapas).

🧩 Para quién es

• Servidores Survival y SMP que quieren un mapa 3D público o para administradores.
• Servidores Creative o de exhibición que necesitan vistas previas de las construcciones accesibles desde el navegador.
• Administradores de servidor que requieren inspección remota y herramientas de navegación basadas en mapas.

🏗️ Casos de uso de ejemplo

• Ofrecer a los jugadores un mapa 3D del mundo alojado públicamente para ayudar con la navegación y mostrar construcciones.
• Un admin localiza y revisa bases o claims creados por jugadores desde el visor web antes de visitarlos en el juego.
• Un plugin usa la API de BlueMap para mostrar marcadores dinámicos de eventos, tiendas o lugares de teletransporte.

⌨️ Comandos

(Todos los comandos anteriores están documentados por el proyecto; los nodos exactos de permisos aparecen en la documentación del proyecto y no se repiten aquí.)

⚙️ Instalación

📥 Configuración

• Descarga el JAR de BlueMap adecuado para tu plataforma (JAR de plugin para Spigot/Paper/Sponge, JAR de mod para Fabric/Forge o distribución CLI independiente).
• Coloca el JAR en la carpeta plugins/ del servidor (para Spigot/Paper/Sponge) o en la carpeta mods/ (para Fabric/Forge), o usa los archivos de la distribución CLI para el renderizado independiente.
• Inicia o reinicia el servidor. Vigila la consola del servidor para confirmar que BlueMap y su servidor web integrado se iniciaron correctamente.

📦 Dependencias

• No se requieren dependencias externas obligatorias de plugins para el renderizado principal del mapa. Existen integraciones y complementos opcionales; consulta la documentación del proyecto para obtener información sobre addons de terceros.

🧠 Notas técnicas

• BlueMap se distribuye como plugins de servidor, mods y una herramienta CLI; elige el artefacto que coincida con tu configuración.
• El renderizado se realiza de forma asíncrona para evitar bloquear el hilo principal del servidor.
• Los resource packs y data packs pueden colocarse en el directorio de packs configurado para cambiar el aspecto del mapa.
• El proyecto mantiene un repositorio público de código fuente y compilaciones de lanzamiento; la configuración se basa en archivos y puede recargarse en tiempo de ejecución.

🤝 Cuándo es útil este plugin

Si necesitas una vista tridimensional de tu mundo de Minecraft accesible desde el navegador para navegación, revisión de construcciones o exhibición para la comunidad, BlueMap ofrece renderizado automatizado, control en tiempo de ejecución y una API para marcadores e integraciones sin requerir que los jugadores entren al servidor.