# 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 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](https://github.com/Trexler180/mc-disguises#readme). **Requires** Fabric Loader and Fabric API. The main build targets Minecraft 26.2, with alternate 26.1.2 and 1.21.11 builds 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. ### Disguise names in messages Server owners can optionally show disguise names in signed chat decoration and player-facing system messages such as deaths and advancements. Real account identities remain intact for UUIDs, profiles, commands, permissions, logs, and signed-chat reporting, with an optional real-name hover tooltip. ### 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 [flags...]` | Disguise yourself | | `/disguise player [flags...]` or `/disguise as [flags...]` | Disguise yourself as a named player skin | | `/disguise [flags...]` | Disguise another player | | `/disguise player [flags...]` | Disguise another player as a named player skin | | `/disguise entity [flags...]` | Disguise a targeted entity | | `/disguise entity player [flags...]` | Disguise a targeted entity as a named player skin | | `/disguise radius [flags...]` | Disguise all entities within radius | | `/disguise radius player [flags...]` | Disguise all entities within radius as a named player skin | | `/disguise modify ` | Modify your active disguise | | `/disguise viewself [on\|off]` | Toggle whether you see your own disguise | | `/undisguise [target]` | Remove a disguise | | `/undisguise radius ` | 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 names` | Show chat/system disguise-name settings | | `/disguises names ` | Change and persist a disguise-name setting (`death` is an alias for `system`) | | `/disguises observer [flags]` | Set a per-observer disguise override | | `/disguises removeobserver ` | Remove one per-observer disguise override | | `/disguises clearobservers ` | Remove all per-observer overrides for an entity | | `/savedisguise save [flags...]` | Save a personal disguise preset | | `/savedisguise apply ` | Apply a saved disguise preset | | `/savedisguise list` | List your saved disguise presets | | `/savedisguise delete ` | 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 | | `disguiseNamesInChat` | `false` | Show disguise names as signed-chat display names (also configurable with `/disguises names chat`) | | `disguiseNamesInDeathMessages` | `false` | Show global disguise names in system messages such as deaths and advancements (use `/disguises names system`) | | `revealRealNameOnHover` | `true` | Reveal the real account name when hovering a substituted name (also configurable with `/disguises names hover`) | | `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.` permission per entity type | | `maxSavedPresetsPerPlayer` | `50` | Maximum saved presets per player (`0` = unlimited) | | `permLevelSelf/Others/Entity/Radius` | `2` | Op levels for each command category | | `permLevelAdmin` | `3` | Op level for `/disguises` admin commands | | `permLevelType` | `4` | Fallback op level for per-type permissions without a permissions mod | | `disabledEntityTypes` | `[]` | Block specific entity types from being used | --- ## Requirements - **Fabric Loader** - **Fabric API** - Main build: Minecraft 26.2 - Alternate builds: Minecraft 26.1.2 and 1.21.11 --- ## Inspired by [LibsDisguises](https://www.spigotmc.org/resources/libs-disguises.81/)