Wise Boxes

The first release of Wise Boxes, for Fabric (with Fabric API), Minecraft 26.1 – 26.3.

Labels like frames and signs:

• Label shulker boxes with any item in an anvil (1 level). The label item isn't used up: it stays in the anvil, so the same stack labels one box after another.
• Up to 4 labels per box, changed one per anvil use: an item not on the box is added, an item already on it removes its label (a plain item matches any label of its kind), and an empty right slot removes the last label. With an empty slot and a new name, the box is just renamed and keeps its labels.
• Labels show on the lid (side by side, two above one, or a 2 × 2 grid), rise and turn with the lid as it opens, and show on box items in the inventory, hotbar, hand, on the ground and in item frames. They stay on the box when it's broken, picked up, moved by pistons or blown up.
• Any item works as a label, including enchanted items (with glint) and filled maps (shown as their picture).
• Item frame tool: sneak + right-click a placed box with an item frame to change its labels without breaking it. The item in your other hand is added (or removed, if it's already a label); with the other hand empty, the last label is removed. Nothing is used up; it costs the same levels as the anvil, and the action bar says what changed.
• Glowing labels: sneak + right-click a labeled box with a glow ink sac and its labels glow in the dark, on the lid and on the box item. An ink sac removes the glow.
• Waxed boxes: sneak + right-click with honeycomb locks the labels, the glow and the color; renaming still works. An axe scrapes the wax off. Tooltips say "Waxed" and "Glowing labels".
• Barrel labels: barrels carry labels too, on their open face, in any direction, with everything above. Label a placed barrel with the item frame tool or a barrel item in the anvil.
• Lid view: inventory icons can turn their lid toward you (iconStyle: 3d, lid, large_lid). Hold Tab ("Swap Icon Style") to swap for a moment, or bind "Cycle Icon Style".
• Recolor placed shulker boxes by sneak + right-clicking with a dye (server owners can turn it off).

Labels that know what's inside:

• Fill gauge: a thin bar along the bottom edge of labeled boxes' lids, and a fill bar on shulker box items in slots, coloured like the bundle bar (red when full).
• Tooltips: "12/27 slots" and the labels ("Labels: Diamond, Stone") under the name.
• Automatic labels: a box without labels shows its most common item on the lid, smaller and dimmed so it never passes for a real label. It follows the contents.
• Find mode: a "Find Boxes" key (unbound by default). Press it holding an item, or over a slot in a container screen, and every box within 32 blocks labeled with that item gets an outline that shows through walls for 5 seconds. When the server has the mod, Find also asks it which boxes contain the item, so a box labeled "Ores" holding diamonds is found too.
• Match marks: while you carry an item in an inventory screen, shulker box items labeled with it get a gold frame in their slot, filled if the box already holds some.
• Placed boxes tell clients only how many slots are filled and their most common item, at most twice a second and only when it changes; never the items themselves. Server option shareContentsInfo turns it off.

Moving items:

• Transfer buttons: ↑ and ↓ on chests, barrels, ender chests, shulker boxes, hoppers, dispensers and droppers move everything into the container or into your inventory (not your hotbar, unless transferHotbar is on). With Shift, only what the target already has; an empty labeled box counts its labels. They use normal shift-clicks, so they work on any server.
• Smart pickup (off by default): items you pick up from the ground go straight into a box in your inventory labeled with them. Needs the mod on the server; server owners can turn it off.

Settings:

• A settings screen with every client option, opened from Mod Menu (optional).
• Client commands /wiseboxesc <option> [value] and /wiseboxesc reload; options in config/wiseboxes/client.json: iconStyle, labelDistance, contentsInfo (turns off every contents feature at once), fillGauge, itemFillBar, tooltipInfo, autoLabels, findRadius, findContents, matchMarks, transferButtons, transferHotbar, smartPickup.
• Server commands /wiseboxes config <option> [value] and /wiseboxes reload (operators); options in config/wiseboxes/server.json: dyeInWorld, labelCost, maxLabels, shareContentsInfo, barrelLabels, smartPickup.

Compatibility:

• Players without the mod can still join a server that has it, and a client with the mod keeps item labels, tooltips, match marks, transfer buttons and the lid view on servers without it.
• Labels from worlds made with the original Shulker+ (Minecraft 1.21) are read.
• Languages: English, Deutsch, Español (España), Español (México), Français, Português (Brasil), Português (Portugal).