━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚔ RacePlugin ⚔
A fully config-driven Race & Class System
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Give your players a meaningful identity from the moment they join.
RacePlugin lets you define as many races as you want — entirely in
config.yml — each with unique stats, abilities, and rewards.
No coding required.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ Fully Config-Driven
Define unlimited races in config.yml. Set names, icons, GUI slots,
lore, colours — everything without touching Java.

✅ Permanent Potion Effects
Give each race passive abilities — Speed, Jump Boost, Regeneration,
Slowness, and any other Bukkit potion effect.

✅ Bonus Hearts
Add extra max health to races using the attribute system.
Clean, compatible, no gimmicks.

✅ Race Selection GUI
A polished inventory GUI opens on first join. Players browse
available races, each shown with its custom icon and lore.

✅ Confirm Screen
A dedicated 9-slot confirmation GUI prevents accidental selections.
Fully configurable materials, names, lore, and sounds.

✅ Race Change Tokens
Admins can give players a Race Change Token (/race give <player>).
Right-clicking it reopens the GUI and lets them switch — consumed
on confirmation. Configurable material, name, and lore.

✅ mcMMO Integration (Optional)
Award flat skill levels to players on their first race pick.
Also supports per-race XP multipliers per skill (e.g. Dwarves
get 2x Mining XP). Gracefully disabled if mcMMO isn't installed.

✅ On-Select Commands
Run any console command when a player first picks a race.
Use {player} as a placeholder — perfect for giving starter kits.

✅ WorldGuard Region Protection (Optional)
Designate regions where players of the same race cannot damage
each other. Define region IDs in config — works out of the box
if WorldGuard is present, silently disabled if not.

✅ Scoreboard Team Prefixes/Suffixes
Each race gets its own scoreboard team. Players display their
race tag above their head and in the tab list automatically.
Format is fully configurable.

✅ Admin Commands
/race set <player> <race> — force-set any player's race
/race give <player> — give a Race Change Token
/race reload — hot-reload config without restarting

✅ Anti-Abuse Safeguards
Race choices are permanent without a token. Players can't
spam-select or click their current race again.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMMANDS & PERMISSIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Command Permission Default
/race raceplugin.use All players
/race info raceplugin.use All players
/race reload raceplugin.reload OP
/race set <p> <r> raceplugin.admin.set OP
/race give <p> raceplugin.admin.give OP

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SOFT DEPENDENCIES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

- mcMMO — skill level rewards & XP multipliers
- WorldGuard — same-race region PvP protection

Both are entirely optional. The plugin runs without them.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙ REQUIREMENTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

- Paper / Spigot 1.21+
- Java 17+​