Configuring

The 3D selector

The centre stage in the world: browse, try, buy and wear effects without an inventory window.

The 3D selector is the same catalogue as the menu, drawn in the world in front of the player instead of in a chest. The categories run along the top, the effects on an arc at eye level, and the one being tried plays as a miniature on a mannequin in the middle. Owning, wearing and buying go through the same code as the inventory menu, so the two screens never disagree about what a player has.

Opening it

How	What opens
`/killeffect 3d` (alias `showroom`)	Always the 3D selector.
`/killeffect classic`	Always the inventory menu.
`/killeffect`	Whichever `menu.style` in `config.yml` names: `CLASSIC` (default) or `SPATIAL`. The API's `openMenu` and `/killeffectsadmin menu open` follow the same setting.
A placed spot	`/killeffectsadmin spatial place` leaves a small clickable hologram where you stand. Clicking it walks the player onto the spot and opens the selector there, facing the way the spot faces. Spots are kept in `spatial/spots.yml`.

Every way in asks for exyliakilleffect.command.killeffect, and on a weapon server it answers menu-disabled exactly as the inventory menu does.

Older clients get the classic menu

Drawing it needs a 1.21.4 client or newer. A player on an older client who asks for the 3D selector is shown the inventory menu instead, with nothing to configure.

Using it

Piece	What it does
Tabs	The categories, as plain words. The mouse wheel steps through them.
The arc	Four effects either side of the preview. The wheel or the arrows turn it a page; owned effects come first.
Looking at an effect	Its name, rarity and status show above the arc, and its description once the crosshair rests on it.
Clicking an effect	Tries it: it plays on the mannequin as a draft, nothing is worn yet.
The primary button	EQUIP wears the effect being tried. On a locked effect the shop sells it reads BUY · price, then CONFIRM · price for the second click that pays. Otherwise LOCKED.
The icons	Favourite, unequip, revert the draft, random choice, replay, crate, the guided tour again, and leave. The words of the one looked at show under it.

Closing on an effect that was tried but not saved drops it, and the player is told so. The first time a player opens the selector a short guided tour points out the arc, the preview, the primary button and the icons; the ? icon shows it again, and /killeffectsadmin spatial tour <player> makes it show on their next open.

The same permissions apply as in the inventory menu: the crate icon needs exyliakilleffect.crate, random needs exyliakilleffect.random, a new star needs exyliakilleffect.favourites, and a price is only shown to a player holding exyliakilleffect.buy. Without exyliakilleffect.preview clicking an effect still picks it, but the mannequin stays still. A locked effect is marked with a cross (✘); the padlock used before 1.9.1 has no glyph in the vanilla font and drew as a box. Locked lines under spatial.stage still as shipped are changed on update, edited ones are left alone.

The layout

Where every piece stands is spatial/effects.yml; every word it draws is under spatial in lang/<code>/messages.yml. Coordinates are blocks on a board standing anchor.distance (4.5) in front of the player's eyes, and every line is drawn at least as large as theme.min-glyph-degrees reads from there.

Block	What it sets
`anchor`	How far ahead the board stands and how high it is lifted, so its lowest piece stays above the floor.
`theme`	Text sizes, the page arrows, the locked and equipped markers.
`panels`	The tabs, the title, the description, the primary button, the icon row and the hint line.
`preview`	The mannequin: its size, `effect-scale` (`0.44`), the skins it wears (`[others, defaults]`) and `effect-facing`.
`carousel`	The arc: how many effects, their spacing and curve.
`intro`	The guided tour's steps.
`backdrop`	The soft dark backdrop behind the board, so it reads on sky and ground alike.

Pieces are moved in game rather than by hand: /killeffectsadmin spatial edit opens the selector for an admin to aim at a piece, click it and move it with the mouse wheel.

The side an effect is seen from

preview.effect-facing: AUTO watches an effect's first play and turns it so its motion runs across the view, never showing the victim's back. One effect can override it in effects.yml:

effects.yml

kill_effects:
  GRIDDY:
    preview-facing: SIDE   # AUTO, FRONT, SIDE or degrees

Admin commands

Command	What it does
`spatial place`	Sets a 3D selector down where you stand, facing the way you face.
`spatial remove`	Removes the placed selector nearest you, up to four blocks away.
`spatial edit`	Opens the selector to move its pieces.
`spatial tour <player>`	Shows the guided tour to a player again on their next open.

All under /killeffectsadmin, so all need exyliakilleffect.admin.

The crate has a 3D opening too

crate.opening: SPATIAL plays the crate in the world in front of the player. See The crate.

Something missing on this page? Tell us on Discord