Permissions

Courier uses Fabric’s permission API. If you’ve got LuckPerms, you can fine-tune who does what. Without a permission mod, it falls back to operator levels.

Permission Nodes

Player Permissions

Permission	Default	What It Does
`courier.mail.use`	All (level 0)	Basic mail access, open inbox
`courier.mail.send`	All (level 0)	Send mail and use compose GUI
`courier.locker.use`	All (level 0)	View and claim locker items

Admin Permissions

Permission	Default	What It Does
`courier.admin`	OP (level 4)	Base admin permission
`courier.admin.reload`	OP (level 4)	Reload configs
`courier.admin.preset`	OP (level 4)	Manage and send presets
`courier.admin.preset.bulk`	OP (level 3)	Send presets to multiple targets
`courier.admin.cleanup`	OP (level 4)	Run cleanup tasks
`courier.admin.stats`	OP (level 4)	View system stats
`courier.admin.debug`	OP (level 4)	Debug player mailboxes
`courier.admin.locker`	OP (level 4)	Manage package lockers

Content Filter

Permission	Default	What It Does
`courier.filter.bypass`	OP (level 4)	Skip the content filter when sending mail

Cooldown Permissions

Permission	Effect
`courier.cooldown.bypass`	No send cooldown
`courier.cooldown.vip`	5 second cooldown
`courier.cooldown.premium`	2 second cooldown
(none)	Default 10 second cooldown

OP Level Fallback

No permission mod? Courier maps permissions to vanilla operator levels:

Level	Who
0	All players
3	Operators (bulk preset send)
4	Server console / owners

Recommended LuckPerms Setup

Basic Player Group

/lp group default permission set courier.mail.use true
/lp group default permission set courier.mail.send true
/lp group default permission set courier.locker.use true

VIP Player Group

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

Mail Admin

/lp group mailadmin permission set courier.admin true
/lp group mailadmin permission set courier.admin.reload true
/lp group mailadmin permission set courier.admin.preset true
/lp group mailadmin permission set courier.admin.preset.bulk true
/lp group mailadmin permission set courier.admin.cleanup true
/lp group mailadmin permission set courier.admin.stats true
/lp group mailadmin permission set courier.admin.debug true
/lp group mailadmin permission set courier.admin.locker true
/lp group mailadmin permission set courier.cooldown.bypass true