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.

Everything runs on the server, so your players just join with vanilla Fabric and it works. There is no client mod or resource pack to install.

Over 100 entity types are supported, from passive animals and hostile mobs to other players (with their real skins), block displays, items, every boat and minecart variant, and projectiles. Each type takes its own flags for things like colour, age, pose, equipment, tameness and professions, all with full tab-completion.

For build instructions and source, see the GitHub repository.

Requires Fabric Loader and Fabric API. The main build targets Minecraft 26.1.2, and an alternate 1.21.11 build is available.

---

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.

Player skins and saved presets

Players can disguise as named player skins, cache fetched skins, and save reusable disguise presets for quick re-application.

Vanish-aware packet handling

Observer-specific disguises and vanish providers are supported, including a built-in scoreboard-tag fallback for vanished entities.

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 player <name> [flags...] or /disguise as <name> [flags...]	Disguise yourself as a named player skin
/disguise <type> <target> [flags...]	Disguise another player
/disguise <type> <target> player <name> [flags...]	Disguise another player as a named player skin
/disguise entity <target> <type> [flags...]	Disguise a targeted entity
/disguise entity <target> player <name> [flags...]	Disguise a targeted entity as a named player skin
/disguise radius <r> <type> [flags...]	Disguise all entities within radius
/disguise radius <r> player <name> [flags...]	Disguise all entities within radius as a named player skin
/disguise modify <flags...>	Modify your active disguise
/disguise viewself [on|off]	Toggle whether you see your own disguise
/undisguise [target]	Remove a disguise
/undisguise radius <r>	Remove disguises from all entities within radius
/disguises reload	Reload the config
/disguises info [player]	Show active disguise info
/disguises list	List all currently disguised entities
/disguises clearcache	Clear the player-skin cache
/disguises observer <target> <viewer> <type> [flags]	Set a per-observer disguise override
/disguises removeobserver <target> <viewer>	Remove one per-observer disguise override
/disguises clearobservers <target>	Remove all per-observer overrides for an entity
/savedisguise save <name> <type> [flags...]	Save a personal disguise preset
/savedisguise apply <name>	Apply a saved disguise preset
/savedisguise list	List your saved disguise presets
/savedisguise delete <name>	Delete a saved disguise preset
/disguisehelp [type]	List disguise types or flags for one type

---

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
showDisguiseInTab	false	Keep fake player disguises visible in the tab list while skins load
tabRemoveDelayTicks	20	Ticks before removing a fake player tab entry after spawn
vanishedEntitiesHidden	true	Hide vanished disguised entities from unauthorized observers
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
permLevelAdmin	3	Op level for /disguises admin commands
disabledEntityTypes	[]	Block specific entity types from being used

---

Requirements

• Fabric Loader
• Fabric API
• Main build: Minecraft 26.1.2
• Alternate build: Minecraft 1.21.11

---

Inspired by

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