Package net.fabricmc.fabric.api.renderer.v1.render

Interface FabricBlockModelRenderer

public interface FabricBlockModelRenderer

Note: This interface is automatically implemented on all block model renderers via Mixin and interface injection.

Method Summary

Modifier and Type	Method	Description
static void	render(MatrixStack.Entry matrices, VertexConsumerProvider vertexConsumers, BlockStateModel model, float red, float green, float blue, int light, int overlay, BlockRenderView blockView, BlockPos pos, BlockState state)	Alternative for BlockModelRenderer.render(MatrixStack.Entry, VertexConsumer, BlockStateModel, float, float, float, int, int) that accepts a VertexConsumerProvider instead of a VertexConsumer.
default void	render(BlockRenderView blockView, BlockStateModel model, BlockState state, BlockPos pos, MatrixStack matrices, VertexConsumerProvider vertexConsumers, boolean cull, long seed, int overlay)	Alternative for BlockModelRenderer.render(BlockRenderView, List, BlockState, BlockPos, MatrixStack, VertexConsumer, boolean, int) and BlockRenderManager.renderBlock(BlockState, BlockPos, BlockRenderView, MatrixStack, VertexConsumer, boolean, List) that accepts a BlockStateModel instead of a List<BlockModelPart> and a VertexConsumerProvider instead of a VertexConsumer.

Method Details

render

default void render(BlockRenderView blockView,
 BlockStateModel model,
 BlockState state,
 BlockPos pos,
 MatrixStack matrices,
 VertexConsumerProvider vertexConsumers,
 boolean cull,
 long seed,
 int overlay)

Alternative for BlockModelRenderer.render(BlockRenderView, List, BlockState, BlockPos, MatrixStack, VertexConsumer, boolean, int) and BlockRenderManager.renderBlock(BlockState, BlockPos, BlockRenderView, MatrixStack, VertexConsumer, boolean, List) that accepts a BlockStateModel instead of a List<BlockModelPart> and a VertexConsumerProvider instead of a VertexConsumer. Also accepts the random seed. Prefer using this method over the vanilla alternative to correctly retrieve geometry from models that implement

invalid reference

BlockStateModel#emitQuads(QuadEmitter, BlockRenderView, BlockPos, BlockState, Random, Predicate)

and to correctly buffer models that have geometry on multiple render layers.

This method allows buffering a block model in a terrain-like context, which usually includes stages like culling, dynamic tinting, shading, and flat/smooth lighting.

Parameters:

blockView - The world in which to render the model. Should not be empty (i.e. not EmptyBlockRenderView).

model - The model to render.

state - The block state.

pos - The position of the block in the world.

matrices - The matrix stack.

vertexConsumers - The vertex consumers. The RenderLayer passed to VertexConsumerProvider.getBuffer(RenderLayer) is guaranteed to be one of RenderLayer.getBlockLayers().

cull - Whether to try to cull faces hidden by other blocks.

seed - The random seed. Usually retrieved by the caller from AbstractBlock.AbstractBlockState.getRenderingSeed(BlockPos).

overlay - The overlay value to pass to output VertexConsumers.

render

static void render(MatrixStack.Entry matrices,
 VertexConsumerProvider vertexConsumers,
 BlockStateModel model,
 float red,
 float green,
 float blue,
 int light,
 int overlay,
 BlockRenderView blockView,
 BlockPos pos,
 BlockState state)

Alternative for BlockModelRenderer.render(MatrixStack.Entry, VertexConsumer, BlockStateModel, float, float, float, int, int) that accepts a VertexConsumerProvider instead of a VertexConsumer. Also accepts the BlockRenderView, BlockPos, and BlockState to pass to

invalid reference

BlockStateModel#emitQuads(QuadEmitter, BlockRenderView, BlockPos, BlockState, Random, Predicate)

when necessary. Prefer using this method over the vanilla alternative to correctly buffer models that have geometry on multiple render layers and to provide the model with additional context.

This method allows buffering a block model with minimal transformations to the model geometry. Usually used by entity renderers.

Parameters:

matrices - The matrices.

vertexConsumers - The vertex consumers. The RenderLayer passed to VertexConsumerProvider.getBuffer(RenderLayer) is guaranteed to be one of RenderLayer.getBlockLayers().

model - The model to render.

red - The red component of the tint color.

green - The green component of the tint color.

blue - The blue component of the tint color.

light - The minimum light value.

overlay - The overlay value.

blockView - The world in which to render the model. Can be empty (i.e. EmptyBlockRenderView).

pos - The position of the block in the world. Should be BlockPos.ORIGIN if the world is empty.

state - The block state. Should be Blocks.AIR.getDefaultState() if not applicable.