EloAddon - An Add-on for many elo plugin out there

The plugin is designed to work with ANY ELO plugin as long as it provides a PlaceholderAPI placeholder.
✨ Features
✔ Supports any ELO plugin via PlaceholderAPI
✔ GUI reward menu with 5 configurable tiers
✔ Each tier can grant multiple permissions
✔ Firework animation when claiming rewards
✔ Achievement sound when claiming rewards
✔ Cooldown system between tier claims
✔ Reset rewards per player or globally
✔ Safe placeholder parsing (never crashes server)
✔ Lightweight and optimized for large servers

Requirements

• PlaceholderAPI
  
  
• Paper / Spigot 1.21+
  
  
• LuckPerms (recommended for permissions)

⚙️ Configurable ELO Source
You can choose which placeholder provides the player's ELO.

Example config.yml:

papi-elo: "%hnybpvpelo_elo%"
cooldown-seconds: 60

You can change it to any placeholder:
Example papi:
%yeye-elo%
%pvpstats_elo%
%player_level%

This makes the plugin compatible with many ELO systems.

Commands
Player Commands
/thuongelo

Open the ELO reward GUI.

Admin Commands
Create or overwrite a tier:

/eloaward create <id 1-5> <require_elo> <permission>

Example:

/eloaward create 1 300 vip.rank

Add another permission to a tier:

/eloaward addperm <id> <permission>

Example:

/eloaward addperm 1 kit.vip

Remove a permission from a tier:

/eloaward delperm <id> <permission>

Remove a tier completely:

/eloaward remove <id>

Reset a specific tier reward for a player:

/eloaward reset <id> <player>

Reset a specific tier for ALL players:

/eloaward resetall <id>

Reload plugin configuration:

/eloaward reload

Permissions
eloaddon.admin

Allows use of all /eloaward admin commands.

Reward GUI
Players can open the reward GUI with:

/thuongelo

Inside the GUI:

• Locked tiers show normally
  
  
• Unlocked tiers glow with enchant effect
  
  
• Claimed tiers show Already Claimed
  
  
• Clicking a valid tier grants rewards

Claim Effects
When a player claims a reward:

• Fireworks spawn above the player
  
  
• Higher tiers have better fireworks
  
  
• Achievement sound plays

⏱ Cooldown System
After claiming a tier, the player must wait 60 seconds before claiming another tier.

Already claimed tiers cannot be claimed again unless an admin resets them.

Example award.yml
id1:
material: WOODEN_SWORD
slot: 29
display_name: "&aTier 1"
lore:
- "&7Reach 300 ELO"
perm:
- "vip.rank"
require_elo: 300

id2:
material: STONE_SWORD
slot: 30
display_name: "&bTier 2"
lore:
- "&7Reach 600 ELO"
perm:
- "elite.rank"
require_elo: 600

Use Cases
This plugin is perfect for:

• PvP servers
  
  
• Practice servers
  
  
• Ranked arenas
  
  
• Competitive ladders

Reward players automatically as they climb the ELO ladder.

❤️ Feedback
If you find bugs or have suggestions, come to my discord server : https://discord.gg/Q4RVZHEtSX

Enjoy!