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

Interface Renderer

public interface Renderer

Interface for rendering plug-ins that provide enhanced capabilities for model lighting, buffering and rendering. Such plug-ins implement the enhanced model rendering interfaces specified by the Fabric API.

Renderers must ensure that terrain buffering supports

invalid reference

BlockStateModel#emitQuads

, which happens in SectionCompiler in vanilla; this code is not patched automatically. Renderers must also ensure that the following vanilla methods support

invalid reference

BlockStateModel#emitQuads

; these methods are not patched automatically.

• ModelBlockRenderer.renderModel(PoseStack.Pose, VertexConsumer, BlockStateModel, float, float, float, int, int)
• BlockRenderDispatcher.renderBreakingTexture(BlockState, BlockPos, BlockAndTintGetter, PoseStack, VertexConsumer)
• BlockRenderDispatcher.renderSingleBlock(BlockState, PoseStack, MultiBufferSource, int, int)

All other places in vanilla code that invoke BlockStateModel.collectParts(RandomSource, List), BlockStateModel.collectParts(RandomSource), or ModelBlockRenderer.renderModel(PoseStack.Pose, VertexConsumer, BlockStateModel, float, float, float, int, int) are, where appropriate, patched automatically to invoke the corresponding method above or the corresponding method in FabricBlockModelRenderer or FabricBlockRenderManager.

Method Summary

Modifier and Type	Method	Description
static Renderer	get()	Access to the current Renderer for creating and retrieving mesh builders and materials.
QuadEmitter	getLayerRenderStateEmitter(net.minecraft.client.renderer.item.ItemStackRenderState.LayerRenderState layer)
MutableMesh	mutableMesh()	Obtain a new MutableMesh instance to build optimized meshes and create baked models with enhanced features.
static void	register(Renderer renderer)	Rendering extension mods must implement Renderer and call this method during initialization.
void	render(com.mojang.blaze3d.vertex.PoseStack.Pose matrices, BlockVertexConsumerProvider vertexConsumers, net.minecraft.client.renderer.block.model.BlockStateModel model, float red, float green, float blue, int light, int overlay, net.minecraft.world.level.BlockAndTintGetter blockView, net.minecraft.core.BlockPos pos, net.minecraft.world.level.block.state.BlockState state)
void	render(net.minecraft.client.renderer.block.ModelBlockRenderer modelRenderer, net.minecraft.world.level.BlockAndTintGetter blockView, net.minecraft.client.renderer.block.model.BlockStateModel model, net.minecraft.world.level.block.state.BlockState state, net.minecraft.core.BlockPos pos, com.mojang.blaze3d.vertex.PoseStack matrices, BlockVertexConsumerProvider vertexConsumers, boolean cull, long seed, int overlay)
void	renderBlockAsEntity(net.minecraft.client.renderer.block.BlockRenderDispatcher renderManager, net.minecraft.world.level.block.state.BlockState state, com.mojang.blaze3d.vertex.PoseStack matrices, net.minecraft.client.renderer.MultiBufferSource vertexConsumers, int light, int overlay, net.minecraft.world.level.BlockAndTintGetter blockView, net.minecraft.core.BlockPos pos)
void	setLayerRenderTypeGetter(net.minecraft.client.renderer.item.ItemStackRenderState.LayerRenderState layer, ItemRenderTypeGetter renderTypeGetter)

Method Details

get

static Renderer get()

Access to the current Renderer for creating and retrieving mesh builders and materials.

register

static void register(Renderer renderer)

Rendering extension mods must implement Renderer and call this method during initialization.

Only one Renderer plug-in can be active in any game instance. If a second mod attempts to register, this method will throw an UnsupportedOperationException.

mutableMesh

MutableMesh mutableMesh()

Obtain a new MutableMesh instance to build optimized meshes and create baked models with enhanced features.

Renderer does not retain a reference to returned instances, so they should be re-used when possible to avoid memory allocation overhead.

render

@OverrideOnly
void render(net.minecraft.client.renderer.block.ModelBlockRenderer modelRenderer,
 net.minecraft.world.level.BlockAndTintGetter blockView,
 net.minecraft.client.renderer.block.model.BlockStateModel model,
 net.minecraft.world.level.block.state.BlockState state,
 net.minecraft.core.BlockPos pos,
 com.mojang.blaze3d.vertex.PoseStack matrices,
 BlockVertexConsumerProvider vertexConsumers,
 boolean cull,
 long seed,
 int overlay)

See Also:

• FabricBlockModelRenderer.render(BlockAndTintGetter, BlockStateModel, BlockState, BlockPos, PoseStack, BlockVertexConsumerProvider, boolean, long, int)

render

@OverrideOnly
void render(com.mojang.blaze3d.vertex.PoseStack.Pose matrices,
 BlockVertexConsumerProvider vertexConsumers,
 net.minecraft.client.renderer.block.model.BlockStateModel model,
 float red,
 float green,
 float blue,
 int light,
 int overlay,
 net.minecraft.world.level.BlockAndTintGetter blockView,
 net.minecraft.core.BlockPos pos,
 net.minecraft.world.level.block.state.BlockState state)

See Also:

• FabricBlockModelRenderer.render(PoseStack.Pose, BlockVertexConsumerProvider, BlockStateModel, float, float, float, int, int, BlockAndTintGetter, BlockPos, BlockState)

renderBlockAsEntity

@OverrideOnly
void renderBlockAsEntity(net.minecraft.client.renderer.block.BlockRenderDispatcher renderManager,
 net.minecraft.world.level.block.state.BlockState state,
 com.mojang.blaze3d.vertex.PoseStack matrices,
 net.minecraft.client.renderer.MultiBufferSource vertexConsumers,
 int light,
 int overlay,
 net.minecraft.world.level.BlockAndTintGetter blockView,
 net.minecraft.core.BlockPos pos)

See Also:

• FabricBlockRenderManager.renderBlockAsEntity(BlockState, PoseStack, MultiBufferSource, int, int, BlockAndTintGetter, BlockPos)

getLayerRenderStateEmitter

@OverrideOnly
QuadEmitter getLayerRenderStateEmitter(net.minecraft.client.renderer.item.ItemStackRenderState.LayerRenderState layer)

See Also:

• FabricLayerRenderState.emitter()

setLayerRenderTypeGetter

@OverrideOnly
void setLayerRenderTypeGetter(net.minecraft.client.renderer.item.ItemStackRenderState.LayerRenderState layer,
 ItemRenderTypeGetter renderTypeGetter)

See Also:

• FabricLayerRenderState.setRenderTypeGetter(ItemRenderTypeGetter)