Permissions
MineMail declares nine permission nodes in plugin.yml. It also checks open-ended rank limit nodes and the particle nodes listed in config.yml.
| Permission | Default | Description | Enforced? |
|---|---|---|---|
minemail.use | true | Use the player /minemail commands. | Yes, commands only. See the note below. |
minemail.admin | op | Admin commands (reload, cleanupholograms, inspect, log, recover, export, itemtest), delete -f, group info on any group, opening any mailbox read-only by right-clicking it or picking it in the directory, and breaking any player's mailbox barrel. | Yes |
minemail.mailbox.share | true | Use /minemail share and /minemail unshare. | Yes, commands only. See the note below. |
minemail.group.create | true | Create mail groups. | Yes |
minemail.group.manage | true | Add, remove, promote, and demote group members, and link mailboxes. Also needs a Manager or Owner role in the group. | Yes |
minemail.mailbox.particles | false | Open the per-mailbox particle picker. | Yes |
minemail.particle.default | true | Entitlement to the default HAPPY_VILLAGER particle in the picker. | Yes, through mailbox.particles.selectable |
minemail.mailbox.icon | false | Custom mailbox icons. | No: not checked, and there's no in-game icon setter |
minemail.sounds | false | Optional sound effects. | No: not checked, and sounds always play |
minemail.use and minemail.mailbox.share only gate commandsRight-clicking a mailbox barrel and every MineMail menu work without minemail.use, so revoking it stops a player using commands but not mailboxes they can already open.
Similarly, the Manage Access menu (Manage Mailbox → Manage Access) lets a mailbox owner add and remove viewers without minemail.mailbox.share. Only the /minemail share and /minemail unshare commands check it.
Rank Limits
Grant these from your permissions plugin to give ranks different limits. The highest number a player has wins. With none, the config value applies, and that is unlimited by default (-1).
| Node | Overrides | Notes |
|---|---|---|
minemail.limit.mailboxes.<n> | mailbox.max-per-player | How many mailboxes the player may own. Purchased extra slots are added on top. |
minemail.limit.capacity.<n> | mail.max-per-mailbox | How much mail each of the player's mailboxes can hold. Only applies while the owner is online; mail sent to an offline owner's mailbox uses mail.max-per-mailbox. |
For example, minemail.limit.mailboxes.10 lets a player own 10 mailboxes. These nodes aren't declared individually in plugin.yml, because <n> is open-ended.
Particle Entitlements
Each particle in the picker is unlocked by the permission it's mapped to under mailbox.particles.selectable in config.yml. The defaults are:
| Particle | Permission |
|---|---|
HAPPY_VILLAGER | minemail.particle.default |
END_ROD | edeneffects.mailbox.endrod |
CHERRY_LEAVES | edeneffects.mailbox.cherry |
HEART | edeneffects.mailbox.heart |
SOUL_FIRE_FLAME | edeneffects.mailbox.soulfire |
ENCHANT | edeneffects.mailbox.enchant |
TOTEM_OF_UNDYING | edeneffects.mailbox.totem |
A player needs minemail.mailbox.particles to open the picker at all, then sees only the particles they're entitled to. If an owner loses an entitlement, their mailbox shows the server default particle again, but their choice is kept in case they get it back.
Access Levels
What a player can do with a mailbox depends on how they're connected to it, not on a permission node.
| Who | Open and read | Collect, mark read, delete mail | Manage (rename, description, hologram, particle, access) | Delete mailbox |
|---|---|---|---|---|
| Owner | Yes | Yes | Yes | Yes |
| Group owner | Yes | Yes | Yes | Yes |
| Group manager | Yes | Yes | Yes | No |
| Group member | Yes | Yes | No | No |
| Shared (view-only) player | Yes | No | No | No |
| Admin | Read-only, via /minemail inspect, right-clicking the barrel, or the directory | No | No | Can break the barrel, if it's empty |
Anyone can send mail to any mailbox, whatever their access. Anyone who can open a mailbox, including view-only players, can reply to and forward its mail. The read-only admin view can't.
Common Setups
Standard players
The defaults let every player create mailboxes, send and receive mail, share their mailboxes view-only, and create and run groups.
Staff / moderators
Grant minemail.admin for the admin commands: reload, hologram cleanup, read-only inspection, the transaction log, recovery, and exports. Staff with it can also open any mailbox read-only by right-clicking its barrel or picking it in the directory. Admins can break any player's mailbox barrel, but only once it's empty.
Ranked mailbox limits
Give ranks minemail.limit.mailboxes.<n> and minemail.limit.capacity.<n>, for example .3 for default players and .10 for donors. Optionally enable mailbox.extra-slots so players can buy more.
Cosmetic particles
Grant minemail.mailbox.particles to players who should get the picker, then grant the particle nodes you want them to have, from your permissions plugin, Eden Effects, or a webstore.