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	Bypasses the `/leavefight` teleport delay (`leavefight.delay`) and is teleported immediately.
`shyamduels.admin.forcespawn`	op	Bypasses the `/spawn` teleport delay (`spawn.delay`, falling back to `leavefight.delay`). Also bypasses the `/leavefight` delay.
`shyamduels.tournament.use`	true	Declared in `plugin.yml` for tournament interaction, but not enforced by any command - tournament player commands are currently open to everyone.
`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`. Note: Bukkit `/kitcreator` and `/customkits play` are open (no permission); only `edit-category`/`reload` require this node.
`shyamduels.advancements.use`	true	Opens the advancement GUI via `/advancements` (aliases `/adv`, `/achievements`, `/sdadv`).
`shyamduels.advancements.admin`	op	Advancement admin subcommands: `list`, `grant`, `revoke`, `reset`, `resetall`, `reload`.

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).
`shyamduels.country`	true	Allows using `/countryflags` to select or reset your country flag.
`shyamduels.party.create`	true	Allows creating a party via `/party create`.
`shyamduels.party.public`	true	Allows switching a party to Public visibility mode.

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 base party capacity is the config value party.default-max-size (default 8) and requires no permission. It can be raised for the party leader by either numeric tier nodes (<prefix><number>, prefix configurable via party.size-permission-prefix) or the alias nodes mapped in party.size-permissions (by default shyamduels.vip → 16 and shyamduels.vipplus → 32). The highest applicable limit wins.

Permission Node	Default	Max Party Members	Scope
`shyamduels.party.size.8`	true	8 Members	Informational node matching the default cap (the default requires no permission).
`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`.
`<category permission>` (for example `shyamduels.category.potpvp`)	true	Custom per-category view permission set with `/kit category setpermission` (alias `setperm`). Empty permission means everyone can see the category; `shyamduels.admin` bypasses all category permissions.

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.