🤺 UltMannequin

A cutting-edge practice dummy plugin for Paper 1.21+ servers.
GUI-first design • Zero dependencies • Performance optimized

Version Paper Java License

✨ Features

🎨 Visual & Customization

Full armor, weapon, and off-hand equipment rendering (totems only)
Potion effect particles for visual feedback
Custom loadout system per mannequin

⚔️ Combat Mechanics

Infinite health with real-time floating damage holograms
Accurate player-sized hitbox
Full support for macing , elytra combos, critical hits, enchantments, and potions

🎭 Totem of Undying

Store multiple totems inside the mannequin's inventory
Automatic consumption on killing blows with full animation & sounds
Totem usage tracked in statistics

🤖 AI Behaviors (All Toggleable)

AI	Description
Look-at-Player	Tracks and faces the nearest player

📊 Statistics Tracking

Total damage, hit count, average damage per hit, totems popped
Individual stat resets or full reset in one click

🖥️ GUI System

Six integrated menus — no commands needed after spawning:

Main Management (equipment + quick actions)
AI Settings
Statistics & Reset
Deletion Confirmation
Back Navigation

📥 Installation

Requirements

Paper 1.21+ (Spigot not officially supported)
Java 21+
No dependencies

Steps

Download `UltMannequin-1.0.0.jar`
Place it in your `/plugins/` folder
Restart the server
Run `/mannequin spawn` to create your first mannequin
(Optional) Edit `plugins/UltMannequin/config.yml` and run `/mannequin reload`

🔧 Commands & Permissions

Commands

Command	Description	Permission	Aliases
`/mannequin spawn`	Spawn a new mannequin at your location	`ultmannequin.spawn`	`/um spawn`, `/manne spawn`
`/mannequin removeall`	Remove all mannequins on the server	`ultmannequin.admin`	`/um removeall`, `/manne removeall`
`/mannequin reload`	Reload plugin configuration	`ultmannequin.admin`	`/um reload`, `/manne reload`

Permissions

Permission	Description	Default
`ultmannequin.spawn`	Allow spawning mannequins	All players (`true`)
`ultmannequin.admin`	Full admin access (includes spawn)	Operators only (`op`)

Permission Inheritance: `ultmannequin.admin` automatically includes `ultmannequin.spawn`

📊 Performance

Mannequins	RAM	CPU	TPS Impact
1	~4 KB	<0.1%	0
10	~40 KB	~0.3%	0
50	~200 KB	~1.2%	~0.1
100	~400 KB	~2.5%	~0.2

🖼️ GUI System

Main Management Right-click a mannequin to access equipment slots, AI settings, statistics, full inventory, and removal options.

AI Settings Toggle Look-at-Player behaviors with visual indicators showing enabled/disabled status.

Statistics & Reset View total damage, hit count, average damage, and totems popped. Reset individual stats or perform a full reset.

💡 Use Cases

PvP Training — Practice combos with realistic mechanics
Weapon Testing — Compare damage between different weapons and enchantments
Potion Testing — Test strength and weakness effects with before/after comparisons
Enchantment Comparison — Side-by-side damage testing with separate tracking
Arena Practice — Set up training stations with customizable difficulty levels

🐛 Troubleshooting

Issue	Solution
"Maximum mannequins reached"	Increase `max-mannequins-per-player` in config
Mannequin burns in daylight	Ensure Paper 1.21+ is used, then restart server
Damage hologram not showing	Set `damage-indicator.enabled: true` in config
Can't open GUI	Right-click with empty hand and verify you own the mannequin
Command not working	Check if you have `ultmannequin.spawn` or `ultmannequin.admin` permission

🤝 Support

💬 Discord: Join Discord
🐛 Bug Reports: Include server version, plugin version, reproduction steps, and logs

📄 License

*Developed by geturplugins — Special thanks to the Paper team for their excellent API.