Mobs/Disguises.md

-===========
+### Mob Disguises
 
-Mob disguises are dependent on the plugins [LibsDisguises ](https://www.spigotmc.org/resources/libs-disguises.81/)and [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/). They will not work without either of those plugins.
+**Mob disguises are dependent on the plugins [LibsDisguises ](https://www.spigotmc.org/resources/libs-disguises.81/)and [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/). They will not work without both of those plugins. [The most up to date documentation for LibsDisguises can be found here](https://www.spigotmc.org/wiki/lib-s-disguises/)**
 
-Also note that some versions work better with others- some versions break mob disguises, other players disguises. You'll have to experiment for yourself- there's no consensus on what works
+Most features do not require the premium version of LibsDisguises because LibraryAddict is a pretty nice dude.
 
-Also also note that disguises are likely to break if you capitalize the disguise type.
+**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](mythicmobs.net/discord)
+
+### 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.
 
-Below is a list of disguise types that can be assigned to a mob using the disguise mob option.
-
-Available Disguises
-===========
-- arrow
-- babyzombievillager
-- bat
-- blaze
-- block - Disguise a mob as (literally) a block
-- boat
-- cave_spider
-- chicken
-- cow
-- creeper
-- donkey
-- dropped_item - Disguses a mob as a dropped item.
-- egg
-- ender_crystal
-- ender_dragon
-- ender_pearl
-- ender_signal
-- enderman
-- experience_orb
-- fireball
-- firework
-- fishing_hook
-- ghast
-- giant
-- horse
-- iron_golem
-- item_frame
-- leash_hitch
-- magma_cube
-- minecart
-- minecart_chest
-- minecart_furnace
-- minecart_hopper
-- minecart_mob_spawner
-- minecart_tnt
-- mule
-- mushroom_cow
-- ocelot
-- painting
-- pig
-- pig_zombie
-- player - Disguise a mob as a player!
-- polar_bear
-- primed_tnt
-- rabbit
-- sheep
-- silverfish
-- skeleton
-- skeleton_horse
-- slime
-- small_fireball
-- snowball
-- snowman
-- spider
-- splash_potion
-- squid
-- thrown_exp_bottle
-- undead_horse
-- villager
-- witch
-- wither
-- wither_skeleton
-- wither_skull
-- wolf
-- zombie
-- zombie_villager
+Any entity type found in the spigot docs should function correctly.
+https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
 
 ### Options
 
-All disguises have certain options available to them. These options go under the Disguises block, and can only be used in conjunction with a disguise (they will not work on their own).
+All disguises have certain options available to them. These options go under the Disguises block, and can only be used in conjunction with a disguise (they will not work on their own). Some options will be mob specific. The lists of options for any entity can be found using `/dhelp <entity>`. Because this is generated by your plugin it should _always_ be up to date.
+
+Here are some common ones that may be of interest to you:
 
 - Disguise.Burning: true - Causes the mob to always appear to be burning
 - Disguise.Blocking: true - Causes certain disguises to be stuck in the “blocking” animation.
@@ -115,11 +51,11 @@ SneakyDisguisingMob:
     Sneaking: true
     Sprinting: true
     ModifyBoundingBox: false
+    setDynamicName: true
 ```
 
 #### Nameplates
 
-Added in 4.1
 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.
@@ -134,6 +70,9 @@ Monkey:
 ```
 This feature requires LibsDisguises and the Holograms plugin: [https://www.spigotmc.org/resources/holograms.4924/](https://www.spigotmc.org/resources/holograms.4924/)
 
+If you have premium you can use multi line disguise names using the `setDynamicName` option
+![image](uploads/e9f3926c7a8d74dfb1b8fa6d2cd2d67c/image.png)
+
 #### Examples
 
 Examples of Disguises being used:
@@ -145,6 +84,7 @@ Disguise:
   Player: '&8Not Darkitect'
   Skin: Darkitect
 ```
+
 ```
 MobType: skeleton
 Health: 20
@@ -153,11 +93,24 @@ Disguise:
   Player: Ashijin
   Skin: Notch
 ```
+
 ```
 MobType: skeleton
 Health: 20
 Disguise:
   Type: pig
 ```
-
+You may also use in line conditions for the mobs disguise. For example from the orc shown earlier:
+```
+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 setDynamicName```
 ------------------------------------------------------------------------