MasterfulMC

https://newdocs.masterfulmc.com/current/
Admin
MasterfulMC is a Minecraft server network offering various game modes and experiences to players,...
Tokens:6,293
Snippets:66
Trust Score:4.6
Update:1 year ago
Show doc for...
Tokens:
Raw
### Consume Input Example - JSON

Source: https://newdocs.masterfulmc.com/current/process-recipes/input-entries

This JSON snippet demonstrates a basic input entry configuration for consuming an ingredient. It includes optional fields for per-tick consumption and a chance-based consumption model. The 'ingredient' field requires a separate INGREDIENT CONFIG.

```json
{
  "type": "mm:input/consume",
  "per_tick": true, // Optional: Remove to consume at end of ticks timer
  "chance": 0.5, // Optional: Remove for 100% chance
  "ingredient": {
    // An Ingredient Config
  }
}
```

--------------------------------

### Fluid Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Configures an ingredient using a specific fluid and amount. The 'fluid' field is the fluid ID, and 'amount' represents the quantity in millibuckets (mB). For example, 1000 mB is equivalent to one bucket.

```json
"ingredient": {
    "type": "mm:fluid",
    "fluid": "minecraft:water",
    "amount": 1000
}
```

--------------------------------

### JSON Structure Layout Alignment Example

Source: https://newdocs.masterfulmc.com/current/structures

This example demonstrates the correct alignment for the 'layout' field in a Masterful Machinery structure JSON. The front of the structure, represented by the controller character 'C', should be aligned to the bottom line of the array. This ensures consistent reading and rotation of direction-based properties.

```json
"layout": [
    [
        "BBB",
        "ACB"
    ]
]
```

--------------------------------

### Set Recipe Duration in Ticks

Source: https://newdocs.masterfulmc.com/current/process-recipes

Defines the 'ticks' field for a process recipe, determining its execution duration in in-game ticks. For example, 60 ticks equate to 3 seconds of in-game time.

```json
"ticks": 60
```

--------------------------------

### Configure Multiple Controller IDs for a Port

Source: https://newdocs.masterfulmc.com/current/ports

This JSON snippet demonstrates how to specify multiple controller identifiers for a port. The 'controllerIds' field can accept an array of strings, allowing a single port to be associated with several different controllers. This provides flexibility in how ports are integrated into machine setups.

```json
"controllerIds": [
    "mm:my_controller",
    "mm:my_other_controller"
]
```

--------------------------------

### TOML Configuration for Common Settings

Source: https://newdocs.masterfulmc.com/current/common-config

This snippet shows the TOML configuration for various settings. It includes enabling the debug tool, splitting JEI recipes by structure, and setting the default for automatic item port extraction.

```toml
#Enables the Debug Tool Item's functionality (Disable when on server)
debugTool = true
#Splits JEI recipe viewer categroies by the structure they belong to.
splitRecipesJei = true
#The default value of 'autoPush' (when not set) on ports that support automatic extract to nearby storages
portsAutoExtractByDefault = false
```

--------------------------------

### Create a Machine Controller - JSON

Source: https://newdocs.masterfulmc.com/current/controllers

Defines a new machine controller for Masterful Machinery. The 'type' specifies it as a standard machine controller, 'id' provides a unique identifier, and 'name' sets the display name. This JSON file should be placed in the './config/mm/controllers' directory.

```json
{
    "type": "mm:machine",
    "id": "my_controller",
    "name": "My Controller"
}
```

--------------------------------

### Create Botania Mana Port Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/botania-mana-compat

This JSON object defines a Botania Mana Port. It specifies the port's unique ID, controller association, display name, type, and configuration details such as mana capacity. The 'type' field 'mm:botania/mana' indicates it's a Botania mana port, and the 'config' object holds port-specific settings.

```json
{
  "id": "my_mana_port",
  "controllerIds": "mm:controller_a",
  "name": "My Mana Port",
  "type": "mm:botania/mana",
  "config": {
    "capacity": 1000
  }
}
```

--------------------------------

### Create Mekanism Pigment Port (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/mekanism-ports-compat/pigment-ports

This JSON structure defines a Mekanism Pigment Port. It requires an 'id', 'controllerIds', 'name', and 'type'. The 'type' field, specifically 'mm:mekanism/pigment', indicates it's a Mekanism pigment port. The 'config' object holds port-specific settings, such as 'capacity' for pigment storage.

