Ranked RTPQUEUE v1.1

⚔ RankedPvP — Competitive 1v1 Ranked Queue
A polished ranked PvP experience for Paper/Spigot servers.

Queue up, fight opponents in randomized arenas, climb the ladder, and become the top player on the server.

Features
⚔ Ranked Matchmaking
Players can join a live ranked queue through a clean GUI system.

- GUI colors / fill Item can be changed in the config.yml


Instant matchmaking
FIFO queue system
Queue announcements
Ambient queue music
Automatic cleanup for offline players
/queue, /ranked, and /rtpqueue aliases
Once two players are available, the match begins automatically.



Random RTP Battle System
Every duel takes place at a fresh random location across one or multiple configurable RTP worlds.



Includes:
Safe random teleport generation
Randomized coordinates
Automatic spawn positioning
Players face each other perfectly
No prebuilt arenas required
This keeps fights feeling dynamic instead of repetitive.



Match Countdown
Before combat begins:



Players are frozen in place
Health & inventory reset
Global kit applied

Cinematic 3 → 2 → 1 countdown
Sound effects & titles
Movement and damage blocked until the fight starts
Then the duel begins instantly.



ELO Ranking System
Built around a real Elo formula with configurable settings.



- colors can be changed in the config.yml (theme color)

Includes:
17 progression ranks
Automatic rank updates
Win streak tracking
ELO gain/loss calculations
Leaderboards
Rank progress display
Ranks range from:

Bronze → Silver → Gold → Platinum → Diamond → Elite → Champion



Plus one exclusive rank:



✦ Unreal Rank
The Unreal rank is automatically assigned to the highest ELO player on the entire server.



Only one player can hold it at a time.



Statistics & Leaderboards
Built-in stat GUI with multiple pages showing:



Top ranked players
Personal statistics
Win/loss ratio
Win streaks
Current ELO
Rank progression bar
Rank threshold overview
Anti-Stall Boundary System
Prevents players from endlessly running away during fights.



Features:
Distance warnings
Automatic pull-back countdown
Fair repositioning system
Configurable max distance
No more stalled fights or endless chasing.



Draw System
Players can mutually agree to end fights as a draw.



Includes:
30-second request timer
No ELO changes
No win/loss recorded
Smooth match ending flow
Perfect for even matchups or stalemates.



Personal Kit Layouts
Admins set one global competitive kit.



Players can:



Rearrange inventory slots
Save personal layouts
Keep layouts permanently
The items stay balanced while still allowing personal preference.



Rank Prefixes
Player ranks automatically appear in:



Chat
Tab list
Features:
Full hex color support
Modern scoreboard team system
Automatic updates after matches
Clean formatting
Example:



[Gold II] PlayerName

[✦ Unreal] TopPlayer



PlaceholderAPI Support
Integrated placeholders for:



Player Data
%rankedpvp_elo%

%rankedpvp_rank%

%rankedpvp_wins%

%rankedpvp_losses%

%rankedpvp_streak%



Leaderboards
%rankedpvp_top_1_name%

%rankedpvp_top_1_elo%

%rankedpvp_top_1_rank%



Supports leaderboard positions 1–10.



Perfect for:



Scoreboards
TAB
Holograms
NPC displays
DeluxeMenus
Optimized Performance
Built with performance and scalability in mind.



Technical Features
Async SQLite database operations
CompletableFuture-based data handling
No main-thread database lag
WAL mode enabled
Match state protection
Modular architecture
Plugin Stats
~3,100 lines of source
20 Java classes
SQLite included
No external database setup
Included Systems
✔ Ranked Queue

✔ Matchmaking

✔ RTP Arena System

✔ Elo Rating System

✔ Rank Progression

✔ Unreal Top Rank

✔ Draw Requests

✔ Boundary Enforcement

✔ GUI Menus

✔ Statistics Pages

✔ Kit Layout Editor

✔ Async Database

✔ PlaceholderAPI Support

✔ Chat & Tab Prefixes

✔ Admin Commands

✔ Configurable Messages & Sounds



🛠 Commands


Default:
/queue

/ranked

/rtpqueue

/leave

/draw



OP:

/rpvpadmin kit

/rpvpadmin setspawn

/rpvpadmin setelo

/rpvpadmin reload



Permissions
rankedpvp.admin

rankedpvp.bypass



⚙ Fully Configurable
Customize:



Rank ladder
Colors
Messages
Sounds
RTP settings
Elo values
Boundary distance
GUI items
Allowed commands
Spawn location
Supports:



Hex colors
Legacy color codes
Database
Uses SQLite automatically.



/plugins/RankedPvP/data.db



Stores:



ELO
Wins/losses
Win streaks
Kit layouts
Player names
No MySQL setup required.



Perfect For
Practice servers
KitPvP servers
Lifesteal servers
Competitive SMPs
PvP networks
Minigame hubs
Requirements
Paper / Spigot 1.20+
PlaceholderAPI (optional)

RankedPvP
A modern competitive PvP system focused on replayability, progression, and clean gameplay without requiring prebuilt arenas or complicated setup.



I recommend this plugin for every Sandbox/Practice server.