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 [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 bar
• rewards — rank-up & milestone rewards (commands + Vault money)
• season — leaderboard archive, top-player prizes, resets
• leaderboard.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.