```json
{
  "id": "my_pigment_port",
  "controllerIds": "mm:controller_a",
  "name": "My Pigment Port",
  "type": "mm:mekanism/pigment",
  "config": {
    "capacity": 10000000
  }
}
```

--------------------------------

### Create a Basic Process Recipe Structure

Source: https://newdocs.masterfulmc.com/current/process-recipes

Defines the fundamental structure for a MasterfulMC process recipe. It includes a structure ID to link to a specific structure file, the duration in ticks, and placeholders for input and output recipe entries. This is the foundational JSON object for any recipe.

```json
{
  "structureId": "mypack:my_structure",
  "ticks": 60,
  "inputs": [
    // Some Input Recipe Entries
  ],
  "outputs": [
    // Some Output Recipe Entries
  ]
}
```

--------------------------------

### Item Port Configuration Details (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/item-ports

This JSON snippet details the 'config' object for an item port. It includes 'rows' and 'columns' to define the storage grid size (total slots = rows * columns), and 'autoPush' which, when true, enables the port to push items into adjacent storage blocks.

```json
{
    "rows": 3,
    "columns": 3,
    "autoPush": true
}
```

--------------------------------

### Simple Output Entry Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/output-entries

Defines a basic output recipe entry in JSON format. It includes optional fields for per-tick output and chance, and a required ingredient configuration. The 'per_tick' field controls output frequency, while 'chance' manages the probability of output. The 'ingredient' field specifies the item to be output.

```json
{
  "type": "mm:output/simple",
  "per_tick": true, // Optional: Remove to output at end of ticks timer
  "chance": 0.5, // Optional: Remove for 100% chance
  "ingredient": {
    // An Ingredient Config
  }
}
```

--------------------------------

### Define Inputs for Process Recipe

Source: https://newdocs.masterfulmc.com/current/process-recipes

Specifies the 'inputs' field in a process recipe, which is a list of JSON objects representing the required recipe entries for the recipe to progress. These entries detail the ingredients or conditions needed.

```json
"inputs": [
    // Input Recipe Entries
  ]
```

--------------------------------

### Create Item Port Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/item-ports

This JSON object defines a new item port, specifying its unique ID, controller association, display name, type, and configuration. The 'config' object determines the storage dimensions (rows and columns) and whether auto-push functionality is enabled.

```json
{
  "id": "my_port",
  "controllerIds": "mm:controller_a",
  "name": "My Item Port",
  "type": "mm:item",
  "config": {
    "rows": 3,
    "columns": 3,
    "autoPush": true // optional
  }
}
```

--------------------------------

### Create Mekanism Gas Port Configuration

Source: https://newdocs.masterfulmc.com/current/ports/mekanism-ports-compat/gas-ports

Defines the JSON structure for creating a Mekanism gas port. It specifies unique identifiers, connection details, display name, port type, and configuration options like gas capacity.

```json
{
  "id": "my_gas_port",
  "controllerIds": "mm:controller_a",
  "name": "My Gas Port",
  "type": "mm:mekanism/gas",
  "config": {
    "capacity": 10000000
  }
}
```

--------------------------------

### Configure Mekanism Infusion Port (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/mekanism-ports-compat/infusion-ports

Defines the structure for a Mekanism Infusion Port configuration. It includes a unique ID, controller association, a display name, the specific type identifier 'mm:mekanism/infuse', and a configuration object for tank capacity.

```json
{
  "id": "my_infuse_port",
  "controllerIds": "mm:controller_a",
  "name": "My Infuse Port",
  "type": "mm:mekanism/infuse",
  "config": {
    "capacity": 10000000
  }
}
```

--------------------------------

### Create Energy Port Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/energy-ports

This JSON configuration defines a new energy port, specifying its ID, controller, name, and type. The 'config' object further details the energy storage's capacity, maximum receive and extract rates per tick, and an optional 'autoPush' setting for output ports.

```json
{
  "id": "my_port",
  "controllerIds": "mm:controller_a",
  "name": "My Port",
  "type": "mm:energy",
  "config": {
    "capacity": 1000000,
    "maxReceive": 1000,
    "maxExtract": 1000,
    "autoPush": true  // optional
  }
}
```

--------------------------------

### Botania Mana Port Capacity Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/botania-mana-compat

This JSON snippet illustrates the 'config' object for a Botania mana port, specifically highlighting the 'capacity' field. This field determines the maximum amount of mana that the port can store, which is essential for managing mana flow and availability.

```json
"config": {
    "capacity": 1000
}
```

--------------------------------

