disguise-plugin

disguise-plugin

🐑 DisguisePlugin

Transform into 86 different mobs — from a humble sheep to the Ender Dragon itself! Pick a disguise from a beautiful GUI menu and become any creature of Minecraft with its realistic mob mechanics, authentic movement speed, and unique interactions.

Works on Minecraft 1.21.x — Paper, Spigot and Purpur servers.

✨ Features

🎭 86 Mobs in One Menu

• Animals — sheep, pig, cow, fox, panda, axolotl, frog...
• Mounts & Fast Mobs — horse, camel, dolphin, bee, allay...
• Monsters — zombie, skeleton, creeper, enderman, warden...
• Elite & Bosses — shulker, Ender Dragon, Wither, Happy Ghast...

Every mob is spawned as a real entity — other players see the actual mob with its authentic hitbox, sounds and animations. No fake packets.

🍼 Baby & Size Variants

• Disguise as a baby version of any mob (baby chicken, baby zombie...)
• Choose slime / magma cube sizes (1–4)
• Pick sheep colors (16 wool colors) and axolotl variants (5 types)

🐔 Realistic Mob Mechanics

Each disguise behaves like the real mob:

Plus: realistic walk speeds for every mob, knockback resistance, fall immunity (cats, iron golems...), eating grass animation and more.

💰 Optional Economy System (Vault)

• 3 modes in config: admin (admins only) / all (everyone) / paid (disguises cost money)
• Per-mob pricing: animals 100 coins, mounts 200, strong mobs 300, elite 500, bosses 1000 — fully adjustable
• Per-mob disguise duration: default 30 minutes, auto-expires when time runs out
• Players can cancel their disguise anytime for free via the menu (BARRIER button)

🌍 Multi-Language Support

• Ships with 简体中文 (zh_cn) and English (en_us)
• Custom languages: copy any language file, rename it, translate — done!
• All chat messages, action bars, menus and console logs follow the selected language

📥 Installation

1. Download the jar
2. Drop it into your server's plugins/ folder
3. Restart the server
4. Run /dp to open the disguise menu!

Requirements:

• Paper, Spigot or Purpur — Minecraft 1.21+
• Java 21
• No hard dependencies — works out of the box. Vault is optional, only needed for paid mode
• Server-side only — no client mod or resource pack required

New mobs from newer versions (1.21.9 / 1.21.11) are hidden automatically on older servers — no errors, the menu simply shows fewer mobs.

🎮 Commands

Permissions:

⚙️ Configuration

config.yml — choose the language and the usage mode:

# Language file inside the lang/ folder
language: zh_cn

# /dp mode: admin / all / paid
dp-mode: paid

# Disable the locator bar (player positions on the XP bar, 1.21.6+)
disable-locator-bar: true

Per-mob pricing & duration (paid mode) — every mob is configurable:

mobs:
  sheep: { price: 100, duration: 1800 }    # 100 coins, 30 minutes
  ender_dragon: { price: 1000, duration: 1800 }
  slime: { price: 300, duration: 0 }       # 0 duration = unlimited

❓ FAQ

Q: Does it work without Vault?

A: Yes — the plugin starts fine, logs a warning and automatically falls back to all mode.

Q: Can I make my own language?

A: Yes! Copy lang/en_us.yml in the plugin folder, rename it (e.g. fr_fr.yml), translate the values, then set language: fr_fr in config.

Q: Why do I see fewer mobs than 86?

A: Mobs added in newer Minecraft versions (1.21.9+) are hidden on older servers automatically.

🐛 Support & Feedback

Found a bug or have a suggestion? Open an issue on GitHub or leave a review below!

Have fun disguising! 🎭