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	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
arenapvp.maps	Open map preferences UI (block/unblock maps)
arenapvp.history	View match history (/arena history)

Group Permissions

These permissions control access to the party/group system:

Permission	Description
haporelab.groupmanager.command.group	Base permission to use the Group system
groupmanager.group.*	Grants all group permissions
groupmanager.group.invite	Create groups and invite players
groupmanager.group.accept	Accept group invitations
groupmanager.group.decline	Decline group invitations
groupmanager.group.leave	Leave a group
groupmanager.group.kick	Kick members from a group (leader only)
groupmanager.group.transfer	Transfer group leadership
groupmanager.group.disband	Disband a group
groupmanager.group.info	View group information
groupmanager.group.help	Show commands info
groupmanager.group.confirm	Toggle invitation confirmation UI

Admin Permissions

These permissions should only be granted to server staff:

Permission	Description
arenapvp.admin	Base admin permission — allows bypassing the GameMode key ("O") override so it changes gamemode instead of opening the Arena UI, and exempts from blocked commands in arenas
arenapvp.admin.*	Grants all admin permissions
arenapvp.admin.debug	Toggle debug mode and use test commands (/arena debug, /arena antidroptest, /arena trailtest, /arena orbtest, /arena notifytest, /arena testkitui)
arenapvp.admin.cancel	Cancel active arena matches
arenapvp.admin.kitcreate	Create kit presets from inventory
arenapvp.admin.reload	Reload the plugin configuration
arenapvp.admin.prefab	Validate arena prefab files

Recommended Setup

Do not use arenapvp.* for regular players

The wildcard arenapvp.* matches all permissions under the arenapvp namespace, including arenapvp.admin.*. If you grant arenapvp.* to a player, they will have access to admin commands like /arena debug, /arena reload, and all test commands.

Always use the individual permissions listed below for regular players.

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

Default Players

Grant these to all players:

haporelab.arenapvp.command.arena
arenapvp.join
arenapvp.leave
arenapvp.kit
arenapvp.ui
arenapvp.leaderboard
arenapvp.spectate
arenapvp.hytv
arenapvp.maps
arenapvp.history
haporelab.groupmanager.command.group
groupmanager.group.*

Moderators

In addition to player permissions:

haporelab.arenapvp.command.arena
arenapvp.admin.cancel

Administrators

Full access:

haporelab.arenapvp.command.arena
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.

GameMode Key ("O") Behavior

The "O" key normally sends a gamemode change command (/gm c or /gm a). ArenaPvP intercepts this key based on the player's arenapvp.admin permission:

Situation	Has arenapvp.admin	Doesn't have arenapvp.admin
Inside arena	Gamemode change allowed + Kit UI opens	Gamemode change blocked + Kit UI opens
Outside arena (GameModeKeyOpensArenaUI=true)	Gamemode change allowed normally	Gamemode change blocked + Arena UI opens
Outside arena (GameModeKeyOpensArenaUI=false)	Gamemode change allowed	Gamemode change allowed

Permission Resolution Order

The arenapvp.admin permission is checked in the following priority:

1. HyperPerms — If installed, checks the arenapvp.admin permission node directly.
2. LuckPerms — If installed (and HyperPerms is not), checks arenapvp.admin via cached permission data.
3. Native fallback — If no permission plugin is available, checks whether the player belongs to the OP or Operator group in Hytale's native PermissionsModule.

tip

If you use HyperPerms or LuckPerms, assign arenapvp.admin to your admin group. If you don't use any permission plugin, players in the native OP group will be treated as admins automatically.