Skip to main content

Admin & Maintenance

MineMail's admin tools are gated behind the minemail.admin permission (op by default).

Reloading Configuration​

/minemail reload

Reloads config.yml and messages.yml from disk without restarting the server. Use this after editing either file. Requires minemail.admin.

Cleaning Up Holograms​

/minemail cleanupholograms

Removes every MineMail hologram currently tracked, then recreates exactly one per existing mailbox. Use this if you see:

  • Duplicate holograms above a mailbox (can happen after certain restarts or DecentHolograms hiccups).
  • Orphaned holograms left behind after a mailbox was removed some other way.
  • Missing holograms that should be showing but aren't.

Requires minemail.admin and DecentHolograms installed - if DecentHolograms isn't present, holograms (and this command's effect) are disabled entirely, with a warning logged at startup.

Removing a Player's Mailbox​

Admins with minemail.admin can break any player's mailbox barrel, bypassing the normal owner-only restriction. As with owner-initiated breaking, if the mailbox still contains mail, the break is blocked to prevent accidental data loss - the mail must be emptied (or the mailbox deleted via /minemail delete, which does not have this guard) first.

caution

Deleting a mailbox via /minemail delete <name> (owner-only) or the in-GUI "Delete Mailbox" button in Manage Mailbox does not check whether the mailbox still has mail in it. Only breaking the barrel in-world has that protection. If you're clearing out a banned or inactive player's mailbox, breaking the barrel in-world (as an admin) is the safer option, since it still blocks deletion while mail is present.

Operational Notes​

  • Storage - MineMail persists everything as flatfile YAML: plugins/MineMail/mailboxes.yml and plugins/MineMail/mail.yml. There is no database backend yet (see Configuration).
  • Auto-save - data saves automatically every storage.auto-save-interval minutes (default 5), plus a synchronous save on clean shutdown. A crash between auto-saves can lose up to that interval's worth of changes.
  • Economy - mailbox creation and mail sending costs require Vault and a registered economy plugin. Without either, all costs are effectively waived.
  • Unfinished features - mail groups, mail expiration, and per-mailbox custom icons/particles are present in config and permissions but not yet functional. Don't advertise these to players; see Configuration for the full list.
  • GUI sharing bypass - the in-GUI "Manage Access" add/remove buttons don't check minemail.mailbox.share, only the /minemail share//minemail unshare commands do. See Permissions.

Maintenance Checklist​

TaskHow
Apply config/messages changes/minemail reload
Fix duplicate/missing/orphaned holograms/minemail cleanupholograms
Remove another player's mailboxBreak its barrel as an admin (bypasses the owner-only check; still blocked if the mailbox has mail)
Back up mail dataCopy plugins/MineMail/mailboxes.yml and plugins/MineMail/mail.yml (server stopped, or accept up to auto-save-interval minutes of drift)