Plugin Minecraft WorldGuardExtraFlagsPlus

🔌 Sobre o WorldGuard ExtraFlags Plus

O WorldGuard ExtraFlags Plus é uma extensão do plugin WorldGuard que adiciona flags e comportamentos extras para regiões. Ele amplia o sistema de regiões do WorldGuard com mais de 40 flags confirmadas para controlar uso de itens, teleporte, limites de entrada, crafting, colisão entre jogadores, comércio com aldeões e outras regras específicas por região.

🎯 Objetivo

O plugin preenche lacunas nas flags nativas do WorldGuard, oferecendo controle detalhado sobre as ações dos jogadores e as políticas de região. Ele foi pensado para administradores de servidores que precisam de personalização em nível de região além do WorldGuard base, por exemplo para criar arenas PvP protegidas, lobbies, comportamento de hub ou áreas com jogabilidade restrita.

⚙️ Recursos

• Adiciona mais de 40 flags extras (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Novas flags específicas do Plus: disable-completely, disable-throw, entry-min-level, entry-max-level, player-count-limit, villager-trade, lightning-damage, disable-collision, inventory-craft, permit-workbenches, deny-item-drops, deny-item-pickup, allow-block-place, deny-block-place, allow-block-break, deny-block-break.
• Mensagens personalizáveis armazenadas em messages-wgefp.yml (cooldown de mensagem para evitar spam).
• Hooks de integração opcionais: suporte ao PlaceholderAPI para placeholders numéricos, hooks opcionais de pacotes com PacketEvents ou ProtocolLib para melhorar o bloqueio de certos itens/ataques.
• Interação com EssentialsX: aprimoramentos das flags godmode e fly desativam o godmode/fly do EssentialsX quando essas flags são negadas.
• Suporte ao Folia e handlers seguros para async quando aplicável.
• Verificador de atualizações e uma flag experimental hide-players e o comportamento experimental chambered-enderpearl.
• Flag console-command-repeat para executar um comando de console repetidamente enquanto um jogador permanecer em uma região (desativada por padrão).

🧩 Para quem é

• Donos e administradores de servidores que usam WorldGuard e precisam de controles de região mais precisos.
• Servidores Survival, SMP, hub/lobby e PvP que exigem comportamento personalizado por região.
• Servidores que usam Paper ou Folia e precisam de suporte async ou específico da fork.

🏗️ Exemplos de uso

• Limitar o número de jogadores em uma região de arena com player-count-limit.
• Bloquear o uso e o arremesso de itens específicos (mace, trident, ender pearls) dentro de zonas de evento usando disable-completely e disable-throw.
• Impedir crafting (2x2) no inventário dentro de áreas seguras com inventory-craft ou bloquear o uso da bancada com permit-workbenches.
• Restringir a entrada na região pelo nível de XP do jogador ou por um valor numérico do PlaceholderAPI usando entry-min-level / entry-max-level.
• Executar repetidamente um comando de console enquanto jogadores permanecerem dentro de uma região usando console-command-repeat.

⌨️ Comandos

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial e coloque-o no diretório plugins/ do seu servidor junto com o WorldGuard.
• Se estiver atualizando a partir do antigo WorldGuardExtraFlags: remova o WorldGuardExtraFlags.jar antigo antes de iniciar — os dois não podem coexistir.
• Reinicie o servidor e verifique o console para confirmar que o plugin e suas flags foram carregados corretamente.

📦 Dependências

• Obrigatório: WorldGuard (este projeto é uma extensão do WorldGuard).
• Opcional / Integrações: PlaceholderAPI (suporte a placeholders numéricos), PacketEvents ou ProtocolLib (bloqueio por pacotes aprimorado), EssentialsX (integração para o comportamento de godmode/fly).

🧾 Configuração

• As mensagens do plugin ficam em plugins/WorldGuard/messages-wgefp.yml e são totalmente personalizáveis; há um sistema de cooldown de mensagens configurável pela config do plugin.

🧠 Notas técnicas

• O projeto declara api-version: 1.21 e usa artefatos modernos da API do Paper; a compatibilidade com Folia está implementada e confirmada.
• O bytecode Java e o alvo de API acompanham ambientes de servidor recentes da era 1.21.
• O plugin substitui o comportamento antigo de permit-completely por disable-completely para um bloqueio de itens com semântica mais ampla.
• Alguns recursos (por exemplo, bloqueio completo de certas mecânicas de investida da lança) são mais confiáveis quando PacketEvents ou ProtocolLib estão presentes.
• O plugin expõe muitas flags por meio dos comandos padrão de flags do WorldGuard (as flags são definidas pela interface de flags de região do WorldGuard).

🤝 Quando este plugin é útil

Se você usa WorldGuard e precisa de flags de região adicionais e confirmadas para controlar o uso de itens, regras de entrada de jogadores, crafting e outros comportamentos por região — especialmente em servidores Paper ou Folia — o WorldGuard ExtraFlags Plus centraliza esses recursos dentro do sistema de flags do WorldGuard, sem precisar de plugins separados de gerenciamento de regiões.