Permissions

All permissions registered by ShyamDuels, categorized by administrative, base, VIP, and party configurations.

LuckPerms Command Examples

/lp user Steve permission set shyamduels.vip true
/lp group vip permission set shyamduels.vip true
/lp group admin permission set shyamduels.admin true

Admin Permissions

Permission Node	Default	Description
`shyamduels.admin`	op	Grants full access to all kit and arena configuration commands, along with system controls.
`shyamduels.tournament.admin`	op	Grants full control over tournaments (start, stop, forcestart, setkit, setmin/max, skipround, nextmatch, reload).
`shyamduels.admin.bypass`	op	Bypasses block building restrictions inside match arenas (allows placing/breaking blocks).
`shyamduels.admin.forceleavefight`	op	Declared in `plugin.yml` but not currently enforced: the `/leavefight` teleport delay (`leavefight.delay`) applies to all players regardless of permission.
`shyamduels.tab.admin`	op	Allows reloading the tab list system via `/tab reload` or `/shyamduels reload-tab`. Child of `shyamduels.admin`.
`shyamduels.tab.staff`	op	Staff sort rank in the tab list. Child of `shyamduels.admin`.
`customkits.admin`	op	Allows customizing the items and categories inside the custom kits builder GUI via `/shyamduels customkits`.

Player Permissions

Permission Node	Default	Description
`shyamduels.use`	true	Grants base permission to join queues, use duels, join FFA, spectate, open profiles, and customize preferences.
`shyamduels.practice.duel`	true	Allows round-based practice duels via `/practiceduel` and `/shyamduels practiceduel` (not ranked `/duel`).
`shyamduels.practice.totempractice`	true	Grants entry into the Totem Reaction practice game.
`customkits.unlock.all`	false	Unlocks all slots inside the Custom Kit builder, disregarding default slot restrictions.
`customkits.unlock.<kitId>`	false	Unlocks a specific custom kit slot by ID (configured in custom kits module configs).

VIP Perks Permissions

Granting shyamduels.vip automatically inherits all child permissions listed under it (e.g. trimmer, shield, and shulker customizations).

Permission Node	Default	Perks Unlocked
`shyamduels.vip`	false	VIP Tier: Unlocks 16-player maximum capacity parties and all four sub-practice modules.
`shyamduels.vipplus`	false	VIP+ Tier: Inherits all VIP perks and increases maximum party capacity limits to 32.
`shyamduels.tab.vip`	false	VIP sort rank in the tab list. Child of `shyamduels.vip`.
`shyamduels.practice.armortrimmer.use`	op	Use the Armor Trimmer GUI in the Kit Editor / Kit Room (Requires VIP).
`shyamduels.practice.shieldcustomizer.use`	op	Use the Shield Customizer pattern editor in the Kit Editor / Kit Room (Requires VIP).
`shyamduels.practice.shulkereditor.use`	op	Opens the Shulker Box Editor GUI workspace in the Kit Room (Requires VIP).
`shyamduels.practice.enchanttable.use`	op	Access the virtual Enchant Table panel inside the Kit Room (Requires VIP).

Party Capacity Restrictions

The maximum size constraints of a party are decided by the highest permission node active on the party leader at party creation.

Permission Node	Default	Max Party Members	Scope
`shyamduels.party.size.8`	true	8 Members	Standard base cap for all players.
`shyamduels.party.size.16`	false	16 Members	VIP tier party size constraint limit.
`shyamduels.party.size.32`	false	32 Members	VIP+ tier party size constraint limit.

Additional Utility Permissions

Permission Node	Default	Module Scope
`shyamduels.practice.goldenhead`	op	Allows generating and giving custom Golden Head items to players.
`shyamduels.practice.gate.setup`	op	Allows configuring start block doors (Complex Gates) in arenas.
`shyamduels.cosmetics`	op	Allows keeping armor trims and banner patterns in fights, and grants access to Armor Trimmer and Shield Customizer. It is included in `shyamduels.vip`.
`shyamduels.enchant`	op	Allows using the Enchant Table in the Kit Editor and Kit Room. It is included in `shyamduels.vip`.

Tab Sort Rank Permissions

Configured in tab/display.yml under sort-ranks:. These control tab list prefix priority when assigned via LuckPerms:

Permission Node	Tab Prefix
`group.owner`	Owner rank prefix (dark red)
`shyamduels.tab.admin`	Admin rank prefix (red)
`shyamduels.tab.staff`	Staff rank prefix (blue)
`shyamduels.tab.vip`	VIP rank prefix (gold)

Custom Kit Slot Permissions

Per-slot unlock permissions follow the pattern customkits.unlock.<kitId> where <kitId> matches the slot ID in custom kit configs. Grant all slots with customkits.unlock.all.