3D menus
The shield designer and the shield picker drawn in the world in front of the player, how to make /shields open them, and how to place and restyle them.
Besides the inventory menus, ExyliaShields draws two menus in the world, on a stage a few blocks in front of the player: the 3D designer and the 3D shield picker. They are packets only — no resource pack, nothing placed in the world, and nobody else sees them.
| Menu | Opened by | What it is |
|---|---|---|
| 3D designer | /shields 3d, or EDIT / NEW SHIELD in the picker | The editor and the colour picker in one: the layers on one side, the dyes on the other, every pattern along the bottom as a small banner, and the shield in the middle wearing the draft. |
| 3D shield picker | /shields 3d slots, or /shields with menu.style: SPATIAL | Every saved shield on a plinth, the one looked at turning in the middle. EQUIP wears it, EDIT opens it in the designer, NEW SHIELD starts one on the first free slot, COMMUNITY opens the browser. |
The designer
Every click changes a draft, never the saved design:
- A pattern is laid on top as a new layer, in the paint colour; with a layer chosen it replaces that layer's pattern instead.
- A dye recolours the chosen layer, or the base.
- UNDO takes one click back, REVERT drops them all.
- SAVE writes the draft to the slot under the same rules as the inventory editor: a slot the player has, no more layers than their limit, and every new pattern and colour theirs.
A draft that uses a pattern or colour not unlocked yet reads BUY & SAVE with the total. The first click asks, the second pays at the shop's prices and saves. A part nobody sells blocks the save. A saved design is published to the community library as the inventory editor does.
Each menu shows a short guided tour the first time a player opens it. Sneaking leaves it.
Making /shields open them
menu:
style: CLASSIC| Value | What /shields opens |
|---|---|
CLASSIC | The inventory slot list. The default. |
SPATIAL | The 3D shield picker, whose EDIT and NEW SHIELD open the 3D designer. |
/shields 3d and /shields 3d slots open the 3D menus whatever menu.style says. The
API's openSlots follows menu.style like the command.
The 3D menus need a 1.21.4 or newer client. An older one gets the inventory menus instead: the slot list, or the editor on the slot it was opening. Nothing has to be configured for that.
Both menus need exyliashields.command.shields, like /shields.
Placing one in the world
A 3D menu can also stand fixed in a lobby, where players walk up to it:
/shieldsadmin spatial place designer # where you stand, facing the way you face
/shieldsadmin spatial place wardrobe # the picker
/shieldsadmin spatial remove # the one within 4 blocks of you/shieldsadmin spatial edit <designer|wardrobe> opens one for you to move its pieces with the mouse
wheel, and /shieldsadmin spatial tour <player> shows that player both tours again. See
Commands and permissions.
Files
| File | Contents |
|---|---|
spatial/designer.yml | The designer's layout: where every piece sits, its size, the stage distance and the theme. |
spatial/wardrobe.yml | The picker's layout. |
spatial/crate.yml | The 3D crate opening, written the first time it is used. |
Every word the menus draw is in lang/<code>/messages.yml, under designer and wardrobe, so a
translation restyles them without touching the layout. Coordinates are blocks on the board, a plane
anchor.distance ahead of the player's eyes; the comment at the top of each file draws the layout.
Something missing on this page? Tell us on Discord