PvP

Duels

1v1 duels: challenge a player with /duel, they click Accept and you both go to a free arena with a countdown. Ready-made kits, kits made in game or your own inventory, money bets, stats and a leaderboard. Nobody really dies: at the end inventory, health and position go back to how they were and the arena blocks are restored.

Buy a license Paper, Spigot, Bukkit 1.20 – 1.21 · Java 17+

Installation

Download the file from the customer area and copy it into your server's plugins folder.
Start the server once: the plugin folder with config.yml is created.
Paste your license under license: and restart the server.

Commands

Aliases: /duels

Command	Permission	Description
`/duel <player> [kit] [bet]`	`duels.use`	Challenges a player
`/duel accept · deny [player]`	`duels.use`	Accepts or denies a challenge (or click the chat buttons)
`/duel leave`	`duels.use`	Gives up the duel
`/duel kits · stats [player] · top`	`—`	Available kits, stats, leaderboard
`/duel arena create\|setspawn\|delete\|list <name> [1\|2]`	`duels.admin`	Creates and manages arenas
`/duel kit save\|delete <name>`	`duels.admin`	Saves your inventory as a kit or deletes it
`/duel reload`	`duels.admin`	Reloads configuration, kits and languages

Permissions

Permission	Default	Description
`duels.use`	true	Send and play duels
`duels.admin`	op	Arenas, kits and reload (and free commands during duels)

Setting up an arena

1) /duel arena create arena1. 2) Stand on the first starting point and type /duel arena setspawn arena1 1, then on the second /duel arena setspawn arena1 2. Create as many arenas as you want: each duel takes a free one. Duels also work when the arena is inside a LandClaims claim.

Kits and reset

kits.yml already has the iron, diamond and archer kits. To make one with enchantments put the items in your inventory and type /duel kit save name. During the duel players can place blocks (arenas.allow-building) and break only those: at the end everything that changed within arenas.reset-radius goes back to how it was.

Bets

With Vault and an economy plugin: /duel Steve iron 500 = both pay 500 when the duel starts and the winner takes 1000. On a draw (time up) the money goes back.

Configuration files

config.yml

# Your license key (you received it privately from our Discord bot).
license: "PASTE-YOUR-LICENSE-HERE"

# Message language: "en" (English) or "it" (Italiano). Files are in /lang and can be edited freely.
language: en
# When true, each player sees the messages in their own game language (when a file for it exists).
use-client-language: true

# Setup in 3 steps (as op):
#   1) /duel arena create arena1
#   2) stand on the first spawn point and type /duel arena setspawn arena1 1, then on the second /duel arena setspawn arena1 2
#   3) optional: put the items you want in your inventory and /duel kit save mykit   (some kits are already in kits.yml)

requests:
  # Seconds before a duel request expires.
  expire-seconds: 30

duel:
  # Kit used when the player doesn't choose one: a kit name from kits.yml, or "own" = everyone fights with their own inventory.
  default-kit: own
  # Allow duels with the players' own inventory (nothing is lost: inventories are not dropped).
  allow-own-inventory: true
  # Seconds of countdown (players can't move) before the fight.
  countdown-seconds: 3
  # Seconds the players stay in the arena after the end before going back.
  end-delay-seconds: 3
  # A duel that lasts longer than this ends in a draw (0 = no limit).
  max-duration-seconds: 300
  # Tell the whole server who won.
  broadcast-result: true
  # Only these commands work during a duel.
  allowed-commands:
    - duel
    - msg
    - tell
    - r
  # Commands run by the console for the winner. {winner} and {loser} are replaced with the names.
  winner-commands: []
  #  - "give {winner} diamond 1"

arenas:
  # Players can place blocks during the duel (they are removed at the end) and break only those blocks.
  allow-building: true
  # Blocks changed within this distance from the middle of the arena are put back after the duel.
  reset-radius: 40

bets:
  # /duel <player> [kit] <amount> = both players pay the amount, the winner takes everything. Needs Vault and an economy plugin.
  enabled: true
  # Maximum bet (0 = no limit).
  max-bet: 0

# Sound names from https://minecraft.wiki/w/Sounds.json  ->  "name:volume:pitch"  ("none" = no sound)
sounds:
  countdown: "block.note_block.hat:1:1"
  start: "entity.ender_dragon.growl:0.5:1.4"
  win: "ui.toast.challenge_complete:0.8:1"

kits.yml

kits:
  iron:
    items: ["iron_sword", "bow", "arrow:16", "cooked_beef:8", "golden_apple:2"]
    armor: ["iron_helmet", "iron_chestplate", "iron_leggings", "iron_boots"]
    offhand: shield
  diamond:
    items: ["diamond_sword", "diamond_axe", "bow", "arrow:32", "golden_apple:4", "cooked_beef:16", "oak_planks:64"]
    armor: ["diamond_helmet", "diamond_chestplate", "diamond_leggings", "diamond_boots"]
    offhand: shield
  archer:
    items: ["stone_sword", "bow", "arrow:64", "cooked_beef:8"]
    armor: ["leather_helmet", "chainmail_chestplate", "chainmail_leggings", "leather_boots"]