RankedSystem

🏆 RankedSystem: MMR-Based Progression

Take your server's competition to the next level. RankedSystem introduces a dynamic, skill-based MMR (Matchmaking Rating) system that tracks player performance across PvP, PvE, and world progression.

Unlike simple leveling plugins, this system allows players to fall into the negatives, creating a high-stakes environment where every death matters.

---

📈 The Ranking Ladder

Rise through the ranks from a lowly Unranked survivor to the legendary NETHERITE tier. Your rank is displayed as a colored prefix on your nametag and in the tab list for all to see.

* Unranked: 20,000+ MMR * Unranked: 7,000 — 20,000 MMR * Unranked: 1,000 — 7,000 MMR * Unranked: 200 — 1,000 MMR * Unranked: 1 — 200 MMR * Unranked: 0 MMR or below

---

⚔️ How to Earn (and Lose) MMR

The system is fully automated and rewards active, skilled gameplay:

Gains

* Progression: Defeat another player (+1 to +15 MMR). * Progression: Slay the Ender Dragon, Wither, or Raid leaders like Evokers and Pillagers (+1 to +15 MMR). * Progression: Complete advancements (+1 to +10 MMR).

Losses

* immediate 2-rank penalty Slain by another player (-5 to -20 MMR). * immediate 2-rank penalty Dying to bosses or raid mobs (-5 to -20 MMR). * immediate 2-rank penalty Any other death (-5 to -15 MMR). * immediate 2-rank penalty Getting banned by staff results in an immediate 2-rank penalty.

---

🛠 Commands & Permissions

The plugin is designed to be lightweight and easy to use.

| Command | Description | Permission | | --- | --- | --- | | `/ranked check {player}` | Check your own or another player's MMR and rank. | *None* | | `/ranked xp give {player} {qty}` | Add MMR to a player. | `ranked.admin` | | `/ranked xp remove {player} {qty}` | Deduct MMR from a player. | `ranked.admin` |

> Note: Admins (OPs) have access to all commands by default.

---

⚙️ Fully Configurable

Want to change the thresholds? You can easily modify the `config.yml` to set your own MMR requirements for each rank, change the display names, or adjust the colors to match your server's theme.

Installation

1. Drop the `.jar` into your `plugins` folder. 2. Restart your server. 3. (Optional) Customize the `config.yml` and use `/reload`.