GitLab

Mob Disguises

Mob disguises are dependent on the plugins LibsDisguises and ProtocolLib. They will not work without both of those plugins. The most up to date documentation for LibsDisguises can be found here

Most features do not require the premium version of LibsDisguises because LibraryAddict is a pretty nice dude.

Note: Some version of ProtocolLib work better than others- some versions break mob disguises, other players disguises, we do not have control over this. The LibsDisguises plugin will try to auto-update to a working version but sometimes that may fail. check the discord if this is the case, normally we have backup links to working versions

Now that the technical mumbo-jumbo is over... What is a disguise?

Disguises allow you to make your mob look like a different mob, a block, or even an item! Disguises are great for shaking things up with mobs, allowing you to do things that are otherwise not possible… for example, making a spider that looks like a zombie– a zombie that climbs walls!. The possibilities are huge.

Any entity type found in the spigot docs should function correctly. https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html

How To Set up Disguises

With the newer versions of MythicMobs, disguises can now be done completely inline using the same disguise string syntax as the in-game /disguise command.

For example, let's say we want a skeleton that is glowing, spinning, and on fire. To get this disguise ingame, we would use the command: /disguise SKELETON setGlowing setSpinning setBurning. We can take this command, and use it on a mob next to the disguise option, like in the example below:

SLSkelF:
  Type: ZOMBIE
  Equipment:
  - IRON_SWORD HAND
  - SHIELD OFFHAND
  - LEATHER_HELMET HEAD
  - LEATHER_CHESTPLATE CHEST
  - LEATHER_LEGGINGS LEGS
  - LEATHER_BOOTS FEET
  Display: '&BSkeletal Fighter\n&ELv.<mob.level>'
  Disguise: SKELETON setGlowing setSpinning setBurning

Disguise Options

You can view additional disguise options by using /dhelp <disguisetype>. You can also view more information on types by using /dhelp.
Examples:

#Invisible powered Creeper
Disguise: creeper setPowered true setInvisible true

#Brown horse with white spots and gold armor
Disguise: horse setColor brown setStyle white_dots setHorseArmor 418

#Upside-down player disguise with Notch's skin
Disguise: player Dinnerbone setSkin Notch

Saving Disguises

1. Download the skin.png file you want to use for your disguises and put it inside of the server/plugins/libsdisguises/skins folder.
2. use the command /savedisguise RumiIsAwesome player <inherit> setSkin RumiExMachina.png setDynamicName to save your skin to a disguise.
3. Apply it to your MM with Disguise: RumiIsAwesome

Detailed steps

1. RumiIsSuperAwesome would be the name of your disguise
2. player means it's a player disguise
3. <inherit> means it will take its name from Display: instead of adding it here
4. setSkin RumiExMachina.png is telling it to set the disguise skin to your .png file in the skins folder So if you have a skin named Goblin.png in the skins folder, use setSkin Goblin.png
5. setDynamicName is used to allow the disguise name to change often, useful when you want to display the entity's health in its name

Excessive Example:

SneakyDisguisingMob:
  Type: wither_skeleton
  Display: 'meh'
  CustomKillMessages:
  - '<target.name> was sneaked upon! (to death)'
  Health: 128
  Disguise: player Steve setSkin meeeh.png setBurning true setSneaking true setSprinting true setModifyBoundingBox false setDynamicName true

Nameplates

Nameplates allow you to extend the nameplates of Player-disguise mobs, which are normally limited to 16 characters. To use this, simply have Holograms installed and then leave out the “Player” field in your disguise (skin is still required!). If you don't specify the player field, it will use the Display field instead using a custom nameplate.

Monkey:
  Type: skeleton
  Display: "this display name is too long for players normally"
  Disguise: player Steve setSkin Kurdie.png

This feature requires LibsDisguises and the Holograms plugin: https://www.spigotmc.org/resources/holograms.4924/

If you have premium you can use multi line disguise names using the setDynamicName option

Examples

Examples of Disguises being used:

ExampleMob:
  Type: skeleton
  Disguise: player libraryaddict setCustomName "&8Not Darkitect" setSkin Darkitect.png

ExampleMob2:
  Type: skeleton
  Health: 20
  Disguise: player Ashijin setSkin Notch.png

ExampleMob3:
  MobType: skeleton
  Health: 20
  Disguise: pig