Permissions

Reverie uses Fabric’s permission API. If you have LuckPerms or another permission mod installed, you can use these nodes for fine-grained access control. Without a permission mod, checks fall back to operator level.

Permission Nodes

Core Admin

Permission	OP Level	Description
`reverie.command.base`	2	Access to `/reverie` base command
`reverie.command.reload`	2	Reload all configurations
`reverie.command.debug`	2	Access all debug commands
`reverie.command.beatmap`	2	Manage beatmaps
`reverie.command.showdown`	2	Access Showdown debug utilities
`reverie.command.showdown.eval`	4	Evaluate Showdown JS expressions (dangerous)

Contest Management

Permission	OP Level	Description
`reverie.contest.create`	2	Create new contests
`reverie.contest.manage`	2	Admin-manage contests (add bots, set stats, etc.)
`reverie.contest.spectate`	0	Spectate contests (if `requirePermission` is true)

Camera Management

Permission	OP Level	Description
`reverie.camera.manage`	2	Preview, test, and visualize camera positions

Hall Management

Permission	OP Level	Description
`reverie.hall.manage`	2	Create, edit, delete, and reload halls

Tournament Management

Permission	OP Level	Description
`reverie.tournament.create`	2	Create new tournaments
`reverie.tournament.manage`	2	Admin-manage tournaments

Contest Type Management

Permission	OP Level	Description
`reverie.contesttype.manage`	2	Create, edit, and reload contest types

Item Usage

Permission	OP Level	Description
`reverie.sealcase.use`	0	Use a Seal Case item

Cooldowns

Permission	Description
`reverie.cooldown.bypass`	Bypass all contest entry cooldowns
`reverie.cooldown.vip`	VIP tier: 2 min entry, 30 sec re-entry
`reverie.cooldown.premium`	Premium tier: 30 sec entry, 10 sec re-entry

Without any cooldown permission, the defaults are 5 minutes between entering contests and 1 minute to re-enter after leaving.

Custom Entry Permissions

Contest types can define custom permission requirements:

entry {
  permission = "reverie.contest.vip"
}

Any string can be used as a permission node, allowing VIP-only contests, rank-restricted events, etc.

OP Level Fallback

When no permission mod is installed:

Level	Who
0	All players
2	Server operators
4	Server console / owners

Most admin commands require level 2. Player-facing commands like /contest join, /accessibility, and /tournament join require no special permissions.

Recommended LuckPerms Setup

Basic Player Group

/lp group default permission set reverie.contest.spectate true
/lp group default permission set reverie.sealcase.use true

Contest Coordinator Role

/lp group coordinator permission set reverie.contest.create true
/lp group coordinator permission set reverie.contest.manage true
/lp group coordinator permission set reverie.tournament.create true

VIP Player Group

/lp group vip permission set reverie.cooldown.vip true

Full Admin

/lp group admin permission set reverie.command.base true
/lp group admin permission set reverie.command.reload true
/lp group admin permission set reverie.command.debug true
/lp group admin permission set reverie.hall.manage true
/lp group admin permission set reverie.camera.manage true
/lp group admin permission set reverie.contesttype.manage true
/lp group admin permission set reverie.tournament.manage true
/lp group admin permission set reverie.command.beatmap true
/lp group admin permission set reverie.cooldown.bypass true