Skip to main content

Troubleshooting & FAQ

Troubleshooting​

I can't create a mailbox​

Check that:

  • you left-clicked the barrel with a stick in your main hand, within 60 seconds (mailbox.creation-timeout-seconds) of running /minemail create <name>;
  • the block is a barrel, and isn't already a mailbox;
  • you don't already have a mailbox with that name;
  • you haven't reached your mailbox limit (mailbox.max-per-player, unlimited by default, or your minemail.limit.mailboxes.<n> rank node, plus any bought slots);
  • the name isn't longer than mailbox.max-name-length (default 32);
  • you can afford economy.mailbox-creation-cost, if one is set;
  • you have minemail.use.

My mailbox has no hologram​

Holograms are built in, so no other plugin is needed. Check mailbox.hologram.enabled in config.yml, and that the owner hasn't turned the hologram off in Manage Mailbox. Holograms only exist while the mailbox's chunk is loaded. If one looks stuck or duplicated, run /minemail cleanupholograms.

The mailbox is full​

A mailbox holds mail.max-per-mailbox letters (unlimited by default, -1), or more if its owner has a minemail.limit.capacity.<n> node. The node only applies while the owner is online. Sending to a full mailbox is refused before anything is taken from the sender; there's no queue.

I can't delete or break my mailbox​

A mailbox that still holds mail, read or unread, can't be broken, deleted with /minemail delete, or deleted from Manage Mailbox. Open it, collect or delete each letter, then try again.

I can't send mail to a player​

They must have joined the server at least once, and own at least one mailbox. You also can't compose from the directory for a mailbox you don't have access to; use /minemail send <player> instead.

I can't reply to a letter​

The sender needs at least one mailbox to reply to. Returned mail has no Reply button, and the read-only admin view has neither Reply nor Forward.

My inventory was full when I collected an item​

It dropped at your feet. Items are collected one per click.

A shared player can't take anything from my mailbox​

That's expected: sharing is view-only. To let someone collect mail, create a group, add them, and link the mailbox. See User Guide.

A player without minemail.mailbox.share added a viewer​

The Manage Access menu doesn't check minemail.mailbox.share; only the /minemail share and /minemail unshare commands do. This is a known gap. Revoking minemail.use doesn't close it, because menus don't check that node either.

Items or money went missing​

Run /minemail log <player> to see what happened. Deleted, expired, and returned mail can be restored with /minemail recover <entryId>. See Admin & Maintenance.

Config changes didn't apply​

Run /minemail reload. economy.enabled and storage.auto-save-interval need a restart, and hologram setting changes need /minemail cleanupholograms.

Custom icons or minemail.sounds don't do anything​

Those aren't implemented yet, even though the permissions exist.

FAQ​

Can anyone send mail to my mailbox?​

Yes. Sending needs no ownership or sharing. Any player can send mail to any mailbox on the server with /minemail send.

Can offline players receive mail?​

Yes, as long as they've joined the server before. They're told about new mail about two seconds after they next join, and anything held for them (returned mail, currency, read receipts) is delivered at the same time.

What can shared players and group members do?​

Shared players are view-only: they can read, but can't collect, delete, or mark mail read. Group members can read, collect, and delete mail. Group managers can also manage the mailbox and group, and only the owner can delete the mailbox. See Permissions.

What happens to expired mail?​

With mail.expiration.enabled, mail older than mail.expiration.days is returned to its sender with its items and currency, never deleted. Expiration is off by default.

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

Nothing. The setting isn't read; only YAML storage exists.

Can I set a description or custom icon for my mailbox?​

You can set a description from Manage Mailbox → Edit Description; it shows in the directory and at the top of the mailbox, and can span several lines. Custom icons aren't available yet.

Where is mail/mailbox data stored?​

In plugins/MineMail/: mailboxes.yml, mail.yml, groups.yml, players.yml, and the transaction logs in logs/. Changes are saved within a couple of seconds. See Admin & Maintenance.

Does MineMail cost anything to use?​

Only if the server sets costs. economy.mailbox-creation-cost and economy.mail-send-cost both default to 0.0, and extra slots are off by default. All costs need Vault and an economy plugin.

Can Bedrock players use MineMail?​

Yes, with Floodgate installed on the Paper server: every dialog (recipient, subject, message, currency, sort, filter, search, confirmations, choices) is sent to Bedrock players as a native form. Every menu button works with a plain click, so nothing needs a right-click. On a proxy network, Floodgate must be on each backend as well as the proxy; see Installation.