⚔️ hnybPvPElo

hnybPvPElo is a competitive PvP Elo rating system for Minecraft with rank progression, match history tracking, and anti-farming protection.

---

Overview

• 🎯 Dual Calculation Methods: RANDOM or RATIO-based Elo changes
• 🏆 Rank Progression: Customizable tiers with auto rank-up
• 🛡️ Anti-Farming: Daily kill limits per opponent
• 📊 Match History: Track last 20 PvP matches with detailed GUI
• 🔒 Elo Lock System: Automatic protection when falling below threshold
• 👑 TOP 1 Bonus: Extra Elo rewards for defeating #1 ranked player
• 🔌 PlaceholderAPI: 10+ placeholders for scoreboard/chat integration
• 🌐 Multi-language: English & Vietnamese support
• ⚡ Folia Ready: Full compatibility with regionized threading

---

Core Features

Elo System

• RANDOM Mode: Randomized changes within configurable ranges
• RATIO Mode: Skill-differential calculations (upset victories = bigger rewards)
• TOP 1 bonus rewards for defeating the highest-ranked player
• Configurable default Elo, min/max change values

Ranking System

• Customizable rank tiers with auto rank-up detection
• Title & sound notifications on rank progression
• Server-wide broadcast announcements
• Fully customizable names, colors, Elo thresholds

Anti-Farming & Protection

• Daily kill limits prevent stat farming
• Elo Lock System: auto-protection when below threshold
• Configurable lock duration (default: 1.5 hours)
• Auto-reset to default Elo option
• Custom command execution on lock trigger

Match History

• Beautiful GUI for viewing past matches
• Tracks: opponent, timestamp, damage dealt, Elo change
• Configurable history size (default: 20 matches)
• Click-to-view detailed information

Integrations

• PlaceholderAPI support with 10+ placeholders
• Discord Webhooks for kill events, TOP 1 defeats, rank-ups
• Multi-language message system
• Custom sounds & particle effects

---

Requirements

• Minecraft: 1.19+ (Paper/Folia)
• Java: 17+
• Dependencies:
  • Paper or Folia (required)
  • PlaceholderAPI (optional, recommended)

---

Commands

Command	Description	Permission
/elo	View your current Elo	-
/elo top	Display Elo leaderboard	-
/elo history	Open match history GUI	-
/elo rank	Show your current rank	-
/elo lock	Check Elo lock status	-
/history	Alias for history GUI	hnybpvpelo.history
/eloadmin help	Show admin commands	hnybpvpelo.admin
/eloadmin reload	Reload plugin config	hnybpvpelo.admin
/eloadmin add <player> <value>	Add Elo to player	hnybpvpelo.admin
/eloadmin set <player> <value>	Set player's Elo	hnybpvpelo.admin
/eloadmin remove <player> <value>	Remove Elo from player	hnybpvpelo.admin
/eloadmin reset <player>	Reset player's Elo	hnybpvpelo.admin
/eloadmin setall <value>	Set all players' Elo	hnybpvpelo.admin
/eloadmin resetall	Reset all players' Elo	hnybpvpelo.admin
/eloadmin addall <value>	Add Elo to all players	hnybpvpelo.admin
/eloadmin lock <player> <seconds>	Lock player's Elo	hnybpvpelo.admin
/eloadmin unlock <player>	Unlock player's Elo	hnybpvpelo.admin

---

Permissions

Permission	Description	Default
hnybpvpelo.admin	Full admin command access	op
hnybpvpelo.history	Access to /history command	op

---

Placeholders

Requires PlaceholderAPI

Placeholder	Description
%hnybpvpelo_elo%	Current Elo of the player
%hnybpvpelo_top%	Player's leaderboard position
%hnybpvpelo_rank%	Current rank name
%hnybpvpelo_next_rank%	Next rank name
%hnybpvpelo_next_needed%	Elo needed for next rank
%hnybpvpelo_lock_time%	Remaining Elo lock time
%hnybpvpelo_top_<N>_name%	Top N player name
%hnybpvpelo_top_<N>_elo%	Top N player Elo value
%hnybpvpelo_top_<N>_value%	Alias for top N Elo value

---

Information:

• 👨‍💻 Author: "hnyb05"
• 🌐 Bio: https://zyo.lol/hnyb
• 💬 Discord: https://discord.gg/mqemSGne53