InfiniteBags integration

When the InfiniteBags plugin is installed, each player gets a Mailbox Settings menu where they can choose to have incoming items skip the mailbox and go straight into their InfiniteBag. This is opt-in and set per player, so nothing changes until a player turns it on.

This whole feature is ignored unless the InfiniteBags plugin is on the server and infinitebags.enabled is true. Without it, the Settings button never appears and the mailbox behaves exactly as before.

Open /mailbox and click the Settings button on the bottom control row. The button only shows when InfiniteBags is available.

The two switches

Switch	When on
Auto-send existing types	An arriving item whose type is already in your bag goes straight to the bag instead of the mailbox.
Auto-send everything	Every arriving item your bag can hold goes straight to the bag.

Either switch routes items the moment they arrive, so a player with one of these on rarely needs Claim All. A player with both off uses the mailbox normally.

Flipping a switch also sweeps the mailbox

Flipping a switch (or pressing Refresh) does two things: it routes matching items as they arrive from then on, and it sweeps items already waiting in the mailbox into the bag under the same rule. So the backlog no longer sits there until the player claims it by hand; the moment a switch is flipped, everything it now covers moves to the bag and the player gets a "moved X item(s)" line. Items only move if the bag has a free slot for that type; anything it has no room for stays safely in the mailbox.

The Refresh button re-snapshots what is in the bag right now, locks it as the "already in bag" list, and runs the same sweep with the current switches. Use it after changing what is in the bag so the mailbox is re-checked against it.

When the bag is full

If the bag has no free slot for an item's type, the item stays safely in the mailbox and the player is told there was no room. Nothing is lost.

Items an admin delivers with /mailbox admin deliver always stay in the mailbox, even with the switches on, so the player sees what was sent before claiming it.

Pulling items out of the bag

When a player takes a stack out of their InfiniteBag while their inventory is full, the item drops on the ground. AT-MailBox leaves those drops alone instead of pulling them into the mailbox, so bag storage is never copied into mailbox storage. This needs InfiniteBags 1.2.1 or newer, which tags its own bag drops for AT-MailBox to recognise.

InfiniteBags' own auto-pickup cannot collect items while the inventory is full (the game only fires pickups when there is room). To auto-bag items on a full inventory, use the Mailbox Settings switches above and leave InfiniteBags' auto-pickup off.

Configuration

infinitebags:
  enabled: true
  defaults:
    auto-existing: false
    auto-all: false
  gui:
    settings-button-material: "COMPARATOR"
    auto-existing-material: "HOPPER"
    auto-all-material: "ENDER_CHEST"
    refresh-material: "CLOCK"
    back-material: "ARROW"

Key	What it does
`enabled`	Master switch. `false` hides the Settings button and never auto-sends.
`defaults.auto-existing`	Starting state of the first switch for a new player.
`defaults.auto-all`	Starting state of the second switch for a new player.
`gui.settings-button-material`	Material for the Settings button in the mailbox.
`gui.auto-existing-material`	Material for the first switch.
`gui.auto-all-material`	Material for the second switch.
`gui.refresh-material`	Material for the Refresh-bag-snapshot button.
`gui.back-material`	Material for the Back button.

Each button in the menu has its own sound under gui.sounds.settings (open, auto-existing, auto-all, refresh, back); leave one blank to silence it. Button names and lore come from the language file under gui.settings. See Messages and language.