FAQ

The mannequin button doesn't show

ModelEngine isn't installed, or it has no blueprint matching the model: id in the kind file. Import the bundled blueprints and run /meg reload.

A pose plays and immediately snaps back

The animation is set to Play Once in Blockbench. ModelEngine drops it when it ends and the model falls back to idle. Set it to Loop.

A preset pose is missing from the pose page

That variant has no pose: block, or the animation it names is not in the model. A variant with template: borrows the template's poses only while it writes none of its own.

The pose looks different on another model

The pose belongs to the stand, not the model, and carries over as angles. Each model lays them over its own rest pose, so a different stance reads them differently.

Punching a stand does nothing

It is locked. The action bar says so. Unlock it from the GUI, or use boxstand.lock.bypass.

The stand won't break when I aim at the model

Breaking asks for the stand's own hitbox, which is the armor stand inside the model rather than the model's shape. Aim at the middle of the stand.

Items I put on the stand disappeared

A mannequin hides the slots it cannot use, and anything in one is stored on the stand instead of worn. It comes back the moment the model is removed or the slot is visible again.

The stand is hidden but I want to find it

Sneak. Markers appear within the radius set under sneak in config.yml. Blacklisted worlds show nothing - /boxstand bypass <player> turns them on for one player there.

Turning Visible off removed my mannequin

It doesn't. The model, the pose and the stored items all stay on the stand and come back when Visible is on again.

Backpacks and balloons flicker, or get pushed around

Without PacketEvents they are real entities, so a sweep or a shove can reach them - they rebuild within a tick or two, so it reads as a flicker. See everything it changes.

Bedrock players see a different pose

Bedrock cannot follow a custom pose on a modelled stand - armour would drift off the model. Those players see the model's idle held still; Java sees the real pose.

The pose sidebar took over my scoreboard

It borrows the slot only while a player is posing and hands it back after. Turn it off with pose.sidebar: false in config.yml.

Custom GUI icons don't show

Ids like boxstand:pose need Nexo or ItemsAdder with the bundled content installed. Without them the plain material behind each id is used.

A player cannot open the GUI

gui.require-permission is on and they do not have boxstand.use. The same pattern applies to every button and slot - see Permissions.

Where did the stand's default pose come from?

The first frame of the model's idle animation, named by pose.default-animation in config.yml. With no such animation, the degrees under pose.default are used.

Does BoxStand work without any of the optional plugins?

Yes, on a bare Paper server. Mannequins need ModelEngine; everything else is optional and only changes how things are drawn.

Can I stop players opening stands in one area?

Yes, with a region plugin - nothing to set in BoxStand. It reads the interact event after them, so cancelled means no menu. In WorldGuard that is the interact flag.

Permissions are the other half. boxstand.use gates the menu everywhere, and each button has a permission of its own - see Permissions.