Voxel Shop beta is live. Expect occasional bugs. Learn more
A survival/kit duel plugin.
[1] Ratings per kit. Every server kit from kits.yml now has its own rating next to the overall one. A ranked 1v1 changes both and shows a second line, for example » NoDebuff rating +18 (Now: 1218). Kits that players build themselves only count toward the overall rating. Turn it off with elo-system.per-kit.enabled: false.
[2] The 1v1 queue pairs players by the rating of the kit they queued for (elo-system.per-kit.use-for-matchmaking), so a strong NoDebuff player is not matched as a beginner in a kit they never played.
[3] 2v2, 4v4 and FFA have their own ratings. They are calculated from the average rating of each side, so a strong player carried by a weak team gains less than in an even match. Before, team matches changed the overall rating pair by pair. Casual players are left out but still count toward their side's average. Turn it off with elo-system.team-modes.enabled: false.
[4] The 2v2 and 4v4 party queues now pair parties by their average rating with the same window as the 1v1 queue (max-rating-difference, widening over time, match-anyone-after). Before, they paired in join order.
[5] New /duel elo [player] (also /duel rating) shows the overall rating with tier and peak, the 2v2, 4v4 and FFA ratings, and every kit played ranked with wins and losses.
[6] Leaderboards: /duel top 2v2, /duel top 4v4, /duel top ffa and /duel top elo <kit>. The leaderboard menu has a Team ELO button that cycles 2v2, 4v4 and FFA and a Kit ELO button that cycles through every kit with rated players. Rating boards only list players who played at least one duel, so new players at the starting rating no longer fill the board.
[7] New placeholders: %justduel_elo_kit_<kit>%, %justduel_elo_tier_kit_<kit>%, %justduel_elo_peak%, %justduel_elo_2v2%, %justduel_elo_4v4%, %justduel_elo_ffa%, %justduel_kittop_<kit>_<position>_<name|value>% and %justduel_top_elo2v2_<position>_<name|value>% (also elo4v4 and eloffa).
[8] Admin commands: /dueladmin elo info <player>, /dueladmin elo set <player> <rating> [global|2v2|4v4|ffa|<kit>], /dueladmin elo reset <player> [scope] and /dueladmin elo resetall confirm for a season reset.
[9] elo-system.ranked-challenges (default true): set it to false so only queue matches change ratings and friends cannot farm rating with /duel challenges. elo-system.ranked-smp-hard (default false) lets SMP-HARD duels change ratings.
[10] elo-system.placement-games (default 0, off): for a player's first this many duels the rating moves twice as fast, so new players reach their level sooner.
[11] Tier names and thresholds are now set under elo-system.tiers. The defaults are the same as before.
[12] The highest overall rating is saved as the peak rating. When two matches of one player end at the same moment, both rating changes are now applied one after the other, and rating changes still being saved are finished before the server stops.
Replace the JAR and restart. Config version 34 adds the new elo-system keys and messages version 24 adds the rating messages. Your values and comments are kept. Existing overall ratings stay as they are; kit ratings start at starting-rating with the next ranked duel.
[1] On every start justDuel created two temporary duel worlds (duel_temp_...) and kept them loaded, also on servers that only use fixed arenas. The example entries in worlds.yml caused this. Temporary worlds are now only created while at least one enabled arena is a Temporary or Schematic arena, so a new install or a server with fixed arenas loads no extra worlds.
[2] Ready worlds for Temporary and Schematic arenas are unloaded when no duel used them for world-manager.idle-unload-minutes (new, default 10) and are created again for the next duel. To turn temporary worlds off completely, set world-manager.temporary-worlds: false in worlds.yml and run /dueladmin system reload.
[3] Arena worlds that justDuel loads itself no longer keep their spawn chunks in memory. The new world-management.keep-arena-spawn-loaded (default false) in config.yml turns this back on. Worlds loaded by the server or another plugin are not changed.
[4] justDuel no longer forces a full garbage collection. When the server used more than 85 % of its memory, it started one every 30 seconds, which caused lag spikes and high CPU use.
[5] The idle action bar (hub.idle-action-bar) is only shown to players inside the hub zone. Without a hub spawn it was sent to every player on the server every second, which cost CPU and covered the action bar of other plugins.
[6] The hub only turns on after a hub spawn is set with /da system setspawn. Before, the default config placed the hub at 0, 64, 0 in the world called "world": players were moved there when they joined, got the hub items, and every player got the hub scoreboard. If you already set a hub spawn, nothing changes.
[7] On a new install world-control.disable-mobs-in-all-worlds is now false, so mobs are only turned off in arena worlds, the hub world and the worlds in extra-mob-control-worlds. Your current value is kept on update. Set it to false on a survival server so mobs keep spawning in your survival worlds.
[8] Every duel start left a small task running that was never stopped. It kept a reference to both players and the arena, so with every duel the server did a little more work and kept more memory until the next restart. It now stops when the duel starts.
[9] Arena reset: block changes far away from a running match, such as flowing water, redstone or crops elsewhere on the server, are now skipped right away instead of being checked against every arena. One match tracks at most 250,000 changed blocks.
[10] Finished duels, the inventory copy taken when a duel is accepted but cannot start, admin log subscriptions, player settings and several small per-player lists are now cleared when they are no longer needed or when the player leaves, and the cache of player heads used in menus keeps at most 1,000 players. Before, these stayed in memory until the next restart.
[11] Less work on busy servers: clicks in chests and other containers no longer copy the container contents, player stats are loaded once when several features ask for them at the same time, the kit editor zone checks are skipped while no zone exists, the arena world check no longer loads chunks, and the arena worlds are no longer scanned for entities and chunks every minute.
Replace the JAR and restart. Config version 33 adds world-management.keep-arena-spawn-loaded and worlds.yml version 4 adds world-manager.idle-unload-minutes. Your values and comments are kept, and example arenas you removed from worlds.yml are not added back.
[1] Players outside a duel could not break or place blocks near the hub spawn and got no message, ops included: the hub zone (hub.radius around the hub spawn) blocked everyone. Players in a duel, a countdown or practice are now never blocked there, players with justduel.hub.build or justduel.admin.build can build, and a blocked player is told why (hub-build-blocked). Turn the hub block protection off with hub.protect-blocks: false.
[2] Building works in practice on arenas that allow building. Arenas whose world loads late, for example through a world manager plugin, keep their Break Original Terrain, rounds and type settings. The arena-building settings now apply with /dueladmin system reload.
[3] If a player cannot be moved into the arena when a duel starts, for example because a region, claim or combat plugin refuses the teleport, the duel is cancelled. Both players are sent back with their own inventory, the duel scoreboard and boss bar are removed, a locked wager is refunded and the arena is free again. Before, the other player could stay in the arena and the scoreboard stayed on screen. Party and team matches and cross-server duels are cancelled the same way.
[4] If the teleport back after a match is refused, it is tried again, and if it keeps failing the player is sent to the hub or the world spawn instead of staying in the arena.
[5] Arena reset: water and lava can no longer flow out of the arena area, liquid placed by dispensers is reset, and nobody can build or use buckets in the arena between the end of the match and the reset. The reset waits until the players of that match have left the arena.
[6] The arena is now also reset after SMP-HARD matches, draws, duels cancelled at the start and matches that ended because a player went offline. If the server stops during a match, the arena is reset on shutdown. On Folia the changed blocks are saved and reset a few seconds after the next start.
[7] ELO matchmaking now works in the 1v1 queue. Players are paired within max-rating-difference, the window grows by rating-tolerance-increase every 30 seconds, and after elo-system.matchmaking.match-anyone-after seconds (new, default 120, 0 keeps the window) any opponent is accepted. Before, the queue paired players in join order and these settings had no effect. The party queues and the cross-server queue still pair in join order.
[8] The victory message showed the whole rating as a gain, for example "+1200 ELO". It now ends with the match time and the real change follows in its own line ("+16 ELO (Now: 1216)"). Your duel-winner message is only replaced if it is still the old default.
[9] ELO settings apply with /dueladmin system reload. Rating changes are calculated from the stored rating, so servers that share one MySQL database no longer overwrite a newer rating with an old one, and the rating shown on scoreboards is refreshed when a player joins.
[10] Updates no longer reset translated texts. Some duel request messages and the common back button were set back to English on every update. Now your values and your own comments are kept, and new keys are added together with their comments.
[11] The Back and page buttons in the player menus now come from gui.yml (the menu's own back-button entry, otherwise common-items), so they can be translated, and common-items.back-button.enabled: false hides them. The unused duel-settings section is removed from gui.yml; the Settings menu is the settings section.
[12] More texts can be translated in messages.yml: the challenge and result holograms, the rematch line, best-of round titles, party and team match titles, the duel accepted title, the queue tile and party labels in the main menu, the values in the duel request menu, the kit creation boss bars and titles, and the practice disabled message. The Messages page of the wiki lists the new keys.
[13] common-items.filler-primary.material now sets the border pane of every menu, so a red glass border really shows red.
[14] titles-and-bars.boss-bars.enabled: false now turns off the duel boss bars, and the countdown bar uses its configured text, color and overlay from the first second.
[15] Party invites: the new party.invite-title (off by default) also shows a title to the invited player. Invites from another server now show the same message with [ACCEPT] and [DENY] and play the invite sound, and [DENY] works for them.
[16] Wagers: the kit picker has a Set Wager button too, and an amount from /duel <player> <amount> is shown as the current wager in the kit and arena picker. The wager is booked when the challenge is sent, a denied or expired challenge leaves no wager behind for either player, and the payout message shows the amount you actually received (<winnings>).
[17] The license notice in the console links to the current Deltura Discord.
Replace the JAR and restart. Config version 32 adds hub.protect-blocks, elo-system.matchmaking.match-anyone-after and party.invite-title, messages version 23 and gui version 21 add the new texts. Your values and comments are kept. ELO matchmaking follows elo-system.matchmaking.enabled, which is on by default; lower match-anyone-after if your queue is small.
Version 5.1.0
external-teams.enabled: true, the online members of a justTeams team form one JustDuel party led by the team owner. Teams can queue with /duel party queue 2v2|4v4 and challenge each other. The party follows the team: joining, leaving or being kicked from the team updates it within a few seconds, and party create, invite, leave and kick are handled by the team plugin.external-teams.block-same-team-duels: false.ExternalTeamProvider API. Pick the plugin with external-teams.provider (auto, justteams or the plugin's id). Without a team plugin installed nothing changes./duel party duel <player>. The other leader accepts or declines with the clickable buttons or /duel party duel accept|deny <player>. Both parties need 2 or 4 players. New permission justduel.party.duel (default true), switch it off with party.allow-party-duels: false.arena-building.auto-restore.
Version 5.0.5
/duel party invite, /party and /p share this flow.party.invite-sound: false. Text and buttons remain configurable in party-invite-received. Duplicate invitations send no extra notification.world-manager.temporary-worlds in worlds.yml controls temporary and schematic world creation/loading, including scheduled generation and pool replenishment. When disabled, matches require configured fixed worlds and spawn points. Permanent arenas remain available./dueladmin system reload or /dueladmin arena pool. Disabling it removes unused pool worlds; active worlds remain until their matches finish, then are removed.party.invite-sound while preserving existing values. Later sound/world-switch changes support reload and survive restarts./duel kit save and /duel kit cancel now work during kit editing.
Updating
Replace the JAR and restart. Config version 31 adds the external-teams section and party.allow-party-duels, messages version 22 adds the party duel and team messages. Existing values are kept. External teams stay off until you enable them.
[1] Fixed schematic arenas pasting off to one side when the schematic was saved with WorldEdit's `//schem save`, which puts its origin at your copy spot instead of the arena corner. JustDuel now lines the schematic up with the arena corner however it was saved, so players spawn on the floor.
[2] Fixed players getting kicked for flight by anticheats during the pre-match countdown. In a freshly built arena a frozen player could sit just above the pasted floor and get flagged. The countdown now clears fall distance and briefly allows flight. Toggle: `arena-spawns.warmup-flight-exempt` (default on).
[3] Fixed `kit-browser.allow-player-creation: false` only blocking `/duel createkit` and `/duel savekit`. It now blocks every route: `/duel kit create`, the kit editor GUI, the template picker, editing a kit, and kit editor zones. Admins with `justduel.kit.create.bypass` keep access.
[1] New Queue Status tile in the `/duel` menu: shows your queue, mode, kit and party standing; click to leave the queue or pick a mode.
[2] Players are fully frozen during the pre-match countdown in every mode: no placing, breaking, dropping, shooting arrows or throwing projectiles. Toggle `duel.countdown-freeze-actions`.
[3] Item drops work normally in a duel and no longer duplicate (each drop is swept at match end). Toggle `duel.allow-item-drop-in-match`.
[4] Temporary arenas now show as Available instead of In Use.
[5] `/party` and `/p` work as standalone commands, party invites show clickable [ACCEPT] / [DENY], and party messages match the JustDuel style.
[6] Blocks placed during a duel are always restored before the arena is reused, including between best-of rounds.
[7] Random Kit only picks kits shown in the queue, and rematch "Same Setup" works after a random duel.
[8] Scoreboard fixes: real FFA kill count, the queue/spectator/sudden-death boards now show, and end-of-match boards show the real winner and rosters.
[9] `/duel leave` while spectating returns you to your original position.
[10] Cross-server duels return you to your home server when the match ends.
[11] No errors on shutdown, and leftover temporary duel worlds are cleaned up on a clean stop.
[12] Throttled the arena-edge correction teleports; stays smooth under heavy load (tested with 40 bots).
[13] Fixed a rare stuck QUEUE sidebar after leaving the queue.
[14] Kit armor applies again (it was silently dropped when the kit loaded).
[15] The kit creator is a Creative editing mode: `/duel kit create`, `save` and `cancel` build the kit on your own person, with drops, pickups, containers and gamemode changes blocked while editing.
[16] Live Server Settings panel (`/dueladmin settings`): switch duel mode and tune countdown, timers, death tracking and SMP-HARD claim time without a restart.
[17] SMP and SMP-HARD now behave the same in team and FFA as in 1v1 (own inventory kept and restored; SMP-HARD losers drop their gear).
[18] Team and FFA matches get the same leftover-gear sweep as 1v1.
[19] Spawn-safety guard: a teleport that would land you inside a block lifts you to the first safe spot instead of suffocating you.
[20] Temporary arena worlds no longer leak (scrubbed on boot, deleted on clean shutdown, and a janitor reclaims strays).
[21] Smoother result holograms; the old fullscreen VICTORY/DEFEAT title is off by default (`holograms.match-result.show-title`).
[22] Recipe-unlock toasts and advancement broadcasts are suppressed inside arenas (`arena-notifications.*`).
[23] The main menu, mode selector and admin panel refresh their live numbers in place, without reopening.
[24] Kit templates: start a new kit from blank, a premade kit, or one of your own (`kit-templates.*`).
[25] Preset library (`/duel kit preset`): save and load named loadouts across kits, separate from your kit list.
[26] Two new hub hotbar items, Leaderboard and Kits (`hub.inventory`, actions `open_leaderboard` / `open_kits`).
[27] Offline player heads now render the real skin instead of showing "Dynamic".
[28] Cross-server duels no longer strand a transferred player (the arena and kit travel with them).
[29] Two cross-server duels can no longer be booked into the same arena, and the MySQL manager stays off on SQLite servers.
[30] Each mode opens its own page (what it is, your readiness, the supported arenas) instead of dropping you straight into a queue.
[31] Leaf and other Paper forks are detected properly and get full support, instead of an "unknown server" warning.
[32] Menu icons no longer leak vanilla tooltip text; preview and inspect screens still show real item details.
[33] Right-click a preset to preview its full loadout before loading it.
[34] Menus no longer flicker when navigating; same-size menus hand off in place.
[35] Ranked toggle in `/duel settings`: ELO changes only when both players are ranked, with your status shown in the action bar.
[36] Fixes: garbled menu titles, a kit swapped by your last duel, a lingering "Waiting for X", WLR mislabelled as KDR, the queue action bar naming you instead of your opponent, and being stuck after naming a preset on rejoin.
[37] Party invites show "Invite pending" and glow until the player accepts.
[38] Clicking a match in `/duel history` opens a detailed overview with a Challenge Again button.
[39] Team/FFA: a match decided during the countdown ends cleanly with no hanging bar; empty admin-menu slots are filled in; the tournament live-match card is no longer hidden behind a head.
[40] Menus keep their coloured title when `gui.yml` omits one.
[41] Reworded in-game text that used a spaced hyphen as a sentence dash.
[1] Kit creation works the way you'd actually type it now. Do /duel kit create <name> and it starts building your kit. Before this it just said "Player not found", because the command had no idea "kit" was a keyword and thought you were trying to duel a player named kit. Now /duel kit create, /duel kit save and /duel kit cancel all work and tab-complete as you type. The old /duel createkit, savekit and cancelkit still work too, nothing got removed, you've just got the obvious version on top of them.
[2] The admin menus aren't spitting out raw code anymore. A big chunk of /dueladmin was printing things like <yellow> and <gray> as literal text instead of the actual colors, the kit approval list, the world commands, validate, audit, the help pages, all of it. Every one of those lines runs through the proper formatter now, so the whole /dueladmin (or /da) interface reads clean instead of looking half broken.
[3] Players stop spawning inside blocks. People were landing stuck in terrain when they joined or respawned at the hub. Two separate things were wrong: the saved spawn wasn't centered on the block, so you could clip into the one next to it, and the join teleport never checked whether the spot was even open. Both are sorted. The spawn now saves dead-center on the block, and the join, respawn and back-to-hub teleports all look for a clear spot and lift you up out of any solid blocks before they drop you in.
[4] One thing worth doing after you update: stand where you want the hub and run /da system setspawn once. Your current saved spawn could still be a bad point from before the fix, and re-running it writes a clean centered one. If you forget, the new safety check still pulls players out of blocks on join, but setting it fresh gets you the exact spot you picked.
[5] Fixed the disconnects on 1.21.11. Players were getting booted with an "Internal Exception" the second the plugin tried to show an action bar, the queue timer, the idle hub bar, that kind of thing. The text library the plugin used to ship didn't know about the new Minecraft version and was quietly building broken packets, and the server kicked the player rather than send a bad one. That library is gone. The plugin uses Paper's own built-in text now, so action bars and titles show up and nobody gets dropped.
[6] Tidied up the Folia and reload side of things. Spawning a second queue NPC could throw an error, and the NPC bobbing animation could keep running after a reload and pile up. A scheduler fallback could also call itself in a loop and take the server down with it. All fixed. A few teleports that could error out on Folia now go through the safe async teleport that handles crossing regions and worlds.
[7] Keeping it off your survival worlds is just config. JustDuel only applies its arena rules inside arena worlds, so survival is already left alone there. The one thing that reaches everywhere is the hub pulling players in on join, so if you run duels next to a survival world, set hub.teleport-on-join and hub.hub-on-join to false and force-spawn-on-join to false, then put your duel hub and arenas in their own world. Players stay where they log out and only come to the hub when you send them.
[8] Runs on Paper 1.21.11, 26.1.x, Folia and Spigot, single server or cross-server over Redis, same as before.
### NEW
- Party menu. Open it with /duel party (or click the new Party item in /duel). You see your members, who the leader is, your pending invites, and shortcuts to queue the whole party for 2v2, 4v4 or FFA. Leader gets the kick / transfer / disband buttons. Everyone else gets a Leave button
### FIXED
/queue jumped your mouse cursor to the middle of the screen when you clicked a kit.
### COMPATIBILITY
- Same single jar still works on Paper 1.21.1, 1.21.11, 26.1+, Folia 1.21.x and Folia 26.1+