![\"Logo\"](\"https:\/\/i.ibb.co\/VYNPYwxK\/Neues-Projekt.png\")
\n<\/p>\n# EpicDuels<\/p>\n
\n \n<\/p>\n
\n
\n <\/p>\n
<\/p>\n
<\/p>\n
—<\/p>\n
**A full-featured Duels plugin for Paper 1.21.1+ \u2014 no external dependencies required.**<\/p>\n
Challenge players 1v1, group up with friends for team duels or tournaments, track stats across multiple servers, and keep your lobby perfectly pristine \u2014 all out of the box.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Party System<\/p>\n
Create a party with `\/party create`, invite friends, and launch a game with `\/party start`. The party owner selects a kit once; arenas are chosen randomly per match.<\/p>\n
**Team Duel (2v2 \/ 3v3 \/ 4v4)**
\n– Teams are split randomly at match start
\n– Teammates spawn together with small offsets \u2014 nobody overlaps
\n– Friendly fire is disabled automatically
\n– Eliminated players spectate the battle until their whole team falls
\n– Last team standing wins<\/p>\n
**Single-Elimination Tournament**
\n– Full 1v1 bracket with automatic byes for non-power-of-2 counts
\n– Eliminated players are auto-routed to spectate a live match \u2014 they are never left waiting in the lobby
\n– When a spectated match ends, eliminated players are re-routed to the next live match
\n– The final winner is announced **inside the party only** \u2014 no server-wide spam<\/p>\n
### 1v1 Duels<\/p>\n
– **Challenge anyone** \u2014 Pick a player, kit, and map through the GUI. Opponent gets a clickable Accept \/ Deny message with a 30-second timer. ### Kits & Arenas<\/p>\n – **Kit editor** \u2014 Save current inventory as a kit (`\/duel kit create ### Leaderboards & Stats<\/p>\n – **Per-player stats** \u2014 Wins, losses, win rate, and a score (`wins\u00b2 \/ (wins + losses)`) that rewards consistency. ### Multi-Server Stats<\/p>\n Sync win\/loss data across servers \u2014 all async, zero tick impact:<\/p>\n | Backend | Setup | Local `stats.yml` always serves as a fallback cache.<\/p>\n ### Lobby Protections<\/p>\n All lobby players are in **Adventure mode** \u2014 they cannot break or place blocks, and cannot interact with item frames or armor stands. Fifteen additional rules, each togglable in `config.yml`:<\/p>\n – Block break \/ place \/ interact **Per-admin bypass** \u2014 `\/duel lobby off` switches *that admin* to Creative and suspends all protections for their session only. Every other player keeps full protection. `\/duel lobby on` restores Adventure mode for them.<\/p>\n —<\/p>\n ## Requirements<\/p>\n – **Paper 1.21.1+** Does not work on Spigot or Vanilla.<\/p>\n —<\/p>\n ## Installation<\/p>\n 1. Drop `EpicDuels-2.0.0.jar` into your `plugins\/` folder. **Optional \u2014 true void lobby world** (add to `bukkit.yml`): —<\/p>\n ## Commands<\/p>\n ### Player Commands<\/p>\n | Command | Alias | Description | ### Party Commands<\/p>\n | Command | Alias | Description | ### Admin Commands<\/p>\n | Command | Description | —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Multi-Server Stats Setup<\/p>\n ### Supabase<\/p>\n 1. Run in SQL Editor: ### Firebase<\/p>\n 1. Enable Realtime Database in your Firebase project. —<\/p>\n ## Data Files<\/p>\n | File | Contents | —<\/p>\n *Licensed under CC BY-NC-SA 4.0 \u2014 free to use on any server, including revenue-generating ones. Not for resale.*<\/p>\n","protected":false},"excerpt":{"rendered":" A full-featured 1v1 Duels plugin for Paper 1.21.1+ servers.<\/p>\n","protected":false},"featured_media":65035,"template":"","meta":{"_minecraft_slug":"epicduels","_minecraft_project_id":"o53wtqgv","_minecraft_author":"nuroso","_minecraft_license":"CC-BY-NC-SA-4.0","_minecraft_downloads":92,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"epicduels.zip","_minecraft_size_bytes":520580,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T19:51:59.624929Z","_minecraft_date_created":"2026-04-11T20:18:49.450578Z","_minecraft_date_modified":"2026-05-04T14:59:11.821843Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/epicduels","_minecraft_icon_attachment_id":65035,"_minecraft_imported_at":"2026-06-03T17:50:33+00:00","_minecraft_import_hash":"14b86a1397a2db8c62d3700f53318caa","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,89,126,127],"mod_loader":[132],"minecraft_version":[37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-65034","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_loader-paper","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Queue \/ Matchmaking** \u2014 Join a kit-based queue from the menu or via `\/duel queue
\n– **Spectate** \u2014 `\/duel spectate
\n– **Isolated arenas** \u2014 Every duel runs in its own void world copy, deleted immediately after the match.
\n– **Full lifecycle** \u2014 Async world copy \u2192 5-second countdown (Title API, player freeze) \u2192 fight \u2192 instant winner detection \u2192 3-second victory screen \u2192 cleanup.<\/p>\n
\n– **Arena builder** \u2014 `\/duel arena create
\n– **Rename, icons, list** \u2014 Both types support rename, custom icons (hold item in hand), and paginated lists.
\n– **Admin kit preview** \u2014 `\/duel kit give
\n– **Block protection** \u2014 Player-placed blocks can be broken during a duel; original map blocks are protected. Lobby locked for non-admins.<\/p>\n
\n– **In-chat leaderboards** \u2014 `\/duel leaderboard wins` and `\/duel leaderboard score` print the top 10 in chat.
\n– **In-world holograms** \u2014 Place a persistent floating leaderboard with `\/duel leaderboard sethologram
\n|—|—|
\n| **Local** *(default)* | `stats.yml` only \u2014 no configuration needed |
\n| **Supabase** | PostgREST upsert to PostgreSQL |
\n| **Firebase** | Realtime Database REST API |<\/p>\n
\n– Fall damage \/ void damage
\n– Item pickup \/ drop \/ inventory movement
\n– Hunger \/ fire spread \/ leaf decay \/ block burning
\n– Natural mob spawning \/ weather changes \/ death messages \/ PvP<\/p>\n
\n– **Java 21**<\/p>\n
\n2. Restart the server.
\n3. Set lobby spawn: stand where you want it and run `\/duel setlobby`.
\n4. Create an arena: `\/duel arena create myarena` \u2192 build \u2192 `\/duel arena setspawn1` \u2192 `\/duel arena setspawn2` \u2192 `\/duel arena save`.
\n5. Create a kit: equip gear \u2192 `\/duel kit create pvp`.
\n6. Open the menu with `\/duel` and start dueling.<\/p>\n
\n“`yaml
\nworlds:
\n world:
\n generator: EpicDuels
\n“`<\/p>\n
\n|—|—|—|
\n| `\/duel` | `\/d` | Open main menu |
\n| `\/duel challenge
\n| `\/duel accept [player]` | | Accept a duel request |
\n| `\/duel deny [player]` | | Deny a duel request |
\n| `\/duel cancel` | | Cancel your outgoing request |
\n| `\/duel queue
\n| `\/duel queue leave` | `\/d q leave` | Leave the queue |
\n| `\/duel spectate
\n| `\/duel stats [player]` | | View stats in chat |
\n| `\/duel leaderboard wins` | `\/d lb wins` | Top 10 by wins |
\n| `\/duel leaderboard score` | `\/d lb score` | Top 10 by score |<\/p>\n
\n|—|—|—|
\n| `\/party create` | `\/p create` | Create a party |
\n| `\/party invite
\n| `\/party accept [player]` | `\/p accept` | Accept an invite |
\n| `\/party deny [player]` | `\/p deny` | Deny an invite |
\n| `\/party leave` | `\/p leave` | Leave your party |
\n| `\/party disband` | `\/p disband` | Disband the party (owner only) |
\n| `\/party list` | `\/p list` | Show members and online status |
\n| `\/party start` | `\/p start` | Open mode-select GUI (owner only) |<\/p>\n
\n|—|—|
\n| `\/duel arena create\/delete\/rename\/list\/tp\/save\/setspawn1\/setspawn2\/seticon` | Arena management |
\n| `\/duel kit create\/delete\/rename\/list\/edit\/preview\/give\/seticon` | Kit management |
\n| `\/duel setlobby` | Set lobby spawn |
\n| `\/duel lobby off` | Creative + bypass all lobby protections (you only) |
\n| `\/duel lobby on` | Restore Adventure + re-enable protections (you only) |
\n| `\/duel leaderboard sethologram
\n| `\/duel leaderboard removehologram
\n|—|—|—|
\n| `epicduels.admin` | All admin commands | OP |
\n| `epicduels.duel` | Challenge, accept, queue, spectate | Everyone |
\n| `epicduels.stats` | View stats and leaderboards | Everyone |
\n| `epicduels.party` | All party commands | Everyone |<\/p>\n
\n “`sql
\n CREATE TABLE IF NOT EXISTS player_stats (
\n uuid TEXT PRIMARY KEY,
\n wins INTEGER NOT NULL DEFAULT 0,
\n losses INTEGER NOT NULL DEFAULT 0
\n );
\n “`
\n2. In `config.yml`:
\n “`yaml
\n stats:
\n backend: “supabase”
\n supabase:
\n url: “https:\/\/your-project.supabase.co”
\n api-key: “your-anon-key”
\n “`<\/p>\n
\n2. In `config.yml`:
\n “`yaml
\n stats:
\n backend: “firebase”
\n firebase:
\n database-url: “https:\/\/your-project-default-rtdb.firebaseio.com”
\n auth-token: “” # optional database secret
\n “`<\/p>\n
\n|—|—|
\n| `config.yml` | Lobby spawn, protections, PvP toggle, stats backend |
\n| `arenas.yml` | Arena definitions, spawn points, icons |
\n| `kits.yml` | Kit inventories (Base64) and icons |
\n| `stats.yml` | Player win\/loss records (local cache) |
\n| `leaderboards.yml` | Hologram positions |<\/p>\n