RankedSMPX

🏆 RankedSMPX

> A highly configurable competitive ranked SMP plugin for Minecraft. Players compete for 20 limited rank slots kill to climb, survive to stay on top.

> ⚠️ Disclaimer: This is an unofficial fan-made recreation of the RankedSMP concept. Not affiliated with the original RankedSMP server or team.

---

✨ Features

| Category | Highlights | |----------|-----------| | Admin Tools | 20 competitive rank slots, rank stealing on kill, rank transfer, history tracking, blacklist system | | Admin Tools | Health scaling (10.5–20 ), potion multipliers (1.05×–2.00×), XP boosts (1.1×–3.0×), extra inventory (top 10) | | Admin Tools | Per-rank buff multipliers, RGB prefixes, all messages editable, TAB integration, PlaceholderAPI (8 placeholders) | | Admin Tools | Account linking, live leaderboard, DM notifications, role sync, slash commands, event announcements | | Admin Tools | SQLite (default) or MySQL/MariaDB with HikariCP pooling, JSON import/export, auto backups | | Admin Tools | GUI management, rank fix utility, debug logging, blacklist system, rank history with timestamps |

---

📈 Rank Buffs

| 🏆Rank | ❤️ Hearts | 🧪 Potion | ⭐ XP | 📦 Inv Slots | |------|-----------|-----------|-------|-------------| | #1 | 20.0 | 2.00× | 3.0× | 54 | | #2 | 19.5 | 1.96× | 2.9× | 54 | | #3 | 19.0 | 1.91× | 2.8× | 50 | | #4 | 18.5 | 1.86× | 2.7× | 45 | | #5 | 18.0 | 1.81× | 2.6× | 40 | | #6 | 17.5 | 1.76× | 2.5× | 35 | | #7 | 17.0 | 1.71× | 2.4× | 30 | | #8 | 16.5 | 1.66× | 2.3× | 25 | | #9 | 16.0 | 1.61× | 2.2× | 20 | | #10 | 15.5 | 1.56× | 2.1× | 15 | | #11 | 15.0 | 1.51× | 2.0× | — | | #12 | 14.5 | 1.46× | 1.9× | — | | #13 | 14.0 | 1.41× | 1.8× | — | | #14 | 13.5 | 1.36× | 1.7× | — | | #15 | 13.0 | 1.31× | 1.6× | — | | #16 | 12.5 | 1.26× | 1.5× | — | | #17 | 12.0 | 1.21× | 1.4× | — | | #18 | 11.5 | 1.16× | 1.3× | — | | #19 | 11.0 | 1.11× | 1.2× | — | | #20 | 10.5 | 1.05× | 1.1× | — | | Unranked | 10.0 | 1.00× | 1.0× | — |

> All values are fully configurable in `config.yml`.

---

📋 Commands

👤 Player Commands

| Command | Aliases | Description | |---------|---------|-------------| | `/rankinfo [player]` | `/ri`, `/myrank` | Check rank info and active buffs | | `/ranktop` | `/rt`, `/topranks` | View the top ranked players | | `/rank [player]` | — | View rank and buffs for any player | | `/ranks` | — | Open the ranked players GUI | | `/ranktransfer <player>` | `/transfer`, `/giverank` | Give your rank to another player *(must be enabled in config)* | | `/linkdiscord` | `/discordlink` | Link your Minecraft account to Discord | | `/unlinkdiscord` | `/discordunlink` | Unlink your Discord account | | `/extrainventory` | `/inv`, `/ei`, `/einv` | Open extra inventory *(Ranks 1–10 only)* |

🔧 Admin Commands

| Command | Permission | Description | |---------|------------|-------------| | `/rsmp start` | `rankedsmp.admin` | Start the game and assign ranks | | `/rsmp stop` | `rankedsmp.admin` | Stop the game and clear all ranks | | `/rsmp reload` | `rankedsmp.admin` | Reload all config files | | `/rsmp manage` | `rankedsmp.admin` | Open the rank management GUI | | `/rsmp set <player> <rank|unranked|blacklisted>` | `rankedsmp.admin` | Set a player's rank directly | | `/rsmp rank remove <player>` | `rankedsmp.admin` | Remove a player's rank | | `/rankblacklist <add|remove|list> <player>` | `rankedsmp.blacklist` | Manage the rank blacklist | | `/rankhistory <player>` | `rankedsmp.history` | View a player's rank change history | | `/rankhistorywipe <player|all>` | `rankedsmp.historywipe` | Wipe rank history | | `/rankexport` | `rankedsmp.export` | Export all ranks to JSON | | `/rankimport <filename>` | `rankedsmp.import` | Import ranks from JSON | | `/rankfix` | `rankedsmp.admin` | Fix any invalid ranks in database |

💬 Discord Commands

| Command | Who | 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` / `/rankimport` | Admin | Export/import rank data as JSON |

---

📊 PlaceholderAPI Placeholders

| Placeholder | Description | Example | |-------------|-------------|---------| | `%rankedsmp_rank%` | Player's rank or "Unranked" | `5` / `Unranked` | | `%rankedsmp_rank_number%` | Rank as a number (0 if unranked) | `5` / `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 slot count | `18` | | `%rankedsmp_rank_prefix%` | Rank prefix for TAB | `[#5]` | | `%rankedsmp_rank_suffix%` | Rank suffix for TAB | ` ` |

---

⚠️ First Startup Note

On first launch, the plugin downloads required dependencies (JDA, Gson, MySQL connector, SQLite, HikariCP) from Maven Central. This only happens once — subsequent startups are instant. Make sure your server has internet access on first run.

---

💬 Support

Discord

For bug reports and feature requests, please use the Discord server.

📚 Wiki/Docs: Coming soon!

---

*Made by mukulx (heckerx on Discord)*