Permissions
MineMail defines nine permission nodes. Only four are currently enforced by the code - the rest are reserved for planned features and have no effect yet.
| Permission | Default | Description | Enforced? |
|---|---|---|---|
minemail.use | true | Baseline access: create/delete/list/open mailboxes, browse the directory, send and read mail. | Yes |
minemail.admin | op | /minemail reload, /minemail cleanupholograms, and breaking another player's mailbox barrel. | Yes |
minemail.mailbox.share | true | Use /minemail share and /minemail unshare. | Yes (commands only - see note below) |
minemail.group.create | true | Allow creating mail groups. | No - group feature isn't wired up |
minemail.group.manage | true | Allow managing group members. | No - group feature isn't wired up |
minemail.group.send | true | Allow sending mail to groups. | No - group feature isn't wired up |
minemail.mailbox.icon | false | Allow custom GUI mailbox icons. | No - no in-game setter exists |
minemail.mailbox.particles | false | Allow particle customization. | No - no in-game setter exists |
minemail.sounds | false | Allow optional sound effects. | No - not checked anywhere |
:::caution GUI access doesn't check minemail.mailbox.share
The Manage Access GUI (add/remove viewers from inside a mailbox) does not check minemail.mailbox.share - only the /minemail share and /minemail unshare commands do. Anyone with minemail.use can still add or remove shared players through the GUI even without minemail.mailbox.share. If you need to lock down sharing entirely, revoke minemail.use for the specific players/groups instead, or wait for this to be fixed upstream.
:::
Common Setups
Standard players
Default permissions (minemail.use: true, minemail.mailbox.share: true) let every player create mailboxes, send and receive mail, and manage access to their own mailboxes with no configuration needed.
Staff / moderators
Grant minemail.admin to allow reloading the config (/minemail reload) and cleaning up holograms (/minemail cleanupholograms). Admins can also break any player's mailbox barrel, bypassing the normal owner-only restriction.
Restricting mailboxes to trusted players
Set minemail.use: false in your permissions plugin's default group, then grant it explicitly to players/ranks who should be able to use mailboxes. There's no separate "read-only" tier - minemail.use gates the whole feature.
Don't bother granting minemail.group.*, minemail.mailbox.icon, minemail.mailbox.particles, or minemail.sounds yet - none of them currently change plugin behavior. See Configuration for what's actually functional today.