glTF 渲染器 API

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

专为 Minecraft Forge 1.20.1 打造的快速 glTF 渲染

将 glTF 模型带入 Minecraft

glTF 渲染器 API 是一个客户端渲染库，使 Forge 模组能够加载并在 Minecraft 中展示 glTF 2.0 模型，支持方块、方块实体、实体、物品、盔甲、粒子和 GUI 预览的集成。

该 API 支持 .gltf 和 .glb 文件，包括嵌入资源、来自外部资源包的资源、材质、透明度、骨骼动画、皮肤、形态目标、多场景和 GPU 实例化。

压缩资源	性能优先
支持 Draco 和 Meshopt 压缩，以及 KTX2/BasisU 纹理。KTX2 纹理自动选择合适的 GPU 格式，并为不支持的硬件或转码失败提供回退选项。	模型使用可复用的 GPU 缓冲区、兼容的批处理提交、模型边界、视锥体裁剪、基于距离的 LOD 选择以及透明几何体排序。
原生依赖已捆绑并隔离，以减少与其他模组的冲突。	资源和解码缓冲区限制还能保护客户端免受格式错误或过大资源的影响。

Embeddium 和 Oculus 支持

渲染器支持 Embeddium，并与 Oculus/Iris 着色器和阴影通道兼容，允许模型参与着色器包的光照和阴影，同时在着色器关闭时保持兼容。

专为模组开发者打造

公共 API 包含以下辅助功能：

实体和方块实体
静态烘焙方块和物品
自定义物品渲染器
盔甲层
粒子
仅限 GUI 的模型预览
动画和场景选择
视锥体裁剪和 LOD 组
批处理模型渲染

公共渲染 API 位于客户端，只能由客户端专用代码使用。

测试内容

该模组包含一个静态 glTF 模型作为测试模型，以演示渲染器是否正常工作。这些是测试示例，当其他模组使用该 API 时并非必需。

Beta 版本

这是初始公开测试版。仍可能出现错误、异常模型行为、性能问题和兼容性问题。

如需帮助或报告错误，请加入 Uncool Labs Discord。（也可以在 GitHub 上报告错误！）