AT-MailBox logoAT-MailBox

Overflow capture

How items a player cannot pick up with a full inventory are saved to the mailbox instead of dropping.

When a player walks over an item but their inventory has no room for it, that item normally stays on the ground and despawns. AT-MailBox catches that case and stores the item in the player's mailbox instead, so nothing is lost.

How it works

  1. A player picks up an item.
  2. AT-MailBox checks if there is room: a free slot, or a matching stack that is not yet full.
  3. If there is room, the pickup happens as normal.
  4. If there is no room, the pickup is cancelled and the item is moved to the player's mailbox.
  5. The player gets a message telling them the item went to their mailbox.

This covers both vanilla item drops and items dropped by other plugins.

When a large amount arrives split across many stacks at once (for example a big /give into a full inventory, which the server hands over as many 64-item drops), the chat lines are combined into one summary per item type, like "5000x Grass Block has been sent to your mailbox", instead of one line per stack.

When the mailbox is also full

If the mailbox itself is at capacity, the mailbox.full-overflow.drop-at-feet setting decides what happens:

SettingResult
true (default)The item is dropped at the player's feet.
falseThe item is rejected and the player is told. The item is not stored.

Capacity is set per rank through tiers. A higher rank can hold more before the mailbox is full. See Capacity tiers.

  • mailbox.full-overflow.drop-at-feet decides the full-mailbox behaviour.
  • Capacity comes from Capacity tiers.
  • Stored items can expire. See Item expiry.

See the full file on the Configuration page.

On this page