Disguise-Plugin1.0.0

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:

Mob Interaction
Chicken lays eggs over time
Camel sits down / stands up
Armadillo curls up and drops scutes
️ Breeze shoots wind charges
Shulker teleports while sneaking
Creeper explodes with a fuse timer
️ Warden fires sonic boom at attackers
Ender Dragon / Wither giant flying boss with hover animation
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
Command Description Permission
/dp Open the disguise menu disguise.use
/dp reload Reload config, language, economy disguise.reload
/dp debug Show debug information disguise.admin
/dp mode Show current usage mode disguise.use
Permissions:

Permission Default Description
disguise.use true Use the disguise menu
disguise.reload op Reload the plugin
disguise.admin op Admin mode access
⚙️ 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!