MCglTF

MCglTF 是一个用于加载 glTF 格式文件并准备渲染模型所需技术的 3D 模型加载库，适用于 Minecraft Modding 环境。

它支持 glTF 规范中的多种功能，同时保持良好的兼容性和性能。

使用方法

渲染方块、物品和实体的示例代码：

• https://github.com/ModularMods/MCglTF-Example

功能特性

• ✅ GLTF 格式（嵌入资源或通过 ResourceLocation）
• ✅ GLB 格式
• ✅ UV 坐标
• ✅ 法线
• ✅ 切线
• ✅ 顶点颜色
• ✅ 材质（需要 OptiFine 或 Iris Shaders 以及支持 PBR 和法线贴图的 ShaderPack）
• ✅ 纹理
• ❎ 多重纹理坐标（出于与 Vanilla 的兼容性考虑）
• ✅ 骨架
• ✅ 动画（多个）
• ✅ 变形目标
• ✅ 零缩放节点剔除 (https://github.com/KhronosGroup/glTF/pull/2059)

常见问题

问： 为什么我的模型纹理没有显示？

答： 您需要在材质的 "extras" 中定义材质以链接您的纹理。更多详情请访问 wiki 页面。

问： 为什么两个动画不能同时控制同一节点的平移/旋转/缩放/权重，导致其中一个动画无法播放？

答： glTF 规范中没有定义动画混合技术，因此 GltfAnimationCreator 创建的动画也不支持动画混合。您需要根据您的场景创建自己的动画处理器。

问： 如何将我的自定义处理应用到模型上，比如自定义材质（例如应用玩家皮肤）或为指定节点创建特殊的 OpenGL 命令？

答： 对于生成 glTF 模型 OpenGL 命令的更高级方式，您可以在您的 IGltfModelReceiver 中重写并返回 false 给 isReceiveSharedModel(GltfModel, GltfRenderDatas)。这允许您基于提供的 GltfModel 创建自定义的 RenderedGltfModel。（注意在刷新资源期间将您的 OpenGL 对象如 VBO、VAO、纹理等添加到 GltfRenderDatas 中进行删除。）

致谢

• JglTF by javagl: https://github.com/javagl/JglTF
• Mikk Tangent Generator by jMonkeyEngine: https://github.com/jMonkeyEngine/jmonkeyengine