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

Interface FabricBakedModel

All Known Implementing Classes:
ForwardingBakedModel
public interface FabricBakedModel
Interface for baked models that output meshes with enhanced rendering features. Can also be used to generate or customize outputs based on world state instead of or in addition to block state when render chunks are rebuilt.

Note for Renderer implementors: Fabric causes BakedModel to extend this interface with isVanillaAdapter() == true and to produce standard vertex data. This means any BakedModel instance can be safely cast to this interface without an instanceof check.

  • Method Details

    • isVanillaAdapter

      boolean isVanillaAdapter()
      When true, signals renderer this producer is implemented through BakedModel.getQuads(BlockState, net.minecraft.util.math.Direction, Random). Also means the model does not rely on any non-vanilla features. Allows the renderer to optimize or route vanilla models through the unmodified vanilla pipeline if desired.

      Fabric overrides to true for vanilla baked models. Enhanced models that use this API should return false, otherwise the API will not recognize the model.

    • emitBlockQuads

      void emitBlockQuads(BlockRenderView blockView, BlockState state, BlockPos pos, Supplier<Random> randomSupplier, RenderContext context)
      This method will be called during chunk rebuilds to generate both the static and dynamic portions of a block model when the model implements this interface and isVanillaAdapter() returns false.

      During chunk rebuild, this method will always be called exactly one time per block position, irrespective of which or how many faces or block render layers are included in the model. Models must output all quads/meshes in a single pass.

      Also called to render block models outside of chunk rebuild or block entity rendering. Typically, this happens when the block is being rendered as an entity, not as a block placed in the world. Currently, this happens for falling blocks and blocks being pushed by a piston, but renderers should invoke this for all calls to BlockModelRenderer.render(BlockRenderView, BakedModel, BlockState, BlockPos, MatrixStack, VertexConsumer, boolean, Random, long, int) that occur outside of chunk rebuilds to allow for features added by mods, unless isVanillaAdapter() returns true.

      Outside of chunk rebuilds, this method will be called every frame. Model implementations should rely on pre-baked meshes as much as possible and keep transformation to a minimum. The provided block position may be the nearest block position and not actual. For this reason, neighbor state lookups are best avoided or will require special handling. Block entity lookups are likely to fail and/or give meaningless results.

      In all cases, renderer will handle face occlusion and filter quads on faces obscured by neighboring blocks (if appropriate). Models only need to consider "sides" to the extent the model is driven by connection with neighbor blocks or other world state.

      Note: with BakedModel.getQuads(BlockState, net.minecraft.util.math.Direction, Random), the random parameter is normally initialized with the same seed prior to each face layer. Model authors should note this method is called only once per block, and call the provided Random supplier multiple times if re-seeding is necessary. For wrapped vanilla baked models, it will probably be easier to use RenderContext.fallbackConsumer() which handles re-seeding per face automatically.

      Parameters:
      blockView - Access to world state. Using RenderAttachedBlockView.getBlockEntityRenderAttachment(BlockPos) to retrieve block entity state unless thread safety can be guaranteed. param safeBlockEntityAccessor Thread-safe access to block entity data
      state - Block state for model being rendered.
      pos - Position of block for model being rendered.
      randomSupplier - Random object seeded per vanilla conventions. Call multiple times to re-seed. Will not be thread-safe. Do not cache or retain a reference.
      context - Accepts model output.

    • emitItemQuads

      void emitItemQuads(ItemStack stack, Supplier<Random> randomSupplier, RenderContext context)
      This method will be called during item rendering to generate both the static and dynamic portions of an item model when the model implements this interface and isVanillaAdapter() returns false.

      Vanilla item rendering is normally very limited. It ignores lightmaps, vertex colors, and vertex normals. Renderers are expected to implement enhanced features for item models. If a feature is impractical due to performance or other concerns, then the renderer must at least give acceptable visual results without the need for special case handling in model implementations.

      Calls to this method will generally happen on the main client thread but nothing prevents a mod or renderer from calling this method concurrently. Implementations should not mutate the ItemStack parameter, and best practice will be to make the method thread-safe.

      Implementing this method does NOT mitigate the need to implement a functional BakedModel.getOverrides() method, because this method will be called on the result of BakedModel.getOverrides(). However, that method can simply return the base model because the output from this method will be used for rendering.

      Renderer implementations should also use this method to obtain the quads used for item enchantment glint rendering. This means models can put geometric variation logic here, instead of returning every possible shape from BakedModel.getOverrides() as vanilla baked models.