RankPlugin

# RankPlugin — PvP Kill-Points, Ranks, Rewards & Leaderboards

RankPlugin is a lightweight yet powerful Minecraft PvP rank plugin (kill-points / PTS system) for Paper and Spigot servers running 1. 16 up to the latest version (incl. 26. 2). Players earn points for every kill, lose points on death, climb named ranks and leagues, and compete on a server-wide PvP leaderboard — all saved safely in SQLite or MySQL.

Looking for a PvP ranking plugin, kill-points system, PvP stats tracker (kills, deaths, KDR, killstreaks), ELO ranking, GUI leaderboard, or seasonal PvP with rank-up rewards? RankPlugin does all of it — fully asynchronous, multi-language (17 locales), and PlaceholderAPI-ready out of the box, with zero setup.

> 📁 Plugin folder: `plugins/RankPlugin`

## ✨ Features

• ⚔️ Kill-points (PTS) system — gain points for kills, lose points on death
• 🏅 Named ranks / leagues — Bronze → Champion by score, with colours, gradients and a progress bar (optional)
• 📊 PvP stats — kills, deaths, KDR, current & best killstreak, each with its own leaderboard + `/rank stats`
• 🏆 Leaderboards — text `/rank top`, `%ranksystem_top_%` placeholders, and an interactive GUI with player heads (optional)
• 🎯 Two scoring modes — classic fixed points or Elo-style rating (beating stronger players is worth more)
• 🎁 Rewards — run commands and pay Vault money on rank-up and kill milestones (optional)
• 🔄 Seasons — archive the leaderboard, reward the top players, reset manually or on a schedule (optional)
• 🔥 Killstreak rewards — bonus points for consecutive kills without dying
• 🛡️ Anti-farm protection — per-victim cooldown + optional same-IP (alt account) detection
• 💾 SQLite & MySQL — JDBC drivers bundled, nothing extra to install
• ⚡ Fully asynchronous database access — never lags the main server thread
• 🧰 Admin tools — `set`, `add`, `take`, `reset` for online & offline players
• 🌈 MiniMessage — hex colours, gradients, hover/click
• 🌍 17 languages — `en`, `ru`, `ua`, `zh`, `ko`, `ja`, `cs`, `it`, `pl`, `fr`, `es`, `hi`, `id`, `ro`, `pt`, `pt_br`, `be`
• 👋 Separate first-join greeting + join-message toggle
• 🔌 PlaceholderAPI integration • ⌨️ full tab-completion
• 🧱 Paper & Spigot, Minecraft 1. 16 → 26. 2 (latest)

> 💡 Every advanced system (ranks, rewards, GUI, seasons) is optional and off by default — the plugin stays lightweight until you turn them on.

## 🎯 Why RankPlugin?

• A drop-in PvP ranking system for SMP, factions, KitPvP, anarchy and arena servers
• No database setup — SQLite works instantly; MySQL is one config block away
• Async by design, so even large PvP servers stay lag-free
• Anti-farm rules stop alt accounts from inflating the leaderboard
• Clean, fully customizable messages in 17 languages

## 📥 Installation

1. Download the latest `RankPlugin-1. 3. 0.jar` 2. Drop it into your server's `plugins` folder 3. (Optional) Install PlaceholderAPI for placeholders, and Vault + an economy plugin for money rewards 4. Restart the server 5. Edit `plugins/RankPlugin/config.yml` and the files in `plugins/RankPlugin/lang/`

## ⌨️ Commands

| Command | Description | Permission | |---|---|---| | `/rank` | Show your points (and rank) | everyone | | `/rank top` | Open the leaderboard (GUI or text) | everyone | | `/rank stats ` | Show kills / deaths / KDR / killstreaks | everyone | | `/rank ` | Show another player's points | `rankplugin.others` | | `/rank set\|add\|take ` | Manage a player's points | `rankplugin.admin` | | `/rank reset ` | Reset a player's points | `rankplugin.admin` | | `/rankscore` | Print only your raw point value | everyone* | | `/ranksystem reload` | Reload config & language files | `rankplugin.admin` | | `/ranksystem season ` | Season info / archive & reset | `rankplugin.admin` | | `/reset ` | Reset points (online or offline) | `rankplugin.admin` |

## 🔑 Permissions

• `rankplugin.admin` — admin commands (default: op)
• `rankplugin.others` — view another player's rank / stats (default: op)

## 🔌 PlaceholderAPI

| Placeholder | Description | |---|---| | `%ranksystem_score%` | Current points | | `%ranksystem_kills%` / `%ranksystem_deaths%` | Total PvP kills / deaths | | `%ranksystem_kdr%` | Kill/Death ratio | | `%ranksystem_killstreak%` / `%ranksystem_max_killstreak%` | Current / best streak | | `%ranksystem_rank%` / `%ranksystem_rank_color%` | Rank name / colour | | `%ranksystem_next_rank%` / `%ranksystem_progress%` / `%ranksystem_progress_bar%` | Next rank / progress % / bar | | `%ranksystem_season%` | Current season number | | `%ranksystem_top_1_name%` / `%ranksystem_top_1_score%` | #1 player by score (1…N) | | `%ranksystem_top__1_name%` / `_value%` | #1 on a board — `kills`