FAQ
Common questions about installing, configuring, and running AT-MailBox.
Every answer is on this page (no dropdowns), so Ctrl+F finds anything. Each question has a number and a stable link, so docs/faq#q6 always points at the same question.
Jump to a question
| # | Question |
|---|---|
| Q1 | The plugin will not enable |
| Q2 | Do I need a database driver? |
| Q3 | Apply config changes without a restart |
| Q4 | Give a rank a bigger mailbox |
| Q5 | Add a custom capacity tier |
| Q6 | Crate or vote rewards land on the ground |
| Q7 | Limit the mailbox to /give only |
| Q8 | Does turning a trigger off delete items? |
| Q9 | What happens when the mailbox is also full |
| Q15 | Items on the ground vanished with a delivery (RoseStacker) |
| Q10 | Mailbox uses one slot per item |
| Q11 | Do items stay forever? |
| Q12 | Share one mailbox across a network |
| Q13 | Change or translate the messages |
| Q14 | Hex color support |
🔧 Setup
Q1 · The plugin will not enable. What is wrong?
AT-MailBox needs TheAPI. If TheAPI is missing, the server refuses to enable AT-MailBox and logs a clean error. Install TheAPI into plugins/ and restart. See Installation.
Q2 · Do I need to install a database driver?
No. TheAPI downloads the right JDBC driver for your chosen backend the first time it connects. Your machine needs internet access for that first download. See Storage.
Q3 · How do I apply config changes without a restart?
Run /mailbox admin reload. It reloads the config and language files and re-hooks PlaceholderAPI. See Commands.
📦 Capacity and ranks
Q4 · How do I give a rank a bigger mailbox?
Add or pick a tier in mailbox.pages.max-pages, then grant that rank the matching atmailbox.capacity.<name> permission. The player gets the highest tier they hold. See Capacity tiers.
Q5 · Can I add a tier that is not vip, mvp, or unlimited?
Yes. Tiers are not fixed. Add any name with a page count, for example elite: 10, and it grants atmailbox.capacity.elite. See Capacity tiers.
🎯 Capture and triggers
Q6 · Crate or vote rewards land on the ground instead of the mailbox. Why?
Check mailbox.capture-ground-drops first. It is the master switch for catching anything dropped at a full player's feet, and it must be true. When it is false, the mailbox ignores every ground drop before the mailbox.triggers switches are even read, so rewards fall on the floor even with plugin-rewards: true. It ships true, so the only way it is off is if someone set it by hand. Set it back to true and run /mailbox admin reload.
capture-ground-drops gates the whole capture path above every trigger. If it is false, plugin-rewards, commands, and pickup all do nothing. This is the first thing to check when capture seems dead. See Overflow capture.
If rewards still drop after the switch is on, the reward plugin may be flagging its item so no one but the owner can pick it up. Turn on general.debug and check the console to confirm before filing it as a bug.
Q7 · Can I limit the mailbox to /give only, so it does not catch normal farming?
Yes. Set mailbox.triggers.pickup to false and leave commands, plugin-rewards, and api on. Items a player farms or mines with a full inventory then drop on the ground exactly as vanilla does, while handouts from /give, crates, votes, and other plugins still land in the mailbox. This is the usual setup on servers that sell backpack space, so the mailbox does not compete with the backpack. See Configuration.
This covers crops handled by a farm-regen or harvester plugin as well, however that plugin hands the crop over and however late it arrives. On versions before 1.2.4 those were mistaken for a plugin handout and captured even with pickup: false, sometimes only part of a harvest; if you see that, update. Turn on general.debug to have the console name the trigger behind each captured item.
Q8 · Does turning a trigger off delete the items it used to catch?
No. A disabled source behaves as if AT-MailBox were not installed: the item stays on the ground, or is handled by the plugin that produced it. Nothing is removed.
Q9 · What happens when the mailbox is also full?
It depends on mailbox.full-overflow.drop-at-feet. If true, the item drops at the player's feet. If false, the item is rejected and the player is told. See Overflow capture.
Q15 · Items lying on the ground disappeared when a delivery landed. Do you support RoseStacker?
Yes, from 1.3.7, automatically and with nothing to configure. RoseStacker merges nearby dropped items into one pile with its own count, so a pile already on the floor could become part of the drop the mailbox was about to take, and go with it. The mailbox now holds a drop apart from its neighbours for the one tick it takes to decide on it, and releases it again as soon as it decides not to take it, so everything else on the server keeps stacking normally. Where a pile was merged before the mailbox saw it, only the amount handed to the player is taken and the rest stays on the ground. The startup log says RoseStacker: hooked when it is found. See Overflow capture.
💾 Storage and items
Q10 · Why does my mailbox use one slot per item?
It should not. mailbox.stack-similar-items (on by default) merges identical items into one slot, up to a normal stack size. Slots filled before the setting existed are not merged retroactively, but new deliveries stack into them.
Q11 · Do items stay forever?
Only if you turn expiry off. By default items expire after the number of days in mailbox.expiry.days, with warnings first. Set mailbox.expiry.enabled to false to keep items until claimed. See Item expiry.
Q12 · Can players share one mailbox across my network?
Yes. Point every server at the same MySQL or MariaDB database with the same table-prefix.
SQLite and H2 are single-file backends and cannot be shared. Use MYSQL or MARIADB for a shared network mailbox. See Storage.
🎨 Customization
Q13 · How do I change the messages or translate the plugin?
Edit the file in lang/ for your language, or set general.language to a new name and the plugin generates that file from the English defaults for you to translate. See Messages and language.
Q14 · Does it support hex colors?
Yes, in the &#rrggbb form, for example ,eebb. Legacy & codes also work. Hex needs a 1.16 or newer client. MiniMessage and a bare #rrggbb are not supported.
Still stuck? See Support.