### Create Fluid Port Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/fluid-ports

This JSON object defines the configuration for creating a fluid port. It specifies the port's ID, controller, name, type, and configuration details like dimensions, capacity, and auto-push behavior. The 'type' field must be 'mm:fluid' for fluid ports.

```json
{
  "id": "my_port",
  "controllerIds": "mm:controller_a",
  "name": "My Item Port",
  "type": "mm:fluid",
  "config": {
    "rows": 3,
    "columns": 3,
    "slotCapacity": 1000,
    "autoPush": true // optional
  }
}
```

--------------------------------

### Create a Basic Machine Port Configuration

Source: https://newdocs.masterfulmc.com/current/ports

This JSON configuration defines a basic port for a Masterful Machinery machine. It includes essential fields like 'id', 'controllerIds', and 'name'. The 'id' is a unique identifier, 'controllerIds' specifies compatible controllers, and 'name' sets the default display name. Note that specific port types may have additional configuration fields not shown here.

```json5
{
  "id": "my_port",
  "controllerIds": "mm:my_controller",
  "name": "My Port",
  //...
}
```

--------------------------------

### Create Mekanism Slurry Port Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/mekanism-ports-compat/slurry-ports

Defines a Mekanism Slurry Port with its unique identifier, associated controller, name, type, and storage capacity. The 'type' field specifies the Mekanism slurry port, and 'config.capacity' sets the slurry storage limit.

```json
{
  "id": "my_slurry_port",
  "controllerIds": "mm:controller_a",
  "name": "My Slurry Port",
  "type": "mm:mekanism/slurry",
  "config": {
    "capacity": 10000000
  }
}
```

--------------------------------

### Mekanism Pigment Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Specifies a Mekanism pigment as an ingredient. The 'pigment' field is the Mekanism pigment ID, and 'amount' is the quantity in millibuckets (mB).

```json
"ingredient": {
    "type": "mm:mekanism/pigment",
    "pigment": "mekanism:blue",
    "amount": 20
}
```

--------------------------------

### Fluid Port Configuration Object (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/fluid-ports

This JSON object outlines the configuration parameters for a fluid port. It includes 'rows' and 'columns' to define the grid of fluid tanks, 'slotCapacity' for the fluid capacity per tank in mB, and an optional 'autoPush' boolean to enable fluid transfer to adjacent storage.

```json
"config": {
    "rows": 3,
    "columns": 3,
    "slotCapacity": 1000,
    "autoPush": true
}
```

--------------------------------

### Mekanism Gas Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Specifies a Mekanism gas as an ingredient. The 'gas' field is the Mekanism gas ID, and 'amount' is the quantity in millibuckets (mB). This allows recipes to consume specific gases.

```json
"ingredient": {
    "type": "mm:mekanism/gas",
    "gas": "mekanism:hydrogen",
    "amount": 10
}
```

--------------------------------

### Energy Port Configuration Parameters (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/energy-ports

This JSON object details the configuration parameters for an energy port. 'capacity' sets the maximum energy storage, while 'maxReceive' and 'maxExtract' control energy transfer rates per tick. 'autoPush' enables automatic energy distribution to adjacent storage blocks.

```json
"config": {
    "capacity": 1000000,
    "maxReceive": 1000,
    "maxExtract": 1000,
    "autoPush": true
}
```

--------------------------------

### Item Tag Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Defines an ingredient based on an item tag and count. The 'tag' field matches any item with the specified tag ID, and 'count' specifies the quantity. This allows for flexible ingredient matching.

```json
"ingredient": {
    "type": "mm:item",
    "tag": "forge:ingots",
    "count": 5
}
```

--------------------------------

### Define Machine Structure with JSON

Source: https://newdocs.masterfulmc.com/current/structures

This JSON object defines a machine structure for Masterful Machinery. It includes the structure's name, the controller IDs that can form it, a 3D layout of blocks using characters, and a key that maps these characters to specific block requirements or ports. Whitespace in the layout is ignored.

```json
{
  "name": "My Machine",
  "controllerIds": "mm:controller_a",
  "layout": [
    [
      "  A  "
    ],
    [
      "1PCD2"
    ],
    [
      "1P D2"
    ]
  ],
  "key": {
    "A": {
      "block": "minecraft:glass"
    },
    "P": {
      "block": "mm:my_port_input"
    },
    "D": {
      "portType": "mm:item",
      "input": false
    },
    "1": {
      "port": "mm:my_port",
      "input": true
    },
    "2": {
      "port": "mm:my_port",
      "input": false
    }
  }
}
```

