ShyamDuels v2.0

High-performance 1v1 and team dueling plugin built for modern Paper servers. Features ELO ranked matchmaking, custom kit creation, a robust party system, FFA modes, and an extensive Java developer API.

Paper 1.21+ Java 21+ MiniMessage Support SQLite & MySQL FAWE Integration
Get Started Developer API

Documentation Sections

01
Getting Started
Learn how to install, set up lobby spawns, and configure your first duel kit and arena in under 10 minutes.
02
Commands Reference
Exhaustive subcommands list for administrative configuration, party setups, and queue matchmaking control.
03
Permissions
A complete reference of permission nodes including admin, player, VIP, and party capacity scopes.
04
Arena Setup
Step-by-step guides to create regular duel arenas, block-building arenas, and FFA arenas.
05
Gate Setup
Configure Complex Door start gates with the video tutorial and full /shyamduels gate command reference.
06
Kit Configuration
Snapshot inventory layouts, allow blocks for building, scan match-start splash potions, and configure kit rooms.
07
Party System
Configure party size limits, team splitting, party vs party matches, and party Free-For-All queues.
08
Tournament System
Automated single-elimination brackets, persistent schedulers across restarts, wave arena duels, and visual live GUIs.
09
ELO & Ranks
Explore the 34-tier rank progression system, formulas for matchmaking ELO, and rank multipliers.
10
Practice Features
Practice duels, totem training, golden heads, death messages, VIP kit tools, and legacy command aliases.
11
Migration Guide
Import arenas, kits, gates, and schematics from StrikePractice with /shyamduels migrate strikepractice.
12
Configuration Files
Detailed breakdowns of config.yml, database.yml, ranks.yml, tab configs, menus, and runtime data files.
13
PlaceholderAPI
Every %shyamduels_% variable: stats, queue, party, practice toggles, relational nametag colors, and tab tokens.
14
Developer API
Access duel services, custom events, entity models, and code examples for integration.

Core Requirements

Dependency Minimum Version Role in Plugin
Paper / Spigot 1.21+ Server core. Paper is recommended for async performance features.
Java 21+ Java 21 or newer. The plugin will not load on older JVM versions.
FastAsyncWorldEdit (FAWE) 2.x Required. Saves arena schematics and handles instant block-rollback after duels.
LuckPerms 5.x Required. Handles permissions for VIP tiers, limits, and admin overrides.
PlaceholderAPI 2.11+ Required. Exports match stats, ranks, and player states for scoreboards and chat.
packetevents 2.x Required. Manages network packets for scoreboards, tab lists, and nametags.
Nexo Latest Optional. Enables custom menu icons via Nexo item IDs in GUI and item configs.
Dependency Boot Constraints
FAWE, LuckPerms, PlaceholderAPI, and packetevents are required at startup. Nexo is optional (soft-dependency).