The mailbox GUI
How players open their mailbox and claim items, one at a time or all at once.
Players claim their stored items from a chest GUI. They open it with /mailbox,
then click to take items back into their inventory.
Opening the mailbox
Run /mailbox (or the alias /mb). The menu shows the player's stored items, with
controls along the bottom row.
The layout
The GUI height is 3 or 6 rows, set by gui.rows. The bottom row is reserved for
controls, so the rows above it hold items.
| Control | Where | What it does |
|---|---|---|
| Item | Top area | Left-click an item to claim that one item. |
| Claim All | Bottom row, centre | Claims as many items as will fit in your inventory. |
| Previous Page | Bottom row, left | Goes back a page (shown when there is one). |
| Next Page | Bottom row, right | Goes forward a page (shown when there is one). |
Each item shows the date it was received in its lore. Items close to expiring also show how much time is left.
Claiming items
- One item: left-click it. It moves into your inventory and the menu refreshes.
- Everything: click Claim All. Items are added until your inventory is full.
If your inventory fills up partway through Claim All, the rest stays in the mailbox and you are told how many items are left. A stack that only partly fits is split: you get what fits and the mailbox keeps exactly the remainder, so claiming 32 of a 40 stack leaves 8 behind.
If your inventory is full when you try to claim, the item stays in the mailbox and you get a message. Make room first.
Pages and capacity
The number of pages a player can use comes from their capacity tier. A higher rank gets more pages. See Capacity tiers.
Look and sound
The filler item, sounds, and Claim All count are all configurable:
| Setting | Controls |
|---|---|
gui.rows | Menu height, 3 or 6 rows. |
gui.fill-empty | Fill unused slots with a filler item. |
gui.filler-material | The filler material. |
gui.claim-all-count-mode | What Claim All counts: slots, items, or both (default). |
gui.sounds.open | Sound when the menu opens. |
gui.sounds.claim-one | Sound when claiming one item. |
gui.sounds.claim-all | Sound when claiming all items. |
gui.sounds.page-turn | Sound when changing pages. |
gui.sounds.settings.open | Sound when the Settings menu opens. |
gui.sounds.settings.notify | Sound when the login-notification button is cycled. |
gui.sounds.settings.auto-existing | Sound when the first switch is flipped. |
gui.sounds.settings.auto-all | Sound when the second switch is flipped. |
gui.sounds.settings.refresh | Sound when the Refresh-bag-snapshot button is clicked. |
gui.sounds.settings.back | Sound when the Back button is clicked. |
The menu title (gui.title) and the button names and lore come from the language
file. See Messages and language.
Wording of the Claim All count
gui.claim-all-count-mode picks which numbers are shown; the language file picks
the words around them. The {count} placeholder in gui.claim-all-button.lore is
filled from one of three format keys, matching the mode:
gui:
claim-all-button:
count-slots: "{slots}"
count-items: "{items}"
count-both: "{slots} &7slots used for &f{items} &7items"{slots} is how many mailbox slots are occupied (one per stack) and {items} is
the total item amount across all of them, so both reads as
116 slots used for 1050 items. Both placeholders also work directly in
gui.claim-all-button.lore if you would rather split them over separate lines.