🤺 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](https://discord.gg/xctckUQukB)
- 🐛 **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.
