Modifiers are basic status effects that can be selected by the Mayhem interface.
These will be added with a duration of 10000 seconds, because making them persistent could lead to crashes or breaking things when removing them is needed.

• Create your status effect
  . (You can check some of the existing effects for some useful tools, like acceptance chances, crit changes, adding more mayhem modifiers within, isBoss and others)
  
• Create a patch
  in "/scripts/bl3healthconfig/mayhem.config".
  
• Here you add your "statusEffectName" to the modifier category list:
  Default lists include:
  • Easy
    
  • Medium
    
  • Hard
    
  • Very Hard
    
  • Mayhem11
  Each category contains 3 lists, defining WHO gets the effect applied:
  • enemy: NPCs and monsters get this effect
    
  • player: Players get this effect
    
  • both: can be a name or table that defines the effect that applies to BOTH types. (See file for examples)
• Add your descriptions
  • Inside the "descriptions" path, the same categories as before are present, but they simply contain a list of effect-names and data:
    { "name" : "Infinite Energy", "description" : "Grants infinite ^#<color>;energy^reset; to NPCs", "processing" : {"color" : "poison"} }
  • "processing" contains a list of key, emelent pairs, the key ("color") will replace the <color> tag in the text with the element's color configured in the mod ("poison", kinda green).

This should be it for custom modifiers.

Actually creating one is a bit simpler:

• Create a patch
  in "/scripts/bl3healthconfig/mayhem.config".
  
• Add an element to the "/levels/-" path, any number is fine.
  
• Add a modifer category combination to "/modCombinations/-",
  The combination determines the category of modifiers to use, if you want 4 easy modifiers do:
  
  { "op" : "add", "path" : "/modCombinations/-", "value" : ["easy", "easy", "easy", "easy", "easy"] }
• Modifiers are not limited to 4 and the interfaces does have an slider to scroll when there are more.

These can be found in the "/leveling/levelingmultipliers.functions" file.

• Simply patch in whatever you need.
  
• IF you are adding a level, adding the proper multipliers here is recommended, you can use any number before, this is a tool to be able to expand tiers, so use that same number as an index here.
  { "op" : "add", "path" : "/modCombl3_mayhemWeaponMultiplierbinations/-", "value" : [26(number used for mayhem.config:levels), 100] }
• WARNING: Due to the nature of patching, it is too difficult to read if your added multiplier has an index lower than another previously added by another mod, this would crash the game or the script, only by proper priority and mod order can be fixed. Some "test" patches too.