CustomGLTF

CustomGLTF

Внимание: 1.20.4 больше не поддерживается. Пожалуйста, используйте Minecraft 1.20.1 для всех последних исправлений, функций и обновлений.

CustomGLTF — это клиентская библиотека-мод, которая позволяет загружать, анимировать, прикреплять и рендерить стандартные 3D-модели glTF / GLB в Minecraft.

Что такое glTF?

glTF (GL Transmission Format) — это открытый стандартный формат 3D-файлов, поддерживаемый практически любым 3D-софтом (Blender, Maya, 3ds Max, Blockbench и т.д.). Это делает экспорт и перенос кастомных 3D-моделей прямо в Minecraft очень простым.

Возможности

• Загрузка файлов glTF и GLB: стандартные модели .gltf и .glb с мешами, текстурами и костями.
• Полная поддержка анимаций: скелетная анимация, анимация узлов и встроенный Animation Controller (кроссфейдинг, зацикливание, конечный автомат).
• Система костных сокетов и прикреплений: прикрепляйте предметы, оружие, частицы или другие модели к конкретным анимированным костям.
• Процедурные переопределения костей: управляйте поворотами/смещениями костей динамически через код (наведение турели, рулевое управление транспорта, слежение головы).
• Динамические хитбоксы: вычисление точных 3D-хитбоксов из геометрии модели.
• Исправленная прозрачность и рендер воды: чистое альфа-смешивание и отбрасывание фрагментов (никаких чёрных квадратов, вода за моделями рендерится корректно).
• Скиннинг с ускорением на GPU: несколько профилей OpenGL (GL43, GL40, GL33 и CPU-фолбэк GL30).
• Двуязычное предупреждение о шейдерах: предупреждение в игровом чате (на английском и немецком) при активных шейдерах.

Требования

• Minecraft: 1.20.1 (1.20.4 больше не поддерживается)
• Fabric Loader: 0.14.21 или выше
• Fabric API
• Java: 17 или выше

Важное замечание о шейдерах: шейдерпаки (Iris / OptiFine) НЕ поддерживаются. Если шейдеры включены, в игре появится предупреждение. Пожалуйста, отключите шейдеры, чтобы модели glTF рендерились правильно.

Для разработчиков модов

Это библиотека-мод. Сам по себе он не добавляет отдельные предметы или блоки. Чтобы увидеть модели в игре, нужен другой мод, использующий CustomGLTF. Если вы разработчик модов и хотите использовать эту библиотеку в своём моде, ознакомьтесь с Developer Guide и API в репозитории — там есть полные шаблоны и примеры.

Благодарности

• Этот мод основан на MCglTF от TimLee9024 и Protoxy. Огромное спасибо им за создание оригинальной библиотеки!
• Использует код из JglTF от Marco Hutter (javagl.de).
• Портирован на 1.20.1 и обновлён Maiky.

Лицензия

MIT License. Смело используйте это в своих модпаках или как зависимость для своих модов.

Проблемы и отзывы

Если найдёте баги или у вас есть вопросы — открывайте issue или оставляйте комментарий!