NDuels

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper spigot

标签： equipment game-mechanics

NDuels

Fast, configurable duels plugin for Paper/Spigot.
Designed for clean queues, flexible menus, and smooth arena resets.

Core Features

• Matchmaking & queues with /duel menu support
• Custom kits per mode + in‑game editor
• Configurable /duel menu layout via menu.layout
• Lag‑safe arena reset (batch block restore)
• And Much more! :D

Important Notes

• TAB integration: duelists can see only opponent + spectators in tablist (if TAB is installed)
• PlaceHolderAPI support included

Player Commands

Player Commands ``` - /duel - show basic help - /duel queue - join queue for a mode - /duel leave - leave current queue - /duel unqueue - same as leave - /duel modes - list available modes - /duel menu - open duel menu - /duel preview - preview a kit - /duel spectate - spectate a player or stop spectating - /duel accept - accept a duel request - /duel ready - confirm ready check - /duel stats [player] - view duel stats - /duel - send duel request ```

Admin Commands

Admin Commands ``` - /dueladmin menu - open the admin GUI - /dueladmin placeholders - open placeholder list GUI - /dueladmin save - save selected arena positions - /dueladmin removearena - delete an arena - /dueladmin reload - reload config, modes, arenas, queues - /dueladmin victorymsg - set who sees win message - /dueladmin startmsg - set who sees start message - /dueladmin gdelay - set glowing delay for a mode - /dueladmin casing - toggle arena casing protection - /dueladmin modearena add - assign arena to a mode - /dueladmin modearena remove - remove arena from a mode - /dueladmin setspawn - set arena spawn point - /dueladmin kit create - create kit from your inventory - /dueladmin kit preview - preview a kit - /dueladmin kit editor - edit a kit - /dueladmin kit list - list all kits - /dueladmin mode delete - delete a mode - /dueladmin rdelay - set respawn delay after duel - /dueladmin list - list arenas and their status ```

Permissions

Permissions ``` - nduels.bypass - nduels.admin - nduels.admin.legacy (deprecated) - nduels.admin.wand - nduels.admin.menu - nduels.admin.placeholders - nduels.admin.save - nduels.admin.arena.remove - nduels.admin.reload - nduels.admin.victorymsg - nduels.admin.gdelay - nduels.admin.kit.rename - nduels.admin.nosat - nduels.admin.modearena.add - nduels.admin.modearena.remove - nduels.admin.modearena.list - nduels.admin.setspawn - nduels.admin.kit.editor - nduels.admin.kit.create - nduels.admin.kit.preview - nduels.admin.kit.list - nduels.admin.rdelay - nduels.admin.list ```

Placeholders (Using PlaceHolderAPI)

Placeholders ``` - %nduels_queue% - %nduels_queuepos% - %nduels_queue_eta% - %nduels_queued_mode% - %nduels_in_duel% - %nduels_duel_mode% - %nduels_duel_mode_display% - %nduels_duel_opponent% - %nduels_ready% - %nduels_requests% - %nduels_arenas_total% - %nduels_arenas_free% - %nduels_arenas_inuse% - %nduels_arenas_resetting% - %nduels_modes_total% - %nduels_queued_total% - %nduels_online% - %nduels_wins% - %nduels_losses% - %nduels_kills% - %nduels_deaths% - %nduels_kd% - %nduels_wl% Per-mode (replace with mode id) - %nduels_queue_% - %nduels_queuepos_% - %nduels_wins_% - %nduels_losses_% - %nduels_kills_% - %nduels_deaths_% - %nduels_wl_% ```

Menu Example:

Examples  ### Code: ``` menu: layout: row2: '[] [] [] m o a [] [] []' row3: '[] [] [] t r h [] [] []' row4: '[] [] [] [] [] [] [] [] []' row5: 'p [] [] c [] u [] [] n' row6: '' items: p: page_prev n: page_next c: close u: unqueue a: mode_axe r: mode_crystal1 m: mode_mace1 h: mode_helden2 o: mode_only t: mode_uhc ```

Default Config.yml

Config.yml ### U can change many settings/options with the ingame Admin Commands ``` # # NDuels configuration # Tips: # - Most values can be changed and reloaded with /dueladmin reload # - Times are in seconds unless stated otherwise # # Arena definitions (auto-filled by /dueladmin save) arenas: {} modes: # Example mode (copy this to add more) example: # Display name shown in menus & messages displayName: "&bExample" # Fallback icon material (if no icon-item is set) icon: DIAMOND_SWORD # Optional: glowing delay for this mode (seconds). 0 = off # glowing-delay-seconds: 0 # Optional: disable hunger drain for this mode # no-saturation: false # Optional full item override (serialized ItemStack) # icon-item: {} settings: # Block non-/duel commands while in a duel command-blocking: true # Make arena casing (border) unbreakable arena-shell-unbreakable: true # Broadcast duel start messages to the whole server broadcast-duels: true # Victory message scope: ALL / PLAYERS / NONE victory-message: PLAYERS # Start message scope: ALL / PLAYERS / NONE start-message: PLAYERS # Time after duel before returning to lobby (0 = instant) respawn-delay: 0 # Seconds before killing players who leave the arena during a duel arena-exit-seconds: 3 # How many blocks are reset per tick (higher = faster, more load) arena-reset-blocks-per-tick: 2000 # Particle radius to show arena borders when near boundary-particle-radius: 3 # Queue status actionbar update interval (ticks) queue-status-interval-ticks: 40 # Average duel length used for ETA (seconds) queue-avg-duel-seconds: 60 # Ready check timeout (seconds) ready-check-seconds: 10 # Duel request timeout (seconds) duel-request-timeout-seconds: 30 # Menu sound effects menu-click-sound: UI_BUTTON_CLICK menu-page-sound: ITEM_BOOK_PAGE_TURN menu-open-sound: BLOCK_CHEST_OPEN xp: # XP needed per level per-level: 100 # XP for wins / losses / kills win: 10 loss: 5 kill: 2 menu: # /duel menu layout (up to 6 rows). # Use [] for empty (auto-filled with gray glass). # Set row6: "" to make a 5-row menu, row5: "" for 4 rows, etc. layout: row1: "[] [] [] [] [] [] [] [] []" row2: "[] [] [] [] [] [] [] [] []" row3: "[] [] [] [] [] [] [] [] []" row4: "[] [] [] [] [] [] [] [] []" row5: "[] [] [] [] [] [] [] [] []" row6: "p [] [] [] c [] [] n u" # Map layout letters to actions items: p: "page_prev" n: "page_next" c: "close" u: "unqueue" # Generic mode slot (auto-fills modes, with paging) s: "mode" # You can also pin specific modes: # x: "mode_sword" ```