UltMannequin

🤺 UltMannequin

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

---

✨ 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:

1. Main Management (equipment + quick actions)
2. AI Settings
3. Statistics & Reset
4. Deletion Confirmation
5. Back Navigation

---

📥 Installation

Requirements

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

Steps

1. Download `UltMannequin-1.0.0.jar`
2. Place it in your `/plugins/` folder
3. Restart the server
4. Run `/mannequin spawn` to create your first mannequin
5. (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

Copyright © 2026 geturplugins — All Rights Reserved.

---

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