Plugin Minecraft Rankup

🔌 Sobre o Rankup

Rankup é um plugin Bukkit/Spigot de Minecraft que implementa um sistema configurável de progressão em escada de ranks. Ele fornece uma GUI para navegar pelas etapas de rank, um sistema flexível de requisitos para controlar quando os jogadores podem avançar e um sistema de prestígio para progressão repetida. O plugin foi pensado para administradores de servidor que querem uma forma automatizada e configurável de promover jogadores pelos ranks.

🎯 Objetivo

Rankup resolve o problema de gerenciar a progressão dos jogadores (escadas de rank) sem promoção manual. Ele centraliza as definições de rank, os requisitos de avanço e mecânicas opcionais de prestígio, para que os donos do servidor possam definir progressões em várias etapas ligadas a permissões e requisitos personalizados.

⚙️ Recursos

• Escada de ranks configurável definida em rankups.yml.
• GUI para os jogadores verem e confirmarem rankups.
• Sistema de requisitos para definir as condições de cada etapa de rank (por exemplo, permissões, tempo jogado, tokens/valores fornecidos por plugins de requisitos).
• Suporte a prestígio com um prestiges.yml separado.
• Comandos para listar ranks, executar rankups de uma ou várias etapas e recarregar a configuração.
• Suporte a placeholders por meio do mecanismo de placeholders do plugin para mensagens e GUIs.
• Controle de acesso baseado em permissões para comandos e funções administrativas.

🧩 Para quem é

• Servidores Survival / SMP que usam progressão ou escadas de rank.
• Servidores Prison ou de economia que expõem sistemas de promoção baseados em etapas.
• Administradores de servidor que querem avanço de rank guiado por permissões com suporte a GUI.

🏗️ Casos de uso de exemplo

• Definir uma sequência de ranks que exija automaticamente mais tempo jogado ou itens antes de o jogador avançar.
• Usar prestígios para redefinir o rank de um jogador enquanto concede recompensas especiais ou contadores de progresso.
• Integrar com um plugin de permissões para conceder ou remover nós de permissão relacionados a rank quando um jogador avança.

⌨️ Comandos

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o JAR do plugin pela distribuição oficial do plugin ou compile a partir do código-fonte.
• Coloque o JAR no diretório plugins/ do seu servidor.
• Inicie ou reinicie o servidor e verifique a saída do console para confirmar que o plugin foi carregado.
• Use os arquivos de configuração fornecidos (rankups.yml, prestiges.yml, locale/config) e o comando de reload fornecido para aplicar as mudanças em tempo de execução.

📦 Compilar a partir do código-fonte

• O projeto inclui um Gradle wrapper; execute o gradlew build incluso para gerar o JAR do plugin no diretório build/libs.

🧠 Notas técnicas

• O plugin usa arquivos de configuração YAML (principalmente rankups.yml e prestiges.yml) para definições de rank e prestígio.
• Ele fornece um mecanismo de placeholders e oferece suporte a placeholders para uso em mensagens e GUIs.
• O plugin expõe nós de permissão explícitos para comandos e uma permissão administrativa para espelhar o acesso de OP.
• O código-fonte é publicado sob GPL-3.0.

🤝 Quando este plugin é útil

Se você precisa de uma escada de ranks configurável e baseada em permissões, com suporte a GUI e prestígio, o Rankup centraliza as definições de rank e as regras de avanço para automatizar a progressão dos jogadores sem promoções manuais.