Mobs/Disguises.md

@@ -13,9 +13,41 @@ Disguises allow you to make your mob look like a different mob, a block, or even
 Any entity type found in the spigot docs should function correctly.
 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
 
-### **PLEASE NOTE: The method described below with Disguise Options is an outdated way of doing disguises. Please scroll to the bottom to see the more modern way of adding disguises to mobs.**
+## Inline Disguises
+With the newer versions of MythicMobs, disguises can now be done completely inline using the same syntax as the ingame `/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
+```
+
+This is a much neater way of doing mob disguises compared to the Options version, and matches both the disguise mechanic syntax and the disguise command syntax. If at all possible, please use this method of disguising mobs over the Options method.
+
+## 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``
+#### Break down
+1. ``RumiIsAwesome`` would be the name of your disguise
+2. ``player`` means its a player disguise
+3. ``<inherit>`` means it will take its name from MM Display: instead of you 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 entities health in its name
+
+## LEGACY: Disguise Options
 
-### Options
+These options are no longer utilized in modern disguises and the documentation is preserved for historical purposes only.
 
 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.
 
@@ -104,34 +136,3 @@ Disguise:
   Type: pig
 ```
 
-## Inline Disguises
-With the newer versions of MythicMobs, disguises can now be done completely inline using the same syntax as the ingame `/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
-```
-
-This is a much neater way of doing mob disguises compared to the Options version, and matches both the disguise mechanic syntax and the disguise command syntax. If at all possible, please use this method of disguising mobs over the Options method.
-
-## 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``
-#### Break down
-1. ``RumiIsAwesome`` would be the name of your disguise
-2. ``player`` means its a player disguise
-3. ``<inherit>`` means it will take its name from MM Display: instead of you 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 entities health in its name
\ No newline at end of file