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 directions NONE: Cannot rotate NONE_Y_AXIS: X, Z axis directions Y_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 block false: 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 block false: 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 content out: Output content both: 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 content out: Output content both: 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 capabilities NONE: Don't proxy any capabilities IN: Only proxy input capabilities OUT: 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.

Contributors

M1hono

Changelog

Last edited 6 months ago

View full history

f655109-Reorganize SingleBlock Machine structure.

e92ea0b-Update CNAME.

269c420-Update Single Block Machine Setting Details.

760523a-Init 1.21 KubeJS File Structure. Translate the current porcess of MBD2 Tutorial.