
自定义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 或留言!
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。