AT-MailBox | Never Lose Items Again v1.3.7

🔢 Claim All Shows Both Numbers

The Claim All button can now show the slot count and the item total together, so instead of just Pending: 116 a player reads Pending: 116 slots used for 1050 items.

gui.claim-all-count-mode picks which: slots, items, or both. It ships as both, so you get the new line without changing anything.

The wording is yours. Your language file has a line per mode under the Claim All button, and the button picks the one matching your setting:

gui:
  claim-all-button:
    count-slots: "{slots}"
    count-items: "{items}"
    count-both: "{slots} &7slots used for &f{items} &7items"

{slots} is the number of filled mailbox slots and {items} is the total item count. Put whatever text, spacing and colours you like around them, and both work in the button's lore lines too if you would rather split them across two lines. The French and Spanish files ship already translated.

The numbers count the whole mailbox, not just the page you are looking at.

📥 Command Overflow Reaches the Mailbox

Giving a player more items than their inventory can hold should send the remainder to their mailbox. On newer server versions that had stopped working properly, and two separate things were going wrong.

• Most of a large delivery was being left on the floor. Newer server versions report command overflow the same way they report a player throwing something away, and the mailbox deliberately never takes an item you threw yourself. It now tells the two apart correctly, so overflow reaches the mailbox and a real throw is still left alone
• Single stray items appeared in the mailbox. The game briefly drops an invisible one-count copy of an item purely to play the pickup animation. That copy is now recognised and ignored again on newer versions
• A full inventory is measured correctly on servers that change how many items fit in a stack

🧺 Your Ground Items Stay Yours

Items already lying on the floor could be swept into a mailbox alongside an incoming delivery, because the game merges nearby items into one pile and the mailbox then took the lot.

That is fixed in both directions. The mailbox now takes only the amount that was actually handed over and puts anything that merged in back on the floor, and a pile that merged before it looked gets a second glance rather than being pulled in whole.

🌹 RoseStacker Support

RoseStacker groups items lying close together into one pile with its own count, which the mailbox could not see. A delivery landing next to items already on the floor became a single pile, so the mailbox took the player's own items with it, and on a large pile could throw part of it away.

• Nothing is folded into a delivery while the mailbox is deciding on it, and the item goes straight back to normal the moment it decides not to take it
• A pile that was already grouped is read at its real count, so the mailbox takes only what was given and shrinks the pile by that much rather than removing it
• Nothing to configure. The console says RoseStacker: hooked on startup when it is found

🔍 Better Debug Logging

With general.debug turned on, every item that appears near a player is now logged, along with what the mailbox decided to do with it and why. A burst of items ends with a single summary line carrying the totals, so you can see at a glance how many items appeared, how many reached the mailbox and how many were deliberately left alone.

It says so plainly when a drop was refused by another plugin, when items went into the inventory instead, and when they landed too far away to count.

It is noisy on purpose and logs ordinary drops around a player too, so leave it off unless you are chasing something.

📦 Install

Stop the server, replace the old jar in plugins/, and start it again. Your mailbox contents, your config and your language files all carry over untouched.

📋 Version Breakdown

📦 Crate Keys & Plugin Rewards Now Reach the Mailbox

Crate keys, vote rewards, and other plugin payouts handed to a full player used to drop on the ground and stay there, even with plugin-rewards: true. They now land in the mailbox the moment they appear, before they can fall or another player can grab them. /give overflow, farming, and API deliveries were unaffected and behave the same.

🌾 Farming Is Now Properly Separated

On servers using a farm or harvester plugin, carrots and other crops used to slip into the mailbox even with pickup: false, because the plugin hands crops over at the player instead of at the crop, sometimes a second later, so the drop looked like a reward from another plugin.

The classifier is much smarter now:

• It looks at what the item is, not just when and where it lands. While you break blocks it remembers what those blocks yield, so a carrot dropped on you counts as farming no matter how it was handed over
• Covers everything: chopping, mining, right-click harvests (berries, hives), leaf drops, TNT and creeper explosions, and mob kills all count as farming
• The first block of a harvest is now handled correctly, previously the first crop could slip through where the rest didn't
• Crate keys and rewards are safe to claim while farming: a key is never mistaken for a crop, so it always reaches the mailbox

💡 Master Switch Reminder

mailbox.capture-ground-drops is the master switch above mailbox.triggers. If it's false, none of the triggers do anything. It ships true and always has, if you turned it off by hand long ago, turn it back on to let the mailbox catch anything at all. This is now documented in the config, the Overflow Capture docs page, and the FAQ.

📝 Heads Up

If a plugin ever hands you a reward that happens to be the same item you're farming (a bonus carrot from a crate while farming carrots), it follows the farming setting and stays on the ground. Nothing else overlaps.

📦 Install

Replace the old jar in plugins/ with AT-MailBox-1.2.4.jar and restart. Your config, language files, and stored mailbox items carry over unchanged.

If your mailbox seems to catch nothing after installing, check that mailbox.capture-ground-drops is true in config.yml.

📋 Version Breakdown

🐛 Duplication Fixed

Clicking Claim All when you had room for only part of what was waiting used to hand you the fitting part but leave the whole stack marked unclaimed, so those items existed twice. Claiming now takes exactly what fits and leaves exactly the rest: claim 32 of 40 potatoes and the mailbox is left holding 8, not 40. The same fix applies when left-clicking a single item to claim it.

📦 Items Now Stack

Deliveries used to take a fresh slot each, so farming with a full inventory filled the mailbox one potato per slot. Deliveries of the same item now stack up to a full stack in the slot that's already there, and only spill into a new slot when that one fills.

• Items that expire and items that never expire stay in separate slots
• When two stacks merge, the slot keeps the earlier of the two expiry times, so nothing gets a longer life by being merged into
• Prefer one slot per delivery? Set mailbox.stack-similar-items: false

Mailbox slots that already hold single items from before this update aren't merged retroactively. New deliveries will stack into them.

🎛 New: Trigger Switches

A new mailbox.triggers block in config.yml lets you turn each source of items on or off individually:

• pickup normal gameplay: farming, mining, mob loot, walking over items with a full inventory
• commands overflow from a command run on the player: /give, /giveall, event handouts
• plugin-rewards items other plugins hand out: crates, votes, quests, kits
• api other plugins delivering through AT-MailBox directly

Turning one off means those items behave as if AT-MailBox weren't installed at all, they stay on the ground, or are handled by whatever plugin produced them. Nothing is deleted.

Common setup: want the mailbox only for handouts, so it never interferes with farming? Set pickup: false and leave the other three on. Your bag keeps its value, and admin/plugin drops still land safely.

All four triggers default to true, so a server that changes nothing behaves exactly as 1.1.0 did, minus the two bugs. /mailbox admin deliver always reaches the mailbox regardless, so you can always hand an item on purpose. The existing capture-ground-drops remains the master switch for anything landing on the ground.

📦 Install

1. Replace AT-MailBox-1.1.0.jar in plugins/ with AT-MailBox-1.2.0.jar and restart.
2. The new mailbox.triggers block is added to your config automatically on first start. Set pickup: false if you want the mailbox for handouts only, then reload.

Your config, language files, and stored mailbox items carry over unchanged.

latest