CustomglTF
A glTF model loader library for Minecraft Fabric 1.20.1. 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.4,共 2 个版本,可用的加载器:Fabric。下载时注意选择和你游戏版本一致的文件。
CustomglTF 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。
Maiky_hda 的其他作品
查看全部 →Hire villager worker
Hire and manage your own villager workers. Equip pickaxes, bind a chest with a Wand, auto‑mine stone/deepslate, and control them with /worker start/stop. Version 1.2 by maiky_hda.
AdminTroll Commands
AdminTrollCommands ultimate trolling and stealth mod for Minecraft 1.20.1! Gain supernatural abilities to spy on players and move completely silently. Perfect for server administrators, content creators, and players who love pranks and stealth gameplay.
Mutated Mobs
Ever thought vanilla mobs were a bit... boring? Mutant monsters 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).
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.
评论
登录后评论和评分