--------------------------------

### Define a Create Kinetic Port (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/create-kinetic-compat

This JSON snippet demonstrates the structure for defining a Create Kinetic port. It includes essential fields like 'id', 'controllerIds', 'name', 'type', and a 'config' object for specific settings. The 'type' field 'mm:create/kinetic' is crucial for identifying the port type.

```json
{
  "id": "my_kinetic_port",
  "controllerIds": "mm:controller_a",
  "name": "My Create Kinetic",
  "type": "mm:create/kinetic",
  "config": {
    "stress": 4
  }
}
```

--------------------------------

### Specify Infusion Port Type (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/mekanism-ports-compat/infusion-ports

This snippet shows how to set the 'type' field to 'mm:mekanism/infuse'. This is crucial for the configuration reader to correctly interpret and apply Mekanism-specific infusion port settings.

```json
"type": "mm:mekanism/infuse"
```

--------------------------------

### Mekanism Slurry Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Defines a Mekanism slurry as an ingredient. The 'slurry' field is the Mekanism slurry ID (e.g., clean or dirty), and 'amount' is the quantity in millibuckets (mB).

```json
"ingredient": {
    "type": "mm:mekanism/slurry",
    "slurry": "mekanism:clean_tin",
    "amount": 10
}
```

--------------------------------

### Botania Mana Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Specifies Botania mana as an ingredient. The 'mana' field indicates the amount of mana required for the recipe. This ingredient type is exclusive to the Botania mod.

```json
"ingredient": {
    "type": "mm:botania/mana",
    "mana": 25
}
```

--------------------------------

### Create PneumaticCraft Air Port (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/pneumaticcraft-air-compat

This JSON object defines a PneumaticCraft air port. It includes a unique 'id', associated 'controllerIds', a descriptive 'name', the 'type' identifier, and a 'config' object for specific parameters. The 'config' object contains 'danger', 'critical', and 'volume' settings.

```json
{
  "id": "my_air_port",
  "controllerIds": "mm:controller_a",
  "name": "My Air Port",
  "type": "mm:pneumaticcraft/air",
  "config": {
    "danger": 11.0,
    "critical": 12.0,
    "volume": 20000
  }
}
```

--------------------------------

### PneumaticCraft Air Port Configuration Parameters (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/pneumaticcraft-air-compat

This JSON fragment details the configuration options for a PneumaticCraft air port. It includes 'volume' for capacity, 'danger' for the high-pressure warning threshold, and 'critical' for the pressure limit that could cause an explosion.

```json
"config": {
  "danger": 11.0,
  "critical": 12.0,
  "volume": 20000
}
```

--------------------------------

### PneumaticCraft Air Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Defines a PneumaticCraft air ingredient. The 'pressure' field sets a limit for the air pressure, and 'air' specifies the amount of air required in the recipe. This ingredient is for PneumaticCraft: Air Pressure.

```json
"ingredient": {
    "type": "mm:pneumaticcraft/air",
    "pressure": 0.7,
    "air": 100
}
```

--------------------------------

### Create Kinetic Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Specifies a Create kinetic rotation ingredient. The 'speed' field determines the required rotational speed in RPM. This ingredient type is specific to the Create mod.

```json
"ingredient": {
    "type": "mm:create/kinetic",
    "speed": 16
}
```

--------------------------------

### Botania Mana Port Type Identifier (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/botania-mana-compat

This snippet shows the specific 'type' field value required to identify a Botania mana port within the configuration system. This value is crucial for the config reader to correctly interpret and apply Botania mana port-specific settings.

```json
"type": "mm:botania/mana"
```

--------------------------------

### Item Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Defines an ingredient using a specific item and count. The 'item' field specifies the item ID, and 'count' determines the quantity required. This is a fundamental ingredient type.

```json
"ingredient": {
    "type": "mm:item",
    "item": "minecraft:string",
    "count": 5
}
```

--------------------------------

### Configure Per-Tick Consumption - JSON

Source: https://newdocs.masterfulmc.com/current/process-recipes/input-entries

This JSON snippet illustrates the 'per_tick' field, which enables consuming an ingredient every tick of a recipe's timer. Omitting this field causes the ingredient to be consumed only at the end of the timer.

```json
"per_tick": true
```

--------------------------------

### Energy Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Defines an ingredient based on energy. The 'amount' field specifies the quantity of energy, typically in Forge Energy (FE). This is used for recipes that consume or require a specific amount of energy.

