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.
About this Mod
CustomGLTF
This is a client-side library mod that allows you to load and render glTF 3D models in Minecraft.
What is glTF?
glTF is an open standard file format for 3D models. Its supported by pretty much every 3D software like Blender, Maya, 3ds Max and many more. This makes it super easy to bring your custom models into Minecraft.
Features
- Load glTF and GLB model files
- Full animation support including skeletal animations
- Works with Iris Shaders
- Works with OptiFine shaders via OptiFabric
- GPU accelerated skinning for better performance
- Supports normal maps and specular maps for shader packs
- Multiple OpenGL profiles for different hardware (GL43, GL40, GL33, GL30)
Requirements
- Minecraft 1.20.1
- Fabric Loader 0.14.21 or higher
- Fabric API
Optional but Recommended
- Iris Shaders for shader support
- OptiFabric for OptiFine shader support
For Mod Developers
This is a library mod. It doesnt do anything on its own. You need another mod that uses CustomGLTF to actually see models in game. If youre a mod developer and want to use this library check out the source code for examples on how to implement it.
Credits
This mod is based on MCglTF by TimLee9024. Big thanks to them for creating the original library. I ported it to 1.20.1 and made some changes but the core work is theirs.
Also uses code from JglTF by Marco Hutter.
License
MIT License - Feel free to use this in your modpacks or as a dependency for your mods.
Issues
If you find any bugs or have questions feel free to leave a comment. Im not a professional developer so please be patient with me.
Available Versions
How to Install CustomGLTF on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.6).
Install Mod
Open the mod browser in the dashboard and search for "CustomGLTF". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.6, 1.20.5, 1.20.4 (+3 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
CustomGLTF server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.6). You can switch loaders with one click in the panel.
Is CustomGLTF compatible with fabric?
CustomGLTF officially supports fabric for Minecraft 1.20.6, 1.20.5, 1.20.4. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with CustomGLTF – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if CustomGLTF consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install CustomGLTF with just one click on your server.