Plugin Minecraft PvPManager

🔌 Sobre o PvPManager

O PvPManager é um plugin de Minecraft para gerenciar o comportamento de jogador contra jogador e as regras do servidor relacionadas a combate. Ele reúne alternância de PvP, marcação em combate, prevenção de combat-log, proteção para iniciantes e vários comportamentos de morte/respawn em um único plugin configurável, voltado para administradores de servidor.

🎯 Objetivo

O objetivo principal do PvPManager é fornecer controles centralizados e configuráveis para interações de PvP e casos extremos relacionados a combate, para que os donos do servidor possam aplicar regras consistentes (alternar PvP, punir combat logging, proteger novatos, controlar recompensas/penalidades por kills e gerenciar restrições de combate).

⚙️ Recursos

• Alternar PvP por jogador, por mundo ou globalmente.
• Sistema de marcação em combate com temporizadores configuráveis e indicadores visuais (action bar/boss bar).
• Prevenção de combat-log com punições configuráveis (dropar inventário, dropar armadura/XP, penalidade em dinheiro, matar o jogador, anunciar/logar eventos).
• Proteção para iniciantes e proteção no respawn/teleporte.
• Anti border-hopping (impede fugir para zonas seguras enquanto estiver marcado) e gatilhos anti abuso de kill.
• Desativar ações durante o combate (voar, mudar gamemode, comandos, ender pearls, colocar blocos, etc.).
• Opções de gerenciamento do inventário (manter, dropar ou transferir os itens para o killer) e suporte a auto-soup.
• Recompensas/penalidades em dinheiro e comandos executáveis ao matar.
• Integrações com PlaceholderAPI e suporte para plugins de zonas (WorldGuard, Towny) e Citizens; integrações opcionais para comportamentos específicos.
• Telemetria e relatório de uso via bStats.

🧩 Para quem é

• Servidores Survival e SMP que precisam de regras de PvP configuráveis.
• Servidores que exigem proteção contra combat logging e segurança no onboarding de novatos.
• Administradores que querem regras integradas de kill/recompensa e alternância simples de PvP sem vários plugins separados.

🏗️ Casos de uso de exemplo

• Ativar a proteção para iniciantes nas primeiras sessões e permitir PvP apenas depois de um tempo configurável.
• Marcar jogadores em combate e impedir que usem teleportes, comandos ou entrem em zonas seguras até a marca expirar.
• Penalizar jogadores que desconectam durante o combate, fazendo dropar o inventário ou aplicando uma punição definida pelo servidor.
• Recompensar automaticamente os killers com dinheiro ou executar comandos personalizados ao matar.

⌨️ Comandos

Notas: os comandos listados foram retirados da documentação oficial do plugin e da página do recurso. Os nós de permissão de cada comando são documentados pelo projeto, mas não são reproduzidos aqui.

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do plugin na página de distribuição do plugin para a sua plataforma.
• Coloque o JAR no diretório plugins/ do servidor em um servidor compatível com Spigot/Paper.
• Reinicie o servidor e verifique os logs do console para confirmar que o plugin foi carregado.

📦 Dependências

• PlaceholderAPI (integração opcional para placeholders).
• Integrações disponíveis para plugins de zonas e NPC, como WorldGuard, Towny e Citizens (opcionais, usadas quando presentes).

🧠 Notas técnicas

• O software de servidor suportado e confirmado inclui Spigot e Paper; o suporte a Folia também é listado pelo projeto.
• O plugin fornece uma API para desenvolvedores e publica builds de desenvolvimento para testes.
• O projeto publica o código-fonte e o rastreamento de issues em seu repositório público e usa bStats para telemetria.
• As versões de Minecraft testadas abrangem muitos lançamentos; os donos do servidor devem consultar a documentação do plugin para compatibilidade exata com uma versão específica do servidor.

🤝 Quando este plugin é útil

O PvPManager é útil quando você precisa de um único plugin configurável para lidar com alternância de PvP, marcação em combate, punição por combat-log e proteção para iniciantes, sem juntar vários plugins separados. Ele centraliza regras comuns de PvP e fornece comandos de administração e integrações para adaptar o comportamento a diferentes configurações de servidor.