RankPlugin — PvP Kill-Points & Rank System

RankPlugin is a lightweight Minecraft PvP rank plugin (kill-points / PTS system) for Paper and Spigot servers running 1.16 up to the latest version. Players earn points for every kill, lose points when they die, and climb a server-wide leaderboard — all saved safely in SQLite or MySQL.

If you're looking for a simple but powerful PvP ranking plugin, kill-based points system, or PvP leaderboard plugin that is fully asynchronous, multi-language, and PlaceholderAPI-ready out of the box — RankPlugin does exactly that, with zero setup.

📁 Plugin folder: plugins/RankPlugin

---

✨ Features

• ⚔️ Kill-points (PTS) system — gain points for kills, lose points on death
• 🏆 Server-wide leaderboard — /rank top and %ranksystem_top_*% placeholders
• 📊 Two scoring modes — classic fixed points or Elo-style rating (killing stronger players is worth more)
• 🔥 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 are bundled, nothing extra to install
• ⚡ Fully asynchronous database access — never lags the main server thread
• 🧰 Admin tools — set, add, take, reset working on online & offline players
• ✨ MiniMessage messages — hex colours, gradients, hover/click
• 🌍 Languages — en, ru, ua, fully editable in the lang/ folder
• 🔌 PlaceholderAPI integration
• ⌨️ Tab-completion for every command
• 🧱 Paper & Spigot, Minecraft 1.16 → latest

---

🎯 Why RankPlugin?

• A drop-in PvP ranking system for SMP, factions, KitPvP, and arena servers
• No database setup required — 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 three languages

---

📥 Installation

1. Download the latest RankPlugin-1.2.0.jar
2. Drop it into your server's plugins folder
3. (Optional) Install PlaceholderAPI for placeholders
4. Restart the server
5. Edit plugins/RankPlugin/config.yml and the files in plugins/RankPlugin/lang/

---

⌨️ Commands

Command	Description	Permission
/rank	Show your own points	everyone
/rank top	Show the leaderboard	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
/reset <player>	Reset points (online or offline)	rankplugin.admin

---

🔑 Permissions

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

---

🔌 PlaceholderAPI

Placeholder	Description
%ranksystem_score%	The player's current points
%ranksystem_top_1_name%	Name of the #1 player (1…N)
%ranksystem_top_1_score%	Points of the #1 player (1…N)

---

⚙️ Configuration

language: en            # en, ru, ua

database:
  type: sqlite          # sqlite or mysql
  initial-points: 100

points:
  mode: fixed           # "fixed" or "elo"
  add: 5                # [fixed] points the killer gains
  subtract: 5           # [fixed] points the victim loses
  max: -1               # -1 = unlimited
  allow-negative: false
  elo:
    k-factor: 32        # [elo] bigger = larger swings per kill

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
    15: 50
    20: 100

save:
  interval-minutes: 5

leaderboard:
  size: 10