Block behaviour (Java Edition)

This article describes the various components of block behaviour in Java Edition, based on the class BlockBehaviour in the code.

This article aims to document the technical details of each block's behavior, citing the code responsible for each behavior and specifying details such as which tags are used, how the block states or block entity is affected, which advancement triggers are activated, etc. These details are usually hidden in the usage section of a specific block's wiki page.

This file may become very large and need to be split, however, the basic property information should be present here, pointing to main articles when necessary.

Note that not all block behaviors will be described here, as some behaviors of certain blocks are described in item classes, entities, etc. For example, the behavior of blocks in the #convertable_to_mud tag turning into mud is described by the items that corvert them.^[1]

BlockBehaviour(...)

These are the block properties saved as attributes of each block instance. Normally these properties are given in the block registry in the Blocks class, or sometimes in a subclass of Block.

• hasCollision
• drops
• descriptionId
• explosionResistance
• isRandomlyTicking
• soundType
• friction
• speedFactor
• jumpFactor
• dynamicShape
• requiredFeatures
• properties

The effect of each property depends on its use in other methods.

Properties is a public static class of BlockBehaviour which defines the properties for each block. These properties serve to describe general block behaviors that do not need to be specified by a specific method.

For example, blocks with the hasCollision property, a priori, have a collision shape equal to their shape, and blocks without this property have an empty collision box. However, there are some exceptions, namely the blocks that have implementations of the method that defines their collision box, defining it more specifically.

Block properties can be of various types, such as boolean, float, etc., unlike block tags which in practice function as a boolean property.

There are many methods used to assign properties to a certain block; most commonly, the Blocks class is used to add properties to blocks at the time of their registration.

ofLegacyCopy(...)

Copies some properties from one block to another.

The final properties of the new block are, in order of priority:

• Properties defined after copying
• Properties copied from the other block, which are:

• Default properties, for the other properties

Used in the registration of 105 blocks and in the method registerLegacyStair(...) (used in the registration of 47 stairs) in Blocks, and in ofFullCopy(...).

ofFullCopy(...)

Like the ofLegacyCopy(...) but in addition to the properties copied by ofLegacyCopy(...) it also copies:

• jumpFactor
• isRedstoneConductor
• isValidSpawn
• postProcess
• isSuffocating
• isViewBlocking
• drops
• descriptionId

Used in the registration of 84 blocks and in the method registerStair(...) (used in the registration of 4 cut copper stairs) in Blocks.

mapColor(...)

For all states of the block, define the color map as the color associated with the given dye color.

Used in the registration of 48 blocks (all 16 glazed terracotta, concrete, and concrete powder) and in the method registerStainedGlass(...) (unsed in all 16 stained glass) in Blocks.

mapColor(...)

For all states of the block, define the color map with the given map color

Used in the registration of 662 blocks, in the method leavesProperties(...) (used in 9 leaves), in the method shulkerBoxProperties(...) (used in all 17 shulker boxs), in the method pistonProperties() (used in piston and sticky piston) and, in the method candleProperties(...) (used in all 17 candles) in Blocks.

mapColor(...)

For a block, it defines a map between its states and a map color, so that the same block can have different colors in different states.

Used in the registration of 3 blocks (wheat crop, barrier and light), in the method registerBed(...) (unsed in all 16 beds), in the method logProperties(...) (unsed in 21 blocks, but 11 of they have the same color for all states) and, in the method netherStemProperties(...) (unsed in 4 blocks, but they all have the same color for all states) in Blocks.

noCollision()

Set the hasCollision and canOcclude block properties to false.

Used in the registration of 241 blocks and in the method buttonProperties() (used in the registration of 14 buttons) in Blocks.

Hardcoded item properties (Java Edition) — Similar article for items