Plugin Minecraft BlueMap

🔌 Sobre o BlueMap

O BlueMap é uma ferramenta de mapas para Minecraft que lê os arquivos do mundo do servidor e gera modelos 3D e um visualizador web interativo. Ele pode funcionar como plugin ou mod de servidor (plugin para Spigot/Paper ou Sponge, mod para Fabric/Forge) ou como um renderizador em linha de comando independente. Quando instalado em um servidor em execução, o BlueMap renderiza de forma assíncrona, para não bloquear a thread principal do servidor.

🎯 Objetivo

O BlueMap oferece uma representação tridimensional de um mundo de Minecraft acessível pelo navegador, para que administradores e jogadores possam explorar o terreno, localizar estruturas e inspecionar construções sem entrar no servidor. Ele é voltado para operadores de servidor que precisam de um mapa visual atualizado para administração, navegação ou divulgação da comunidade.

⚙️ Recursos

• Gera modelos 3D da superfície do mundo e os disponibiliza em um visualizador web baseado no navegador.
• Funciona como plugin/mod (Spigot/Paper, Sponge, Fabric, Forge) ou como uma ferramenta CLI independente.
• Renderização assíncrona para evitar bloquear a thread principal do servidor Minecraft.
• Suporta resource packs e data packs para personalizar texturas, modelos de blocos e cores de biomas usadas nas renderizações.
• Suporta vários backends de armazenamento e gerenciamento de mapas por comandos (load, unload, list, delete etc.).
• Suporte a marcadores e uma API para que plugins de terceiros adicionem ou gerenciem marcadores nos mapas.
• Comandos em tempo de execução para recarregar e controlar a renderização (reload, iniciar/parar renderização, atualizar/purgar mapas, congelar/descongelar mapas).

🧩 Para quem é

• Servidores Survival e SMP que querem um mapa 3D público ou para administradores.
• Servidores Creative ou de showcase que precisam de prévias das construções acessíveis no navegador.
• Administradores de servidor que precisam de inspeção remota e ferramentas de navegação baseadas em mapa.

🏗️ Exemplos de uso

• Oferecer aos jogadores um mapa 3D do mundo hospedado publicamente para ajudar na navegação e mostrar construções.
• Um administrador localiza e analisa bases ou claims criados por jogadores no visualizador web antes de visitar no jogo.
• Um plugin usa a API do BlueMap para exibir marcadores dinâmicos de eventos, lojas ou locais de teleporte.

⌨️ Comandos

(Todos os comandos acima são documentados pelo projeto; os nós exatos de permissão estão na documentação do projeto e não são repetidos aqui.)

⚙️ Instalação

📥 Configuração

• Baixe o JAR do BlueMap apropriado para a sua plataforma (JAR de plugin para Spigot/Paper/Sponge, JAR de mod para Fabric/Forge ou distribuição CLI independente).
• Coloque o JAR na pasta plugins/ do servidor (para Spigot/Paper/Sponge) ou na pasta mods/ (para Fabric/Forge), ou use os arquivos da distribuição CLI para renderização independente.
• Inicie ou reinicie o servidor. Acompanhe o console para confirmar que o BlueMap e o servidor web embutido foram iniciados com sucesso.

📦 Dependências

• Não são necessárias dependências obrigatórias de plugins externos para a renderização principal dos mapas. Existem integrações e complementos opcionais; consulte a documentação do projeto para informações sobre addons de terceiros.

🧠 Notas técnicas

• O BlueMap é distribuído como plugins de servidor, mods e uma ferramenta CLI; escolha o artefato que corresponda à sua configuração.
• A renderização é executada de forma assíncrona para evitar bloquear a thread principal do servidor.
• Resource packs e data packs podem ser colocados no diretório de packs configurado para alterar o visual do mapa.
• O projeto mantém um repositório público de código-fonte e builds de release; a configuração é baseada em arquivos e pode ser recarregada em tempo de execução.

🤝 Quando este plugin é útil

Se você precisa de uma visualização tridimensional do seu mundo Minecraft acessível pelo navegador para navegação, revisão de construções ou exibição para a comunidade, o BlueMap oferece renderização automatizada, controle em tempo de execução e uma API para marcadores e integrações sem exigir que os jogadores entrem no servidor.