Disguises

Disguises

A powerful, server-side Fabric disguise mod inspired by LibsDisguises. Disguise players or any entity as virtually any mob, animal, player, block display, item, vehicle, or projectile, with fine-grained per-entity customisation, equipment overrides, self-view support, and a fully configurable permission system.

---

Features

Disguise anything as anything

- Observer-specific overrides can disguise as any mob, animal, player skin, or inanimate entity - Observer-specific overrides can also be disguised (e.g. disguise a zombie as a villager) - Observer-specific overrides, make one player see a different disguise than everyone else - Disguises persist across chunks and dimensions (configurable)

Self-view support

Players can optionally see their own disguise from a third-person puppet perspective, mirroring their crouch, sprint, swim, and elytra state in real time.

Sound replacement

Ambient, hurt, death, and footstep sounds are automatically replaced with the disguise type's sounds.

Extensive entity customisation

Every disguise type supports entity-specific flags set inline with the disguise command:

| Category | Example flags | |----------|--------------| | Universal | `setFire`, `setInvisible`, `setGlowing`, `setCustomName`, `setCrouching` | | Living entities | `setHealth`, `setBaby` | | Sheep | `setColor RED`, `setSheared` | | Creeper | `setPowered`, `setIgnited` | | Wolf / Cat | `setTamed`, `setAngry`, `setCollarColor BLUE` | | Villager | `setVillagerType plains`, `setProfession librarian`, `setVillagerLevel 3` | | Horse | `setHorseColor chestnut`, `setHorseStyle white_field` | | Panda | `setMainGene playful`, `setHiddenGene brown` | | Shulker | `setAttachFace north`, `setPeek 50`, `setShulkerColor CYAN` | | Armor Stand | `setSmall`, `setShowArms`, `setHeadPose 0 45 0` | | Block Display / Falling Block / Minecart | `setBlock diamond_block` | | Item entity | `setItem diamond` | | All living disguises | `setHelmet iron_helmet`, `setMainHand diamond_sword` |

Full tab-completion for all flags and their values is supported.

---

Supported Entity Types

100+ entity types across all categories:

- Projectiles: Cow, Sheep, Pig, Horse, Donkey, Mule, Cat, Wolf, Fox, Panda, Axolotl, Frog, Goat, Bee, Strider, Parrot, Rabbit, Llama, Turtle, Mooshroom, Villager, Iron Golem, Snow Golem, and more - Projectiles: Zombie, Skeleton, Creeper, Enderman, Blaze, Warden, Breeze, Pillager, Piglin, Ravager, Shulker, Phantom, Slime, Magma Cube, and more - Projectiles: Disguise as any player (with their skin) - Projectiles: Falling Block, Block Display, Item - Projectiles: All 20 boat variants, all 7 minecart types - Projectiles: Arrow, Trident, Firework Rocket, Ender Pearl, Snowball, and more

---

Commands

> Permissions are configurable per-command in `disguises.json`.

| Command | Description | |---------|-------------| | `/disguise <type> [flags...]` | Disguise yourself | | `/disguise <type> [flags...] self` | Disguise yourself with self-view enabled | | `/disguise <player> <type> [flags...]` | Disguise another player | | `/disguise entity <target> <type> [flags...]` | Disguise a targeted entity | | `/disguise radius <r> <type> [flags...]` | Disguise all entities within radius | | `/undisguise [player]` | Remove a disguise | | `/disguises reload` | Reload the config | | `/disguises info [player]` | Show active disguise info | | `/disguises list` | List all currently disguised entities | | `/disguises observer <target> <viewer> <type> [flags]` | Set a per-observer disguise override |

---

Configuration

`disguises.json` (in your config folder):

| Option | Default | Description | |--------|---------|-------------| | `showDisguiseActionBar` | `true` | Show the disguise type in the action bar | | `actionBarIntervalTicks` | `100` | How often the action bar reminder appears (0 = only on change) | | `disguiseSounds` | `true` | Replace sounds with the disguise type's sounds | | `selfDisguiseDefault` | `false` | Players see their own disguise by default | | `undisguiseOnDeath` | `false` | Remove disguise when the player dies | | `undisguiseOnWorldChange` | `false` | Remove disguise on dimension change | | `persistDisguises` | `false` | Save and restore disguises across server restarts | | `showEquipmentThroughDisguise` | `false` | Show the real entity's equipment through the disguise | | `enforceTypePermissions` | `false` | Require `disguises.type.<type>` permission per entity type | | `permLevelSelf/Others/Entity/Radius` | `2` | Op levels for each command category | | `disabledEntityTypes` | `[]` | Block specific entity types from being used |

---

Requirements

- Fabric API - Fabric API - Minecraft 1.21.x

---

Inspired by

LibsDisguises, the gold standard for Bukkit/Spigot disguise plugins, reimagined for Fabric.