# 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 } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://frinn.gitbook.io/custom-machinery-1.16/recipes/upgrades/modifiers.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.