═══════════════════════════════════════════════════════
⚔ DuelPlugin v1.5.0 - ⚔
Made by Johnlee | Helper: Chunkzz
═══════════════════════════════════════════════════════


HOW TO INSTALL
──────────────
1. Drop DuelPlugin-1.5.0.jar into your server's /plugins folder.
2. Restart your server (not reload - full restart).
3. The plugin auto-creates its data files on first run.
4. All permissions are enabled by default for all players.


═══════════════════════════════════════════════════════
1v1 DUELING
═══════════════════════════════════════════════════════

The core feature. Challenge any online player to a
1v1 fight to the death.

/duel <player> Challenge someone to a duel.

The other player gets clickable [ACCEPT] and [DECLINE]
buttons in chat. They have 60 seconds to respond.

Once accepted, a bet chest opens for both players.
Place any items you want to wager on the left side of
the chest. You can see what your opponent bets on the
right side. Both players must click [ACCEPT] to lock
in the bet, or close the chest to cancel.

After both accept, a 5-second countdown starts, then
both players teleport to a random arena far away from
spawn. Fight until one player's health drops to half
a heart - that player loses. No actual death occurs,
no items are dropped.

The winner gets their bet items back PLUS the loser's
bet items. If no one wins in 10 minutes, it's a draw
and both players get their items back.

/duel quit Forfeit your current duel.
(Counts as a loss)

After the duel ends, both players teleport back to
where they were before.


═══════════════════════════════════════════════════════
LEADERBOARD & TITLES
═══════════════════════════════════════════════════════

Every duel win and loss is tracked on a server-wide
leaderboard.

/duel leaderboard View the Top 20 duel players.
/duel lb Same thing, shorter.

The leaderboard shows each player's wins, losses,
online status, and rank. Top 3 get special icons.

TITLES - If you're in the Top 20, you can equip a
colored title that shows above your head and in chat:

/duel title equip Show your rank title.
/duel title unequip Hide your rank title.

Title examples:
#1 ✦⭐ TOP 1 ⭐✦ (gold, legendary)
#2 ✦⚔ TOP 2 ⚔✦ (white)
#3 ✦⚔ TOP 3 ⚔✦ (gold)
#4-20 Colored rank badges

Titles update automatically when rankings change.


═══════════════════════════════════════════════════════
TRAINING MODE
═══════════════════════════════════════════════════════

Practice fighting against an AI skeleton with four
difficulty levels.

/duel training Show all difficulties.
/duel training normal Iron armor skeleton.
/duel training hard Diamond armor, enchanted.
/duel training hell Netherite + Prot 3, fast.
/duel training mace Mace combo skeleton.

NORMAL - The skeleton wears iron armor. When you're
far away it shoots arrows. When you get close it
switches to an iron sword. Good for beginners.

HARD - Diamond armor. The bow has Punch 1 and Flame.
The sword has Knockback 1 and Sharpness 3. The
skeleton moves faster than normal.

HELL - Full netherite armor with Protection 3 and
40 HP (double health). The bow has Punch 2, Power 3,
and Flame. The sword has Knockback 2, Fire Aspect 2,
and Sharpness 3. Very fast movement. This one is
brutal.

MACE - Full netherite armor with Protection 3 and
40 HP. The skeleton uses the mace combo: it throws a
wind charge at its own feet to launch itself into the
air, flies above you, then smashes down with a Mace
enchanted with Wind Burst 3. This is how real mace
PvP works - the falling hit triggers massive bonus
damage. The skeleton repeats this combo every 3 to 5
seconds.

/duel quit Leave your training session.

Training has a 10-minute time limit. If you don't
kill the skeleton by then, it's a draw. You teleport
back to your previous location after training ends.
There's a boundary of 50 blocks - go too far and
you get teleported back to the arena center.


═══════════════════════════════════════════════════════
CLAN SYSTEM
═══════════════════════════════════════════════════════

Create a clan, recruit members, and wage war against
rival clans.

