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,resetfor 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
- Download the latest
RankPlugin-1.3.0.jar - Drop it into your server's
pluginsfolder - (Optional) Install PlaceholderAPI for placeholders, and Vault + an economy plugin for money rewards
- Restart the server
- Edit
plugins/RankPlugin/config.ymland the files inplugins/RankPlugin/lang/
⌨️ Commands
| Command | Description | Permission |
|---|---|---|
/rank |
Show your points (and rank) | everyone |
/rank top |
Open the leaderboard (GUI or text) | everyone |
/rank stats [player] |
Show kills / deaths / KDR / killstreaks | everyone |
/rank <player> |
Show another player's points | rankplugin.others |
/rank set|add|take <player> <amount> |
Manage a player's points | rankplugin.admin |
/rank reset <player> |
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 [reset confirm] |
Season info / archive & reset | rankplugin.admin |
/reset <player> |
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_<board>_1_name% / _value% |
#1 on a board — kills, deaths, kdr, streak |
⚙️ Configuration
Core settings (the full file is fully commented and beginner-friendly):
language: en # 17 locales available
join-message: true # greet players on join
database:
type: sqlite # sqlite or mysql
initial-points: 100
points:
mode: fixed # "fixed" or "elo"
add: 5 # points the killer gains
subtract: 5 # points the victim loses
max: -1 # -1 = unlimited
allow-negative: false
anti-farm:
enabled: true
cooldown-seconds: 60
check-same-ip: false
killstreak:
enabled: true
broadcast: true
rewards: # streak length: bonus points
5: 10
10: 25
leaderboard:
size: 10
Optional systems (each has its own enabled: false switch):
ranks— named ranks/leagues with a progress barrewards— rank-up & milestone rewards (commands + Vault money)season— leaderboard archive, top-player prizes, resetsleaderboard.gui— interactive inventory leaderboard
🧩 Compatibility
- Paper / Spigot 1.16 → 26.2 (latest) • Java 8+
- Storage: SQLite (default) or MySQL
- Optional soft-depends: Vault (money rewards), PlaceholderAPI (placeholders)
- Existing databases upgrade automatically — your scores are preserved
Found a bug or have a suggestion? Open an issue on the GitHub repository.
