WederRankup

Overview WederRankup is a modern rankup plugin built exclusively for Paper/Purpur, featuring a fully interactive, paginated GUI menu with real-time progress tracking. Configure unlimited rank ladders with extensible requirements — money, permissions, playtime, vanilla statistics, or any PlaceholderAPI expression — and fully customizable rewards, all from a single, well-documented config file.

Key Features
• Interactive Paginated GUI: Fully customizable menu layout — every rank declares its own page and slot, with a real snake/checkerboard pattern instead of a solid grid.
• Extensible Requirement System: Money (Vault or PlayerPoints), permissions, playtime, vanilla statistics (blocks mined, mob kills, etc.), or any PlaceholderAPI expression with custom operators.
• Multi-Economy Support: Choose your economy backend in config.yml — Vault or PlayerPoints — with automatic fallback if the plugin isn't installed, no crashes.
• LuckPerms Integration: Automatically grant LuckPerms groups on rankup.
• Live Player Stats Head: Shows current rank, next rank, progress bar, balance, kills, and playtime right in the menu.
• Per-Rank Icon Overrides: Ranks default to status-based minecart icons (locked/next/obtained) — override with any material or Base64 skin texture per rank.
• Fully Configurable Rewards: Console commands, chat messages, sounds, titles, and cosmetic reward summaries shown right in the GUI lore. • Auto-Rankup Toggle: Players can enable automatic sequential rankup with a single command.
• Tiny Caps Font Style: Optional "ᴛɪɴʏ ᴄᴀᴘꜱ" text styling for all messages and menus, toggleable in config.yml.
• Multi-Language: English and Spanish included out of the box (lang_en.yml / lang_es.yml).
• Async-Safe: All player data I/O runs off the main thread — zero lag from rankup checks or GUI opens.

Commands & Permissions

Command	Description	Permission
/rankup	Attempt to claim the next rank	wederrankup.user
/rankup gui / /ranksmenu	Open the interactive rank menu	wederrankup.user
/rankup autorankup	Toggle automatic sequential rankup	wederrankup.user
/rankup reload	Reload configuration without restarting	wederrankup.admin

Placeholders

Placeholder	Description
%wrankup_rank%	Player's current rank name
%wrankup_next_rank%	Next rank to be claimed
%wrankup_progress%	Progress toward the next rank, e.g. "42%"
%wrankup_progress_bar%	Text progress bar
%wrankup_total_rankups%	Total ranks the player has claimed
%wrankup_total_ranks%	Total ranks configured on the server

Installation

1. Download WederRankup.jar.
2. Place it into your server's /plugins directory.
3. Restart your server.
4. Configure ranks.yml — set up your rank ladder, requirements, rewards, and GUI layout.
5. (Optional) Install Vault or PlayerPoints for the MONEY requirement, LuckPerms for group rewards, and PlaceholderAPI for the PLACEHOLDER requirement type and %wrankup_...% placeholders.

Requirements • Paper (or Paper fork) 1.20+ • Java 21+