Plugin Minecraft PhoenixCrates

🔌 Sobre o Phoenix Crates

Phoenix Crates é um plugin de Minecraft para executar sistemas de crates/recompensas em um servidor. Ele oferece tipos de crates, chaves (físicas e virtuais), sequências animadas de abertura e um editor dentro do jogo para criar e gerenciar crates e recompensas sem editar arquivos brutos. O projeto é publicado pela Phoenix Plugins e está disponível em uma edição gratuita, além de uma versão premium paga com recursos extras.

🎯 Objetivo

Fornecer aos administradores do servidor um sistema configurável de recompensas/crates que possa exibir aberturas animadas, gerenciar chaves e chaves no estilo de moeda virtual, e permitir que a equipe crie ou edite crates e recompensas no jogo. Ele é voltado para servidores que querem mecânicas no estilo de eventos ou de loja/recompensa (por exemplo: brindes de recompensa, crates da loja ou prêmios de evento).

⚙️ Recursos

• Vários modos de engine de crates (bloco vanilla, modelo vanilla, integração com Model Engine).
• Sequências animadas de abertura e animações de espera com fases e combinações configuráveis.
• Chaves físicas e gerenciamento de chaves virtuais (menus de chaves virtuais, comandos de pagar/transferir, dar/retirar/definir).
• Editor dentro do jogo para criar/editar crates, chaves, recompensas e animações.
• Tipos de recompensa incluindo recompensas aleatórias e seletivas (o jogador escolhe), rerolls e recompensas garantidas.
• Complementos e extras premium (animações adicionais, suporte a MySQL, API e instalação de add-ons no plano premium).
• Suporte básico de visualização no Bedrock/Geyser para certas animações e modelos.
• Ferramentas de pré-visualização no servidor e gerenciamento de recompensas (limites globais/de jogador, redefinição de cooldown).

🧩 Para quem é

• Servidores Survival/SMP e de economia que usam crates ou sistemas de recompensa.
• Servidores que querem aberturas de crates animadas/visuais e suporte a modelos (Model Engine).
• Administradores que preferem um editor dentro do jogo para configurar crates em vez de editar arquivos manualmente.

🏗️ Exemplos de uso

• Dar aos jogadores chaves virtuais que eles podem gastar em uma GUI para abrir crates de cosméticos ou itens.
• Criar crates com tema de feriado e animações de abertura personalizadas e recompensas limitadas.
• Usar o editor dentro do jogo para migrar ou reconstruir configurações de crates sem editar YAML manualmente.

⌨️ Comandos

(Os comandos acima foram retirados da documentação oficial do Phoenix Crates e da referência de comandos.)

🔐 Permissões

(Apenas os nós de permissão explicitamente documentados pelo projeto estão listados.)

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do plugin Phoenix Crates ou obtenha-o pelo canal oficial de distribuição.
• Coloque o JAR no diretório plugins/ do seu servidor para um servidor compatível (veja as Notas Técnicas).
• Inicie ou reinicie o servidor e verifique o console para confirmar que o plugin foi carregado.
• Use o editor dentro do jogo ou os comandos fornecidos para criar crates e chaves; o plugin também oferece comandos de recarregar e de editor.

📦 Dependências

• Por padrão, não há dependências de terceiros obrigatórias listadas. O plugin integra-se com sistemas opcionais como o Model Engine para modelos personalizados e fornece placeholders mencionados nos changelogs.

🧠 Notas técnicas

• Software de servidor suportado (conforme informado pelo autor): Spigot e forks do Spigot, Paper e forks do Paper, e Folia.
• Versões suportadas do Minecraft: conforme documentado, o Phoenix Crates (na linha de versão informada) suporta Minecraft 1.20.4+ (o suporte a versões mais antigas foi removido a partir do grande lançamento mencionado).
• Integrações opcionais: Model Engine (modelos animados personalizados), notas de compatibilidade com GeyserMC para visualização no Bedrock e placeholders do PlaceholderAPI mencionados em atualizações.
• O projeto é oferecido em níveis gratuito e premium; o premium adiciona recursos como suporte a MySQL, acesso à API pública, crates ilimitados, animações adicionais e add-ons.

🤝 Quando este plugin é útil

Se você precisa de um sistema de crates configurável e baseado em animações, com editor dentro do jogo e suporte opcional a modelos/Bedrock, o Phoenix Crates oferece tanto visuais para os jogadores quanto ferramentas administrativas para gerenciar recompensas e chaves no servidor.