```json
"ingredient": {
    "type": "mm:energy",
    "amount": 1000
}
```

--------------------------------

### Configure Stress for Kinetic Port (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/create-kinetic-compat

This JSON snippet shows the 'config' object for a Create Kinetic port, specifically highlighting the 'stress' key. The value assigned to 'stress' dictates either the stress capacity for output ports or the stress impact for input ports within the kinetic network.

```json
"config": {
    "stress": 4
}
```

--------------------------------

### Mekanism Infusion Ingredient Configuration (JSON)

Source: https://newdocs.masterfulmc.com/current/process-recipes/ingredient-configs

Defines a Mekanism infusion type as an ingredient. The 'infuse' field is the Mekanism infusion type ID. This ingredient does not typically require an 'amount' field as it represents a type.

```json
"ingredient": {
    "type": "mm:mekanism/infuse",
    "infuse": "mekanism:bio",
    "amount": 20
}
```

--------------------------------

### Mekanism Gas Port Capacity Configuration

Source: https://newdocs.masterfulmc.com/current/ports/mekanism-ports-compat/gas-ports

Details the configuration field for setting the storage capacity of a Mekanism gas port. The 'capacity' field accepts a numerical value representing the maximum amount of gas the port can hold.

```json
"config": {
    "capacity": 10000000
}
```

--------------------------------

### Identify Create Kinetic Port Type (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/create-kinetic-compat

This JSON snippet isolates the 'type' field used to identify a Create Kinetic port. The value 'mm:create/kinetic' specifically signals to the configuration reader to process kinetic port-specific parameters within the 'config' object.

```json
"type": "mm:create/kinetic"
```

--------------------------------

### Item Port Type Definition (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/item-ports

This snippet shows the 'type' field within an item port's configuration, which is set to 'mm:item'. This designation informs the system to process specific item port fields within the 'config' object.

```json
"type": "mm:item"
```

--------------------------------

### Create Circuit Extra Block JSON - MasterfulMC

Source: https://newdocs.masterfulmc.com/current/extra-blocks

Defines a Circuit type Extra Block. Requires a unique 'id', a display 'name', and specifies the 'type' as 'mm:circuit'. The 'id' is automatically prefixed with 'mm:'.

```json
{
  "id": "my_circuit",
  "name": "My Circuit",
  "type": "mm:circuit"
}
```

--------------------------------

### Weather Condition Configuration

Source: https://newdocs.masterfulmc.com/current/process-recipes/recipe-conditions

Configures a recipe to run only when specific weather conditions are met. The 'type' must be 'mm:weather', and the 'weather' field accepts 'clear', 'rain', or 'thunder'. This condition is useful for time-sensitive or atmospheric recipes.

```json
{
    "type": "mm:weather",
    "weather": "clear"
}
```

--------------------------------

### Define Structure ID for Process Recipe

Source: https://newdocs.masterfulmc.com/current/process-recipes

Specifies the 'structureId' field within a process recipe. This ID links the recipe to a specific structure JSON file within the datapack, indicating which structure the recipe is intended for.

```json
"structureId": "mypack:my_structure"
```

--------------------------------

### Configure Chance-Based Consumption - JSON

Source: https://newdocs.masterfulmc.com/current/process-recipes/input-entries

This JSON snippet shows the 'chance' field, allowing for a random chance (0.0 to 1.0) of consuming an ingredient per tick. A value of 0 means never consumed, 1 means always consumed. The default is 1 if omitted.

```json
"chance": 0.5
```

--------------------------------

### Define Required Port by ID and Type - JSON

Source: https://newdocs.masterfulmc.com/current/structures/structure-requirements

This code specifies a requirement for a port based on its ID and whether it should be an input or output. The 'input' field is optional; omitting it matches both input and output ports.

```json
{
  "A": {
    "port": "mm:my_port",
    "input": true 
  }
}
```

--------------------------------

### Fluid Port Type Identifier (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/fluid-ports

This snippet shows the specific value for the 'type' field that identifies a fluid port. This 'mm:fluid' value signals the configuration reader to apply fluid port-specific settings.

```json
"type": "mm:fluid"
```

--------------------------------

### Mekanism Gas Port Type Identifier

Source: https://newdocs.masterfulmc.com/current/ports/mekanism-ports-compat/gas-ports

Specifies the exact string value used to identify a Mekanism gas port within the configuration system. This identifier determines how the system interprets the port's properties.

