Plugin Minecraft BanItem

🔌 Sobre o BanItem

BanItem é um plugin de Minecraft que bloqueia ou coloca em whitelist itens específicos e comportamentos de itens por mundo. Ele atende às necessidades de administração de servidores em que certos itens precisam ser impedidos de ser usados, colocados, apanhados ou de outra forma interagidos. O projeto fornece uma API para desenvolvedores e é distribuído sob a licença GPL-3.0.

🎯 Finalidade

O BanItem existe para dar aos administradores de servidores controle detalhado sobre quais itens os jogadores podem usar em cada mundo. Esse controle pode ser aplicado como uma blacklist (bloqueando os itens listados) ou uma whitelist (bloqueando tudo, exceto os itens explicitamente permitidos), e as permissões podem ser aplicadas por mundo e por item.

⚙️ Recursos

• Modo blacklist para bloquear itens e opções especificados.
• Modo whitelist para bloquear todos os itens/opções, exceto as entradas permitidas configuradas.
• Configuração por mundo para que mundos diferentes possam aplicar regras diferentes para itens.
• Permissões por mundo, por item e granularidade de permissões por opção.
• Suporte para itens personalizados/modded (itens identificados por dados/metadados específicos do item).
• Implementação leve que ativa apenas os listeners necessários para as opções configuradas.
• API para desenvolvedores para que outros plugins possam consultar ou modificar bans programaticamente.
• Requer Java 1.8 e qualquer servidor baseado em Bukkit.

🧩 Para quem é

• Donos e administradores de servidores que precisam remover ou restringir itens específicos.
• Servidores Survival e SMP que querem impedir itens poderosos ou que podem quebrar o servidor.
• Operadores de rede que gerenciam vários mundos com regras de itens diferentes.
• Desenvolvedores de plugins que precisam de uma API para interagir com banimentos de itens.

🏗️ Casos de uso de exemplo

• Impedir jogadores de usar elytra, shulker boxes ou totems em mundos Survival.
• Permitir um pequeno conjunto de itens em um mundo de minijogo protegido, enquanto bane todos os outros via modo whitelist.
• Bloquear itens modded/personalizados adicionados por mods do lado do cliente em servidores que os aceitam.
• Integrar o BanItem com outro plugin administrativo por meio da sua API para aplicar regras automaticamente.

⚙️ Instalação

📥 Configuração

1. Confirme que seu servidor roda uma versão compatível com Bukkit e Java 1.8+.
2. Baixe o JAR oficial do plugin e coloque-o na pasta plugins/ do seu servidor.
3. Reinicie o servidor e verifique o console para garantir que o BanItem carregue com sucesso.

📦 Dependências

• Não há dependências obrigatórias de plugins documentadas.
• Requer uma implementação de servidor compatível com Bukkit e runtime Java 1.8 ou mais recente.

🧾 Configuração

• O plugin é configurável por mundo e por item.
• O projeto fornece opções de configuração para os modos blacklist/whitelist e opções por item; os nomes exatos dos arquivos e chaves são fornecidos na documentação do projeto.

🧠 Notas técnicas

• O BanItem informa suporte para qualquer servidor baseado em Bukkit; as versões oficiais são fornecidas para ambientes Spigot/Bukkit.
• Há uma API para desenvolvedores disponível para que outros plugins possam acessar o BanItem programaticamente.
• O projeto é open-source sob a licença GPL-3.0.
• Última versão registrada: v3.8 (9 de junho de 2026).

🤝 Quando este plugin é útil

Se você precisa de controle consistente, por mundo, sobre quais itens podem ser usados pelos jogadores (incluindo suporte para itens personalizados/modded) e de uma API para integração, o BanItem oferece uma solução leve focada em regras de restrição por item e por mundo.