Fake Players / Mannequins

Paper-only display entities for lobbies, shops, and set dressing. Module: fake-players in modules.yml. Permission: soapsadmin.fakeplayer.

Spigot servers do not load mannequin tools.

Commands

Command	Description
/sa fakeplayer <skin>	Spawn a mannequin with that Mojang skin / name at your feet and open the editor
/sa fakeplayer edit	Edit nearest managed mannequin within 10 blocks
/sa fakeplayer remove	Remove nearest mannequin you own within 10 blocks
/sa fakeplayer removeall	Remove all of your mannequins (confirm / -confirm)
/sa fakeplayer list	List your tracked mannequins
/sa fakeplayer pose	Cycle body pose on nearest managed mannequin
/sa fakeplayer rotate	Rotate nearest +45°
/sa fakeplayer glow	Toggle glow
/sa fakeplayer namevisible	Toggle name visibility

Aliases via custom commands may expose /fakeplayer if registered.

Right-click a managed mannequin (staff with permission) to open the editor.

Editor GUI

Six-row Mannequin Editor (system-gui.yml → mannequin):

Area	Controls
Toggles	Glow, invisible, invulnerable, immovable, name visible, collidable, gravity, silent
Pose / placement	Cycle pose, body-pose picker, rotate ±45°, fine rotate ±15°, look at me, move here, main-hand side
Appearance	Skin parts, Presets, set skin / name / description
Equipment	Helmet → offhand; left-click with item in hand to clone onto the mannequin; right-click to clear; Clear All Gear
Actions	Delete, close

Info panel shows pose, yaw, hand, invisible, glowing, and description.

Body poses

Paper Mannequin supports body poses only (Mannequin.validPoses() / setPose). There are no per-limb angles.

• Cycle Pose — left/right cycles valid poses; shift-click opens the picker
• Body Poses — pick any valid pose from a grid

Presets (role kits)

Presets apply pose + flags + description + a full equipment loadout. Selecting a preset replaces all six equipment slots (empty kit slots clear leftover gear).

Preset	Gear summary
Guard	Full iron armor + iron sword
Archer	Chainmail + bow + arrow
Miner	Iron pickaxe + iron helm/boots
Knight	Full diamond + sword + shield
Shopkeeper	Leather tunic + emerald; name visible
Fisher	Fishing rod + leather pants/boots
Farmer	Leather armor + hoe + wheat
Sleeping / Sneaking / Swimming / Flying	Matching body pose (+ gear where listed)
Statue / Glowing NPC / Ghost	Flag-focused (Ghost stays invisible on purpose)

Persistence

• Mannequins are persistent entities tagged soapsadmin_fakeplayer and owner:<uuid>
• Ownership index rebuilds on module enable
• Disabling the module clears the in-memory index only — entities stay in the world

Related

• Item Editor for display items before equipping
• Commands: Staff
• Modules → fake-players
• Integrations — Paper requirement