skills/mechanics/disguise.md

@@ -7,6 +7,8 @@ Disguises and ProtocolLib be installed to enable Disguise functionality.
 See [Add-On: Disguises](/addons/disguises/start) for a list of available
 disguises.
 
+As of 4.12 Disguise mechanic got an overhaul and allows for direct command strings from LibsDiguises to work inside of its disguise attribute. The old way was renamed disguiseOld and the new way is disguise!
+
 Attributes
 ----------
 
@@ -23,9 +25,31 @@ can also be used as an attribute in the skill.
 Examples
 --------
 
+**New Way**
+
+This will disguise you as a sheep that is on fire and spinning. It will also set the disguises custom name to DizzyBoi and make it visible!
+```
+TestingDisguiseMechanic:
+  Skills:
+  - disguise{d="Sheep SetBurning SetSpinning SetCustomNameVisible setCustomName DizzyBoi"} @self
+```
+
+This next example will turn you into a steve head that glides across the floor. No good way to describe it. It is pretty funny. I recommend you try it out!
+
+```
+TestingDisguiseMechanic:
+  Skills:
+  - disguise{d="Zombie setYModifier -1.5 setPitchLocked setInvisible setHelmet PLAYER_HEAD"} @self
+```
+
+---------
+**Old Way**
+
 This example would cause the mob to turn into a sheep.
 
       Skills:
-      - disguise{d=SHEEP}
+      - disguiseOld{d=SHEEP}
+
+Configure custom disguises using Lib's Disguises for more granular detail.
 
-Configure custom disguises using Lib's Disguises for more granular detail.
\ No newline at end of file
+---------
\ No newline at end of file