CustomGLTF
A gLTF model loader library for Minecraft Fabric 1.20.1 that allows mods to load and render 3D models in gLTF format with shader support.
介绍
CustomGLTF
Notice: 1.20.4 is no longer under maintenance. Please use Minecraft 1.20.1 for all latest fixes, features, and updates.
CustomGLTF is a client-side library mod that allows you to load, animate, attach, and render standard glTF / GLB 3D models in Minecraft.
What is glTF?
glTF (GL Transmission Format) is an open standard 3D file format supported by almost every 3D software (Blender, Maya, 3ds Max, Blockbench, etc.). This makes it super easy to export and bring custom 3D models directly into Minecraft.
Features
- Load glTF & GLB files: Standard .gltf and .glb models with mesh, textures, and bones.
- Full animation support: Skeletal animation, node animation, and built-in Animation Controller (crossfading, looping, state machine).
- Bone Sockets & Attachment System: Attach items, weapons, particles, or other models to specific animated bones.
- Procedural Bone Overrides: Control bone rotations/translations dynamically via code (turret aiming, vehicle steering, head tracking).
- Dynamic Bounding Boxes: Calculate exact 3D bounding boxes from model geometry for hitboxes.
- Fixed Transparency & Water Rendering: Clean alpha blending and fragment discarding (no black boxes, water behind models renders correctly).
- GPU-accelerated skinning: Multiple OpenGL profiles (GL43, GL40, GL33, and GL30 CPU fallback).
- Bilingual Shader Warning: In-game chat warning (English & German) when shaders are active.
Requirements
- Minecraft: 1.20.1 (1.20.4 is no longer maintained)
- Fabric Loader: 0.14.21 or higher
- Fabric API
- Java: 17 or higher
Important Note on Shaders: Shader packs (Iris / OptiFine) are NOT supported. If shaders are enabled, an in-game warning will notify you. Please disable shaders so glTF models render properly.
For Mod Developers
This is a library mod. It doesn’t add standalone items or blocks on its own. You need another mod that uses CustomGLTF to see models in-game. If you’re a mod developer and want to use this library in your mod, check out the Developer Guide and API in the repository for complete templates and examples.
Credits
- This mod is based on MCglTF by TimLee9024 and Protoxy. Big thanks to them for creating the original library!
- Uses code from JglTF by Marco Hutter (javagl.de).
- Ported to 1.20.1 & updated by Maiky.
License
MIT License. Feel free to use this in your modpacks or as a dependency for your mods.
Issues & Feedback
If you find any bugs or have questions, feel free to open an issue or leave a comment!
常见问题
CustomGLTF 支持哪些 Minecraft 版本？
CustomGLTF 支持 Minecraft Java 版 1.20.1–1.20.6，共 6 个版本，可用的加载器：Fabric。下载时注意选择和你游戏版本一致的文件。
CustomGLTF 怎么安装？
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric，再把下载的 .jar 文件放进游戏目录的 mods 文件夹，重新启动游戏即可。开启了版本隔离的，mods 文件夹在 versions/版本名 下面。运行环境：仅客户端。
Maiky_hda 的其他作品
查看全部 →
TrollPlayer
TrollPlayer is a Minecraft 1.20.1 mod for stealth and pranks. Spy on players and mute your sounds for ultimate trolling and mystery in multiplayer worlds.
Mutated Mobs
Ever thought vanilla mobs were a bit... boring? Yeah, me too. This mod adds mutated versions of Minecraft mobs - bigger, meaner, and way more fun to fight (or run away from, no judgement).
CreateWhissle
A lightweight Create Mod addon that adds the Steam Engine Silencer to easily mute or soften loud steam engine noise with full in-game config support.
评论
登录后评论和评分