Package net.minecraft.client.renderer.block.model.multipart

Class MultiPartModel

java.lang.Object

net.minecraft.client.renderer.block.model.multipart.MultiPartModel

All Implemented Interfaces:

BlockStateModel, BlockStateModelExtension, DynamicBlockStateModel

public class MultiPartModel
extends Object
implements BlockStateModel, DynamicBlockStateModel

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final record	MultiPartModel.GeometryKey
static final record	MultiPartModel.Selector<T>
(package private) static final class	MultiPartModel.SharedBakedState
static class	MultiPartModel.Unbaked

Nested classes/interfaces inherited from interface net.minecraft.client.renderer.block.model.BlockStateModel

BlockStateModel.SimpleCachedUnbakedRoot, BlockStateModel.UnbakedRoot

Field Summary

Fields

Modifier and Type	Field	Description
private final BlockState	blockState
private List<BlockStateModel>	models
private final MultiPartModel.SharedBakedState	shared

Constructor Summary

Constructors

Constructor	Description
MultiPartModel(MultiPartModel.SharedBakedState p_409947_, BlockState p_410377_)

Method Summary

Modifier and Type	Method	Description
void	collectParts(BlockAndTintGetter level, BlockPos pos, BlockState state, RandomSource p_410101_, List<BlockModelPart> p_410550_)	Collects the parts of the model that should be rendered.
Object	createGeometryKey(BlockAndTintGetter level, BlockPos pos, BlockState state, RandomSource random)	Collects all the data used by the model to produce renderable geometry.
TextureAtlasSprite	particleIcon()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.minecraft.client.renderer.block.model.BlockStateModel

collectParts

Methods inherited from interface net.neoforged.neoforge.client.extensions.BlockStateModelExtension

collectParts, particleIcon

Methods inherited from interface net.neoforged.neoforge.client.model.DynamicBlockStateModel

collectParts

Field Details

shared

private final MultiPartModel.SharedBakedState shared

blockState

private final BlockState blockState

models

@Nullable
private List<BlockStateModel> models

Constructor Details

MultiPartModel

MultiPartModel(MultiPartModel.SharedBakedState p_409947_,
 BlockState p_410377_)

Method Details

particleIcon

public TextureAtlasSprite particleIcon()

Specified by:

particleIcon in interface BlockStateModel

collectParts

public void collectParts(BlockAndTintGetter level,
 BlockPos pos,
 BlockState state,
 RandomSource p_410101_,
 List<BlockModelPart> p_410550_)

Description copied from interface: BlockStateModelExtension

Collects the parts of the model that should be rendered.

Typically called on a meshing worker thread, with a snapshot of world state. To access block entity data, use IBlockGetterExtension.getModelData(BlockPos) on the passed level. Avoid accessing or manipulating the block entities directly as they are not thread safe. Other world state is safe to access.

The parameters passed to this method might not be what the model expects. For example, the model data might be missing or coming from a different/outdated block entity, the block state in the level might be different from the one passed in, and so on... The model should handle these cases gracefully and return the best model it can (e.g. by returning a completely unconnected model, in the case of connected textures).

Calling IBlockStateExtension.getAppearance(net.minecraft.world.level.BlockAndTintGetter, net.minecraft.core.BlockPos, net.minecraft.core.Direction, net.minecraft.world.level.block.state.BlockState, net.minecraft.core.BlockPos) before accessing the block state is recommended.

Specified by:

collectParts in interface BlockStateModelExtension

Specified by:

collectParts in interface DynamicBlockStateModel

Parameters:

level - a level to query block entity data or other world state

pos - the position of the block being rendered

state - the state of the block being rendered

p_410101_ - a random source for random model variations

p_410550_ - the list that should receive all parts to be rendered

createGeometryKey

@Nullable
public Object createGeometryKey(BlockAndTintGetter level,
 BlockPos pos,
 BlockState state,
 RandomSource random)

Description copied from interface: BlockStateModelExtension

Collects all the data used by the model to produce renderable geometry. The returned object encapsulates which parts of the world state the model depends on.

This allows the geometry produced previously by a model to be reused, provided that the key matches. The key can be used to compare the geometry of different models. If this model forwards to a single other model, it can directly return its geometry key. Otherwise, it should use a custom type specific to the model.

The passed in level, pos and random parameters should not be put directly into the returned key. Only the relevant information should be extracted so that the same key is yielded as often as possible.

The default implementation returns null, meaning the model does not implement this method. A model that wishes to override this method must therefore not return null, even if the model does not use any passed in state.

Specified by:

createGeometryKey in interface BlockStateModelExtension

Returns:

an object collecting all the data that influences the geometry of this model; can be any object as long as it implements Object.hashCode() and Object.equals(Object) correctly.