Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
RankedSMPX
A highly configurable competitive ranked SMP plugin with rank-based perks, combat mechanics, and progression systems for Minecraft. Inspired by RankedSMP.
Add competitive ranking to your survival server! ๐ This plugin introduces a ranked system where players compete for 20 limited rank positions. Each rank provides unique advantages including increased health, enhanced potion effects, boosted XP gains, and extra inventory slots. Players can challenge and defeat ranked opponents to steal their position and climb the ladder. The competition never stops as everyone fights to reach and maintain Rank #1!
Disclaimer
This is an unofficial remake of the RankedSMP plugin concept. I am not affiliated with the original RankedSMP server or team. This plugin is a fan-made recreation and I do not claim any credit for the original gameplay concept.
โจ Features
๐จ Highly Customizable
Almost everything can be customized! This plugin is designed to be fully configurable to match your server's needs:
- Buff Multipliers - Customize health, potion duration, and XP multipliers per rank
- Inventory Slots - Set exact slot counts for top 10 ranks (15-54 slots)
- Rank Prefixes - Custom prefix for each rank with RGB color support
- All Messages - Every message can be customized with colors and formatting
- Combat Mechanics - Adjust rank differences for stealing
- Discord Integration - Customize embeds, notifications, and role colors
- TAB Integration - Full control over prefixes, suffixes, and sorting
๐ Rank System
- Dynamic Ranking - Players compete for limited rank slots (configurable 1-20)
- Rank Stealing - Kill ranked players to take their position
- Rank Transfer - Transfer your rank to another player (disabled by default)
- Rank History - Track all rank changes with timestamps and reasons
- Blacklist System - Prevent specific players from receiving ranks
โ๏ธ Combat & Perks
- Health Scaling - Higher ranks get more hearts (10.5 to 20 hearts)
- Potion Duration - Rank-based potion effect multipliers (1.05x to 2.00x)
- XP Multiplier - Earn more XP with higher ranks (1.10x to 3.00x)
- Extra Inventory - Top 10 ranks get additional inventory slots (15 to 54 slots)
- Judgement Hammer - Exclusive custom mace for Rank #1 with special abilities
- Rank Stealing - Kill ranked players to take their position
๐ฌ Discord Integration
- Bot Commands - Full Discord slash command support
- Account Linking - Link Minecraft accounts to Discord
- Rank Notifications - DM players when their rank changes
- Live Leaderboard - Auto-updating embed leaderboard
- Role Sync - Automatic Discord role assignment based on ranks
- Updates Channel - Announce game events and rank changes
- Configurable Embeds - Customize embed footer names
๐พ Database Support
- SQLite - Built-in lightweight database (default)
- MySQL - Full MySQL/MariaDB support for networks
- HikariCP - High-performance connection pooling
- Automatic Backups - Config backups on updates
๐จ Customization
- Fully Configurable - Every aspect can be customized
- Messages System - Customize all plugin messages
- Color Codes - Full RGB hex color support
- Small Caps - Automatic small caps formatting
- TAB Integration - Custom prefixes, suffixes, and sorting
- PlaceholderAPI - 8 placeholders for other plugins
๐ ๏ธ Admin Tools
- GUI Management - Visual rank management interface
- Import/Export - Backup and restore rank data (JSON)
- Rank Fix - Automatically fix invalid ranks
- Debug Logging - Detailed logging for troubleshooting
- Auto-Updates - Config files update automatically with new features
๐ Commands
๐ค Player Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
/rankinfo [player] |
/ri, /myrank |
None | Check your rank info and buffs |
/ranktop |
/rt, /topranks |
None | See the top ranked players |
/rank [player] |
- | None | View rank and buffs for any player |
/ranks |
- | None | Open a GUI showing all ranked players |
/ranktransfer <player> |
/transfer, /giverank |
None | Give your rank to another player (must be enabled in config) |
/linkdiscord |
/discordlink |
None | Link your Minecraft account to Discord |
/unlinkdiscord |
/discordunlink |
None | Unlink your Discord account |
/extrainventory |
/inv, /extrainv, /ei, /einv |
None | Access extra inventory (Ranks 1-10 only) |
๐ง Admin Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
/rankedsmp help |
/rsmp help |
None | Show the help menu |
/rankedsmp start |
/rsmp start |
rankedsmp.admin |
Start the game and assign ranks |
/rankedsmp stop |
/rsmp stop |
rankedsmp.admin |
Stop the game and clear all ranks |
/rankedsmp reload |
/rsmp reload |
rankedsmp.admin |
Reload config files |
/rankedsmp manage |
/rsmp manage |
rankedsmp.admin |
Open rank management GUI |
/rankedsmp set <player> <rank|unranked|blacklisted> |
/rsmp set |
rankedsmp.admin |
Set a player's rank directly |
/rankedsmp rank set <player> <rank> |
/rsmp rank set |
rankedsmp.admin |
Alternative way to set ranks |
/rankedsmp rank remove <player> |
/rsmp rank remove |
rankedsmp.admin |
Remove a player's rank |
/rankedsmp give mace <player> |
/rsmp give hammer |
rankedsmp.admin |
Give Judgement Hammer to a player |
/rankblacklist add <player> |
/rbl add, /blacklist add |
rankedsmp.blacklist |
Blacklist a player from getting ranks |
/rankblacklist remove <player> |
/rbl remove, /blacklist remove |
rankedsmp.blacklist |
Remove player from blacklist |
/rankblacklist list |
/rbl list, /blacklist list |
rankedsmp.blacklist |
View all blacklisted players |
/rankhistory <player> |
/rh, /history |
rankedsmp.history |
View rank change history for a player |
/rankhistorywipe <player|all> |
/rhw, /historywipe |
rankedsmp.historywipe |
Wipe rank history data |
/rankexport |
- | rankedsmp.export |
Export all ranks to JSON file |
/rankimport <filename> |
- | rankedsmp.import |
Import ranks from JSON file |
/rankfix |
- | rankedsmp.admin |
Fix any invalid ranks in database |
๐ฌ Discord Commands
| Command | Permission | Description |
|---|---|---|
/help |
Everyone | Show all available Discord commands |
/rank [player] |
Everyone | Check rank for yourself or another player |
/link <code> |
Everyone | Link Minecraft account with 6-digit code |
/unlink |
Everyone | Unlink your Minecraft account |
/rankset <player> <rank> |
Admin | Set a player's rank via Discord |
/rankrandom |
Admin | Randomly assign ranks to all players |
/setchannel <type> |
Admin | Set leaderboard or updates channel |
/rankexport |
Admin | Export rank data to JSON |
/rankimport |
Admin | Import rank data from JSON |
๐ PlaceholderAPI Placeholders
| Placeholder | Description | Example Output |
|---|---|---|
%rankedsmp_rank% |
Player's rank or "Unranked" | 5 or Unranked |
%rankedsmp_rank_number% |
Rank as number (0 if unranked) | 5 or 0 |
%rankedsmp_hearts% |
Player's max hearts | 24.0 |
%rankedsmp_potion_multiplier% |
Potion duration multiplier | 1.85 |
%rankedsmp_xp_multiplier% |
XP gain multiplier | 2.50 |
%rankedsmp_extra_slots% |
Extra inventory slots | 18 |
%rankedsmp_rank_prefix% |
Rank prefix for TAB | [#5] |
%rankedsmp_rank_suffix% |
Rank suffix for TAB | `` |
โ ๏ธ First Startup Note: The first time you start the server with this plugin, it will take a bit longer to load as it downloads required dependencies (JDA, Gson, MySQL, SQLite, HikariCP) from Maven Central. These are cached locally, so subsequent startups will be fast and normal.
๐ฌ Support
Need help? Have questions? Join our Discord community!
Discord: https://discord.gg/Z2pd8tbm7a
๐ Documentation/Wiki: Coming soon!
For bug reports and feature requests, please use Discord.
๐ฎ Features Showcase
๐ Rank Buffs Table
| Rank | Hearts | Potion Duration | XP Multiplier | Extra Inventory Slots | Special Items |
|---|---|---|---|---|---|
| #1 | 20.0 | 2.00x | 3.0x | 54 slots | Judgement Hammer |
| #2 | 19.5 | 1.96x | 2.9x | 54 slots | - |
| #3 | 19.0 | 1.91x | 2.8x | 50 slots | - |
| #4 | 18.5 | 1.86x | 2.7x | 45 slots | - |
| #5 | 18.0 | 1.81x | 2.6x | 40 slots | - |
| #6 | 17.5 | 1.76x | 2.5x | 35 slots | - |
| #7 | 17.0 | 1.71x | 2.4x | 30 slots | - |
| #8 | 16.5 | 1.66x | 2.3x | 25 slots | - |
| #9 | 16.0 | 1.61x | 2.2x | 20 slots | - |
| #10 | 15.5 | 1.56x | 2.1x | 15 slots | - |
| #11 | 15.0 | 1.51x | 2.0x | 0 slots | - |
| #12 | 14.5 | 1.46x | 1.9x | 0 slots | - |
| #13 | 14.0 | 1.41x | 1.8x | 0 slots | - |
| #14 | 13.5 | 1.36x | 1.7x | 0 slots | - |
| #15 | 13.0 | 1.31x | 1.6x | 0 slots | - |
| #16 | 12.5 | 1.26x | 1.5x | 0 slots | - |
| #17 | 12.0 | 1.21x | 1.4x | 0 slots | - |
| #18 | 11.5 | 1.16x | 1.3x | 0 slots | - |
| #19 | 11.0 | 1.11x | 1.2x | 0 slots | - |
| #20 | 10.5 | 1.05x | 1.1x | 0 slots | - |
| Unranked | 10.0 | 1.00x | 1.0x | 0 slots | - |
๐ Special Items
โ๏ธ Judgement Hammer (Rank #1 Only)
โ ๏ธ WORK IN PROGRESS - NOT RECOMMENDED FOR PRODUCTION USE
The Judgement Hammer feature is still being refined and may have bugs. Miss detection and combo mechanics are being improved. Will be fully stable in a future update.
The ultimate weapon for the top-ranked player:
- Custom Mace - Unique enchanted mace with special abilities
- Exclusive Access - Only Rank #1 can obtain and use it
- Powerful Enchantments - Unbreaking III, Mending
- Special Abilities - Dash forward and Verdict Mode combo system
- Status Symbol - Shows dominance as the #1 player
- Configurable - Fully customizable in config.yml
- Known Issues - Miss detection may occasionally false flag (being improved)
๐ฌ Discord Features
- Link Minecraft accounts with 6-digit codes
- Live leaderboard with auto-updates
- DM notifications for rank changes
- Automatic role assignment
- Game event announcements
- Customizable embed footers
๐ ๏ธ Admin Tools
- Visual GUI for rank management
- Export ranks to JSON
- Import ranks from JSON
- Fix invalid ranks automatically
- View complete rank history
- Blacklist system
๐ง Technical Details
- API Version: 1.21
- Dependencies: JDA, Gson, HikariCP, SQLite JDBC, MySQL Connector
- Database: SQLite (default) or MySQL
- Performance: Optimized with connection pooling
- Thread-Safe: Async database operations
- Memory Efficient: Minimal overhead
Made by mukulx (heckerx on Discord)
Discord: https://discord.gg/Z2pd8tbm7a
Information
| Published on | May 4, 2026 |
|---|---|
| Downloads | 2 |
Platforms
Paper (1.21-26.1.2)
Dependencies
Paper