Plugin Minecraft dynmap

🔌 Sobre o Dynmap

Dynmap é uma família de plugin e mod para Minecraft que fornece mapas em tempo real, baseados na web, para servidores Minecraft. Ele renderiza blocos de mapa dos mundos carregados e oferece uma interface de mapa interativa que pode mostrar marcadores, áreas, linhas, posições ao vivo dos jogadores e balões de chat. O Dynmap permite executar o seu webserver interno ou exportar os dados do mapa para hospedagem externa e oferece vários backends de armazenamento.

🎯 Objetivo

O objetivo principal do Dynmap é dar aos administradores do servidor e aos jogadores uma visão ao vivo e navegável do terreno e da atividade do servidor por meio de um navegador. Ele resolve o problema de visualizar a disposição do mundo, acompanhar a localização dos jogadores, publicar mapas do servidor para os usuários e criar mapas anotados com marcadores e regiões.

⚙️ Funcionalidades

• Renderização de blocos em tempo real dos mundos do servidor (várias visualizações de mapa e modos de renderização).
• Marcadores, áreas e linhas configuráveis para anotar mapas para jogadores ou staff.
• Rastreamento ao vivo de jogadores e balões de chat opcionais / integração de chat web-para-jogo.
• Vários backends de armazenamento: arquivos planos, MySQL/SQLite/PostgreSQL/MariaDB e suporte a AWS S3 para armazenamento do mapa/web.
• Webserver integrado para servir a interface do mapa; pode ser adaptado para publicar/enviar conteúdo estático do site para armazenamento externo.
• Builds multiplataforma: existem artefatos dedicados para builds Spigot/Paper, Forge e Fabric.

🧩 Para quem é

• Donos e administradores de servidores que querem um mapa navegável do(s) seu(s) mundo(s).
• Servidores públicos SMP e de sobrevivência que publicam mapas para os jogadores.
• Servidores de minigames ou roleplay que precisam de mapas anotados, marcadores de spawn ou sobreposições de regiões.
• Hosts que precisam de opções flexíveis de armazenamento/backing (SQL ou S3) para mapas grandes.

🏗️ Casos de uso de exemplo

• Renderizar e publicar um mapa ao vivo do Overworld para os jogadores verem online.
• Marcar cidades, lojas e pontos de referência notáveis com marcadores personalizados e contornos de áreas.
• Executar renders agendados ou sob demanda de chunks recém-explorados (renders por raio ou do mundo inteiro).

⌨️ Comandos

(Observação: o Dynmap expõe um conjunto maior de comandos de mapa e configuração na documentação oficial.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do Dynmap para a plataforma do seu servidor e coloque-o no diretório plugins/ (ou mods/ para Forge/Fabric).
• Reinicie o servidor e verifique o console para confirmar que o Dynmap foi carregado e criou suas pastas de configuração e de mapas.
• Configure mapas, marcadores, backend de armazenamento e opções do webserver nos arquivos de configuração do Dynmap criados na primeira execução.

📦 Dependências

• As builds do Dynmap incluem suporte para drivers JDBC em muitas distribuições Spigot/Paper; outras plataformas podem exigir drivers adicionais ou mods de compatibilidade para backends SQL.
• Plugins de integração (por exemplo, WorldGuard, Towny, Citizens) são fornecidos por meio de integrações separadas do Dynmap; eles não são dependências obrigatórias em tempo de execução.

🧾 Configuração

• O Dynmap usa arquivos de configuração YAML criados na primeira inicialização. A configuração controla mapas, definições de renderização, conjuntos de marcadores, backend de armazenamento e o comportamento do webserver.
• Os backends de armazenamento suportados incluem arquivos planos, MySQL, SQLite, PostgreSQL, MariaDB e armazenamento opcional AWS S3 para hospedar dados do mapa.

🧠 Notas técnicas

• As fontes oficiais do projeto fornecem builds específicos por plataforma para Spigot/Paper, Forge e Fabric.
• A base de código do Dynmap é lançada sob a licença Apache-2.0.
• O projeto suporta execução em Java 8 em tempo de execução, enquanto os requisitos de compilação variam conforme o alvo e podem exigir versões mais recentes do JDK para builds modernas.
• O Dynmap oferece APIs publicadas (DynmapCoreAPI e dynmap-api) usadas por plugins de integração; estas são as interfaces estáveis para extensões de terceiros.

🤝 Quando este plugin é útil

Se você quer um mapa persistente e navegável do seu servidor Minecraft (para navegação, rastreamento de jogadores ou mapas da comunidade), o Dynmap oferece uma solução configurável e multiplataforma com vários backends de armazenamento e um conjunto rico de recursos de renderização e marcadores.