Skip to main content

Troubleshooting & FAQ

Troubleshooting​

I can't create a mailbox​

Check that: you left-clicked the barrel with a stick in hand after running /minemail create <name>; the block is actually a barrel (no other block works); you haven't hit mailbox.max-per-player (default 5); your name isn't longer than mailbox.max-name-length (default 32); and, if economy.mailbox-creation-cost is set, that you have enough balance.

My mailbox has no hologram​

Holograms require DecentHolograms to be installed - MineMail disables hologram features entirely (with a startup warning) if it's missing. Also check mailbox.hologram.enabled in config.yml. If DecentHolograms is installed but holograms look duplicated, missing, or stuck, an admin can run /minemail cleanupholograms.

I sent mail but it didn't arrive / mailbox says full​

Check mail.max-per-mailbox (default 50) - the recipient's mailbox may be at capacity. Mail sent while full simply fails; there's currently no queueing or retry.

I lost mail after deleting a mailbox​

/minemail delete <name> and the in-GUI "Delete Mailbox" button do not check for unread mail before deleting - unlike breaking the barrel in-world, which is blocked while mail is present. If you deleted a mailbox that still had mail in it, that mail is gone; this is a known inconsistency, not a bug in your setup. Read and collect everything before deleting.

Attachment collection isn't working​

You can only collect one item per click, and collection is blocked if your inventory is full - make space and try again.

A shared player can still add/remove other viewers even without permission​

The in-GUI "Manage Access" screen doesn't check minemail.mailbox.share - only the /minemail share//minemail unshare commands do. This is a known limitation; if you need to restrict sharing entirely, revoke minemail.use instead. See Permissions.

Groups, custom icons, particles, or mail expiration don't do anything​

These are not implemented yet, even though their config keys and permissions exist. See Configuration for the full list of what's currently functional.

Config changes didn't apply​

Run /minemail reload after editing config.yml or messages.yml, or restart the server.

FAQ​

Can anyone send mail to my mailbox?​

Yes - mail sending has no ownership or sharing requirement. Anyone with minemail.use can send mail to any mailbox on the server, by design.

Can offline players receive mail?​

Yes. Mail can be sent to and stored for offline players via their UUID, and they're notified of unread mail the next time they log in (a short delay after joining).

Does sharing a mailbox let someone delete mail or the mailbox?​

No. Shared players can read mail and collect attachments/currency, but only the owner can delete mail or delete the mailbox itself.

What happens if I set storage.type to MySQL or SQLite?​

Nothing - only YAML (flatfile) storage is implemented. Other values are silently ignored.

Why can't I set a description or custom icon for my mailbox?​

There's currently no in-game way to do either, even though the config and permission scaffolding exists for them (mailbox.max-description-length, minemail.mailbox.icon). These are reserved for a future update.

Where is mail/mailbox data stored?​

In plugins/MineMail/mailboxes.yml and plugins/MineMail/mail.yml, saved automatically every storage.auto-save-interval minutes (default 5) plus once on clean shutdown.

Does MineMail cost anything to use?​

Only if the server enables it. economy.mailbox-creation-cost and economy.mail-send-cost both default to 0.0 (free), and require Vault plus an economy plugin to take effect at all.