Plugin Minecraft ChunkyBorder

🔌 Sobre o ChunkyBorder

ChunkyBorder é um complemento de plugin para Minecraft do pré-gerador Chunky. Ele oferece criação e aplicação de world border de primeira linha, ligada às seleções do Chunky, para que os servidores possam limitar áreas jogáveis, redirecionar ou bloquear tentativas de teleporte fora das bordas e, opcionalmente, renderizar as bordas para jogadores ou mapas.

🎯 Objetivo

O ChunkyBorder resolve o problema de manter a área jogável de um servidor alinhada com os chunks pré-gerados. Ele é útil quando você pré-genera áreas com o Chunky e precisa de um world border configurável e compatível com chunks, que impeça jogadores e teleportes de saírem da região pré-gerada ou faça o teleporte atravessar as bordas.

⚙️ Recursos

• Criar um world border a partir de uma seleção do Chunky (quadrado, círculo e outras formas do Chunky).
• Impedir o movimento do jogador além das bordas configuradas.
• Redirecionar ou bloquear teleportes que cairiam fora da borda.
• Renderizador opcional de world border no cliente (exige mod/recurso no cliente, quando aplicável).
• Visualizador opcional de partículas no servidor para as bordas.
• Envoltório de borda opcional para teleportar jogadores através da emenda da borda.
• Mensagem, efeitos e sons da borda personalizáveis, exibidos quando um jogador interage com a borda.
• Suporte a marcadores de mapa para Dynmap, BlueMap, Pl3xMap e squaremap.
• Comandos para adicionar, remover, listar, carregar e alternar o envoltório da borda.

🧩 Para quem é

• Donos e administradores de servidores que pré-geram chunks do mundo com o Chunky e precisam de bordas que correspondam às áreas pré-geradas.
• Servidores Survival, SMP ou de mapas personalizados que querem limites de área jogável aplicados sem depender apenas do worldborder padrão.
• Servidores que usam plugins de mapa web (Dynmap/BlueMap/Pl3xMap/squaremap) e querem visualizar bordas nos mapas.

🏗️ Exemplos de uso

• Criar uma área quadrada ao redor do spawn, pré-gerá-la com o Chunky e adicionar um ChunkyBorder para que os jogadores não possam sair da região pré-gerada.
• Carregar uma borda existente do Chunky de outro mundo e reaplicá-la com um raio diferente.
• Ativar o envoltório da borda para permitir teleporte entre lados opostos de um mundo delimitado.

⌨️ Comandos

Nota: o ChunkyBorder usa a seleção e o conjunto de comandos do Chunky; use os comandos do Chunky para preparar seleções (por exemplo chunky radius, chunky shape, chunky world, etc.).

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Obtenha o JAR do ChunkyBorder para a sua versão do Minecraft e coloque-o no diretório plugins/ do servidor.
• Instale o plugin Chunky (o ChunkyBorder é um complemento e precisa do Chunky para definir seleções e gerar chunks).
• Reinicie o servidor e verifique o console para confirmar que o ChunkyBorder foi carregado corretamente.

📦 Dependências

• Necessário: Chunky (plugin) — o ChunkyBorder cria bordas a partir das seleções do Chunky.
• Integrações opcionais (marcadores de mapa / visualização): Dynmap, BlueMap, Pl3xMap, squaremap.

⚙️ Observações sobre Java / versão

As versões do ChunkyBorder oferecem downloads direcionados a diferentes combinações de Minecraft/Java; siga a versão que corresponde ao runtime do seu servidor. A embalagem oficial das releases indica builds diferentes para faixas mais antigas e mais novas do Minecraft.

🧠 Observações técnicas

• Licença: GPL-3.0.
• O ChunkyBorder é distribuído com builds específicos por plataforma no repositório original; a distribuição principal é pela resource do Spigot e pelo repositório GitHub do projeto.
• As versões confirmadas testadas do Minecraft incluem de 1.14 a 1.21 (consulte as releases do projeto para compatibilidade exata e runtime Java recomendado por build).
• O plugin se integra a plugins de mapa para exibir marcadores de borda, mas eles não são necessários para a aplicação básica da borda.

🤝 Quando este plugin é útil

Se você pré-genera chunks com o Chunky e precisa de uma borda que corresponda a essas áreas geradas (incluindo tratamento de teleporte e visualização opcional no mapa), o ChunkyBorder oferece uma solução compacta e compatível com o Chunky que une seleções, aplicação e marcadores visuais sem substituir o próprio Chunky.