Duelcore

⚔️ DuelCore
DonutSMP DuelPlugin — Revamped
A modern, powerful and fully configurable duel system built for competitive Minecraft PvP.

DuelCore is an advanced duel plugin designed for Minecraft servers that want a clean, fast and professional PvP experience.

Featuring CPvP and Sword gamemodes, custom arenas, admin duel tools, arena management, configurable kits, countdowns, sounds, animations, statistics and much more.

Whether you're running a Lifesteal, SMP, PvP or Network server, DuelCore gives you complete control over your duel system.

Main Features
Feature Included
⚔️ Player Duels ✅
️ Admin Duels ✅
️ Custom Arenas ✅
⚔️ Sword Gamemode ✅
CPvP Gamemode ✅
Custom Kits ✅
⏱️ Duel Countdown ✅
✨ Duel Animations ✅
Custom Sounds ✅
Statistics ✅
Win/Loss Tracking ✅
GUI System ✅
⚙️ Fully Configurable ✅
Permission System ✅
️ Admin Management ✅
Lightweight Design ✅
⚔️ Player Duels
Players can challenge anyone on the server using a simple command.

/duel <player>

Example:

/duel Steve

The targeted player receives a duel request and can accept or deny it.

Duel Flow
Player A
↓
/duel PlayerB
↓
Duel Request
↓
Player B Accepts
↓
Gamemode Selection
↓
Arena Selection
↓
Countdown
↓
⚔️ FIGHT
↓
Winner / Loser

Everything can be customized through the configuration.

️ Admin Duel System
DuelCore includes a dedicated Admin Duel system for staff members.

Administrators can start and control duels without depending on the normal player request system.

Command
/adminduel <player>

Example:

/adminduel Steve

Admin duels can be useful for:

• Staff testing
  
  
• Testing kits
  
  
• Testing arenas
  
  
• PvP events
  
  
• Tournament matches
  
  
• Staff vs Player fights
  
  
• Debugging duel setups

Administrators can have additional permissions that normal players don't have.

️ Arena System
DuelCore comes with a complete arena management system.

Create as many arenas as your server needs.

Create an Arena
/arena create <id>

Example:

/arena create arena1

This creates a new arena with the specified ID.

You can then configure the arena's locations and settings.

Example Arena IDs
arena1
arena2
cpvp1
cpvp2
sword1
sword2

Arena Setup
Each arena can have its own settings and locations.

Setting Description
Arena ID Unique arena identifier
Spawn 1 First player's spawn
Spawn 2 Second player's spawn
Gamemode Allowed duel mode
Status Available / Occupied
World Arena world
Spectator Location Optional spectator spawn
Reset Settings Arena reset configuration
This allows you to create completely different arenas for different PvP modes.

⚔️ Available Gamemodes
DuelCore currently supports two dedicated gamemodes:

️ Sword
Traditional Minecraft sword PvP.

Designed for players who want clean and competitive sword combat.

Possible configuration includes:

• Sword type
  
  
• Armor
  
  
• Enchantments
  
  
• Food
  
  
• Potions
  
  
• Combat settings
  
  
• Kit contents

CPvP
A dedicated Crystal PvP gamemode designed for fast and aggressive combat.

CPvP arenas can have their own:

• Kits
  
  
• Armor
  
  
• Weapons
  
  
• Crystals
  
  
• Obsidian
  
  
• Totems
  
  
• Potions
  
  
• Arena settings
  
  
• Combat settings

Each gamemode can be configured independently.

Gamemode Configuration
You can configure different settings for each gamemode.

Setting Sword CPvP
Custom Kit ✅ ✅
Custom Arena ✅ ✅
Countdown ✅ ✅
Sounds ✅ ✅
Animations ✅ ✅
Statistics ✅ ✅
Custom Messages ✅ ✅
✨ Cool Duel Animations
DuelCore is designed to make the start and end of a duel feel more exciting.

⚡ Duel Start
When both players enter the arena:

⚔
3
✨
2
⚡
1

FIGHT!

Animations can include:

• Countdown effects
  
  
• Particle effects
  
  
• Title animations
  
  
• Action-bar messages
  
  
• Sounds
  
  
• Lightning-style effects
  
  
• Victory effects
  
  
• Defeat effects

All visual effects should be configurable so server owners can choose the style that fits their server.

Victory System
When a duel ends, DuelCore automatically determines the winner.

Example:

DUEL COMPLETE

Winner:
⚔ PlayerOne

Defeated:
☠ PlayerTwo

Gamemode:
️ Sword

Arena:
️ Arena-01

Victory and defeat messages can be customized.

Player Statistics
DuelCore can track individual player performance.

Statistic Description
Wins Total victories
Losses Total defeats
Duels Total matches
Win Rate Percentage of wins
Streak Current win streak
Best Streak Highest streak
Sword Wins Sword victories
CPvP Wins CPvP victories
This gives players a reason to compete and improve.

Leaderboards
Display your server's top duel players.

Example:

DUEL LEADERBOARD

