⚔️ RivalDuel / Duells – Plugin Description
Authors: The Glue Team
Version: 1.0 Beta
Platform: Paper 1.21.1

Overview
RivalDuel is a complete competitive 1v1 PvP duel system for Paper 1.21.1 servers. It features GUI-based queue matchmaking, multiple PvP modes (Sword, Netherite, Mace, PlotPvP, Crystal), tier-based matchmaking (LT/MT/HT1-HT3), automatic arena rebuild after crystal fights, live sidebar scoreboards, leaderboards with Top-10 placeholders, spectator mode, admin setup GUI, and full configuration support.It also can reset arenas bugfree and suports english and german. It is a Realised release no beta file .This plugin was created by The Developers Nightwolflg , Wassermagie and Blockem13 . If you want mor content you can join our team server on discord : https://discord.gg/xzwaFMSuV

Features in Detail
1. Duel System

• /duel <player> – Challenge another player
  
  
• /accept / /deny – Accept or decline challenges
  
  
• Configurable timeout & expiry settings

2. Queue GUI Matchmaking

• 2-screen inventory GUI: Mode Select → Tier Select → Auto-matchmaking
  
  
• Supported PvP modes: Sword, Netherite, Mace, PlotPvP, Crystal
  
  
• Tier-based pairing (LT / MT / HT1 / HT2 / HT3)

3. PvP Modes & Kits (Pre-configured)


Mode Equipment
Sword Diamond Armor (Prot IV), Sharpness V Sword, Pearls, Splash Potions
Netherite Netherite Armor + Fire Aspect Sword
Mace Density V Mace, Wind Charges, Jump Boost III effect
PlotPvP Iron Armor, Infinity Bow, Arrows
Crystal Blast Protection Netherite, 128 Crystals, Totems, Fire Resistance
4. Arena Management

• BlockSnapshot captures full arena region on save
  
  
• Automatic block-by-block rebuild after every match
  
  
• Crystal explosions track broken blocks in real-time
  
  
• Arena cleanup kills stray entities (items, crystals, fireballs, exp orbs) after matches
  
  
• Incomplete arenas (missing snapshot) shown in orange in GUI

5. Live Scoreboard

• Per-player sidebar scoreboard updates every 4 ticks
  
  
• Displays: Both players' health, mode, tier, match duration
  
  
• Can be disabled via config

6. Leaderboard System

• playerdata.yml persistence
  
  
• getTop10(mode, tier) for every combination
  
  
• Placeholder support: top10_sword_ht1_1 style identifiers
  
  
• Top-10 rankings per mode and tier

7. Admin Setup Commands


Command Function
/setup arena <name> pos1 Set first corner
/setup arena <name> pos2 Set second corner
/setup arena <name> spawn1 Set player 1 spawn
/setup arena <name> spawn2 Set player 2 spawn
/setup arena <name> save Save arena
/setup arena <name> snapshot Capture rebuild snapshot
/setup spawn Set global spawn
/setup arenas List all arenas
/setup reload Reload config
/setup gui Open admin setup GUI
/duels edit Open arena edit GUI
8. Admin Setup GUI (/setup gui)

• Main page shows all arenas as clickable items
  
  
• + New Arena button – prompts for name in chat
  
  
• Arena edit page: Click position buttons to set to your current location (live refresh)
  
  
• Color-coded save button (red/green based on completion)
  
  
• Snapshot recapture, delete, and reload buttons
  
  
• Arenas without snapshot appear in orange terracotta with warning lore

9. Intense Sound Effects


Event Sound
Countdown tick Hat + Snare (escalating pitch) + title
FIGHT! start Dragon growl + challenge complete + anvil land
Player hit Hurt sounds to both players
Low health (≤6 HP) Bass alarm + flashing title
Win Fireworks + level up sound
Loss Villager death + bass
10. Safety Features

• Blocked commands during duels (configurable list)
  
  
• Disconnect handling
  
  
• No item drops during matches
  
  
• Damage validation – only opponents can hurt each other
  
  
• Spectator mode for losing player

11. Configuration (config.yml)

• Countdown timers
  
  
• Blocked command list
  
  
• Global spawn location
  
  
• Arena definitions
  
  
• Kit effects
  
  
• All messages (MiniMessage format)

Everything is configurable

Botfights with citizens api
Commands Summary


Command Permission Description
/duel <player> rivalduel.duel Challenge a player
/accept rivalduel.duel Accept a challenge
/deny rivalduel.duel Deny a challenge
/duels edit rivalduel.admin Open arena edit GUI
/duels help Everyone Show help
/setup gui rivalduel.admin Open admin setup GUI
/setup arena ... rivalduel.admin Arena setup commands
/setup spawn rivalduel.admin Set global spawn
/setup reload rivalduel.admin Reload config




NEW A SETUP GUI / botfights Kiteditor

/setup gui

You need Citizens

https://ci.citizensnpcs.co/job/Citizens2/







supports short view :;
RivalDuels is a modern Paper 1.21 Practice & Duel plugin with Crystal PvP, Ranked matchmaking, and automatic arena rebuilds — designed for MMC/Hypixel-style competitive servers.




Why RivalDuel?

✔ MMC / Hypixel-style Practice experience
✔ Crystal PvP & competitive duel modes
✔ Fast automatic arena rebuild system
✔ Ranked + Tier matchmaking
✔ Lightweight & high-performance
✔ Fully configurable system
✔ Easy GUI-based arena setup
✔ Bot fights via Citizens integration
✔ Designed for modern Paper 1.21 servers