Permissions

ArenaPvP uses a flat permission system under the arenapvp namespace. All permissions are checked through the server's permission API, and work seamlessly with LuckPerms if installed.

User Permissions

These permissions should be granted to all players who should have access to ArenaPvP:

Permission	Description
haporelab.arenapvp.command.arena	Root permission
arenapvp.use	Base permission to use the ArenaPvP system
arenapvp.join	Join arena matchmaking queues
arenapvp.leave	Leave a queue or arena match
arenapvp.kit	Select kits in the arena
arenapvp.ui	Open the arena menu UI
arenapvp.leaderboard	View the leaderboard
arenapvp.spectate	Spectate matches (HyTv and direct)
arenapvp.hytv	Access the HyTv match browser

Group Permissions

These permissions control access to the party/group system:

Permission	Description
arenapvp.group.*	Grants all group permissions
arenapvp.group.invite	Create groups and invite players
arenapvp.group.accept	Accept group invitations
arenapvp.group.decline	Decline group invitations
arenapvp.group.leave	Leave a group
arenapvp.group.kick	Kick members from a group (leader only)
arenapvp.group.transfer	Transfer group leadership
arenapvp.group.disband	Disband a group
arenapvp.group.info	View group information
arenapvp.group.ui	Open the group management UI
arenapvp.group.confirm	Toggle invitation confirmation UI

Admin Permissions

These permissions should only be granted to server staff:

Permission	Description
arenapvp.admin.*	Grants all admin permissions
arenapvp.admin.debug	Toggle debug mode and use test commands
arenapvp.admin.cancel	Cancel active arena matches
arenapvp.admin.kitcreate	Create kit presets from inventory
arenapvp.admin.reload	Reload the plugin configuration

Recommended Setup

For a typical server, here's a suggested permission setup:

Default Players

Grant these to all players:

arenapvp.use
arenapvp.join
arenapvp.leave
arenapvp.kit
arenapvp.ui
arenapvp.leaderboard
arenapvp.spectate
arenapvp.hytv
arenapvp.group.*

Moderators

In addition to player permissions:

arenapvp.admin.cancel

Administrators

Full access:

arenapvp.admin.*

Permission Groups in Arenas

The DisableGroupPermission setting in config.json allows you to temporarily revoke permission groups from players while they are inside an arena. This is useful for disabling fly, creative mode, or other abilities that would be unfair in PvP:

{
  "DisableGroupPermission": ["creative", "fly-access"]
}

Permission groups listed here are revoked when a player enters an arena and restored when they leave.