MCglTF

Description

MCglTF is a 3D model loader library which load glTF format file and prepare the required techniques to render the model for Minecraft Modding enviroment.
Various features from glTF spec are available, but still remain a good compatibility and performance.

What is glTF?

The following image gives an overview of glTF:

From github.com/javagl/gltfOverview/

Japanese translation by Takuto Takahashi

More detail github.com/KhronosGroup/glTF/

Usages

The example codes for rendering Block, Item, and Entity

• https://github.com/ModularMods/MCglTF-Example

Features

• ✅ GLTF format (Embedded resources or via ResourceLocation)
• ✅ GLB format
• ✅ UVs
• ✅ Normals
• ✅ Tangents
• ✅ Vertex colors
• ✅ Materials (Require OptiFine or Iris Shaders and supported ShaderPack for PBR and Normal map)
• ✅ Textures
• ❎ Mutiple texture coordinates (For compatibility reason with Vanilla)
• ✅ Rig
• ✅ Animations (multiple)
• ✅ Morph targets
• ✅ Zero-scale node culling (https://github.com/KhronosGroup/glTF/pull/2059)

Frequently Asked Question

Q. Why my texture for my model does not show up?
A. You need to defined material inside "extras" of "materials" to link your texture. For more details please visit wiki page.

Q. Why two animations cannot control translation/rotation/scale/weight in same node at the same time and cause one of the animation not playing?
A. There is no animation blending technique defined in glTF specification, so the animations created by GltfAnimationCreator does not support animation blending too. You need to create your own animation processor based on your scenario.

Q. How to apply my custom processing to the model like custom material(e.g. apply player skin) or create special OpenGL commands for specified node?
A. For more advanced way to generate OpenGL commands for glTF model, you can override and return false to isReceiveSharedModel(GltfModel, GltfRenderDatas) in your IGltfModelReceiver. This allow you to create your custom RenderedGltfModel based on supplied GltfModel. (Beware to add your OpenGL objects like VBO, VAO, Texture, etc to GltfRenderDatas for deletion during refresh resource.)

Credit

• JglTF by javagl: https://github.com/javagl/JglTF
• Mikk Tangent Generator by jMonkeyEngine: https://github.com/jMonkeyEngine/jmonkeyengine

What means Verified?

• Compatibility: The mod should be compatible with the latest version of Minecraft and be clearly labeled with its supported versions.
• Functionality: The mod should work as advertised and not cause any game-breaking bugs or crashes.
• Security: The mod should not contain any malicious code or attempts to steal personal information.
• Performance: The mod should not cause a significant decrease in the game's performance, such as by causing lag or reducing frame rates.
• Originality: The mod should be original and not a copy of someone else's work.
• Up-to-date: The mod should be regularly updated to fix bugs, improve performance, and maintain compatibility with the latest version of Minecraft.
• Support: The mod should have an active developer who provides support and troubleshooting assistance to users.
• License: The mod should be released under a clear and open source license that allows others to use, modify, and redistribute the code.
• Documentation: The mod should come with clear and detailed documentation on how to install and use it.

How to Install