DisguisePlugin

English Version

🐑 DisguisePlugin

Transform into 86 different mobs — from a humble sheep to the Ender Dragon itself! Pick a disguise from a GUI menu and become one of the supported Minecraft creatures with mob-specific mechanics, movement speeds, 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 disguise is represented by a real entity — other players can see the corresponding mob with its sounds and animations. No client mod or resource pack is required.

🍼 Baby & Size Variants

• Disguise as a baby version of supported mobs, such as baby chickens and baby zombies
• Choose slime / magma cube sizes from 1–4
• Pick sheep colors from 16 wool colors and axolotl variants from 5 types

🐔 Mob-Specific Mechanics

Different disguises include special mechanics based on their mob type:

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 a sonic boom at attackers
🐉 Ender Dragon / Wither	Large flying boss disguises with hover behavior

Additional features include mob-specific movement speeds, knockback resistance, fall immunity for selected mobs, grass-eating animations, 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 mobs 500, bosses 1000 by default; all values are configurable
• Per-mob disguise duration — default 30 minutes; disguises can automatically expire when time runs out
• Players can cancel their disguise at any time for free through the menu using the BARRIER button

🌍 Multi-Language Support

• Ships with Simplified Chinese (zh_cn) and English (en_us)
• Custom languages — copy a language file, rename it, and translate the values
• Chat messages, action bars, menus, and console logs follow the selected language

---

📥 Installation

1. Download the .jar file
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.x
• Java 21
• No hard dependencies for normal use
• Vault is optional and is only needed for paid mode
• Server-side only — no client mod or resource pack required

Mobs introduced in newer Minecraft versions are automatically hidden when they are not supported by the current server version.

---

🎮 Commands

Command	Description	Permission
/dp	Open the disguise menu	disguise.use
/dp reload	Reload config, language, and economy settings	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 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 and duration

In paid mode, every mob can be configured individually:

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 can run without Vault. If paid mode is configured but Vault is unavailable, the plugin 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 to the language code you want, translate the values, and then set the new language in config.yml.

For example:

language: fr_fr

Q: Why do I see fewer mobs than 86?

A: Some mobs only exist in newer Minecraft versions. Mobs that are not supported by the current server version are automatically hidden.

---

🐛 Support & Feedback

Found a bug or have a suggestion?

Open an issue on GitHub or leave feedback on the Modrinth project page.

Have fun disguising! 🎭

---

中文版

🐑 DisguisePlugin 变身插件

一键变身 86 种受支持的 Minecraft 生物——从小羊到末影龙！通过 GUI 菜单选择变身，并体验不同生物对应的移动速度、特殊机制和互动玩法。

支持 Minecraft 1.21.x — Paper、Spigot、Purpur 服务器。

---

✨ 功能特性

🎭 一个菜单，86 种生物

• 动物 — 羊、猪、牛、狐狸、熊猫、美西螈、青蛙……
• 坐骑与快速生物 — 马、骆驼、海豚、蜜蜂、悦灵……
• 怪物 — 僵尸、骷髅、苦力怕、末影人、循声守卫……
• 精英与 BOSS — 潜影贝、末影龙、凋灵、快乐恶魂……

每种变身都会使用对应的真实生物实体进行展示，其他玩家可以看到相应的生物、音效和动画。玩家无需安装客户端 Mod 或资源包。

🍼 幼年与体型变体

• 支持部分生物的幼年形态，例如幼年鸡、幼年僵尸
• 可选择史莱姆 / 岩浆怪体型，范围 1–4
• 支持 16 种绵羊毛色
• 支持 5 种美西螈品种

🐔 生物特殊机制

不同变身拥有对应生物的特殊互动：

生物	互动效果
🐔 鸡	随时间下蛋
🐫 骆驼	坐下 / 站起
🦔 犰狳	缩成球并掉落鳞甲
🌪️ 旋风人	发射风弹
🐚 潜影贝	潜行时传送
💥 苦力怕	引线倒计时后爆炸
👁️ 循声守卫	对攻击者释放声波攻击
🐉 末影龙 / 凋灵	大型飞行 BOSS 变身与悬浮行为

其他功能还包括不同生物对应的移动速度、击退抗性、部分生物的摔落免疫、吃草动画以及其他特殊互动。

💰 可选经济系统（Vault）

• 3 种模式：admin（仅管理员）/ all（所有玩家）/ paid（使用游戏内货币）
• 每种生物独立价格 — 默认普通动物 100、坐骑 200、强怪 300、精英 500、BOSS 1000，全部可以调整
• 每种生物独立变身时长 — 默认 30 分钟，可以在时间结束后自动解除变身
• 玩家可以随时通过菜单中的 BARRIER 按钮免费主动解除变身

🌍 多语言支持

• 自带简体中文 (zh_cn) 和 English (en_us)
• 支持自定义语言 — 复制语言文件、重命名并翻译即可
• 聊天消息、ActionBar、菜单和控制台日志都会使用配置中选择的语言

---

📥 安装方法

1. 下载 .jar 文件
2. 放入服务器的 plugins/ 文件夹
3. 重启服务器
4. 输入 /dp 打开变身菜单

环境要求

• Paper、Spigot 或 Purpur
• Minecraft 1.21.x
• Java 21
• 正常使用模式下没有必需依赖
• Vault 为可选依赖，仅在 paid 模式下需要
• 纯服务端插件 — 玩家无需安装任何客户端 Mod 或资源包

如果某种生物只存在于较新的 Minecraft 版本中，而当前服务器版本不支持，该生物会自动从菜单中隐藏。

---

🎮 指令说明

指令	说明	权限
/dp	打开变身菜单	disguise.use
/dp reload	重载配置、语言和经济设置	disguise.reload
/dp debug	显示调试信息	disguise.admin
/dp mode	查看当前使用模式	disguise.use

权限节点

权限	默认	说明
disguise.use	true	使用变身菜单
disguise.reload	op	重载插件
disguise.admin	op	管理员模式权限

---

⚙️ 配置说明

config.yml — 选择语言和使用模式：

# 使用的语言文件（lang 文件夹内）
language: zh_cn

# /dp 使用模式：admin / all / paid
dp-mode: paid

# 关闭经验条上的玩家位置显示（1.21.6+ 功能）
disable-locator-bar: true

每种生物的价格与时长

在 paid 模式下，每种生物都可以独立配置：

mobs:
  sheep: { price: 100, duration: 1800 }    # 100 金币，30 分钟
  ender_dragon: { price: 1000, duration: 1800 }
  slime: { price: 300, duration: 0 }       # 时长为 0 = 不限时

---

❓ 常见问题

问：没有安装 Vault 能正常运行吗？

答： 可以。插件可以在没有 Vault 的情况下运行。如果配置为 paid 模式但 Vault 不可用，插件会自动回退到 all 模式。

问：可以自己制作语言文件吗？

答： 可以。复制插件目录下的 lang/en_us.yml，按照需要的语言代码重命名并翻译内容，然后在 config.yml 中选择新的语言。

例如：

language: fr_fr

问：为什么看到的生物少于 86 种？

答： 部分生物只存在于较新的 Minecraft 版本。当前服务器版本不支持的生物会自动隐藏。

---

🐛 支持与反馈

发现 Bug 或有功能建议？

可以在 GitHub 提交 Issue，或者在 Modrinth 项目页面留言。

祝你变身愉快！🎭