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

• Players can disguise as any mob, animal, player skin, or inanimate entity
• Server-side mobs and entities 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:

• Passive animals: 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
• Hostile / neutral mobs: Zombie, Skeleton, Creeper, Enderman, Blaze, Warden, Breeze, Pillager, Piglin, Ravager, Shulker, Phantom, Slime, Magma Cube, and more
• Player: Disguise as any player (with their skin)
• Block / display entities: Falling Block, Block Display, Item
• Vehicles: 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 Loader
• Fabric API
• Minecraft 1.21.x

Inspired by

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