View source for Minecraft:Block behaviour (Java Edition)

{{WIP}}
{{Stub}}

This article describes the various components of block behaviour {{in|JE}}, based on the class {{jbcp|state|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 [[Minecraft:Tag_(Java_Edition)|tags]] are used, how the [[Minecraft:block states]] or [[Minecraft:block entity]] is affected, which [[Minecraft:Advancement_definition#List_of_triggers|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 {{Tag link|block|convertable_to_mud}} tag turning into mud is described by the items that corvert them.{{refhip|PotionItem}}

== Properties ==

'''BlockBehaviour({{Tooltip|...|Properties properties}})'''

These are the block properties saved as attributes of each block instance. Normally these properties are given in the block registry in the {{jbcp|-s}} class, or sometimes in a subclass of {{jbcp|}}.

* 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 class  ===

Properties is a public static class of {{jbcp|state|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.

{| class="wikitable sortable collapsible" style="width:100%"
! Type
! Properties
! Default
|-
| Function<BlockState, MapColor> || mapColor || state -> MapColor.NONE 
|-
| {{nbt|bool}} boolean || hasCollision  || true 
|-
| SoundType || soundType || SoundType.STONE 
|-
| ToIntFunction<BlockState> || lightEmission || state -> 0 
|-
| {{nbt|float}} float || explosionResistance 
|
|-
| {{nbt|float}} float || destroyTime 
|
|-
| {{nbt|bool}} boolean|| requiresCorrectToolForDrops 
|
|-
| {{nbt|bool}} boolean|| isRandomlyTicking 
|
|-
| {{nbt|float}} float || friction || 0.6f 
|-
| {{nbt|float}} float || speedFactor || 1.0f 
|-
| {{nbt|float}} float || jumpFactor || 1.0f 
|-
| @Nullable ResourceKey<Block> || id 
|
|-
| DependantName<Block, Optional<ResourceKey<LootTable>>> || drops || id -> Optional.of(ResourceKey.create(Registries.LOOT_TABLE, id.identifier().withPrefix("blocks/"))) 
|-
| DependantName<Block, String> || descriptionId || id -> Util.makeDescriptionId("block", id.identifier()) 
|-
| {{nbt|bool}} boolean|| canOcclude || true 
|-
| {{nbt|bool}} boolean|| isAir 
|
|-
| {{nbt|bool}} boolean|| ignitedByLava 
|
|-<!--@Deprecated-->
| {{nbt|bool}} boolean|| liquid 
|
|-<!--@Deprecated-->
| {{nbt|bool}} boolean|| forceSolidOff ||
|-
| {{nbt|bool}} boolean|| forceSolidOn 
|
|-
| PushReaction || pushReaction || PushReaction.NORMAL 
|-
| {{nbt|bool}} boolean|| spawnTerrainParticles || true 
|-
| NoteBlockInstrument || instrument || NoteBlockInstrument.HARP 
|-
| {{nbt|bool}} boolean|| replaceable 
|
|-
| StateArgumentPredicate<EntityType<?>> || isValidSpawn || (state, level, pos, entityType) -> state.isFaceSturdy(level, pos, Direction.UP) && state.getLightEmission() < 14 
|-
| StatePredicate || isRedstoneConductor || BlockStateBase::isCollisionShapeFullBlock 
|-
| StatePredicate || isSuffocating || (state, level, pos) -> state.blocksMotion() && state.isCollisionShapeFullBlock(level, pos) 
|-
| StatePredicate || isViewBlocking || this.isSuffocating 
|-
| PostProcess || postProcess || (state, level, pos) -> null 
|-
| StatePredicate || emissiveRendering || (state, level, pos) -> false 
|-
| {{nbt|bool}} boolean|| dynamicShape 
|
|-
| FeatureFlagSet || requiredFeatures || FeatureFlags.VANILLA_SET
|-
| @Nullable OffsetFunction || offsetFunction 
|
|-
|}

=== Properties class methods  ===

There are many methods used to assign properties to a certain block; most commonly, the {{jbcp|-s}} class is used to add properties to blocks at the time of their registration.

'''ofLegacyCopy({{Tooltip|...|BlockBehaviour block}})'''

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: 
{{Collapse|head=1|title=&emsp;}}
:* destroyTime
:* explosionResistance
:* hasCollision
:* isRandomlyTicking
:* lightEmission
:* mapColor
:* soundType
:* friction
:* speedFactor
:* dynamicShape
:* canOcclude
:* isAir
:* ignitedByLava
:* liquid
:* forceSolidOff
:* forceSolidOn
:* pushReaction
:* requiresCorrectToolForDrops
:* offsetFunction
:* spawnTerrainParticles
:* requiredFeatures
:* emissiveRendering
:* instrument
:* replaceable
{{Collapse|tail=1}}
* Default properties, for the other properties

Used in the registration of 105 blocks and in the method {{cd|registerLegacyStair({{Tooltip|...|String id, Block base}})}} (used in the registration of 47 [[Minecraft:stairs]]) in {{jbcp|-s}}, and in {{cd|ofFullCopy(...)}}.

'''ofFullCopy({{Tooltip|...|BlockBehaviour block}})'''

Like the {{cd|ofLegacyCopy(...)}} but in addition to the properties copied by {{cd|ofLegacyCopy(...)}} it also copies:
* jumpFactor
* isRedstoneConductor
* isValidSpawn
* postProcess
* isSuffocating
* isViewBlocking
* drops
* descriptionId

Used in the registration of 84 blocks and in the method {{cd|registerStair({{Tooltip|...|String id, Block base}})}} (used in the registration of 4 [[Minecraft:cut copper stairs]]) in {{jbcp|-s}}.

'''mapColor({{tooltip|...|DyeColor dyeColor}})'''

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 [[Minecraft:glazed terracotta]], [[Minecraft:concrete]], and [[Minecraft:concrete powder]]) and in the method {{cd|registerStainedGlass({{Tooltip|...|String id, DyeColor color}})}} (unsed in all 16 [[Minecraft:stained glass]]) in {{jbcp|-s}}.

'''mapColor({{tooltip|...|MapColor 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 {{cd|leavesProperties({{Tooltip|...|SoundType soundType}})}} (used in 9 [[Minecraft:leaves]]), in the method {{cd|shulkerBoxProperties({{Tooltip|...|MapColor mapColor}})}} (used in all 17 [[Minecraft:shulker box]]s), in the method {{cd|pistonProperties()}} (used in [[Minecraft:piston]] and [[Minecraft:sticky piston]]) and, in the method {{cd|candleProperties({{Tooltip|...|MapColor mapColor}})}} (used in all 17 [[Minecraft:candle]]s) in {{jbcp|-s}}.

'''mapColor({{tooltip|...|Function&lt;BlockState, MapColor&gt; 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 ([[Minecraft:wheat crop]], [[Minecraft:barrier]] and [[Minecraft:light (block)|light]]), in the method {{cd|registerBed({{Tooltip|...|String id, DyeColor color}})}} (unsed in all 16 [[Minecraft:beds]]), in the method {{cd|logProperties({{Tooltip|...|MapColor topColor, MapColor sideColor, SoundType soundType}})}} (unsed in 21 blocks, but 11 of they have the same color for all states) and, in the method {{cd|netherStemProperties({{Tooltip|...|MapColor mapColor}})}} (unsed in 4 blocks, but they all have the same color for all states) in {{jbcp|-s}}.

'''noCollision()'''

Set the hasCollision and canOcclude block properties to false.

Used in the registration of 241 blocks and in the method {{cd|buttonProperties()}} (used in the registration of 14 [[Minecraft:button]]s) in {{jbcp|-s}}.

== Notes ==
{{reflist}}

== See also ==
[[Minecraft:Hardcoded item properties (Java Edition)]] — Similar article for items