⚔ 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

🚀
Getting Started
Learn how to install, set up lobby spawns, and configure your first duel kit and arena in under 10 minutes.
💻
Commands Reference
Exhaustive subcommands list for administrative configuration, party setups, and queue matchmaking control.
🔑
Permissions
A complete reference of permission nodes including admin, player, VIP, and party capacity scopes.
🏟
Arena Setup
Step-by-step guides to create regular duel arenas, block-building arenas, and FFA arenas.
🚪
Gate Setup
Configure Complex Door start gates with the video tutorial and full /shyamduels gate command reference.
🎒
Kit Configuration
Snapshot inventory layouts, allow blocks for building, scan match-start splash potions, and configure kit rooms.
👥
Party System
Configure party size limits, team splitting, party vs party matches, and party Free-For-All queues.
📊
ELO & Ranks
Explore the 34-tier rank progression system, formulas for matchmaking ELO, and rank multipliers.
🎯
Practice Features
Practice duels, totem training, golden heads, death messages, VIP kit tools, and legacy command aliases.
📦
Migration Guide
Import arenas, kits, gates, and schematics from StrikePractice with /shyamduels migrate strikepractice.
⚙️
Configuration Files
Detailed breakdowns of config.yml, database.yml, ranks.yml, tab configs, menus, and runtime data files.
🏷
PlaceholderAPI
Every %shyamduels_% variable: stats, queue, party, practice toggles, relational nametag colors, and tab tokens.
🔌
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.
Dependency Boot Constraints
All dependencies mentioned above are required at startup. The server will fail to load the plugin if any of them are missing.