Common

KattonBlockModificationApi

top.katton.api.modcommon/src/main/kotlin/top/katton/api/mod/KattonBlockModificationApi.kt

Configuration for modifying existing block properties.

Members

Jump directly to declarations on this page.

• BlockModificationConfigClass
• modifyBlockFunction
• modifyBlockFunction
• getBlockFunction
• getBlockFunction
• getBlockStateFunction
• getBlockStateFunction

BlockModificationConfig

CommonClass

class BlockModificationConfig( val blockId: Identifier )

Configuration for modifying existing block properties.

This class provides a fluent API for modifying properties of existing blocks registered in Minecraft's block registry. Similar to KubeJS's block modification system.

Properties

Property	Description
blockId	The identifier of the block to modify

modifyBlock

CommonFunction

@ApiStatus.Experimental
@ApiStatus.Experimental fun modifyBlock(blockId: String, configure: BlockModificationConfig.() -> Unit): Block

Modifies an existing block's properties.

This function allows you to modify properties of blocks already registered in Minecraft's block registry. Changes are applied to the block's default state and will affect all instances of that block.

Parameters

Parameter	Description
blockId	The identifier of the block to modify (e.g., "minecraft:stone")
configure	Configuration lambda for block modifications

Returns

The modified Block instance

modifyBlock

CommonFunction

@ApiStatus.Experimental
@ApiStatus.Experimental fun modifyBlock(blockId: Identifier, configure: BlockModificationConfig.() -> Unit): Block

Modifies an existing block's properties.

Parameters

Parameter	Description
blockId	The identifier of the block to modify
configure	Configuration lambda for block modifications

Returns

The modified Block instance

getBlock

CommonFunction

fun getBlock(blockId: String): Block?

Gets a block by its identifier.

Parameters

Parameter	Description
blockId	The block identifier

Returns

The Block instance, or null if not found

getBlock

CommonFunction

fun getBlock(blockId: Identifier): Block?

Gets a block by its identifier.

Parameters

Parameter	Description
blockId	The block identifier

Returns

The Block instance, or null if not found

getBlockState

CommonFunction

fun getBlockState(blockId: String): BlockState?

Gets the default block state for a block.

Parameters

Parameter	Description
blockId	The block identifier

Returns

The default BlockState, or null if block not found

getBlockState

CommonFunction

fun getBlockState(blockId: Identifier): BlockState?

Gets the default block state for a block.

Parameters

Parameter	Description
blockId	The block identifier

Returns

The default BlockState, or null if block not found