Introduction
What ExyliaDuels is, the ways players can fight and bet, what it needs to run and how this documentation is organised.
ExyliaDuels is survival 1v1 duels. A player types /duel <player>, picks the terms on one screen and sends
them; the challenged player reads them in chat and clicks ACCEPT or DECLINE. Both are taken into an
arena the server built, frozen through a countdown, and fight until one of them dies, falls out, leaves or
the clock runs out. Then both go home exactly as they came, and every stake is paid or refunded. Both can
look at what the other ended with, ask for a rematch, and find the duel, and its replay, in /duel history.
Every stake is paid or refunded exactly once, even through crashes, quits and restarts, on one server or across a network.
It is a premium plugin, installed through a licence loader. See Installation.
Ways to fight
| Mode | What happens to the inventory |
|---|---|
| Own inventory, keep | Players fight with what they carry. Nothing is lost: both go home with exactly what they had. |
| Own inventory, risk | Players fight with what they carry, and the loser's whole inventory goes to the winner. |
| Server kit | Both wear a kit the server defines. Kit items never leave the arena and nobody keeps them. |
| Another plugin's kit | Both wear a kit another plugin offers, such as the Random kit of ExyliaRandomKitsCore. Same rules as a server kit. |
Each kit, and the own inventory modes, sets its own arena flags and rules: how players start, how they fight and what wins, from a death to the first to land N hits, a fall depth, or a best of 3, 5 or more rounds.
On top of any mode a challenge can carry a money bet (both stake the same amount, the winner takes the pot less an optional tax) and an item bet (both put items in a trade window and confirm, the winner takes both). See Duelling.
What is included
The challenge screen, the request, the stakes, the countdown and the fight, rounds, how a duel ends, the end-of-duel inventory and rematch, history, replays, spectators and records.
Arenas and kitsThe admin panel: arenas that save, copy and regenerate themselves, kit-bound arenas, kits with their flags and rules, and settings.
NetworkChallenging players on other servers and fighting server-kit duels on an arena server.
ConfigurationEvery key of config.yml: requests, match times, modes, bets, spectators, after the duel, history, replays, the scoreboards and the command allowlist.
Wins, losses, win rate, streaks, money won and leaderboards, the last duel, and the live duel: opponent, health, time, mode, pot, hits and rounds.
Requirements
| Requirement | Detail |
|---|---|
| Server | Paper 1.21.1 or newer, or a fork of it. Folia 1.21.4 or newer. |
| Java | 21 |
| Required dependencies | packetevents, and the newest ExyliaLib, installed for you if it is missing |
| An economy | Only for money bets: ExyliaEconomy, Vault with an economy plugin, PlayerPoints, or any currency ExyliaLib serves |
| Optional | PlaceholderAPI for the placeholders in other plugins, FastAsyncWorldEdit for arena schematics, ExyliaRandomKitsCore for the Random kit, ExyliaProxyUtils on the proxy for network duels |
Configuration, menus and prompts, the escrow that holds every stake, the trade window, player snapshots, the arena pool and its schematics, teleports, the economy, the database and the network all come from ExyliaLib. ExyliaDuels is written on top of it and does not run without it, which is why the loader installs it on a server that lacks it.
Languages
The plugin ships English, Spanish, French, Portuguese, Russian and Turkish (en, es, fr, pt, ru,
tr): every message and every menu. See
Configuration.
Something missing on this page? Tell us on Discord