Sodium Blending Registry

Этот плагин предназначен для исправления известного бага графического движка Sodium, вызывающего некорректное смешивание цветов в различных модах.

Sodium Blending Registry — это специализированный плагин для графического движка Sodium. Его основная задача — устранение визуальных несоответствий, возникающих из-за бага некорректного смешивания цветов. Эта проблема часто затрагивает множество модов, использующих провайдеры цветов (color providers), что портит общую картинку в игре.

Проблема, которую решает данный проект, подробно описана в официальном отчете Sodium (issue 895). Визуальные искажения возникают именно в момент обработки смешивания, и плагин предоставляет динамический способ регистрации блоков для корректной работы системы.

Для расширения возможностей проекта в него был добавлен новый тег c:blendable. Он позволяет разработчикам регистрировать кастомные блоки или жидкости так, чтобы они использовали систему смешивания Sodium вместо стандартной ванильной логики.

Использование этого тега особенно эффективно при создании контента, где цвета блоков или жидкостей должны динамически меняться в зависимости от биома. Применив тег, разработчик гарантирует, что новый объект будет корректно интегрирован в систему рендеринга Sodium.

Чтобы активировать эту функцию, необходимо создать файл blendable.json по соответствующему пути в папке ресурсов:

{
  "replace": false,
  "values": [
	"testmod:newleaveblock"
  ]
}

Пути для размещения файла зависят от типа объекта: для блоков используйте resources/data/c/tags/blocks, а для жидкостей — resources/data/c/tags/fluids. Обратите внимание, что эта функция предназначена исключительно для разработчиков модов и не влияет на игровой процесс обычных пользователей.

❗ ВАЖНО: Начиная с версии Sodium 0.5, данный функционал уже включен в основной код Sodium. Использование этого плагина вместе с Sodium 0.5 или более новыми версиями приведет к вылету игры!

Проект сфокусирован исключительно на исправлении бага смешивания цветов в Sodium. Если вы столкнулись с другими графическими ошибками, рекомендуется обращаться к официальному репозиторию Sodium.

• Убедитесь, что версия плагина соответствует вашей версии Minecraft и Sodium.
• Воспроизведите ошибку, зафиксировав все условия и действия.
• Предоставьте информацию о версиях Minecraft, Fabric, Sodium и других установленных модах.
• Приложите логи, если они содержат релевантную информацию.

Требования проверенного файла

• По манифесту для файла sodium-blendingregistry-0.4.4.1.jar (Minecraft 1.19, 1.19.1, 1.19.2; Fabric, Quilt) требуется sodium. Встроенных JAR-библиотек в проверенном файле нет.