Discord
Ferramentas

Dynmap: um mapa interativo do servidor no navegador

O Dynmap é um plugin de servidor que gera um mapa interativo do seu mundo de Minecraft e o serve em um navegador. Os jogadores recebem um render 3D do terreno, a posição ao vivo dos outros jogadores e pontos marcados no mapa, sem instalar nada no cliente. É um dos plugins de servidor mais antigos e populares que existem.

O que é o Dynmap?

O Dynmap (Dynamic Map) é um plugin do lado do servidor. Você o instala no seu servidor de Minecraft (Spigot, Paper, Bukkit) e ele gera os tiles do mapa e os serve por um servidor HTTP embutido. Os jogadores abrem o endereço em um navegador (por exemplo http://yourserver.com:8123) e recebem um mapa interativo que dá para arrastar, ampliar e alternar entre camadas.

O plugin existe desde 2011 e é um dos complementos do Minecraft mantidos há mais tempo. Com os anos, virou um padrão: muitos servidores grandes oferecem o Dynmap como parte da experiência do jogador.

A grande vantagem: os jogadores não precisam instalar nada. O mapa funciona em qualquer navegador, até no celular. Isso diferencia o Dynmap dos mods de mapa (JourneyMap, Xaero's), que precisam ser instalados no cliente.

Principais recursos

Renderização 3D do mapa

O Dynmap renderiza o mundo em perspectiva isométrica 3D, então você vê montanhas, vales, construções e árvores de cima, com profundidade. Cada bloco é desenhado com sua cor e sua forma. Também há visões 2D (um mapa plano, como a navegação por GPS) e uma visão de cavernas.

Rastreio de jogadores ao vivo

Os ícones dos jogadores se atualizam ao vivo, então dá para ver quem está online e onde. Clicar em um jogador mostra o nome, as coordenadas e a dimensão atual (Overworld/Nether/End). Os administradores podem desativar o rastreio de jogadores ou grupos selecionados.

Marcadores e camadas

Os administradores podem adicionar marcadores ao mapa para sinalizar lugares importantes (spawn, lojas, arenas PvP, território de clãs). Os marcadores podem ser agrupados em camadas e ativados ou desativados no navegador. Plugins de integração (por exemplo Dynmap-Towny e Dynmap-WorldGuard) desenham automaticamente no mapa os limites das regiões.

Chat

Um chat opcional na página do mapa: jogadores no navegador podem conversar com jogadores dentro do jogo (e vice-versa). Útil para administradores que monitoram o servidor remotamente.

Instalação e configuração

Requisitos

  • Um servidor Spigot, Paper, Purpur ou Bukkit (não funciona em um servidor vanilla)
  • Java 17 ou mais recente
  • Espaço livre em disco: os tiles renderizados podem ocupar de algumas centenas de MB a vários GB, dependendo do tamanho do mundo
  • Uma porta HTTP livre (8123 por padrão)

Instalação passo a passo

  1. Baixe o Dynmap no Modrinth ou no SpigotMC
  2. Coloque o arquivo .jar na pasta plugins/ do servidor
  3. Reinicie o servidor
  4. O Dynmap gera a configuração automaticamente em plugins/dynmap/
  5. Abra http://localhost:8123 em um navegador. O mapa deve carregar

Primeira renderização

Depois da instalação, o Dynmap precisa renderizar o mundo existente. Execute /dynmap fullrender world no console do servidor. A primeira renderização completa pode levar de minutos (mundo pequeno) a horas (mundo grande, com muitos chunks). As atualizações seguintes só renderizam de novo os chunks alterados, por isso são rápidas.

Modos de renderização

O Dynmap oferece vários modos de exibição:

  • 3D isométrico - o padrão e o mais bonito. Mostra o terreno em perspectiva, com construções e relevo visíveis. Usa mais espaço em disco
  • Plano (2D) - uma visão de cima, como um mapa de satélite. Mais leve, renderiza mais rápido e usa menos disco. Uma boa camada extra ao lado do 3D
  • Cavernas - mostra cavernas e túneis subterrâneos. Útil para encontrar minas, dungeons e bases subterrâneas
  • Superfície - uma visão simplificada da superfície, ainda mais leve que a Plana. Combina com servidores de pouco espaço em disco

Cada modo é configurado separadamente em configuration.txt. Você pode ativar vários modos ao mesmo tempo, e os jogadores alternam entre eles no navegador.

Impacto no desempenho do servidor

O Dynmap sobrecarrega o servidor enquanto renderiza: lê chunks, processa blocos e gera imagens. Em servidores com muitos jogadores, dá para sentir.

Formas de reduzir a carga:

  • Diminua a frequência de atualização - defina na configuração um intervalo maior entre as renderizações (por exemplo a cada 5 minutos em vez de a cada segundo)
  • Renderize de madrugada - use o crontab ou um plugin agendador para que a renderização completa comece quando o servidor estiver vazio
  • Limite o raio do mapa - não renderize um mundo infinito. Defina uma borda (por exemplo 10.000 blocos a partir do spawn)
  • Desative o modo 3D - se o desempenho for um problema, mantenha só o Plano. Ele usa bem menos recursos
  • Use um SSD separado - os tiles do mapa são milhares de arquivos pequenos, e um SSD lida com eles melhor que um HDD

Alternativas: BlueMap e Squaremap

O Dynmap é um clássico, mas não é a única opção. Alternativas mais novas oferecem um estilo de renderização e um desempenho diferentes:

BlueMap

Renderiza o mundo em 3D completo com WebGL, e o resultado é espetacular, com sombras, água e profundidade. É muito mais bonito que o Dynmap, mas usa mais recursos. Funciona com Spigot, Paper, Fabric e Forge. Uma boa escolha para servidores com construções que valem ser exibidas.

Squaremap

Um mapa 2D minimalista: muito leve, renderiza rápido e poupa espaço em disco. Não tem modo 3D, mas quase não pesa no servidor. Ideal para servidores de sobrevivência com recursos limitados.

Qual escolher?

  • Dynmap - se você quer uma solução comprovada, com um enorme ecossistema de plugins de integração
  • BlueMap - se o visual importa para você e o servidor tem recursos de sobra
  • Squaremap - se desempenho e simplicidade vêm em primeiro lugar