自定义GLTF

自定义GLTF

一个用于Minecraft Fabric 1.20.1的gLTF模型加载库,允许模组加载并渲染gLTF格式的3D模型,并支持着色器。

基础库

CustomGLTF

注意: 1.20.4 已不再维护。请使用 Minecraft 1.20.1 以获取所有最新修复、功能和更新。

CustomGLTF 是一个客户端库模组,可让你在 Minecraft 中加载、动画、附着和渲染标准 glTF / GLB 3D 模型。

什么是 glTF?

glTF(GL 传输格式)是一种开放标准的 3D 文件格式,几乎被所有 3D 软件(Blender、Maya、3ds Max、Blockbench 等)支持。这使得导出自定义 3D 模型并直接导入 Minecraft 变得非常简单。

功能

  • 加载 glTF 和 GLB 文件: 支持带网格、纹理和骨骼的标准 .gltf 和 .glb 模型。
  • 完整动画支持: 骨骼动画、节点动画,以及内置的动画控制器(交叉淡化、循环、状态机)。
  • 骨骼插槽与附着系统: 将物品、武器、粒子或其他模型附着到特定的动画骨骼上。
  • 程序化骨骼覆盖: 通过代码动态控制骨骼的旋转/平移(炮塔瞄准、载具转向、头部追踪)。
  • 动态包围盒: 从模型几何体计算精确的 3D 包围盒,用于碰撞箱。
  • 修复透明度与水面渲染: 干净的 Alpha 混合与片元丢弃(无黑框,模型后的水面可正确渲染)。
  • GPU 加速蒙皮: 多种 OpenGL 配置(GL43、GL40、GL33 和 GL30 CPU 回退)。
  • 双语着色器警告: 着色器启用时,在游戏内聊天中给出警告(英语和德语)。

需求

  • Minecraft:1.20.1(1.20.4 已不再维护)
  • Fabric Loader:0.14.21 或更高版本
  • Fabric API
  • Java:17 或更高版本

关于着色器的重要说明: 不支持着色器包(Iris / OptiFine)。如果启用了着色器,游戏内会弹出警告提示。请禁用着色器,以便 glTF 模型正确渲染。

面向模组开发者

这是一个库模组,本身不会添加独立的物品或方块。你需要另一个使用 CustomGLTF 的模组才能在游戏中看到模型。如果你是模组开发者,并希望在自己的模组中使用此库,请查看仓库中的开发者指南和 API,以获取完整的模板和示例。

致谢

  • 本模组基于 TimLee9024 和 Protoxy 的 MCglTF。非常感谢他们创建了原始库!
  • 使用了 Marco Hutter(javagl.de)的 JglTF 代码。
  • 由 Maiky 移植到 1.20.1 并更新。

许可证

MIT 许可证。欢迎在你的整合包中使用,或作为你模组的依赖项。

问题与反馈

如果你发现任何 bug 或有疑问,欢迎提交 issue 或留言!