Item-Generator-Modifiers.md

 Modifiers let you randomize your items even more using the item generator. Modifiers are packets of item stats which have some chance to be added to an item when it is being generated.
 
-A typical modifier for a randomized weapon would be for instance `Sharp` which would add +3 Atk Damage to the weapon or `Toxic` which would add an on-hit poison ability to the weapon. Some modifiers are more powerful than others and therefore should have a different chance to be selected. Some modifiers may even be obtainable only for a certain item tier.
\ No newline at end of file
+A typical modifier for a randomized weapon would be for instance `Sharp` which would add +3 Atk Damage to the weapon or `Toxic` which would add an on-hit poison ability to the weapon. Some modifiers are more powerful than others and therefore should have a different chance to be selected. Some modifiers may even be obtainable only for a certain item tier.
+
+When creating a generation template, you need to specify a modifier list:
+```
+
+
+# Example item
+LONG_SWORD:
+    type: SWORD
+    base: ...
+
+    # Modifiers which have a chance to be rolled
+    modifiers:
+
+        # First modifier
+        sharp:
+            weight: 2.5
+            prefix: '&fSharp'
+            stats:
+                attack-damage: 3
+                lore:
+                - '&7Much sharper!'
+
+        # Second modifier
+        fiery:
+            weight: 5
+            prefix:
+                format: '&cFiery'
+                priority: 1
+            stats:
+               ability:
+                   on-hit:
+                       type: burn
+                       mode: on_hit
+```
+
+As seen on the [General|Item-Generator] page, one item can be generated with multiple modifiers. A modifier is defined by four options: its **selection chance**, its **modifier weight**, its **stat list** and its **prefix/suffix**.
+
+### Prefixes/suffixes
+When a modifier is selected during item generation, its suffix/prefix is automatically applied to the item. If multiple prefixes/suffixes are added, MMOItems only keeps the prefixes/suffixes with the higher priority, e.g an item which has `Sharp` with prefix priority 0 (because 0 by default) and `Fiery` with prefix priority 1 will only display `Fiery`. If you don't want to use the prefix/suffix priority system, just define the prefix/suffix using this format:
+```
+prefix: '&fSharp'
+```
+instead of 
+```
+prefix:
+    format: '&fSharp'
+    priority: <integer-needed>
+```
+
+### Weight
+The modifier weight is the amount of capacity deduced to the generated item when the modifier is applied to this item. If your item has 5 modifier capacity, it won't be able to receive a modifier with weight 6. Since modifier capacity is directly determined by the item's tier, some tiers just cannot have specific modifiers.
+```
+modifier:
+    weight: 5
+```
+
+### Selection Chance
+This is a smaller option to balance your modifiers. You can setup modifiers so that, even if the generated item has enough modifier capacity to receive the modifier, there is still a X% chance that the modifier will not apply. Use the following format:
+```
+modifier:
+    chance: .1 # Corresponds to a 10% selection chance
+```
+
+### Modifier Stats
+These are the stats which will be applied to the item, if the modifier is selected, i.e if the generated item has enough modifier capacity and if the modifier selection chance test was successful. The format used here to define what stats are added is the exact same as the format used to define the base item data of an [item generation template|Item-Generator-Template].
\ No newline at end of file