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.

Anyone with soapsadmin.fakeplayer can manage any managed mannequin (shared staff/owner access). The owner:<uuid> tag records who spawned or first claimed it for list/audit only.

Commands

Command	Description
/sa fakeplayer <skin>	Spawn a mannequin with that Mojang skin / name at your feet and open the editor (chat menu if GUI is disabled)
/sa fakeplayer edit	Edit nearest managed mannequin within 10 blocks
/sa fakeplayer remove	Remove nearest managed mannequin within 10 blocks
/sa fakeplayer removeall	Remove all managed mannequins on the server (confirm / -confirm)
/sa fakeplayer list	List all managed mannequins (world, coords, spawned-by)
/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

Two-page Mannequin Editor (system-gui.yml → mannequin / mannequin-equip):

Area	Controls
Toggles	Glow, invisible, invulnerable, immovable, name visible, collidable, gravity, silent
Pose / placement	Body poses picker, Adjust Placement wand, Y up/down, look at me, move here, main-hand side
Appearance	Skin parts, Presets, set skin / name / subtitle (NPC line)
Equipment (page 2)	Helmet → offhand; left-click with item in hand to clone onto the mannequin; right-click to clear; Clear All Gear (shift = copy your gear); clone
Actions	Delete (shift-click), close

Info panel shows pose, yaw, coords, hand, flags, and subtitle.

Body poses

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

• Body Poses: pick any valid pose from a grid (includes fake Sit via an invisible seat stand)
• Pose picker / preset GUIs are code-driven (not YAML menus)

Adjust Placement wand

Closes the editor and gives a temporary blaze-rod tool:

• Click in the air or on a block to rotate (±15°); sneak+click raises/lowers
• Scroll strafes; F nudges forward (sneak+F back)
• Hotbar stays locked on the wand; Q finishes, strips the wand, and reopens the editor
• Session ends if you leave the world or move farther than ~12 blocks
• Fake sit is cleared while adjusting and restored when you finish

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). Name visibility uses the same stash logic as the editor toggle (Sleeping / Statue / Ghost hide correctly).

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 / Sitting	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 usually owner:<uuid>
• Ownership + fake-sit seat indexes rebuild on module enable; orphan empty seats are removed
• Untracked managed mannequins (missing owner tag) still appear in list and are claimed when a staffer edits them
• 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