Grade Competitive PvP Rank System

Grade
Competitive PvP Rank System for Paper 1.21

Paper 1.21+ •
PlaceholderAPI •
16 Ranks •
Live Leaderboard •
Anti-Farm •
100% Configurable

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What is Grade?
Grade turns your PvP server into a competitive ladder.
Players earn points for every kill, lose them on death, and climb through 16 ranks — from Bronze III all the way to Champion. Their rank shows in tab, in chat on promotion, and on a live Top 100 leaderboard.
Built-in anti-farm and anti-dupe keep the competition fair.

16 Ranks — Bronze → Silver → Platinum → Diamond → Elite → Champion, fully configurable.

Point System — gain points per kill, lose per death, all editable from config.

Live Leaderboard — paginated Top 100 GUI with player heads, rank, points & position.

Tutorial GUI — explains the whole system to players in one click.

Personal Rank GUI — progress bar, stats, K/D ratio & next-rank preview.

HEX Colors — true RGB colors for every rank (&#RRGGBB).

Custom Emblems — a unique symbol per rank, shown right in the tab.

Anti-Abuse — anti-farm (kill spam) + anti-dupe (same-IP) protection built in.

Persistent Data — saved in data.yml, never lost on restart.

Multi-Language — English & Italian included, fully translatable.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands

Code:

/grade                       -> open your personal rank GUI
/gradetutorial               -> open the tutorial & leaderboard
/gradeadmin help             -> list all admin commands
/gradeadmin setpoints <player> <n>   (admin)
/gradeadmin addpoints <player> <n>   (admin)
/gradeadmin setgrade <player> <id>   (admin)
/gradeadmin top [n]          -> view the leaderboard
/gradeadmin reload           (admin)

Permissions

Code:

grade.use     -> access to /grade and /gradetutorial
grade.admin   -> admin subcommands

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PlaceholderAPI

Code:

%grade_rank%            -> rank name
%grade_rank_colored%    -> rank name with color
%grade_symbol%          -> rank emblem
%grade_suffix%          -> tab suffix (color + emblem + rank)
%grade_points%          -> current points
%grade_kills%           -> total kills
%grade_deaths%          -> total deaths
%grade_progress%        -> progress percentage
%grade_position%        -> leaderboard position
%grade_next_rank%       -> next rank name
%grade_top_1% ... _100% -> leaderboard lines (perfect for holograms)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Requirements
Paper 1.21 (or forks compatible with the Paper API)
Java 21+
(Optional) PlaceholderAPI — required only for tab suffix & holograms

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation
Drop the JAR into /plugins and start the server once.
Edit config.yml (ranks, points, emblems, colors, anti-abuse).
Edit messages_en.yml / messages_it.yml (every string is customizable).
Reload/restart and you're ready.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Config & Messages
Fully editable ranks (name, color, emblem, points required).
Fully editable point system (points per kill, points lost per death).
Fully editable GUIs (rows, progress bar style, colors).
Built-in anti-abuse (kill spam limit + same-IP detection, both toggleable).
Multi-language with automatic English fallback.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Changelog (short)
Initial release.
16 configurable ranks with HEX colors & emblems.
Point-based progression with live Top 100 leaderboard.
Tutorial GUI, personal rank GUI & full admin suite.
Anti-farm & anti-dupe protection.
English & Italian language support.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Support & Terms
Need help? DM me on BuiltByBit or open a discussion on the resource page.
No refunds for digital goods. Do not redistribute, decompile, or resell.

Purchase Grade

Grade Competitive PvP Rank System v1.0

Overview Dependencies Updates (1) History