```json
"type": "mm:mekanism/gas"
```

--------------------------------

### Create Vent Extra Block JSON - MasterfulMC

Source: https://newdocs.masterfulmc.com/current/extra-blocks

Defines a Vent type Extra Block. Requires a unique 'id', a display 'name', and specifies the 'type' as 'mm:vent'. The 'id' is automatically prefixed with 'mm:'.

```json
{
  "id": "my_vent",
  "name": "My Vent",
  "type": "mm:vent"
}
```

--------------------------------

### Create Gearbox Extra Block JSON - MasterfulMC

Source: https://newdocs.masterfulmc.com/current/extra-blocks

Defines a Gearbox type Extra Block. Requires a unique 'id', a display 'name', and specifies the 'type' as 'mm:gearbox'. The 'id' is automatically prefixed with 'mm:'.

```json
{
  "id": "my_gears",
  "name": "My Gears",
  "type": "mm:gearbox"
}
```

--------------------------------

### Define Required Port by Type - JSON

Source: https://newdocs.masterfulmc.com/current/structures/structure-requirements

This code sets a requirement for a port based on its type, with an optional specification for input or output. Omitting the 'input' field allows matching both input and output ports of the specified type.

```json
{
  "A": {
    "portType": "mm:item",
    "input": true 
  }
}
```

--------------------------------

### Define Required Block by ID - JSON

Source: https://newdocs.masterfulmc.com/current/structures/structure-requirements

This code defines a requirement where a specific block ID must be used at a certain placement point. It uses a JSON object to map a placement identifier (e.g., 'A') to the required block.

```json
{
  "A": {
    "block": "minecraft:glass"
  }
}
```

--------------------------------

### Add Conditions Field to Recipe JSON

Source: https://newdocs.masterfulmc.com/current/process-recipes/recipe-conditions

This snippet demonstrates how to add the 'conditions' field to your Masterful Minecraft recipe JSON file. This field accepts an array of condition objects that must all be met for the recipe to be active. No external dependencies are required, and the input is a JSON object.

```reason
{
    // other fields
    "conditions": [
        // add conditions here
    ]
}
```

--------------------------------

### PneumaticCraft Air Port Type Identifier (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/pneumaticcraft-air-compat

This snippet shows the specific 'type' field required to identify a PneumaticCraft air port within the configuration. Setting this correctly ensures the system interprets the subsequent configuration parameters appropriately.

```json
"type": "mm:pneumaticcraft/air"
```

--------------------------------

### Mekanism Slurry Port Type Identifier (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/mekanism-ports-compat/slurry-ports

Specifies the type identifier for a Mekanism slurry port within a configuration file. This string value is crucial for the system to correctly interpret the port's properties and functionality.

```json
"type": "mm:mekanism/slurry"
```

--------------------------------

### Energy Port Type Identifier (JSON)

Source: https://newdocs.masterfulmc.com/current/ports/energy-ports

This snippet shows the specific JSON value used to identify an energy port. The 'type' field must be set to 'mm:energy' to ensure the configuration reader correctly parses energy port-specific fields within the 'config' object.

```json
"type": "mm:energy"
```

--------------------------------

### Specify Block State Property Requirement in JSON

Source: https://newdocs.masterfulmc.com/current/structures/common-requirements

This JSON snippet demonstrates how to define a requirement for a specific block state property, such as the 'axis' property of a block. This is useful for ensuring that blocks within a structure have the correct orientation or state. The property values might rotate based on the structure's placement orientation.

```json
{
    "A": {
        //...
        "properties": [
            {
                "property": "axis",
                "value": "x"
            }
        ]
    }
}
```

--------------------------------

### Define Required Block by Tag - JSON

Source: https://newdocs.masterfulmc.com/current/structures/structure-requirements

This code specifies a requirement for a block that belongs to a particular block tag. It's important to note that this matches Block Tags, not Item Tags.

```json
{
  "A": {
    "tag": "minecraft:wools"
  }
}
```

--------------------------------

### Dimension Condition Configuration

Source: https://newdocs.masterfulmc.com/current/process-recipes/recipe-conditions

Sets a recipe to be active only within a specified Minecraft dimension. The 'type' must be 'mm:dimension', and the 'dimension' field requires the ID of the target dimension. This allows for dimension-exclusive crafting or processing.

```json
{
    "type": "mm:dimension",
    "dimension": "minecraft:overworld"
}
```
Tokens:
Raw