Plugin Minecraft UltraCosmetics

🔌 Sobre o UltraCosmetics

UltraCosmetics é um plugin de Minecraft para Spigot/Paper que adiciona uma grande variedade de cosméticos de jogador e efeitos visuais a um servidor. Ele oferece um menu baseado em GUI e sistemas para pets, montarias, gadgets, efeitos de partículas, efeitos de projéteis, efeitos de morte, emotes, chapéus, morphs, suits e baús de tesouro. O projeto é open-source e mantido no GitHub.

🎯 Objetivo

O UltraCosmetics foi projetado para dar aos donos de servidores um sistema modular de cosméticos que permite aos jogadores acessar e equipar itens e efeitos cosméticos por meio de um menu dentro do jogo. Ele resolve a necessidade de personalização cosmética sem impacto na jogabilidade e de conteúdo cosmético monetizável, mantendo essa funcionalidade separada dos mecanismos centrais de gameplay.

⚙️ Recursos

• Menu em GUI para navegar e equipar cosméticos.
• Categorias de cosméticos incluindo Pets, Mounts, Gadgets, Hats, Particle Effects, Projectile Effects, Death Effects, Emotes, Morphs e Suits.
• Funcionalidade de baú de tesouro para conceder desbloqueios cosméticos.
• Armazenamento configurável para cosméticos desbloqueados (arquivos de dados do jogador ou um backend SQL, conforme suportado pelo projeto).
• Suporte a traduções (múltiplos idiomas mantidos pelo projeto).

🧩 Para quem é

Donos e administradores de servidores que querem adicionar conteúdo cosmético aos seus servidores Spigot ou Paper: servidores públicos de minigames/lobby, redes SMP que oferecem lojas de cosméticos e qualquer servidor que queira personalização cosmética para os jogadores sem alterar a jogabilidade principal.

🏗️ Exemplos de uso

• Disponibilizar um menu de cosméticos no lobby para que os jogadores equipem pets e efeitos de partículas.
• Dar à staff ou aos jogadores acesso a gadgets especiais ou emotes por comandos ou pela GUI.
• Usar baús de tesouro para conceder recompensas cosméticas aleatórias aos jogadores.
• Armazenar os desbloqueios cosméticos dos jogadores nos arquivos de dados do servidor ou em um banco de dados SQL conectado quando configurado.

⌨️ Comandos

(Observação: esta sintaxe do comando foi retirada da documentação do projeto que descreve o uso do baú de tesouro.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do plugin nas páginas oficiais de distribuição do projeto.
• Coloque o JAR no diretório plugins/ do servidor Spigot ou Paper.
• Reinicie o servidor e verifique os logs do console para confirmar que o plugin foi carregado.

📦 Dependências

• Nenhuma dependência de terceiros obrigatória é declarada por padrão no README do projeto. (Inclua dependências externas apenas se estiverem configuradas explicitamente.)

🧾 Configuração

• O plugin usa arquivos de configuração e dados; por padrão, os cosméticos desbloqueados são armazenados em arquivos de dados do jogador ou em um banco de dados SQL conectado quando configurado.
• Um wiki do projeto e um guia de início rápido fornecem opções de configuração e detalhes de setup.

🧠 Notas técnicas

• Suporta oficialmente o software de servidor Spigot e Paper.
• O projeto fornece notas de compatibilidade para diferentes versões; consulte a documentação do projeto para os intervalos exatos de Minecraft suportados por release.
• O código-fonte é publicado sob a GNU Affero General Public License v3.0.
• O reporte de problemas e o desenvolvimento são feitos pelo repositório do projeto.

🤝 Quando este plugin é útil

Se você precisa de um sistema de cosméticos mantido, orientado por GUI, para um servidor Spigot ou Paper que suporte muitas categorias de cosméticos e armazenamento configurável para itens desbloqueados, o UltraCosmetics oferece uma opção open-source com documentação no próprio repositório e suporte da comunidade.