#1 PlayerOne — 124 Wins
#2 PlayerTwo — 109 Wins
#3 PlayerThree — 97 Wins
#4 PlayerFour — 85 Wins
#5 PlayerFive — 73 Wins

Leaderboards can be separated by:

• Overall
  
  
• Sword
  
  
• CPvP
  
  
• Wins
  
  
• Win Streak

⚙️ Fully Configurable
DuelCore is built around configuration.

Server owners can customize almost every part of the duel experience.

Configuration Categories
Category Configurable
⚔️ Duels Requests, cooldowns, rules
️ Arenas Locations, IDs, settings
️ Sword Kit and combat settings
CPvP Kit and combat settings
GUI Titles, items, layout
Messages Every major message
Sounds Duel sounds and effects
✨ Effects Particles and animations
⏱️ Countdown Timing and messages
Statistics Tracking options
Permissions Staff/player access
️ Spectators Spectator settings
Example Configuration
DuelCore keeps configuration organized into separate sections.

duels:
enabled: true
request-timeout: 30
cooldown: 5

countdown:
enabled: true
seconds: 3
sound: true
particles: true

gamemodes:
sword:
enabled: true
arena-required: true

cpvp:
enabled: true
arena-required: true

animations:
duel-start: true
victory: true
defeat: true

sounds:
duel-request: true
countdown: true
fight: true
victory: true
defeat: true

statistics:
enabled: true
track-wins: true
track-losses: true
track-streaks: true

Custom Messages
You can customize messages such as:

&b&lDUEL

&fYou have challenged &b%player% &fto a duel!

&7Gamemode: &f%gamemode%
&7Arena: &f%arena%

DuelCore can support placeholders for things such as:

%player%
%opponent%
%arena%
%gamemode%
%winner%
%loser%
%wins%
%losses%
%streak%

️ Admin Commands
DuelCore provides staff commands for managing the entire duel system.

Command Description
/adminduel <player> Start an admin duel
/arena create <id> Create an arena
/arena delete <id> Delete an arena
/arena list List all arenas
/arena info <id> View arena information
/arena setspawn1 <id> Set Player 1 spawn
/arena setspawn2 <id> Set Player 2 spawn
/arena setlobby <id> Set arena lobby
/arena enable <id> Enable an arena
/arena disable <id> Disable an arena
/duel reload Reload configuration
Player Commands
Command Description
/duel <player> Challenge a player
/duel accept Accept a duel request
/duel deny Deny a duel request
/duel leave Leave the current duel
/duel stats View your statistics
/duel top View the leaderboard
Aliases can also be configured.

Permission System
DuelCore includes separate permissions for players and administrators.

Example:

duelcore.duel
duelcore.accept
duelcore.deny
duelcore.leave
duelcore.stats
duelcore.admin
duelcore.adminduel
duelcore.arena
duelcore.arena.create
duelcore.arena.delete
duelcore.reload

This allows server owners to control exactly who can access administrative features.

️ Spectator System
After being eliminated, players can optionally become spectators.

Spectators can:

• Watch ongoing duels
  
  
• Fly around the arena
  
  
• View the fight
  
  
• Return to the lobby after the duel

Spectator behaviour can be configured by the server owner.

Kit System
Each gamemode can have its own equipment.

Example:

️ Sword Kit
Diamond Sword
Diamond Helmet
Diamond Chestplate
Diamond Leggings
Diamond Boots
Golden Apples
Food

CPvP Kit
Netherite Armor
Sword
End Crystals
Obsidian
Totems
Golden Apples
Potions

Kits can be changed to match your server's own PvP rules.

Lightweight & Server-Friendly
DuelCore is designed to provide a feature-rich duel system without unnecessarily affecting normal server gameplay.

The system is built around:

• Efficient arena handling
  
  
• Clean event management
  
  
• Configurable features
  
  
• Minimal unnecessary processing
  
  
• Multiple simultaneous duels

Perfect For
❤️ Lifesteal Servers
Add competitive duels without affecting normal Lifesteal gameplay.

⚔️ PvP Servers
Create dedicated Sword and CPvP battles.

SMP Servers
Give players a controlled way to fight their friends and rivals.

Minecraft Networks
Run multiple arenas and gamemodes simultaneously.

Competitive Servers
Use statistics, streaks and leaderboards to create competition.

Quick Setup
1. Install
Place:

DuelCore.jar

inside:

/plugins

2. Restart
Restart your server to generate the configuration files.

3. Create an Arena
/arena create arena1

4. Configure Spawns
Set the two player spawn locations.

5. Configure Gamemodes
Enable and customize:

Sword
CPvP

6. Start Dueling
/duel <player>

Built for Modern PvP
DuelCore combines a clean player experience with powerful administration tools.

Players get:

⚔️ Fast duels
️ Dedicated arenas
️ Sword PvP
CPvP
✨ Animations
Statistics
Leaderboards

Administrators get:

️ Admin Duels
️ Arena Management
⚙️ Configuration
Permissions
Kit Management
Custom Messages
Sounds & Effects

⚔️ DuelCore
DonutSMP DuelPlugin — Revamped
Challenge. Fight. Dominate.

A complete duel experience for modern Minecraft PvP servers.