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

Class FluidVariantRendering

java.lang.Object
net.fabricmc.fabric.api.transfer.v1.client.fluid.FluidVariantRendering
@Experimental @Environment(CLIENT) public class FluidVariantRendering extends Object
Client-side display of fluid variants.

Experimental feature, we reserve the right to remove or change it without further notice. The transfer API is a complex addition, and we want to be able to correct possible design mistakes.

  • Constructor Details

    • FluidVariantRendering

      public FluidVariantRendering()

  • Method Details

    • register

      public static void register(net.minecraft.fluid.Fluid fluid, FluidVariantRenderHandler handler)
      Register a render handler for the passed fluid.

    • getHandler

      @Nullable public static @Nullable FluidVariantRenderHandler getHandler(net.minecraft.fluid.Fluid fluid)
      Return the render handler for the passed fluid, if available, and null otherwise.

    • getHandlerOrDefault

      public static FluidVariantRenderHandler getHandlerOrDefault(net.minecraft.fluid.Fluid fluid)
      Return the render handler for the passed fluid, if available, or the default instance otherwise.

    • getName

      @Deprecated(forRemoval=true) public static net.minecraft.text.Text getName(FluidVariant fluidVariant)
      Deprecated, for removal: This API element is subject to removal in a future version.
      use FluidVariantAttributes.getName(net.fabricmc.fabric.api.transfer.v1.fluid.FluidVariant) instead.
      Return the name of the passed fluid variant.

    • getTooltip

      public static List<net.minecraft.text.Text> getTooltip(FluidVariant fluidVariant)
      Return a mutable list: the tooltip for the passed fluid variant, including the name and additional lines if available and the id of the fluid if advanced tooltips are enabled.

      Compared to the other overload, the current tooltip context is automatically used.

    • getTooltip

      public static List<net.minecraft.text.Text> getTooltip(FluidVariant fluidVariant, net.minecraft.client.item.TooltipContext context)
      Return a mutable list: the tooltip for the passed fluid variant, including the name and additional lines if available and the id of the fluid if advanced tooltips are enabled.

    • getSprites

      @Nullable public static @Nullable net.minecraft.client.texture.Sprite[] getSprites(FluidVariant fluidVariant)
      Return the still and the flowing sprite that should be used to render the passed fluid variant, or null if they are not available. The sprites should be rendered using the color returned by getColor(net.fabricmc.fabric.api.transfer.v1.fluid.FluidVariant).
      See Also:

    • getSprite

      @Nullable public static @Nullable net.minecraft.client.texture.Sprite getSprite(FluidVariant fluidVariant)
      Return the still sprite that should be used to render the passed fluid variant, or null if it's not available. The sprite should be rendered using the color returned by getColor(net.fabricmc.fabric.api.transfer.v1.fluid.FluidVariant).

    • getColor

      public static int getColor(FluidVariant fluidVariant)
      Return the position-independent color that should be used to render the sprite of the passed fluid variant.

    • getColor

      public static int getColor(FluidVariant fluidVariant, @Nullable @Nullable net.minecraft.world.BlockRenderView view, @Nullable @Nullable net.minecraft.util.math.BlockPos pos)
      Return the color that should be used when rendering the sprite of the passed fluid variant.

      If the world and the position parameters are null, a position-independent color is returned. If the world and position parameters are not null, the color may depend on the position. For example, if world and position are passed, water will use them to return a biome-dependent color.

    • fillsFromTop

      @Deprecated(forRemoval=true) public static boolean fillsFromTop(FluidVariant fluidVariant)
      Deprecated, for removal: This API element is subject to removal in a future version.
      use FluidVariantAttributes.isLighterThanAir(net.fabricmc.fabric.api.transfer.v1.fluid.FluidVariant) instead.
      Return true if this fluid variant should be rendered as filling tanks from the top.