Skip to content

FAQ

The Mannequin button doesn't show

  • plugins/BoxStand/mannequins/ is empty. BoxStand creates it empty, so copy the files from a version folder, see Getting Started.
  • ModelEngine isn't installed.
  • The player isn't allowed any mannequin. Check require-permission in each mannequin file and any permission: on its variants.

I picked a model but nothing appears on the stand

ModelEngine has no model with the model: id from the mannequin file. Import the bundled blueprints and run /meg reload.

A pose plays and then snaps back

The animation is set to Play Once in Blockbench. Set it to Loop, see Loop and override.

A preset pose is missing from the pose page

The pose has a permission: the player doesn't have. See Locking a pose.

The pose looks different on another model

A pose is saved on the stand as angles, not on the model. Each model applies those angles on top of its own rest pose, so the same pose can look different.

Punching a stand does nothing

  • The stand is locked. The action bar says so. Sneak + right-click to open the GUI and unlock it.
  • Visible is off. Hidden stands can't be punched.

The stand won't break when I punch the model

Punch inside the model's hitbox, which F3+B shows. Parts of the model that reach outside that box can't be punched.

Items on the stand disappeared

  • A mannequin doesn't draw items in slots it has no use for. They are still stored, and come back when the model is removed.
  • While Arms is off, held items are hidden too, unless show-hands is on.

Turning Visible off removed my mannequin

It didn't. The model, pose and items are all still there, and show again when Visible is turned on.

Bedrock players see a different pose

Bedrock can't show custom poses on a model. Bedrock players see the model frozen on the first frame of its preset pose, or of its idle animation.

The pose sidebar replaced my scoreboard

BoxStand only uses the sidebar while a player is posing. Turn it off with pose.sidebar: false.

Custom GUI icons don't show

  • BoxStand uses vanilla items until you install the version folder for your item plugin. See Getting Started.
  • The gui.yml and mannequins/ must come from the same version folder as the plugin content. A nexo: id on an ItemsAdder server shows the vanilla fallback, and so does an ItemsAdder id written without itemsadder:. See Item ids.
  • After copying the files, run your item plugin's reload command so the icons are in its resource pack.

A player can't open the GUI

  • gui.require-permission is on, and they don't have boxstand.use.
  • The stand is locked with lock.personal on, and they didn't lock it.
  • Another player already has that stand's GUI open.

Where does a stand's default pose come from?

From the first frame of the model's idle animation, set by pose.default-animation. A stand without that animation uses the angles under pose.default.

Does BoxStand work without the optional plugins?

Yes. Only Paper and PacketEvents are required. ModelEngine adds mannequins and model balloons. ItemsAdder, Nexo, Oraxen or CraftEngine adds custom icons.

Why is PacketEvents required?

Backpacks, balloons, leads and outlines are sent straight to each player instead of being spawned as entities, see Drawn per viewer. That needs PacketEvents, so BoxStand won't start without it.

Can I stop players opening stands in one area?

Yes, with a region plugin such as WorldGuard. When the region blocks interacting, BoxStand does nothing there, including clicks on arms past the hitbox. To limit features by player instead of by area, use Permissions.