BlueMap — plugin para gerar um mapa mundial 3D interativo no navegador para Minecraft
Guia completo do plugin BlueMap para Minecraft, que cria um mapa 3D interativo do seu mundo no navegador. Funcionalidades, comandos e…
Guia completo do plugin BlueMap para Minecraft, que cria um mapa 3D interativo do seu mundo no navegador. Funcionalidades, comandos e configuração.
BlueMap — plugin para gerar um mapa mundial 3D interativo no navegador para Minecraft
BlueMap é um plugin de Minecraft que lê os arquivos do mundo e constrói um modelo de superfície tridimensional a partir deles, acessível em um navegador através de um servidor web integrado. O cliente padrão renderiza o mundo apenas ao redor do jogador e não fornece uma visão de cima ou de fora. O plugin forma um mapa completo com a capacidade de girar a câmera, alternar para o modo de perspectiva ou isométrico (plano) e ver estruturas simplesmente seguindo um URL. Ele resolve um problema: visualização externa do mundo do servidor sem a necessidade de entrar no jogo.
Como funciona a renderização
O plugin divide os chunks em tiles e gera duas camadas de detalhes: modelos hires com geometria de blocos completa e um mapa lowres para visão de longe. O Hires fica ativo em zoom próximo — aí blocos específicos, texturas e alturas são visíveis. Com um zoom mais distante, uma camada simplificada com manchas de cores de biomas e a paisagem é carregada.
Processo de renderização na interface web: os tiles são carregados gradualmente com o zoom.
A renderização é executada de forma assíncrona em um pool de threads separado. A thread do servidor do Minecraft não é bloqueada — enquanto a CPU tiver núcleos livres, os jogadores não sentirão lag devido à construção do mapa. O próprio plugin rastreia as mudanças no mundo: o BlueMap verifica periodicamente os arquivos mca, detecta os chunks modificados e re-renderiza apenas eles. Comandos manuais como /bluemap update raramente são necessários — principalmente para diagnósticos.
Renderização na interface web em primeira pessoa
Comandos
O plugin registra um comando raiz /bluemap com subcomandos. A maioria dos casos não requer nenhum comando — a renderização funciona automaticamente.
Comando | O que faz | |
| mostra o status de renderização e a fila | |
| recarrega as configurações; | |
| pausa e retoma toda a renderização (mantido após a reinicialização) | |
| congela um mapa específico (sem atualizações) | |
| apaga completamente os dados do mapa; será re-renderizado | |
| força a atualização dos chunks modificados no raio | |
| re-renderiza tudo, mesmo se não houver alterações | |
| procura problemas típicos no mapa no ponto especificado |
Execução do comando /bluemap
Configuração
A pasta do plugin contém quatro arquivos de configuração: core.conf, plugin.conf, webapp.conf, webserver.conf. E também três subpastas: maps/ (um .conf para cada mundo), packs/ (pacotes de recursos para renderização) e storages/ (file.conf para o sistema de arquivos, sql.conf para o banco SQL).
core.conf
O arquivo principal. O parâmetro chave é accept-download, que precisa ser definido como true na primeira inicialização. O parâmetro render-thread-count (padrão 1) define o número de threads de renderização — um valor negativo significa «número de núcleos da CPU menos o valor absoluto do número». O metrics (true) controla o envio de estatísticas anônimas.
plugin.conf
Parâmetros de visibilidade dos jogadores no mapa e comportamento de renderização:
Parâmetro | O que faz |
| transmite as posições dos jogadores online para o aplicativo web |
| modos em que o jogador não é visível. Valores: |
| oculta os jogadores escondidos por um plugin de vanish |
| oculta os jogadores com o efeito da poção de invisibilidade |
| oculta os jogadores agachados |
| limiar da luz solar; |
| limiar da luz do bloco |
| remove da lista os jogadores de outro mundo |
| segundos entre a gravação dos marcadores no armazenamento; |
| segundos entre a gravação das posições dos jogadores |
| baixa as skins da Mojang quando o jogador entra |
| número de jogadores online em que a renderização é interrompida; |
| minutos entre verificações completas de alterações ignoradas |
webapp.conf
Configurações do aplicativo web. default-to-flat-view (false) determina a visão inicial — perspectiva ou isométrica. Os controles deslizantes hires-slider-default (100) e lowres-slider-default (2000) definem a distância da renderização detalhada e simplificada em blocos. O resolution-default (1) aceita os valores 0.5, 1 ou 2. Os arrays scripts e styles anexam arquivos JS e CSS personalizados.
webserver.conf
Servidor web integrado. enabled (true) — habilitar ou desabilitar. port (8100) — a porta. webroot ("bluemap/web") — diretório com os arquivos do aplicativo web (deve corresponder ao webroot em webapp.conf). A seção log configura o registro da atividade HTTP em um arquivo.
Conclusão
O BlueMap permite a visualização externa do mundo no formato de um modelo 3D completo com rotação de câmera e voo livre. O plugin é ideal para servidores de sobrevivência e RPG, onde é importante para os jogadores compartilhar coordenadas e inspecionar construções; para servidores de minijogos sem um mundo permanente ele é desnecessário.
Instalação
Uma instalação típica leva cerca de 5 minutos. O fluxo é o mesmo; só mudam o loader e o build correspondente.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
