# PlayerDummies *Advanced Combat Training Dummies for Your Minecraft Server* ![https://img.shields.io/badge/Minecraft-1.18.2+-green](https://img.shields.io/badge/Minecraft-1.18.2+-green) [![https://img.shields.io/discord/1475583552564363274?logo=discord&logoColor=blue&label=Discord](https://img.shields.io/discord/1475583552564363274?logo=discord&logoColor=blue&label=Discord)](https://discord.gg/vb263hmspq) [![https://img.shields.io/github/issues/PetarMc1/PlayerDummies?label=GitHub%20Issues](https://img.shields.io/github/issues/PetarMc1/PlayerDummies?label=GitHub%20Issues)](https://github.com/petarmc1/playerdummies/issues) THIS PLUGIN DEPENDS ON THE [CITIZENS](https://www.spigotmc.org/resources/citizens.13811/) PLUGIN ## **⚠️ Early Development Notice** PlayerDummies is currently in early development. While fully functional, you may encounter bugs or missing features. If you encounter bugs: • Open an issue on [GitHub](https://github.com/petarmc1/playerdummies/issues) • Or join the [Discord Server](https://discord.gg/vb263hmspq) 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 ## **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 directly from the 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** **1. Installation** * Place the JAR into your plugins/ folder * Install **Citizens** (required) * Restart your server * Configure settings in plugins/PlayerDummies/config.yml **2. Configuration**

config.yml

``` # PlayerDummies configuration # # This file uses top-level keys for clarity. Each option includes a short # description above it — change values as needed and reload with # "/dummies reload". ####################################################################### # Item / gameplay ####################################################################### item: # Material of the item you get when using /dummies give or picking up a dummy. # Use any valid Bukkit material name (e.g. PLAYER_HEAD, STICK). material: PLAYER_HEAD removal: # Require the player to be sneaking (shift) when right-clicking the NPC to pick it up. require-sneak: true notifications: # Number of decimal places to show for damage values in messages/action bar. precision: 1 ####################################################################### # NPC / Skin / Name settings ####################################################################### # Display name shown above dummy NPCs. Supports color codes (&). # Example: "&ePlayer Dummy" -> yellow name "Player Dummy". npc-name: "&ePlayer Dummy" # Whether the NPC's name is visible above their head. # For Citizens the name appears like a real player nametag. npc-name-visible: true # Default Minecraft username / skin identifier used by NPC plugins. # Leave empty for no specific skin. Works only with Citizens. # Example: npc-skin: "Notch" npc-skin: "P3tar_mc" ####################################################################### # Messaging, debug, permissions ####################################################################### # If true the plugin will send messages to chat instead of # the action bar when reporting damages. use-chat-for-messages: false # Enable verbose debug logging to console (developer use) debug: false # Debug level: 1 = normal debug, 2 = verbose / development-only # Setting this to 2 will enable extra logs intended for development. # DO NOT TURN THIS ON UNLESS YOU ARE A DEVELOPER OR HAVE BEEN ASKED TO BY THE AUTHOR, AS IT WILL GENERATE A LOT OF LOGS! debug-level: 1 # If false, only the owner/placer of a dummy can pick it up. allow-non-owners-break: false ####################################################################### # WorldGuard integration # TEMPORARILY DISABLED - will be reworked in a future update. For now, the plugin ignores WorldGuard flags. ####################################################################### #worldguard: # # Enable/disable WorldGuard integration (if WG is installed) # enabled: true # # Respect flags when placing dummies (requires WG installed) # enforce-place: true # # Respect flags when picking up dummies # enforce-break: true # # Respect flags when damaging dummies # enforce-damage: true ####################################################################### # Storage / persistence ####################################################################### # Saved NPCs are stored as YAML files under the plugin data 'data/' folder. # Each file is named .yml and contains position, owner, type and skin. ```

**3. Permissions** All permissions default to **op**. * 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** * Use /dummies give (requires permission) * You 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**: * ️ **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 after the dummy's armor and enchantments * Test any weapon, enchantment, potion, critical hit, or projectile combination * The dummy **never dies or moves** ## **Commands** ``` /dummies give - Give dummy items to a player /dummies reload - Reload config and messages /dummies list - List all saved dummies (admin) /dummies remove - Force-remove a dummy by its UUID (admin) /dummies info - Show details about a dummy (admin) ``` *Aliases: /dummy and /dummies both 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: [GitHub Issue Tracker](https://github.com/petarmc1/playerdummies/issues) **Want a feature?** Suggest it in the [Discord Server](https://discord.gg/vb263hmspq) ### **⭐ If you enjoy this plugin, please leave a review! ⭐** ##### Constructive feedback is always appreciated ❤️ ## **Screenshots** ![actionbar_dmg.png](https://files.petarmc.com/images/playerdummies/actionbar_dmg.png) ![dummy_skin.png](https://files.petarmc.com/images/playerdummies/dummy_skin.png) Thank you for using PlayerDummies!

Published on	April 12, 2026
Downloads	1

PlayerDummies

Release v1.1.0

Petar_mc released PlayerDummies version v1.1.0 on April 12, 2026

Information

Platforms

Dependencies

Release
v1.1.0