Plugin Minecraft ExcellentCrates

🔌 Sobre o ExcellentCrates

ExcellentCrates é um plugin de Minecraft para servidores Spigot/Paper que implementa um sistema completo de crates (lootbox). Ele foca em tipos de crates configuráveis, gerenciamento de chaves (virtuais e físicas) e definições flexíveis de recompensas que os administradores do servidor podem gerenciar principalmente por meio de um editor em GUI dentro do jogo.

🎯 Objetivo

O plugin resolve o problema de criar, configurar e apresentar recompensas baseadas em crates em um servidor sem exigir edições manuais de arquivos. Ele foi pensado para donos de servidores e administradores que querem usar crates de recompensas (para eventos, recompensas diárias, recursos monetizados ou progressão do jogador) mantendo a configuração e as prévias acessíveis no jogo.

⚙️ Recursos

• Editor em GUI dentro do jogo para criar e gerenciar crates, chaves e recompensas.
• Suporte a chaves físicas e virtuais (chaves virtuais impedem troca/compartilhamento).
• Hologramas integrados e efeitos de partículas para blocos de crate (plugins opcionais podem ser necessários para alguns recursos de holograma).
• Crate Blocks: vincule crates a blocos/zonas físicas para interação no mundo.
• GUIs personalizadas de prévia e GUIs personalizadas de abertura por crate.
• Tipos de recompensa: recompensas de itens e recompensas de comandos.
• Suporte a bundles: vários stacks de itens por recompensa (limite documentado de até 27 itens por recompensa de item) e comandos ilimitados por recompensa de comando.
• Raridades e pesos para equilibrar a chance de recompensa.
• Marcos e funcionalidade de abertura em massa.
• Tempos de espera para abrir e custo por abertura por jogador (integração com economia implícita pelo recurso de custo de abertura).
• Requisitos de permissão e de chaves para crates e recompensas.
• Limites de recompensa (globais e por jogador) e divulgação/log de recompensas.
• Suporte a PlaceholderAPI indicado por fontes oficiais.

🧩 Para quem é

• Servidores públicos e privados de Spigot/Paper que usam crates para eventos, monetização ou engajamento dos jogadores.
• Administradores de servidor que preferem um editor dentro do jogo em vez de editar YAML manualmente.

🏗️ Exemplos de uso

• Configure uma crate com raridades e recompensas com peso, coloque um bloco de crate no spawn e dê aos jogadores chaves virtuais para abri-la.
• Crie prévias de crates e hologramas para que os jogadores possam ver as recompensas antes de gastar chaves.
• Use abertura em massa e marcos para fazer eventos por tempo limitado ou recompensar jogadores ativos.

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do plugin e coloque-o no diretório plugins/ do seu servidor em uma build confirmada como compatível (Spigot ou Paper).
• Reinicie o servidor e verifique o console para confirmar que o plugin foi carregado.
• Se o plugin exigir a dependência do motor auxiliar, instale o plugin de dependência necessário (nightcore) antes ou junto com o ExcellentCrates.

📦 Dependências

• Obrigatória: nightcore (plugin engine), conforme indicado pelas fontes oficiais.
• Opcional: ProtocolLib ou PacketEvents para funcionalidade avançada de hologramas; PlaceholderAPI é suportado para placeholders em textos.

🧠 Observações técnicas

• Software de servidor suportado confirmado: Spigot e Paper.
• Requisito mínimo de versão do servidor confirmado: 1.21.8 ou superior (conforme informado pelo projeto).
• Requisito de Java confirmado: Java 21 ou mais recente.
• Suporte a Folia e Forge não é oferecido explicitamente.
• O repositório do projeto lista uma licença GPL-3.0.

🤝 Quando este plugin é útil

Se você precisa de um sistema de crates configurável no jogo com chaves virtuais/físicas, hologramas e definições flexíveis de recompensas (itens, comandos, raridades e limites) para um servidor Spigot/Paper, o ExcellentCrates oferece esses recursos e um fluxo de edição que mantém a maior parte da configuração gerenciável sem edições manuais de arquivos.