• Forge论坛

导航页

  • 主页
  • 向文档做出贡献
  • 入门
    • 概述
    • 模组文件
    • 规划你的模组结构
    • 版本号
  • 核心概念
    • 注册表
    • 端位(Sides)
    • 事件
    • 模组生命周期
    • 资源
    • 国际化与本地化
  • 方块
    • 概述
    • 方块状态
  • 物品
    • 概述
    • BlockEntityWithoutLevelRenderer
  • 网络
    • 概述
    • SimpleImpl
    • 实体的同步
  • 方块实体
    • 概述
    • BlockEntityRenderer
      • 创建一个BER
      • 注册一个BER
  • 游戏特效
    • 粒子效果
    • 音效
  • 数据储存
    • Capabilities
    • Saved Data
    • 编解码器(Codecs)
  • 图形用户界面
    • 菜单(Menus)
    • 屏幕(Screens)
  • 渲染
    • 模型扩展
      • 概述
      • 根变换
      • 渲染类型
      • 部分可见度
      • 面数据
    • 模型加载器
      • 概述
      • 烘焙模型
      • 变换
      • 物品重载
  • 资源
    • 客户端资源(Assets)
      • 概述
      • 模型
        • 概述
        • 纹理色调
        • 物品属性
    • 服务端数据(Data)
      • 概述
      • 配方
        • 概述
        • 自定义配方
        • 原料
        • 非数据包配方
      • 战利品表
      • 全局战利品修改器
      • 标签
      • 进度
      • 条件性加载数据
  • 数据生成
    • 概述
    • 客户端资源(Assets)
      • 模型提供者
      • 语言提供者
      • 音效提供者
    • 服务端数据(Data)
      • 配方提供者
      • 战利品表提供者
      • 标签提供者
      • 进度提供者
      • 全局战利品修改器提供者
      • 数据包注册表对象提供者
  • 杂项功能
    • 配置
    • 键盘布局
    • 游戏测试
    • Forge更新检查器
    • 调试分析器
  • 进阶主题
    • 访问转换器
  • 向Forge做出贡献
    • 概述
    • Pull Request准则
  • 旧版本
    • 概述
    • 移植到当前版本

BlockEntityRenderer

BlockEntityRenderer(简称BER)用于以静态烘焙模型(JSON、OBJ、B3D等)无法表示的方式渲染方块。方块实体渲染器要求方块具有BlockEntity。

创建一个BER

要创建BER,请创建一个继承自BlockEntityRenderer的类。它采用一个泛型参数来指定方块的BlockEntity类。该泛型参数用于BER的render方法。

对于任意一个给定的BlockEntityType,仅存在一个BER。因此,特定于存档中单个实例的值应该存储在传递给渲染器的方块实体中,而不是存储在BER本身中。例如,如果将逐帧递增的整数存储在BER中,则对于该存档中该类型的每个方块实体也会逐帧递增。

render

为了渲染方块实体,每帧都调用此方法。

参数

  • blockEntity: 这是正在渲染的方块实体的实例。
  • partialTick: 在帧的摩擦过程中,从上一次完整刻度开始经过的时间量。
  • poseStack: 一个栈,包含偏移到方块实体当前位置的四维矩阵条目。
  • bufferSource: 能够访问顶点Consumer的渲染缓冲区。
  • combinedLight: 方块实体上当前亮度值的整数。
  • combinedOverlay: 设置为方块实体的当前overlay的整数,通常为OverlayTexture#NO_OVERLAY或655,360。

注册一个BER

要注册BER,你必须订阅模组事件总线上的EntityRenderersEvent$RegisterRenderers事件,并调用#registerBlockEntityRenderer。

Built with MkDocs using a custom theme. Hosted by Read the Docs.
Enable Dark Theme