Skip to content

Search the store

Find products and categories.

Duels

A duels lobby plugin and a match server plugin for Paper networks, with casual and ranked queues, kits, parties and replays.

What Duels is

Duels is a 1v1 and team duels mode for a Paper network. It comes as two plugins that work together:

  • DuelsLobby runs on your duels lobby. Players join queues, send duel requests, edit kit layouts, start party games and look at stats there. Staff manage kits, maps and ranked settings from the lobby.
  • DuelsGame runs on your match servers. Each match gets its own arena world. The game server applies the kit's rules, records the result, updates ratings and saves a replay.

Scaffold is included. It is the game engine both plugins run on. It handles matchmaking, parties, arenas and moving players between servers.

You can run one lobby and many game servers. Every server shares the same kits, maps, stats and settings through MongoDB and Redis.

What players get

  • Casual and ranked queues for every kit, from /play, /casual and /ranked or the lobby hotbar.
  • Duel requests with /duel, with 1, 3, 5 or 10 rounds or freeplay.
  • Parties with five private modes: Party FFA, Team Fights, Red Rover, Party Battle and party vs party.
  • A kit editor for saving their own hotbar layouts.
  • Ranked divisions from Bronze V to Masters, with 10 placement matches per kit.
  • Stats, leaderboards, match history and replays.
  • Spectating live matches.

What staff get

  • /kit and /kitcategory to build kits and sort them into categories.
  • /duels admin for the kit, map and ranked settings menus.
  • /tier to give players LT, MT and HT tiers per kit. Tiers unlock armour trims in the kit editor.
  • Community replay review with /stasis.

Requirements

RequirementNotes
Paper 1.21.11Folia is not supported.
Java 25 or newerScaffold's release needs Java 25. Duels itself needs Java 21.
BridgeSold separately. Kernel and Stash come with it.
MongoDB and RedisUsed through Stash. Every Duels server must use the same ones.
packeteventsInstalled as a normal plugin on every Duels server.
A proxyPlayers are moved between the lobby and game servers through it.

Next steps

  1. Set up your servers with Installation.
  2. Create your first kit with Kits.
  3. Read Arenas so your kits have somewhere to play.

Add-ons: Robotricks adds practice bots, and Mirror adds cross-region 1v1 matches.