CosDuels

Duels
Duels is an advanced, fully configurable, and performance-optimized 1v1 duel system designed for competitive PvP servers. It allows players to challenge each other in custom arenas with multiple game modes, betting options, and a competitive statistics system.



Core Duel System

Multiple Game Modes

• PotPvP – Classic mode where building and block breaking are disabled.
• CrystalPvP – Players can build and use End Crystals, featuring an optimized arena rollback system.

Complete Duel Flow

1. Request

Players send duel requests using:

/duel <player>

2. Interactive Menus

The challenger selects:

• Game mode
• Arena (random or specific)
• Optional bet amount
  All through intuitive GUI menus.

3. Accept / Deny

The challenged player receives an interactive chat message:

• /duel accept
• /duel deny

4. Countdown

Both players are teleported to the arena.

A 5-second countdown begins.

5. Combat Phase

The duel starts with a configurable time limit.

6. Duel End Conditions

• A player dies
• A player disconnects
• Time runs out

Duel Results

• Win/Loss Announcement(global broadcast)
  • Displays winner
  • Displays loser
  • Shows winner’s remaining health
• Draw System
  • If time expires, duel ends in a draw
• Anti-Combat Log
  • Disconnecting = automatic loss

Custom Death System (Anti-Dupe Safe)
To prevent duplication glitches and death-screen bugs:

• Death is simulated
• Loser enters temporary spectator mode
• Inventory drops naturally
• Winner can collect items
• Inventory is explicitly cleared (including armor & off-hand)

Fully secure and dupe-proof.

Dynamic Duel Scoreboard
During combat, players see:

• Opponent name
• Opponent health (real-time)
• Remaining duel time
• Game mode
• Arena name

Administration & Configuration
Visual Arena Editor
Manage up to 10 arenas.

Commands:

• /duels create
• /duels delete
• /duels tools
• /duels finish

In-Game Setup Tools:

• Combat Zone: Select two corners with an axe
• Spawns: Set spawn points with a blaze rod
• Exit Lobby: Set return location with an emerald

Arena Management GUI
/duels editor

• View all arenas
• Teleport to arenas
• Edit individual settings:
  • Display name
  • Menu icon
  • Game mode (PotPvP / CrystalPvP)
  • Enable / Disable arena

Global Settings

/duels settings

• Maximum duel duration
• Post-duel arena delay before teleport
• Language Support: Built-in multilingual support — Spanish (es) and English (en), fully configurable.

/duels reload

Reload all plugin configurations instantly.

Economy & Betting System

Vault Integration
Compatible with any Vault-supported economy plugin.

Duel Betting System

• Players can choose a bet amount when sending a duel request
• Bet values configurable in data.yml
• Balance is verified before duel starts
• Winner receives the full prize pool (combined bets)

Secure and optimized economy handling.

Security & Performance Optimization

Anti-Dupe Protection

• Explicit inventory clearing
• Safe death simulation
• Prevents all known duplication methods

Anti Combat-Log

• Disconnect = automatic loss
• Inventory drops for winner

Optimized Arena Rollback System
Tracks:

• Blocks placed
• Blocks broken
• Fire spread
• Explosions
• Liquid flow

After the duel:

• Arena regenerates to original state
• Processed in small batches per tick
• No TPS drops
• Crystal explosions do not spawn item entities (prevents lag)

Event Optimization

• Movement checks only trigger when a player changes blocks
• Camera rotation does NOT trigger checks
• Massive performance improvement

Duel Isolation System
During duels:

• Commands are blocked
• Teleports are blocked
• Ender Pearls are restricted
• Chorus Fruit is restricted
• External interference is prevented

Integrations & Compatibility (Hooks)

Duels automatically detects and integrates with the following plugins:


PlaceholderAPI: https://www.spigotmc.org/resources/placeholderapi.6245/

• Full placeholder support
• Real-time stat placeholders:
  • %duels_wins%
  • %duels_kills%
  • %duels_deaths%
• Create dynamic leaderboards in:
  • Holograms
  • Scoreboards
  • TAB
  • Other supported plugins

Vault : https://www.spigotmc.org/resources/vault.34315/

• Direct economy integration
• Secure betting management
• Compatible with all Vault-supported economy systems

DeluxeCombat : https://deluxecombat.com/ (optional)

• Prevents players from sending or accepting duels while combat-tagged
• Automatically removes combat tag when:
  • Duel ends
  • Player dies in arena

No bypass possible.

Statistics & Leaderboards
Tracked Statistics

• Kills
• Wins
• Deaths

Saved asynchronously in stats.yml to avoid performance impact.

Available Placeholders

Player Stats:


%duels_kills%

%duels_wins%

%duels_deaths%


Top Rankings:


%duels_top_kills_name_<position>%

%duels_top_kills_score_<position>%


(Also available for wins and deaths.)