Minecraft plugin Rankup

🔌 About Rankup

Rankup is a Bukkit/Spigot Minecraft plugin that implements a configurable rank-ladder progression system. It provides a GUI for browsing rank steps, a flexible requirements engine to control when players can advance, and a prestige system for repeated progression. The plugin is intended for server administrators who want an automated, configurable way to promote players through ranks.

🎯 Purpose

Rankup solves the problem of managing player progression (rank ladders) without manual promotion. It centralizes rank definitions, advancement requirements, and optional prestige mechanics so server owners can define multi-step progressions tied to permissions and custom requirements.

⚙️ Features

• Configurable rank ladder defined in rankups.yml.
• GUI for players to view and confirm rankups.
• Requirements system to define conditions for each rank step (e.g., permissions, playtime, tokens/values provided by requirements plugins).
• Prestige support with a separate prestiges.yml.
• Commands for listing ranks, performing single or multi-step rankups, and reloading configuration.
• Placeholder support via the plugin's placeholder engine for messages and GUIs.
• Permission-based access control for commands and administrative functions.

🧩 Who It Is For

• Survival / SMP servers using progression or rank ladders.
• Prison or economy servers that expose step-based promotion systems.
• Server admins who want permission-driven rank advancement with GUI support.

🏗️ Example Use Cases

• Define a sequence of ranks that automatically require increasing playtime or items before a player may advance.
• Use prestiges to reset a player’s rank while granting special rewards or progression counters.
• Integrate with a permissions plugin to grant or remove rank-related permission nodes when a player advances.

⌨️ Commands

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the plugin JAR from the plugin distribution (official resource) or build from source.
• Place the JAR into your server's plugins/ directory.
• Start or restart the server and check console output to confirm the plugin loaded.
• Use the provided configuration files (rankups.yml, prestiges.yml, locale/config) and the provided reload command to apply changes at runtime.

📦 Build from source

• The project includes a Gradle wrapper; run the included gradlew build to produce the plugin JAR in the build/libs directory.

🧠 Technical Notes

• The plugin uses YAML configuration files (notably rankups.yml and prestiges.yml) for rank and prestige definitions.
• It provides a placeholder engine and supports placeholders for use in messages and GUIs.
• The plugin exposes explicit command permission nodes and an administrative permission to mirror OP access.
• Source code is published under GPL-3.0.

🤝 When This Plugin Is Useful

If you need a configurable, permission-aware rank ladder with GUI and prestige support, Rankup centralizes rank definitions and advancement rules to automate player progression without manual promotions.