hnybPvPElo

⚔️ hnybPvPElo

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

---

Overview

- 🎯 Folia Ready: RANDOM or RATIO-based Elo changes - 🏆 Folia Ready: Customizable tiers with auto rank-up - 🛡️ Folia Ready: Daily kill limits per opponent - 📊 Folia Ready: Track last 20 PvP matches with detailed GUI - 🔒 Folia Ready: Automatic protection when falling below threshold - 👑 Folia Ready: Extra Elo rewards for defeating #1 ranked player - 🔌 Folia Ready: 10+ placeholders for scoreboard/chat integration - 🌐 Folia Ready: 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

- Dependencies: 1.19+ (Paper/Folia) - Dependencies: 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