Basic Setup

(Getting Started) (Guide)

Supported Server Software

• Paper

• Purpur

• Folia

(Minecraft 1.21+)

---

Dependencies

Required

• WorldGuard – required for duel arenas

• WorldEdit – required to create regions

---

Commands

Player Commands

Command	Default	Action
/duel <player>	true	Send a duel request
/queue	true	Join the duel queue
/teamqueue	true	Join the team duel queue (2v2)
/draw	true	Request a draw
/leave	true	Leave the current duel
/duelstats <player>	true	Show duel statistics of a player

Admin Commands

Command	Default	Action
/duel-reload	op	Reload the plugin
/donutduels setplayer <1-2> <region>	op	Set spawn position for a player (1v1)
/donutduels removeplayer <1-2> <region>	op	Remove spawn position for a player (1v1)
/donutduels setteamplayer <1-4> <region>	op	Set spawn position for team players (2v2)
/donutduels removeteamplayer <1-4> <region>	op	Remove spawn position for team players (2v2)
/donutduels setpointaftermatch <region>	op	Set arena reset point after a duel
/donutduels removepointaftermatch <region>	op	Remove arena reset point

---

Permissions

Permission	Default	Description
donutduels.use	true	Allows players to use duel commands
donutduels.admin	op	Allows admin setup and reload plugins

---

🗺️ Arena Setup Tutorial (WorldEdit & WorldGuard)

DonutDuels uses WorldGuard regions as duel arenas.

Follow these steps to set up an arena correctly.

---

1️⃣ Select the Arena Area (WorldEdit)

• Get the WorldEdit wand:

//wand

• Select your arena:

  • Left Click → First position

  • Right Click → Second position

---

2️⃣ Create the Region (WorldGuard)

Create the region using a custom name:

/rg define <name>

---

3️⃣ Set Spawn Positions

For 1v1 Duels

Stand at the desired spawn locations inside the arena and run:

/donutduels setplayer <1-2> <region>

1 = Player 1, 2 = Player 2

To remove a spawn position:

/donutduels removeplayer <1-2> <region>

For Team Duels (2v2)

Stand at the desired spawn locations for team members:

/donutduels setteamplayer <1-4> <region>

Positions 1-2 = Team 1 players Positions 3-4 = Team 2 players

To remove team spawn positions:

/donutduels removeteamplayer <1-4> <region>

💡 Tip: When setting team spawns, place players 1 and 2 on one side of the arena, and players 3 and 4 on the opposite side.

---

4️⃣ Set Arena Reset Point After a Duel

Set where the arena should reset after a duel:

/donutduels setpointaftermatch <region>

Remove if needed:

/donutduels removepointaftermatch <region>

---

5️⃣ Add Region Names to the Config

Arena names are stored in basic-setup/regions.yml. Example:

region1: "arena_pvp_1"
region2: "arena_pvp_2"
region3: "arena_pvp_3"
region4: "arena_pvp_4"
region5: "arena_pvp_5"

Replace the values with the actual region names you created.

---

6️⃣ Arena Reset After a Duel (Optional)

To make sure an arena automatically resets after each finished duel, you can use ArenaReset.

• Select the area with:

/ar wand

• Left Click → Position 1

• Right Click → Position 2

Save the arena:

/ar save <name>

Configure reset speed and disable interval resets:

/ar mode <name> <fast|mid|slow>
/ar interval <name> never

• Arena will only reset when DonutDuels executes:

/ar reset <name>

---

7️⃣ Reload the Plugin

Apply all changes:

/duel-reload

---

🎯 Features

• ⚔️ 1v1 Duels - Classic player vs player combat

• 👥 Team Duels - 2v2 team battles

• ⏱️ Queue System - Automatic matchmaking for solo and team queues

• 📊 Statistics - Track wins, losses, and ratios

• 🔄 Auto Reset - Clean arena state after each match

• 🏗️ Multi-Arena - Support for multiple duel arenas

---

🎮 How to Play

Solo Queue

1. Type /queue to join the 1v1 queue

2. Wait for matchmaking

3. Get teleported to an arena and fight!

Team Queue

1. Find a teammate

2. Both type /teamqueue to join the 2v2 queue

3. Get matched against another team

4. Fight in a 4-player arena!