How do I put an item icon on my shulker box?
Open an anvil, put the shulker box in the left slot and the item you want as the icon in the second slot. Then take the labeled box from the output slot, which costs one experience level.
How much XP does labeling a shulker box cost?
Applying an item label costs one experience level. If you have no levels, the anvil won't let you take the labeled box out of the output slot.
Can I use any item as a label or only certain ones?
You can use any item as the label. Pick whatever best represents the box's contents, like a cobblestone block for a building-materials box or a redstone dust for a redstone box.
Can I rename the shulker box and add the icon at the same time?
Yes. While the box and the label item are in the anvil, type the new name in the anvil's name field before taking the output. You get both the custom name and the item icon in one anvil use.
Why isn't anything showing up in the anvil output slot?
Check that the shulker box is in the first (left) slot and the label item is in the second slot, not the other way around. Also make sure you have at least one experience level to pay for it.
How do I change how the labels look?
Type /shulker-box-labels config in chat to open the in-game settings menu. From there you can switch between the display modes.
What's the difference between flat, standard, 3D and isometric modes?
Flat and standard control how labeled boxes appear in your inventory menus and hotbar. 3D and isometric are the display angles for placed shulker boxes in the world and boxes you're holding.
Can I see the label on a shulker box after I place it down?
Yes. The item icon shows on the outside of placed shulker boxes, so you can read a whole storage wall without opening anything. Use the config menu to choose between the 3D and isometric look for placed boxes.
Does the icon change automatically based on what's inside the box?
No. The icon is the item you applied in the anvil, so it stays the same even if you swap out the contents. If you repurpose a box, label it again with a fitting item so your storage stays readable.
Does this work on servers, and can friends without the mod still join?
It works on multiplayer servers and is designed to stay friendly for vanilla clients, so players without the mod can still play there. Only players with the mod installed get the visual label displays.