⚔️ 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