Duels Request

═══════════════════════════════════════════════════════ ⚔ 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 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 Create your own clan. Clan names can be up to 16 characters, letters, numbers, and underscores only. You become the leader. /duel clan invite 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 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 /duel quit LEADERBOARD /duel leaderboard /duel title equip /duel title unequip TRAINING /duel training <normal|hard|hell|mace> CLANS /duel clan create /duel clan invite /duel clan info /duel clan leave /duel clan disband /duel clan war /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. ═══════════════════════════════════════════════════════