Plugin Minecraft PvPManager

🔌 Sobre o PvPManager

O PvPManager é um plugin de Minecraft para gerir o comportamento jogador contra jogador e as regras do servidor relacionadas com combate. 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/ressurgimento num único plugin configurável, pensado para administradores de servidores.

🎯 Objetivo

O objetivo principal do PvPManager é fornecer controlos centralizados e configuráveis para interações de PvP e casos especiais relacionados com combate, para que os donos do servidor possam aplicar regras consistentes (alternar PvP, punir quem faz combat logging, proteger novatos, controlar recompensas/penalizações por kills e gerir restrições de combate).

⚙️ Funcionalidades

• Ativar/desativar 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, penalização de dinheiro, matar o jogador, anunciar/registar 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 kills.
• Desativar ações durante o combate (voar, mudar de gamemode, comandos, ender pearls, colocar blocos, etc.).
• Opções de gestão do inventário (manter, dropar ou transferir os itens para o assassino) e suporte para auto-soup.
• Recompensas/penalizações em dinheiro e comandos executáveis em kills.
• 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 utilização 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 início para novos jogadores.
• Administradores que querem regras integradas de kills/recompensas e alternância simples de PvP sem vários plugins separados.

🏗️ Exemplos de uso

• Ativar a proteção para iniciantes nas primeiras sessões e permitir PvP apenas após um tempo configurável.
• Marcar jogadores em combate e impedir que usem teletransportes, comandos ou entrem em zonas seguras até a marca expirar.
• Penalizar jogadores que se desligam durante o combate, fazendo dropar o inventário ou aplicando uma punição definida pelo servidor.
• Recompensar automaticamente os assassinos 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 estão documentados pelo projeto, mas não são reproduzidos aqui.

⚙️ Instalação

📥 Configuração

• Descarregue 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 num servidor compatível com Spigot/Paper.
• Reinicie o servidor e verifique os logs da consola 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 para Folia também é indicado pelo projeto.
• O plugin fornece uma API para developers e publica builds de desenvolvimento para testes.
• O projeto publica o código-fonte e o acompanhamento de issues no 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 obter compatibilidade exata com uma versão específica do servidor.

🤝 Quando este plugin é útil

O PvPManager é útil quando 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. Centraliza regras comuns de PvP e fornece comandos de administração e integrações para adaptar o comportamento a diferentes configurações de servidor.