Rankup

Rankup 1.21.1+



Advanced 100 Ranks Progression and Economy System
Best 2 commands choiced by players: (to view requirements/progress and level up)

Example: /rank or /rankup


Changelogs:

v1.2:
Manual Rank Management: Replaced dynamic calculation logic with a strict YAML-based loading system for ranks to ensure data consistency and prevent requirement errors.
LuckPerms API Integration: Implemented direct API calls for permission handling, replacing console command execution. Added asynchronous retroactive permission checks on player join and introduced a silent check logic to eliminate console spam.
Global Localization and Formatting: Implemented a centralized NumberFormat system...
v1.1:
Added RankListener to verify and apply permissions on player join.
Implemented recursive permission check from Rank 0 to player's current rank.
Fixed null text formatting issue in MessageManager and RankMenu.
Enhanced RankMenu stability with safe slot looping.
Updated RankupCommand with syntax protection and color standardization.
v1.0:
Initial release with multi-version support (1.21.1 to 26.1.2), Paper/Folia compatibility, and precision rank management. Integrated SQL database for persistent player progression and 100 ranks fallback system.

Initial Project
│➜ Precision Progression Engine: Advanced formulas to calculate
│➜ exact requirements for money, xp levels, and playtime,
│➜ ensuring a balanced economy across 100 ranks.
│➜ Automated Fallback System: Smart logic that generates
│➜ rank requirements and rewards mathematically if they
│➜ are not manually defined in the config.
│➜ Interactive GUI Menu: Dynamic 54-slot inventory with
│➜ page navigation to browse all 100 ranks and status.
│➜ Bedrock Compatibility: GUI designed to work perfectly
│➜ with Geyser/Bedrock primary clicks.
│➜ Command Shield: High-priority protection to ensure
│➜ /rank and /rankup are never overwritten by other plugins.
│➜ GriefPrevention Integration: Automatically grants bonus
│➜ claim blocks upon reaching specific ranks.
│➜ PlaceholderAPI Support: Native placeholders %rankup_tag%
│➜ and %rankup_name% for Chat and Tablist integration.
│➜ Discord Integration: Dedicated webhooks for
│➜ announcing player rankups to your community.
│➜ Dual Database Support: Choose between SQLite for
│➜ standalone servers or MySQL for BungeeCord/Velocity.
│➜ Localized Language Core: Full support for English (EN),
│➜ Portuguese (PT), Spanish (ES), and Russian (RU)
│➜ configurable via config.yml.

Update Instructions: It is highly recommended to use Vault and LuckPerms for full feature availability.

Main Features
│➜ Folia & Paper Ready: Built with region-aware
│➜ scheduling and asynchronous database tasks to
│➜ ensure zero impact on server TPS.
│➜ Asynchronous Processing: Webhooks and database
│➜ saves run outside the main thread to prevent lag.
│➜ Multi-Language YAMLs: All messages, titles, and
│➜ menu items are fully translatable in 4 different files.
│➜ Smart Command Protection: Internal listener that
│➜ guarantees your plugin owns its primary commands.

Commands
│➜ / rank Opens the visual GUI menu and shows progress in chat.
│➜ / rankup Attempts to level up to the next rank.
│➜ / rankreload Hot-reloads all configurations and language files.

"You can configure specific permissions and console commands for every single rank. By default, the plugin grants 1,000 claim blocks at Rank 1 and scales up to 100,000 at Rank 100 automatically."

Permissions
Remember you don't need all (default enabled)
Admin permission is required for reloads!
│➜ rankup.player Access to /rank and /rankup commands.
│➜ rankup.admin Master permission to reload and manage the plugin.

Configuration (config.yml)
│➜ database: Configure SQLite or MySQL for logs and
│➜ player progression.
│➜ discord-webhook: Set dedicated URL for server
│➜ rankup announcements.
│➜ language: Switch between en, pt, es, or ru.
│➜ settings: Toggle global broadcasts and PAPI tags.

Important Notice
│➜ Compatible with Minecraft 1.21.1 and newer.
│➜ Required Dependencies: Vault (for Economy).
│➜ Recommended: PlaceholderAPI and GriefPrevention.
│➜ Developed for high-performance production environments.

Developed with ❤️ by Comonier