The blockbuilder is used to… build blocks (you totally didn’t see that one coming, right… right?).
Once you created it you can set various properties which will be outlined by the separate methods.

You can also change the block's type to create a more specialized form of block (e.g. stairs or Blocks that can be rotated in the same way logs can). To tell CoT that you want the block to appear ingame you need to call [mods.contenttweaker.block.BlockBuilder#build(String)](/mods/contenttweaker/API/block/BlockBuilder/#build) and specify a valid resource location path.

This class was added by a mod with mod-id contenttweaker. So you need to have this mod installed if you want to use this feature.

Importing the class

It might be required for you to import the package if you encounter any issues (like casting an Array), so better be safe than sorry and add the import.

mods.contenttweaker.block.BlockBuilder

Implemented Interfaces

BlockBuilder implements the following interfaces. That means any method available to them can also be used on this class.

mods.contenttweaker.api.IIsBuilder

Constructors

Creates a new BlockBuilder. Remember that this will not create a new block in the game, you need to call mods.contenttweaker.block.BlockBuilder#build(String) for that.

new mods.contenttweaker.block.BlockBuilder(material as crafttweaker.api.block.material.MCMaterial);
new mods.contenttweaker.block.BlockBuilder();
new mods.contenttweaker.block.BlockBuilder(<blockmaterial:earth>);

Parameter	Type	Description	IsOptional	Default Value
Parameter material	Type crafttweaker.api.block.material.MCMaterial	Description The material this block will have	IsOptional true	Default Value `<blockmaterial:iron>`

Methods

build

Instructs CoT to actually build whatever this builder is supposed to be building.

myBlockBuilder.build(resourceLocation as String);
myBlockBuilder.build("my_awesome_block");

Parameter	Type	Description
Parameter resourceLocation	Type String	Description The resource path to give this block

withHardnessAndResistance

Sets the block’s hardness and resistance levels. Unlike the other method, this one only accepts one parameter and will use that value for both properties.

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withHardnessAndResistance(hardnessAndResistance as float);
myBlockBuilder.withHardnessAndResistance(0.5f);

Parameter	Type	Description
Parameter hardnessAndResistance	Type float	Description The value to set for hardness and for resistance.

Sets the block’s hardness and resistance levels. Unlike the other method, this one allows you to set each property one to a separate value.

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withHardnessAndResistance(hardnessIn as float, resistanceIn as float);
myBlockBuilder.withHardnessAndResistance(0.5f, 0.5f);

Parameter	Type	Description
Parameter hardnessIn	Type float	Description The value to set for hardness
Parameter resistanceIn	Type float	Description The value to set for resistance.

withHarvestLevel

Sets the mining level required to mine this block

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withHarvestLevel(harvestLevel as int);
myBlockBuilder.withHarvestLevel(3);

Parameter	Type	Description
Parameter harvestLevel	Type int	Description The harvest level requried

withHarvestTool

Sets the tool required to harvest this block

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withHarvestTool(harvestTool as mods.contenttweaker.item.MCToolType);
myBlockBuilder.withHarvestTool(<tooltype:shovel>);

Parameter	Type	Description
Parameter harvestTool	Type mods.contenttweaker.item.MCToolType	Description The tool type

withItemGroup

Sets the item group in which this block will appear

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withItemGroup(group as mods.contenttweaker.item.MCItemGroup);
myBlockBuilder.withItemGroup(<itemgroup:building_blocks>);

Parameter	Type	Description
Parameter group	Type mods.contenttweaker.item.MCItemGroup	Description The group to set

withLightValue

Sets the block’s light value.

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withLightValue(lightValueIn as int);
myBlockBuilder.withLightValue(15);

Parameter	Type	Description
Parameter lightValueIn	Type int	Description The light level to set

withLootFrom

Will instruct CoT to override this block’s loot table with the one of the block Provided. Currently this will still create a loot table entry, though it will be ignored by the game.

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withLootFrom(blockIn as crafttweaker.api.block.MCBlock);
myBlockBuilder.withLootFrom(<block:minecraft:diamond>);

Parameter	Type	Description
Parameter blockIn	Type crafttweaker.api.block.MCBlock	Description The block whose loot table should be applied

withMaxStackSize

Sets the maximum Stack size that this block can have when in your inventory. Will be 64 if unchanged.

Returns: This builder, used for chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withMaxStackSize(size as int);
myBlockBuilder.withMaxStackSize(16);

Parameter	Type	Description
Parameter size	Type int	Description The size to set.

withRarity

Allows you to set the rarity of this block.

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withRarity(rarity as String);
myBlockBuilder.withRarity("UNCOMMON");

Parameter	Type	Description
Parameter rarity	Type String	Description The rarity

withSlipperiness

Sets the slipperiness.

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withSlipperiness(slipperinessIn as float);
myBlockBuilder.withSlipperiness(0.5f);

Parameter	Type	Description
Parameter slipperinessIn	Type float	Description The value to set

withType

Sets the specific type of this block. After this method is called the builder’s context will switch to the more provided type builder. That means that the methods of this builder will no longer be available, so any properties you wish to set should be set before you call this method.

Returns: A builder with the given block.

Return type: T

myBlockBuilder.withType<T>();
myBlockBuilder.withType<mods.contenttweaker.block.pillar.BlockBuilderPillarRotatable>();

ParameterName	Bounds
ParameterName T	Bounds mods.contenttweaker.block.BlockTypeBuilder

withoutDrops

Will instruct CoT that this block will not have any loot entries. Currently this will still create a loot table entry, though it will be ignored by the game.

Returns: This builder, used for method chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withoutDrops();

withoutMovementBlocking

Instructs CoT that this block will does not block movement.

Returns: This builder, used for chaining

Return type: mods.contenttweaker.block.BlockBuilder

myBlockBuilder.withoutMovementBlocking();