⚔ DuelPlugin v1.5.0 ⚔ Made by Johnlee | Helper: Chunkzz
Native MC Version: 1.21
Tested MC Versions: 1.21
HOW TO INSTALL Drop DuelPlugin-1.5.0.jar into your server's /plugins folder. Restart your server (not reload - full restart). The plugin auto-creates its data files on first run. 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 - Iron armor. Shoots arrows far away, switches to iron sword up close. Good for beginners.
HARD - Diamond armor. Bow has Punch 1 and Flame. Sword has Knockback 1 and Sharpness 3. Faster movement.
HELL - Full netherite with Protection 3 and 40 HP. Bow has Punch 2, Power 3, Flame. Sword has Knockback 2, Fire Aspect 2, Sharpness 3. Very fast. Brutal.
MACE - Full netherite with Protection 3 and 40 HP. Uses wind charge to launch into the air, then smashes down with a Mace (Wind Burst 3). Repeats every 3-5 seconds.
/duel quit — Leave your training session. Training has a 10-minute time limit. 50-block boundary.
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 (up to 16 chars, letters/numbers/underscores). /duel clan invite <player> — Invite someone (leader only). /duel clan info — View your clan's details. /duel clan leave — Leave your clan. /duel clan disband — Delete your clan (leader only). Clan Wars Full team battles between clans:
Declare War — /duel clan war <clan name> (leader only). Enemy leader has 60 seconds to accept. Leader Betting — Both leaders get a bet chest to wager items. Member Recruitment — All online members get [JOIN WAR] / [DECLINE] buttons. 30 seconds to respond. The War — Everyone teleports to a war zone. Clan 1 on one side, Clan 2 on the other. When health drops to half a heart, you're eliminated. 80-block boundary. Victory — Last clan standing wins. Winner gets +1 win, loser gets +1 loss. Winning leader gets all bet items. 10-minute time limit (draw if no winner). Clan Leaderboard /duel clan leaderboard — View clan rankings. /duel clan lb — Same thing, shorter. OTHER COMMANDS /duel info — Show plugin version and credits. /duelaccept — Accept a duel. /dueldecline — Decline a duel. DATA FILES Created in plugins/DuelPlugin/:
leaderboard.yml — Player duel wins/losses/titles clans.yml — Clan data, members, war records


