⚔️ PlayerDummies
This plugin depends on Citizens.
⚠️ Early Development Notice
PlayerDummies is currently in early development.
While fully functional, you may encounter bugs or missing features.
If you do:
- Open an issue on GitHub or
- Join the Discord Server
Your feedback helps improve the plugin <3
Overview
PlayerDummies is a lightweight plugin that adds realistic combat training dummies to your Minecraft server.
Perfect for:
- PvP servers
- Practice arenas
- Damage testing zones
- Combat tutorials
- Minigame lobbies
PlayerDummies creates fully interactive Citizens NPCs that:
- Accurately simulate real player damage (including armor and enchantment reduction)
- Support all weapons, armor tiers, enchantments, and potions
- Provide real-time combat feedback in your action bar
- Never die or get knocked back
Train smarter. Test faster. Improve your combat.
Key Features
Realistic Combat Dummies
- Citizens NPCs simulate real player damage behaviour
- Supports all weapons, armor tiers (Leather → Netherite), enchantments, and potions
- Accurate critical hit detection, mace fall-damage bonus, and Strength potion tracking
- Projectile support — arrows, tridents, snowballs and more all register hits
Real-Time Damage Tracking
- Live display in your action bar (or chat, if configured):
Damage: 7.5 (3.8 ❤) - Shows both raw damage dealt and hearts lost after armor/enchantment reduction
- Reflects what you would actually deal to a fully-geared player
Full Customisation via GUI
- Shift + Right-click a dummy to open the Dummy Manager GUI
- Rename your dummy with custom colour codes
- Change the skin to any Minecraft username (Citizens integration)
- Equip any armor set through the dedicated Armor Editor — helmet, chestplate, leggings, boots
- Pick up your dummy from the same GUI
Persistent & Owner-Protected
- Dummies survive server restarts (saved per-UUID under
plugins/PlayerDummies/data/) - Only the placer can manage their dummy by default (configurable)
- Automatic orientation on placement — dummy faces you
Requirements
Required:
- Minecraft 1.18.2+
- Spigot or Paper
- Java 17+
- Citizens (required — plugin will not load without it)
Optional:
- PlaceholderAPI (for placeholder support)
How It Works
For Server Owners
Installation
- Place the JAR into your
plugins/folder - Install Citizens (required)
- Restart your server
- Configure settings in
plugins/PlayerDummies/config.yml
Configuration
Config files are in /plugins/PlayerDummies.
Permissions
All permissions default to op.
| Permission | Description |
|---|---|
playerdummies.give | Use /dummies give |
playerdummies.reload | Reload the plugin config and messages |
playerdummies.admin | Access admin commands: list, remove, info |
For Players
Step 1 — Get a Dummy
/dummies give <player> <amount>
You will receive a Player Dummy item (a player head) in your inventory.
Step 2 — Place It
- Hold the dummy item and right-click a block
- The dummy spawns on top of the block, automatically facing you
- One dummy item is consumed per placement
Step 3 — Manage via GUI
Shift + Right-click the dummy to open the Dummy Manager:
| Button | Action |
|---|---|
| 🏷️ Set Display Name | Click, then type a name in chat (supports & colour codes) |
| 🎭 Set Skin | Click, then type a Minecraft username in chat |
| 🛡️ Armor Editor | Opens a GUI to equip helmet, chestplate, leggings, and boots |
| 📦 Pick Up Dummy | Removes the dummy and returns the item to your inventory |
| ↩️ Back | Close the menu |
Inside the Armor Editor:
- Drag armor pieces into the four armor slots
- Shift-click armor from your inventory to auto-fill the correct slot
- Click Save Armor to apply changes to the dummy
- Closing without saving returns any items you placed back to your inventory
Step 4 — Test Damage
- Attack the dummy normally
- Your action bar shows:
Damage: X.X (X.X ❤)— actual damage dealt after accounting for the dummy's armor and enchantments - Test any weapon, enchantment, potion, critical hit, or projectile combination
- The dummy never dies or moves
Commands
| Command | Permission | Description |
|---|---|---|
/dummies give <player> <amount> | playerdummies.give | Give dummy items to a player |
/dummies reload | playerdummies.reload | Reload config and messages |
/dummies list | playerdummies.admin | List all saved dummies |
/dummies remove <uuid> | playerdummies.admin | Force-remove a dummy by its UUID |
/dummies info <uuid> | playerdummies.admin | Show details about a dummy (owner, location, type) |
Aliases:
/dummyand/dummiesboth work.
Use Cases
⚔️ PvP Practice Arenas
Train against a fully-geared dummy before entering competitive zones.
🔬 Damage Testing Labs
Optimise builds, enchantments, and potion combos with accurate feedback.
🎮 Minigame Lobbies
Keep players engaged while waiting for a game to start.
📚 Combat Tutorials
Teach new players mechanics in a safe, controlled environment.
API for Developers
An official API is currently in development.
Stay tuned for integration features.
Why Choose PlayerDummies?
- ✅ Lightweight & optimized
- ✅ Accurate armor & enchantment damage simulation
- ✅ GUI-based dummy management
- ✅ Built for modern Minecraft
- ✅ Persistent storage
- ✅ Simple and intuitive
Support & Updates
Found a bug?
Report it here:
https://github.com/PetarMc1/PlayerDummies/issues
Want a feature?
Suggest it in the Discord Server
Screenshots
Action Bar Damage Display
Custom Skins (Citizens Integration)
