Package net.fabricmc.fabric.api.client.render.fluid.v1

Interface FluidRenderHandler

All Known Implementing Classes:
SimpleFluidRenderHandler
public interface FluidRenderHandler
Interface for handling the rendering of a FluidState.

  • Method Summary

    Modifier and Type
    Method
    Description
    default int
    getFluidColor(@Nullable net.minecraft.world.level.BlockAndTintGetter view, @Nullable net.minecraft.core.BlockPos pos, net.minecraft.world.level.material.FluidState state)
    Get the tint color for a fluid being rendered at a given position.
    net.minecraft.client.renderer.texture.TextureAtlasSprite[]
    getFluidSprites(@Nullable net.minecraft.world.level.BlockAndTintGetter view, @Nullable net.minecraft.core.BlockPos pos, net.minecraft.world.level.material.FluidState state)
    Get the sprites for a fluid being rendered at a given position.
    default void
    reloadTextures(net.minecraft.client.renderer.texture.TextureAtlas textureAtlas)
    Look up your Fluid's sprites from the texture atlas.
    default void
    renderFluid(net.minecraft.core.BlockPos pos, net.minecraft.world.level.BlockAndTintGetter world, com.mojang.blaze3d.vertex.VertexConsumer vertexConsumer, net.minecraft.world.level.block.state.BlockState blockState, net.minecraft.world.level.material.FluidState fluidState)
    Tessellate your fluid.

  • Method Details

    • getFluidSprites

      net.minecraft.client.renderer.texture.TextureAtlasSprite[] getFluidSprites(@Nullable net.minecraft.world.level.BlockAndTintGetter view, @Nullable net.minecraft.core.BlockPos pos, net.minecraft.world.level.material.FluidState state)
      Get the sprites for a fluid being rendered at a given position. For optimal performance, the sprites should be loaded as part of a resource reload and *not* looked up every time the method is called! You likely want to override reloadTextures(net.minecraft.client.renderer.texture.TextureAtlas) to reload your fluid sprites.

      The "fabric-textures" module contains sprite rendering facilities, which may come in handy here.

      Parameters:
      view - The world view pertaining to the fluid. May be null!
      pos - The position of the fluid in the world. May be null!
      state - The current state of the fluid.
      Returns:
      An array of size two or more: the first entry contains the "still" sprite, while the second entry contains the "flowing" sprite. If it contains a third sprite, that sprite is used as overlay behind glass and leaves.

    • getFluidColor

      default int getFluidColor(@Nullable net.minecraft.world.level.BlockAndTintGetter view, @Nullable net.minecraft.core.BlockPos pos, net.minecraft.world.level.material.FluidState state)
      Get the tint color for a fluid being rendered at a given position.

      Note: As of right now, our hook cannot handle setting a custom alpha tint here - as such, it must be contained in the texture itself!

      Parameters:
      view - The world view pertaining to the fluid. May be null!
      pos - The position of the fluid in the world. May be null!
      state - The current state of the fluid.
      Returns:
      The tint color of the fluid.

    • renderFluid

      default void renderFluid(net.minecraft.core.BlockPos pos, net.minecraft.world.level.BlockAndTintGetter world, com.mojang.blaze3d.vertex.VertexConsumer vertexConsumer, net.minecraft.world.level.block.state.BlockState blockState, net.minecraft.world.level.material.FluidState fluidState)
      Tessellate your fluid. By default, this method will call the default fluid renderer. Call FluidRenderHandler.super.renderFluid if you want to render over the default fluid renderer. This is the intended way to render default geometry; calling LiquidBlockRenderer.tesselate(net.minecraft.world.level.BlockAndTintGetter, net.minecraft.core.BlockPos, com.mojang.blaze3d.vertex.VertexConsumer, net.minecraft.world.level.block.state.BlockState, net.minecraft.world.level.material.FluidState) is not supported. When rendering default geometry, the current handler will be used instead of looking up a new one for the passed fluid state.
      Parameters:
      pos - The position in the world, of the fluid to render.
      world - The world the fluid is in
      vertexConsumer - The vertex consumer to tessellate the fluid in.
      blockState - The block state being rendered.
      fluidState - The fluid state being rendered.

    • reloadTextures

      default void reloadTextures(net.minecraft.client.renderer.texture.TextureAtlas textureAtlas)
      Look up your Fluid's sprites from the texture atlas. Called when the fluid renderer reloads its textures. This is a convenient way of reloading and does not require an advanced resource manager reload listener.

      The "fabric-textures" module contains sprite rendering facilities, which may come in handy here.

      Parameters:
      textureAtlas - The blocks texture atlas, provided for convenience.