MCglTF - Библиотека для работы с 3D моделями в Minecraft

MCglTF представляет собой специализированную библиотеку для загрузки и отображения 3D моделей в формате glTF в среде моддинга Minecraft. Данное решение обеспечивает высокую производительность и совместимость с игровым движком, поддерживая при этом широкий спектр возможностей спецификации glTF.

Практическое применение

Для демонстрации возможностей библиотеки доступны примеры кода, показывающие рендеринг блоков, предметов и существ:

• Примеры реализации

Основные возможности

• Поддержка форматов GLTF и GLB
• Работа с встроенными ресурсами или через ResourceLocation
• Обработка UV-координат
• Нормали и касательные векторы
• Вершинные цвета
• Материалы (требуют OptiFine или Iris Shaders для PBR и нормальных карт)
• Текстуры
• Скелетная анимация
• Множественные анимации
• Морфинг-цели
• Оптимизация рендеринга через отсечение узлов с нулевым масштабом

Примечание: для совместимости с ванильной версией игры не поддерживаются множественные текстурные координаты.

Часто задаваемые вопросы

Вопрос: Почему текстуры для моей модели не отображаются? Ответ: Необходимо определить материал внутри раздела "extras" для "materials", чтобы связать текстуру. Подробности смотрите в документации.

Вопрос: Почему две анимации не могут одновременно управлять трансформацией одного узла? Ответ: Спецификация glTF не определяет технику смешивания анимаций, поэтому анимации, созданные через GltfAnimationCreator, также не поддерживают эту функцию. Требуется создание собственного процессора анимаций.

Вопрос: Как применить пользовательскую обработку к модели? Ответ: Для расширенного управления рендерингом можно переопределить метод isReceiveSharedModel в IGltfModelReceiver и создать собственный RenderedGltfModel. Не забудьте добавить OpenGL объекты в GltfRenderDatas для корректного освобождения ресурсов.

Используемые технологии

• JglTF от javagl
• Генератор касательных Mikk от jMonkeyEngine