# 🏆 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 | |----------|-----------| | **Rank System** | 20 competitive rank slots, rank stealing on kill, rank transfer, history tracking, blacklist system | | **Combat Perks** | Health scaling (10.5–20 ), potion multipliers (1.05×–2.00×), XP boosts (1.1×–3.0×), extra inventory (top 10) | | **Customization** | Per-rank buff multipliers, RGB prefixes, all messages editable, TAB integration, PlaceholderAPI (8 placeholders) | | **Discord Bot** | Account linking, live leaderboard, DM notifications, role sync, slash commands, event announcements | | **Database** | 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 ` | `/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 ` | `rankedsmp.admin` | Set a player's rank directly | | `/rsmp rank remove ` | `rankedsmp.admin` | Remove a player's rank | | `/rankblacklist ` | `rankedsmp.blacklist` | Manage the rank blacklist | | `/rankhistory ` | `rankedsmp.history` | View a player's rank change history | | `/rankhistorywipe ` | `rankedsmp.historywipe` | Wipe rank history | | `/rankexport` | `rankedsmp.export` | Export all ranks to JSON | | `/rankimport ` | `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

` | Everyone | Link Minecraft account with 6-digit code |
| `/unlink` | Everyone | Unlink your Minecraft account |
| `/rankset  ` | Admin | Set a player's rank via Discord |
| `/rankrandom` | Admin | Randomly assign ranks to all players |
| `/setchannel ` | 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](https://img.shields.io/badge/Join%20Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/Z2pd8tbm7a)

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

📚 **Wiki/Docs:** Coming soon!

---

*Made by **mukulx** (heckerx on Discord) · Unofficial fan-made plugin · Not affiliated with original RankedSMP*

mukulx

mukulx's Plugins

RankedSMPX by mukulx

mukulx's Organizations

Stars

Watching

RankedSMPX by