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