Getting Started

Requirements

Before installing SPxTeam Duels, make sure your server meets the following requirements:

Minecraft Version: 1.19 or higher (supports up to latest)
Server Software: Spigot, Paper, or Folia
Java Version: Java 17 or higher
RAM: Minimum 2GB recommended for smooth operation

Folia Support: This plugin fully supports Folia's regionized multithreading!

Installation

Follow these simple steps to install the plugin:

Step 1: Download the Plugin

Download the latest version of SPxTeamDuels.jar from the official sources.

Step 2: Upload to Server

Place the downloaded JAR file into your server's plugins folder.

Step 3: Restart Server

Restart your server (or use a plugin manager to load it). The plugin will generate its configuration files.

plugins/
├── SPxTeamDuels.jar
└── SPxTeamDuels/
    ├── config.yml
    ├── messages.yml
    ├── arenas.yml
    └── teams.yml

Step 4: Configure (Optional)

Edit the configuration files to customize the plugin to your needs. See the Configuration page for details.

Creating Your First Arena

Before players can duel, you need to create at least one arena:

Step 1: Get the Arena Wand

As an admin, run the command:

/teamduels wand

You'll receive a Diamond Axe named "ᴀʀᴇɴᴀ ᴡᴀɴᴅ".

Step 2: Set Position 1

Left-click on a block where Team 1 should spawn. This sets Position 1.

Step 3: Set Position 2

Right-click on a block where Team 2 should spawn. This sets Position 2.

Step 4: Create the Arena

Run the command with your chosen arena name:

/teamduels createarena MyArena

Tip: Create multiple arenas so duels can happen simultaneously!

Starting Your First Duel

Now that you have an arena, here's how players can duel:

1. Create Teams

Each team leader creates their team:

/teamduels create RedWarriors
/teamduels create BlueKnights

2. Invite Team Members

Team leaders invite players to join:

/teamduels invite PlayerName

3. Join the Team

Invited players can join by clicking the message or typing:

/teamduels join RedWarriors

4. Send a Duel Request

A team leader challenges another team with a game mode:

# Crystal PVP - blocks can be placed/broken, arena resets after
/teamduels duel BlueKnights crystal

# Sword PVP - pure combat, no block manipulation
/teamduels duel BlueKnights sword

5. Accept the Duel

The challenged team's leader accepts via the GUI or command:

/teamduels accept RedWarriors

6. Fight!

Both teams are teleported to the arena. A countdown appears in the title screen (5, 4, 3, 2, 1... FIGHT!). The last team standing wins!

Death System: When a player dies, they enter Spectator Mode and can watch their team fight. Their loot drops on the ground (configurable). Spectators cannot leave the arena until the duel ends.

Victory! When a team wins:

Losers are teleported back immediately
Dead teammates from the winning team (spectators) are also teleported back immediately
Alive winners stay in the arena to collect loot (time shown in action bar)
Winners can type /leave to exit the arena early without waiting for the timer
After loot time ends (or all winners leave), the arena resets and becomes available

Arena Reset: After all players leave, the arena automatically resets (for Crystal PVP). Any remaining items are cleared and blocks are restored. No new duels can start until the reset is complete.

Game Modes

SPxTeam Duels supports two game modes:

Crystal PVP

Players can break and place blocks (obsidian, crystals, etc.)
Arena automatically resets after each duel
Requires an arena snapshot for the reset system
Use /teamduels resetwand and /teamduels savearena to set up

Sword PVP

Pure combat - no block breaking or placing allowed
Arena stays intact, no reset needed
Traditional PVP combat experience

Tip: For Crystal PVP arenas, remember to save the arena snapshot after creating the arena! See the Arenas page for details.

Next Steps

Now that you have the basics set up, explore these topics: