> For the complete documentation index, see [llms.txt](https://frinn.gitbook.io/custom-machinery-1.16/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://frinn.gitbook.io/custom-machinery-1.16/recipes/upgrades/modifiers.md). # Modifiers Requirement modifiers are used to tweak some properties of a recipe requirement. They are defined in json inside of the `modifiers` property of the machine upgrade item json. ### List of properties that can be modified
RequirementTargetModified property
Block-amount
Block"chance"chance
Command"chance"chance
Drop-amount
Drop"radius"radius
Drop"chance"chance
Durability-amount
Durability"chance"chance
Effect"time"time
Effect"level"level
Effect"radius" radius
Effect"chance"chance
Energy-amount
Energy"chance"chance
Energy per tick-amount
Energy per tick"chance"chance
Entity-amount
Entity"radius"radius
Entity"chance"chance
Fluid-amount
Fluid"chance"chance
Fluid per tick-amount
Fluid per tick"chance"chance
Item-amount
Item"chance"chance
Light-light
Loot table"luck"luck
Redstone"power"power
Speed-The recipe's time property
Function"chance"chance
### Properties The requirement modifier has 4 mandatory properties and 2 optional property. #### Mandatory properties
Requirement #### Name : `requirement` #### Description : The type of the requirement you want to apply the modifier to. This is the same type as the one you specify in the `type` property when defining the requirement in the recipe json. #### Example : ```json "requirement": "custommachinery:energy" ``` This modifier will be applied to the energy requirement. #### Note : The recipe duration can also be modified with this system. Use `custommachinery:speed` to target it. Warning : Using this as a requirement will alter the recipe process duration, which is the opposite of the speed (the lower the duration the faster the speed).
Mode #### Name : `mode` #### Description : The mode of the requirement you want to apply the modifier to. It can be either `input` or `output` but not both. #### Example : ```json "mode": "input" ``` This modifier will be applied only on input requirements.
Operation #### Name : `operation` #### Description : The mathematical operation that will be applied to the targeted requirement property by the modifier. The available operations are : * `addition` : The resulting value will be the sum of the base requirement value and the modifier value. * `multiplication` : The resulting value will be the multiplication of the base requirement value and the modifier value. #### Example : ```json "operation": "multiplication" ``` The base requirement value (defined in the recipe) will be multiplicated by the value defined in this modifier.
Modifier #### Name : `modifier` #### Description : The value (double) to add or multiply to the base requirement value. It can be positive or negative and support decimal numbers. #### Example : ```json "modifier": 0.5 ```
#### Optional properties
Target #### Name : `target` #### Description : Some requirement have more than one value that can be modified. In that case the `target` property can be used to define which one of the requirement property you want to modify. For example some requirement have a `chance` property that can be modified by the upgrade, simply use `"target": "chance"` to target the chance property instead of the default one. #### Default : `empty` The modifier will be applied to the default property of the defined requirement. #### Example : In case of the [Entity Requirement](https://github.com/Frinn38/Custom-Machinery/wiki/Entity-Requirement) the default property is `amount` so if you want to modify the `radius` property you can do : ```json "target": "radius" ```
Chance #### Name : `chance` #### Description : The chance the modifier will be applied to the requirement, this have nothing to do with the `chance` property some requirement have and will be applied independently. This value must be between 0 and 1 where 0 is 0% chance to be applied and 1 is 100% chance. #### Default : 1 The modifier have 100% chance to be applied on the requirement. #### Example : ```json "chance": 0.4 ``` The modifier have 40% chance to be applied on the requirement.
### Example A modifier that half the time needed to process a recipe : ```json { "requirement": "custommachinery:speed", "mode": "input", "operation": "multiplication", "modifier": 0.5 } ``` A modifier that double the energy per tick consumed by a recipe : ```json { "requirement": "custommachinery:energy_per_tick", "mode": "input", "operation": "multiplication", "modifier": 2.0 } ``` A modifier that has 50% chance to add 1 item produced by a recipe : ```json { "requirement": "custommachinery:item", "mode": "output", "operation": "addition", "modifier": 1, "chance": 0.5 } ```