Duells

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 – 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 pos1 Set first corner
/setup arena pos2 Set second corner
/setup arena spawn1 Set player 1 spawn
/setup arena spawn2 Set player 2 spawn
/setup arena save Save arena
/setup arena 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 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