Duels Addon

Bring competitive PvP battles to your world with the Duels Addon! Create custom arenas, design unique kits, and challenge players in fast-paced 1v1 battles.

⚠️ IMPORTANT: Be sure to read the Dependencies section below. Required actions and downloads are listed there. Need help? Join the Discord server for support (link on the right).

Part of the Server Collection

The Duels Addon is part of my Server Collection - a growing collection of plug-and-play multiplayer add-ons that make it easy to build your own minigame server or multiplayer world.

Explore the collection:

• Duels
• Many more add-ons coming soon!

Each add-on works perfectly on its own while also integrating seamlessly with the rest of the collection, allowing you to expand your server one feature at a time.

Dependencies (Required & Recommended)

Required: Turn on the 'Beta APIs' toggle in your world under Settings -> Experiments. This add-on will NOT work without it.

Required: Download the Icons Texture Pack so menus and icons display correctly.

⚠️ NOTICE: This dependency is not available yet, it still needs to get approved by CurseForge.
Recommended: Download the Custom UI Texture Pack for the best visual experience.

How to Use

⚔️ Dueling (Players)

Use the command /duels:duel (or simply /duel) to open the Duels menu.

• Every available kit is displayed as a large button. Select one to join that kit's queue.
• Use Quick Play at the top of the menu to join the global queue and find the fastest available match, regardless of kit.
• View your personal statistics using the Statistics button.
• View the global rankings using the Leaderboards button.

🛡️ Create/Manage Kits (Admins)

Manage kits with the /duels:manage_kits command. Operator permissions are required.

Create a Kit

Select Create New Kit, enter a name (and optionally an icon path), then press Submit. A new kit will be created using the items currently in your inventory.

Delete a Kit

Select a kit, choose Delete Kit, then confirm by pressing Yes.

Rename or Change the Icon

Select a kit, choose Change Name/Icon, edit the name and/or icon path, then press Submit.

Update Kit Items

Select a kit, choose Change Items, then confirm. The kit's contents will be replaced with the items currently in your inventory.

Equip a Kit

Select a kit and choose Equip Kit to load its contents into your inventory. This is useful for testing or editing kits.

Warning: Equipping a kit replaces your current inventory.

Blacklist Maps

Select Blacklist Maps after choosing a kit. Blacklisted maps will never be selected when players duel using that kit.

🗺️ Create/Manage Maps (Admins)

Manage maps with the /duels:manage_maps command. Operator permissions are required.

Create a Map

Select Create New Map, enter a map name, then press Submit.

The addon will guide you through the setup using action bar messages:

1. Select the first corner of the arena by left-clicking (or hitting) a block.
2. Select the opposite corner.
3. Choose the two player spawn locations.

Once all steps are complete, you'll see a summary of the map settings. Press Submit to finish creating the map.

Delete a Map

Select a map, choose Delete Map, then confirm by pressing Yes.

Rename a Map

Select a map, choose Change Name, edit the name, then press Submit.

Place a Map

Select a map and choose Place Map in World to paste it into your world for editing or inspection.

You'll be asked to confirm the action before the map is placed.

Big shoutout to (@)poetic/bo for helping beta-test this addon!