/duel clan Show all clan commands.

CREATING & MANAGING A CLAN
──────────────────────────

/duel clan create <name> Create your own clan.

Clan names can be up to 16 characters, letters,
numbers, and underscores only. You become the leader.

/duel clan invite <player> Invite someone (leader only).

The invited player gets a clickable [JOIN] button.

/duel clan info View your clan's details.

Shows your clan name, leader, win/loss record, and
all members with online/offline status.

/duel clan leave Leave your clan.
(Leaders cannot leave -
they must disband.)

/duel clan disband Delete your clan entirely.
(Leader only.)


CLAN WARS
─────────

This is the big one. Full team battles between clans.

STEP 1 - DECLARE WAR

/duel clan war <clan name> Challenge a clan (leader only).

The enemy clan's leader gets clickable [ACCEPT WAR]
and [DECLINE] buttons. They have 60 seconds.

STEP 2 - LEADER BETTING

Once the enemy leader accepts, BOTH leaders get a bet
chest (same as regular duel betting). Leaders can put
items on the line for the entire war. Both leaders
must click [ACCEPT BET] to confirm, or [SKIP BET] to
start the war without any wager. If a leader closes
the chest, the war is cancelled.

STEP 3 - MEMBER RECRUITMENT

After betting is settled, ALL members of both clans
who are online get a notification with clickable
[JOIN WAR] and [DECLINE] buttons. Members have 30
seconds to join. Leaders are auto-joined. Members
who click [DECLINE] or don't respond simply sit out.

STEP 4 - THE WAR

After 30 seconds, everyone who joined gets teleported
to a random war zone. Clan 1 spawns on one side,
Clan 2 on the other. Everyone starts at full health.

Fight! When a player's health drops to half a heart,
they're eliminated - they get teleported back to
where they were, and a broadcast announces it. The
war continues until one clan has no fighters left.

The boundary is 80 blocks from center. Go too far
and you get pulled back.

STEP 5 - VICTORY

When all members of one clan are eliminated, the
other clan wins. The result:

- The winning clan gets +1 win on the clan
leaderboard.
- The losing clan gets +1 loss.
- The winning clan's leader receives ALL the
bet items (both their own items back plus
the loser's bet).
- The losing clan's leader loses their bet items.
- All surviving fighters teleport back.

If 10 minutes pass with no winner, it's a draw.
Both leaders get their bet items returned.

If there aren't enough fighters on either side
(0 players), the war is cancelled and bets are
returned.


CLAN LEADERBOARD
────────────────

/duel clan leaderboard View clan rankings.
/duel clan lb Same thing, shorter.

Shows all clans ranked by wins, then by fewest
losses. Displays:
- Rank and clan name
- Win/loss record
- Leader name
- Member count

The #1 clan gets the special [Top 1 Clan] tag
next to their name on the leaderboard.


═══════════════════════════════════════════════════════
OTHER COMMANDS
═══════════════════════════════════════════════════════

/duel info Show plugin version and credits.
/duelaccept Accept a duel (also clickable).
/dueldecline Decline a duel (also clickable).


═══════════════════════════════════════════════════════
QUICK REFERENCE
═══════════════════════════════════════════════════════

DUELING
/duel <player>
/duel quit

LEADERBOARD
/duel leaderboard
/duel title equip
/duel title unequip

TRAINING
/duel training <normal|hard|hell|mace>

CLANS
/duel clan create <name>
/duel clan invite <player>
/duel clan info
/duel clan leave
/duel clan disband
/duel clan war <clan name>
/duel clan leaderboard

OTHER
/duel info

═══════════════════════════════════════════════════════
DATA FILES
═══════════════════════════════════════════════════════

The plugin creates these files in plugins/DuelPlugin/:

leaderboard.yml - Player duel wins/losses/titles
clans.yml - Clan data, members, war records

Both files save automatically. They persist through
server restarts.

═══════════════════════════════════════════════════════