Basic Settings
🌱 Preliminary Completion
The content in this article has been preliminarily completed and can serve as a reference. However, there may be possible errors or areas in need of improvement.
This module can configure the working state of the machine. Its basic configuration
allows players to set the block properties
, item properties
, and machine settings
of the machine.
Block Properties
This configures the
block properties
of the machine. There are detailed tips for each property in the game, which can be obtained by moving the mouse over the question mark box. Therefore, they are only listed here with necessary expansions.Detailed Overview
Property Name | Description | Options | Explanation | Reload Type |
---|---|---|---|---|
Render Type | The block's render type | SOLID : Fully opaque rendering, suitable for blocks that do not require any transparency effects, such as stone and dirt.CUTOUT : Uses alpha testing without mipmapping, suitable for blocks that require transparency effects through the alpha channel, like leaves and iron bars.CUTOUT_MIPPED : Uses alpha testing with mipmapping enabled, suitable for transparent blocks that need to maintain good texture performance at a distance.TRANSLUCENT : Uses alpha blending for partial transparency, suitable for blocks that require partial transparency effects, such as glass and ice. | Controls the rendering method of the block | NEED TO RESTART |
Use AO | Whether to enable ambient occlusion rendering | boolean | When enabled, it can increase the details of block shadows, improving visual effects | NO NEED TO RESTART |
Rotation State | Allowed rotation directions for the block | ALL : All directionsNONE : Cannot rotateNONE_Y_AXIS : X, Z axis directionsY_AXIS : Only Y axis direction | Controls the placement direction of the block in the game | NEED TO RESTART |
Has Collision | Whether to enable collision detection | boolean | When enabled, players and other entities will not be able to pass through this block | NEED TO RESTART |
Dynamic Shape | Whether to enable dynamic shape | boolean | Allows setting the block's shape dynamically | NEED TO RESTART |
Ignited by lava | Whether the block can be ignited by lava | boolean | Affects the interaction between the block and lava | NEED TO RESTART |
Is Air | Whether the block is treated as air | boolean | If true, this block will not block movement or placement | NEED TO RESTART |
Is Suffocating | Whether the block causes entities to suffocate | boolean | If false, entities can breathe inside the block | NEED TO RESTART |
Emissive | Whether the block emits light | boolean | When enabled, the block (texture) will glow in the dark | NEED TO RESTART |
Friction | The friction coefficient of the block surface | float [0.0, 1.0] | 0.0 = No friction (extremely slippery) 1.0 = Maximum friction (extremely rough) | NEED TO RESTART |
Speed Factor | Affects movement speed on the block | float [0.0, +∞) | 1.0 = Normal speed >1.0 = Acceleration (e.g., 1.5 = 50% acceleration) <1.0 = Deceleration (e.g., 0.5 = 50% deceleration) | NEED TO RESTART |
Jump Factor | Affects jump height from the block | float [0.0, +∞) | 1.0 = Normal jump >1.0 = Increase jump height <1.0 = Decrease jump height | NEED TO RESTART |
Destroy Time | Time required to destroy the block | float [0.0, +∞) seconds | 0.0 = Instant destruction Higher = Harder to destroy | NEED TO RESTART |
Explosion Resistance | The block's ability to resist explosions | float [0.0, +∞) | 0.0 = No resistance Higher = More resistant to explosions | NEED TO RESTART |
Sound | Sound played when interacting with the block | SoundEvent | Specifies the sound effect when the block is destroyed | NEED TO RESTART |
Transparent Block | Whether the block is glass-like | boolean | If true, the block will be transparent | NO NEED TO RESTART |
Item Properties
This configures the properties of the machine when it exists as an item. There are detailed tips for each property in the game, which can be obtained by moving the mouse over the question mark box. Therefore, they are only listed here with necessary expansions.
Detailed Overview
Property Name | Description | Options | Explanation | Reload Type |
---|---|---|---|---|
Use Block Light | Controls how the block is lit as an item in the GUI | boolean | true : The item will be lit on the side as a blockfalse : The item will be lit on the front as an item | NO NEED TO RESTART |
Use GUI 3D | Controls the rendering of the block as an item | boolean | Controls whether the item is displayed as a 3D model in the GUI | NO NEED TO RESTART |
Item Render | Selects whether to customize the item's rendering | boolean | true : Select a separate rendering for this blockfalse : Use the parent state of the machine as the default rendering | NO NEED TO RESTART |
Max Stack Size | Sets the maximum stack size of the item | int [1,64] | The maximum stack size of the item | NEED TO RESTART |
Rarity | Sets the rarity of the item | Rarity | The rarity of the item | NEED TO RESTART |
Tooltip | Sets the tooltip of the item | List<Tooltip > | Used to set the tooltip of the item, also known as Lore. | NO NEED TO RESTART |
Slot Preview | Used to preview the inventory | none | Used for preview only | none |
Machine Settings
This section configures the
Machine Settings
, allowing players to set the machine's attributes and recipes. Detailed tips can be obtained by moving the mouse over the question mark box, so they are only listed here with necessary expansions.This configuration does not require restarting the game.Detailed Overview
Property Name | Description | Options | Explanation |
---|---|---|---|
Machine Level | Sets the machine's level | int [0, +∞) | Sets the machine's level, can be used for recipe conditions. |
Has GUI | Whether to display GUI | boolean | If true, the machine will display a GUI |
Has Recipe Logic | Whether to enable recipe logic | boolean | false : The machine will not process recipes. If the machine doesn't need to process recipes, set to false to optimize performance. |
Recipe Damping Value | Sets the recipe damping value | int [0.0, +∞) | If recipe processing is waiting, the damping value is the number of ticks the current progress decreases. |
Recipe Type | Sets the machine's recipe type | RecipeType | Sets the corresponding recipe for the machine. |
Recipe Modifiers | Adds and modifies recipe modifiers | List<RecipeModifier > | Used to modify self/controller recipes in real-time, can be used to create upgrade/plugin components |
- Content Modifier: Used for modifying recipe content. For example, item quantities, fluid amounts, etc.
Multiplier | Sets the modifier multiplier | float [0.0, +∞) | Multiplier for recipe content quantities |
Addition | Sets the modifier addition | float [0.0, +∞) | Addition for recipe content quantities |
Target Content | Modifies working method | option | in : Input contentout : Output contentboth : Input and output content |
- Duration Modifier: Used for modifying recipe duration.
Multiplier | Sets the modifier multiplier | float [0.0, +∞) | Multiplier for recipe duration |
Addition | Sets the modifier addition | float [0.0, +∞) | Addition for recipe duration |
- Maximum Parallel: This value is the maximum number of recipes the machine can process at the same time, don't set it too high.
Multiplier | Sets the modifier multiplier | float [0.0, +∞) | Multiplier for maximum parallel |
Addition | Sets the modifier addition | float [0.0, +∞) | Addition for maximum parallel |
MultiBlock Part Settings | Sets multiblock part | boolean | false : The machine will not run as a normal single block. true : The machine will support running as a multiblock part on a single block. |
Formed Machine Settings
This section configures the
Formed Machine Settings
, allowing players to set the machine's multiblock parts
.Detailed Overview
Property Name | Description | Options | Explanation |
---|---|---|---|
Can Share | Whether it can be shared | boolean | Whether this part can be shared among multiple multiblock machines |
Recipe Modifiers | Adds and modifies recipe modifiers | List<RecipeModifier > | Used to modify self/controller recipes in real-time, can be used to create upgrade/plugin components |
- Content Modifier: Used for modifying recipe content. For example, item quantities, fluid amounts, etc.
Multiplier | Sets the modifier multiplier | float [0.0, +∞) | Multiplier for recipe content quantities |
Addition | Sets the modifier addition | float [0.0, +∞) | Addition for recipe content quantities |
Target Content | Modifies working method | option | in : Input contentout : Output contentboth : Input and output content |
- Duration Modifier: Used for modifying recipe duration.
Multiplier | Sets the modifier multiplier | float [0.0, +∞) | Multiplier for recipe duration |
Addition | Sets the modifier addition | float [0.0, +∞) | Addition for recipe duration |
- Maximum Parallel: This value is the maximum number of recipes the machine can process at the same time, don't set it too high.
Multiplier | Sets the modifier multiplier | float [0.0, +∞) | Multiplier for maximum parallel |
Addition | Sets the modifier addition | float [0.0, +∞) | Addition for maximum parallel |
Proxy Controller Capabilities | Sets proxy controller capabilities | boolean | If the part doesn't contain the required capabilities, it will proxy capabilities from the controller's capabilities. |
- Capability Filter
Trait Name Filter | Sets trait name filter | string | Sets the trait name filter, only traits with matching names will be proxied. |
Capability IO | Capability behavior for all sides of the machine | boolean | BOTH : Proxy both internal and external capabilitiesNONE : Don't proxy any capabilitiesIN : Only proxy input capabilitiesOUT : Only proxy output capabilities |
INFO
Directions include Internal
, Front
, Back
, Left
, Right
, Top
, Bottom
.
WARNING
If you set the top to OUT-Output
for Item Capability Trait
, the machine's top will only be able to be extracted from.