⚔️ 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

1. Place the JAR into your plugins/ folder
2. Install Citizens (required)
3. Restart your server
4. 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: /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:
https://github.com/PetarMc1/PlayerDummies/issues

Want a feature?

Suggest it in the Discord Server

---

Screenshots

Action Bar Damage Display

Custom Skins (Citizens Integration)

---

Thank you for using PlayerDummies! ⚔️