- Документация
- https://modrinth.com/mod/flw-vanillin
Vanillin — мод для Minecraft, применяющий инстансированную отрисовку Flywheel к поддерживаемым сущностям и блок-сущностям. Он сокращает повторяющуюся графическую работу в сценах с множеством одинаковых объектов. Лицензия — MIT; в публичной команде указаны jozufozu и Pepper_Bell. Клиент обязателен, сервер не поддерживается.
Vanillin рассчитан на сцены с большим числом поддерживаемых объектов: хранилища с сундуками и шалкеровыми ящиками, станции с вагонетками, зоны с колоколами и тесты display-сущностей.
Если узким местом служат генерация мира, серверная логика, освещение, частицы или неподдерживаемые объекты, эффект может быть небольшим. Категории проекта в метаданных не указаны.
Инстансирование позволяет передавать общую геометрию и различающиеся данные множества одинаковых объектов компактнее. Vanillin использует Flywheel и добавляет поддержку конкретных типов Minecraft.
Каждый тип требует отдельной реализации, поэтому мод не оптимизирует всё автоматически. Результат зависит от сцены, видеокарты, драйвера, разрешения и других модов; фиксированный прирост гарантировать нельзя.
В исходном описании функции разделены на стабильные, экспериментальные и временно отключённые. Стабильными и включёнными по умолчанию названы:
• сундуки;
• шалкеровые ящики;
• колокола;
• вагонетки всех вариантов.
Экспериментальная поддержка предусмотрена для выброшенных предметов, Item Display и Block Display. Её включают отдельно, учитывая повышенный риск конфликтов или визуальных дефектов. Таблички обозначены как временно отключённые из-за сбоев либо проблем совместимости. Объекты, отсутствующие в перечне, нельзя считать оптимизированными без дополнительного подтверждения.
В предоставленном описании Flywheel 1.0 и Vanillin отмечены как несовместимые с шейдерами. Также сказано, что работа над совместимостью ведётся, но сроков нет. Поэтому профиль, где шейдеры обязательны, нельзя считать совместимым без проверки точных версий.
При визуальных ошибках сначала отключают шейдеры и повторяют сцену. Vanillin также не ускоряет неподдерживаемые объекты и не оптимизирует серверную логику.
Подтверждены Minecraft 1.20.1 и 1.21.1, а среди платформ указаны Forge и NeoForge. Перечисленные файлы имеют явную привязку:
• Forge — Minecraft 1.20.1;
• NeoForge — Minecraft 1.21.1.
JAR устанавливают в клиентскую папку mods. Серверная сторона обозначена как unsupported, поэтому размещение файла на выделенном сервере не является подтверждённым сценарием. Для подключения клиент должен соответствовать своей версии Minecraft и загрузчику; одинаковый номер версии Vanillin не делает Forge- и NeoForge-файлы взаимозаменяемыми.
Vanillin использует Flywheel, однако в выбранных метаданных обязательные project dependencies не перечислены. Это не подтверждает необходимость вручную добавлять отдельный JAR.
Ориентироваться следует на метаданные выпуска и сообщения загрузчика. Если профиль указывает отсутствующую зависимость, её название и допустимую версию сверяют для выбранной ветки Minecraft.
Подтверждены два JAR версии 1.1.3:
• vanillin-forge-1.20.1-1.1.3.jar — 1 055 068 байт; SHA-512: db0dba2abc8eb6908ae3fb625a5bc78dbf120b713e2c17dff63915d8a05a31cff3fb2d361da4bc4cec54744581328c28232dfc33e7509654f3067cdd36f8da06; SHA-1: bc49b972af2523aef31c1dfd68989d8d896e8452;
• vanillin-neoforge-1.21.1-1.1.3.jar — 870 344 байта; SHA-512: b4c42bd310e66f20f679ff091192bb01739670f21162344bd177c812da20e873704ecb6ea5f6fd4d87661aee7be59a160808391582dfb97753833bfbb9fde236; SHA-1: fae8bb9f13cd9d086949b9aca85956bb6fa47f56.
Файлы получены по официальному HTTPS, локально сверены с опубликованными хешами и прошли статическую проверку структуры архива и путей. Динамический запуск не выполнялся. Проверка подтверждает целостность полученных копий, но не их совместимость с конкретным драйвером, модпаком или настройками.
Перед установкой полезно сохранить рабочий профиль, конфигурации и перечень модов. Порядок действий:
• Определить точную версию Minecraft и загрузчик клиента.
• Выбрать соответствующий Forge- или NeoForge-файл.
• Удалить прежний выпуск Vanillin из этого профиля.
• Поместить выбранный JAR в папку mods.
• Выполнить первый запуск без шейдеров.
• Проверить загрузку и тестовую сцену до включения экспериментальных функций.
Оба файла нельзя устанавливать одновременно. Forge-файл для 1.20.1 не подходит профилю NeoForge 1.21.1 и наоборот.
Для поддерживаемых типов предусмотрены режим по умолчанию, отключение и принудительное включение. Экспериментальные варианты лучше включать по одному, сохранив исходную конфигурацию.
Сравнение производительности проводят в одинаковых условиях:
• использовать одну копию мира и одну позицию камеры;
• сохранить разрешение, дальность прорисовки и набор модов;
• выбрать сцену с большим числом поддерживаемых объектов;
• оценить не только FPS, но и ровность времени кадра;
• визуально проверить сундуки, вагонетки и другие затронутые объекты;
• повторить тест после полной загрузки мира.
Отсутствие заметной разницы в пустой сцене нормально. Принудительное включение экспериментальной функции не делает её стабильной и не гарантирует выигрыш.
Для безопасности перед обновлением сохраняют старый JAR, конфигурацию и копию профиля. Новый выпуск сначала запускают с настройками по умолчанию и без шейдеров. Экспериментальные функции возвращают по одной, чтобы не смешивать обновление кода и изменение поведения.
Для отката восстанавливают прежний JAR и сохранённую конфигурацию. Vanillin описан как клиентский мод отрисовки и не заявляет собственных игровых блоков, однако резервная копия профиля всё равно нужна. Простое удаление нового файла без возврата настроек может не восстановить прежнее состояние тестовой среды.
Проверки удобно проводить по этапу сбоя:
• ошибка при старте — сверить Minecraft, Forge или NeoForge и исключить второй JAR;
• визуальные артефакты — отключить шейдеры и экспериментальные типы;
• отсутствие эффекта — убедиться, что сцена содержит поддерживаемые объекты;
• конфликт с другим модом — воспроизвести проблему в минимальном клиентском профиле;
• дефект одного объекта — отключить оптимизацию именно его типа;
• нестабильное время кадра — повторить тест после полной загрузки мира.
Менять следует один компонент за запуск, а вывод подтверждать повторяемым тестом.
Vanillin распространяется по MIT, канонический идентификатор SPDX — MIT. В публичной команде указаны jozufozu и Pepper_Bell. Локализация файлов разрешена при сохранении имени проекта, авторства и лицензионных уведомлений. Редакционные оценки и процедуры проверки не являются заявлениями авторов.
Нет подтверждённой необходимости. Серверная сторона обозначена как unsupported, а клиентская — required. JAR предназначен для совместимого клиентского профиля.
Нет. Поддержка создаётся отдельно для каждого типа. Стабильный перечень ограничен сундуками, шалкеровыми ящиками, колоколами и вагонетками; ещё несколько типов экспериментальны.
В предоставленном описании Vanillin на Flywheel 1.0 отмечен как несовместимый с шейдерами. Будущую поддержку нельзя считать доступной без подтверждения для выбранной версии.
Сцена может содержать мало поддерживаемых объектов, либо узкое место находится в другой части игры. Сравнивать нужно одинаковые сцены и время кадра, а не единичное значение FPS.
Нет. Выполнены получение по официальному HTTPS, сверка хешей и статическая проверка архива. Фактическую работу необходимо подтвердить в собственном клиентском профиле.
Назначение и аудитория
Vanillin рассчитан на сцены с большим числом поддерживаемых объектов: хранилища с сундуками и шалкеровыми ящиками, станции с вагонетками, зоны с колоколами и тесты display-сущностей.
Если узким местом служат генерация мира, серверная логика, освещение, частицы или неподдерживаемые объекты, эффект может быть небольшим. Категории проекта в метаданных не указаны.
Скриншоты и внешний вид
Как работает инстансированная отрисовка
Инстансирование позволяет передавать общую геометрию и различающиеся данные множества одинаковых объектов компактнее. Vanillin использует Flywheel и добавляет поддержку конкретных типов Minecraft.
Каждый тип требует отдельной реализации, поэтому мод не оптимизирует всё автоматически. Результат зависит от сцены, видеокарты, драйвера, разрешения и других модов; фиксированный прирост гарантировать нельзя.
Какие объекты поддерживаются
В исходном описании функции разделены на стабильные, экспериментальные и временно отключённые. Стабильными и включёнными по умолчанию названы:
• сундуки;
• шалкеровые ящики;
• колокола;
• вагонетки всех вариантов.
Экспериментальная поддержка предусмотрена для выброшенных предметов, Item Display и Block Display. Её включают отдельно, учитывая повышенный риск конфликтов или визуальных дефектов. Таблички обозначены как временно отключённые из-за сбоев либо проблем совместимости. Объекты, отсутствующие в перечне, нельзя считать оптимизированными без дополнительного подтверждения.
Шейдеры и другие ограничения
В предоставленном описании Flywheel 1.0 и Vanillin отмечены как несовместимые с шейдерами. Также сказано, что работа над совместимостью ведётся, но сроков нет. Поэтому профиль, где шейдеры обязательны, нельзя считать совместимым без проверки точных версий.
При визуальных ошибках сначала отключают шейдеры и повторяют сцену. Vanillin также не ускоряет неподдерживаемые объекты и не оптимизирует серверную логику.
Версии, загрузчики и стороны
Подтверждены Minecraft 1.20.1 и 1.21.1, а среди платформ указаны Forge и NeoForge. Перечисленные файлы имеют явную привязку:
• Forge — Minecraft 1.20.1;
• NeoForge — Minecraft 1.21.1.
JAR устанавливают в клиентскую папку mods. Серверная сторона обозначена как unsupported, поэтому размещение файла на выделенном сервере не является подтверждённым сценарием. Для подключения клиент должен соответствовать своей версии Minecraft и загрузчику; одинаковый номер версии Vanillin не делает Forge- и NeoForge-файлы взаимозаменяемыми.
Зависимости и роль Flywheel
Vanillin использует Flywheel, однако в выбранных метаданных обязательные project dependencies не перечислены. Это не подтверждает необходимость вручную добавлять отдельный JAR.
Ориентироваться следует на метаданные выпуска и сообщения загрузчика. Если профиль указывает отсутствующую зависимость, её название и допустимую версию сверяют для выбранной ветки Minecraft.
Файлы и контрольные суммы
Подтверждены два JAR версии 1.1.3:
• vanillin-forge-1.20.1-1.1.3.jar — 1 055 068 байт; SHA-512: db0dba2abc8eb6908ae3fb625a5bc78dbf120b713e2c17dff63915d8a05a31cff3fb2d361da4bc4cec54744581328c28232dfc33e7509654f3067cdd36f8da06; SHA-1: bc49b972af2523aef31c1dfd68989d8d896e8452;
• vanillin-neoforge-1.21.1-1.1.3.jar — 870 344 байта; SHA-512: b4c42bd310e66f20f679ff091192bb01739670f21162344bd177c812da20e873704ecb6ea5f6fd4d87661aee7be59a160808391582dfb97753833bfbb9fde236; SHA-1: fae8bb9f13cd9d086949b9aca85956bb6fa47f56.
Файлы получены по официальному HTTPS, локально сверены с опубликованными хешами и прошли статическую проверку структуры архива и путей. Динамический запуск не выполнялся. Проверка подтверждает целостность полученных копий, но не их совместимость с конкретным драйвером, модпаком или настройками.
Установка
Перед установкой полезно сохранить рабочий профиль, конфигурации и перечень модов. Порядок действий:
• Определить точную версию Minecraft и загрузчик клиента.
• Выбрать соответствующий Forge- или NeoForge-файл.
• Удалить прежний выпуск Vanillin из этого профиля.
• Поместить выбранный JAR в папку mods.
• Выполнить первый запуск без шейдеров.
• Проверить загрузку и тестовую сцену до включения экспериментальных функций.
Оба файла нельзя устанавливать одновременно. Forge-файл для 1.20.1 не подходит профилю NeoForge 1.21.1 и наоборот.
Настройки и проверка результата
Для поддерживаемых типов предусмотрены режим по умолчанию, отключение и принудительное включение. Экспериментальные варианты лучше включать по одному, сохранив исходную конфигурацию.
Сравнение производительности проводят в одинаковых условиях:
• использовать одну копию мира и одну позицию камеры;
• сохранить разрешение, дальность прорисовки и набор модов;
• выбрать сцену с большим числом поддерживаемых объектов;
• оценить не только FPS, но и ровность времени кадра;
• визуально проверить сундуки, вагонетки и другие затронутые объекты;
• повторить тест после полной загрузки мира.
Отсутствие заметной разницы в пустой сцене нормально. Принудительное включение экспериментальной функции не делает её стабильной и не гарантирует выигрыш.
Обновление и откат
Для безопасности перед обновлением сохраняют старый JAR, конфигурацию и копию профиля. Новый выпуск сначала запускают с настройками по умолчанию и без шейдеров. Экспериментальные функции возвращают по одной, чтобы не смешивать обновление кода и изменение поведения.
Для отката восстанавливают прежний JAR и сохранённую конфигурацию. Vanillin описан как клиентский мод отрисовки и не заявляет собственных игровых блоков, однако резервная копия профиля всё равно нужна. Простое удаление нового файла без возврата настроек может не восстановить прежнее состояние тестовой среды.
Диагностика неполадок
Проверки удобно проводить по этапу сбоя:
• ошибка при старте — сверить Minecraft, Forge или NeoForge и исключить второй JAR;
• визуальные артефакты — отключить шейдеры и экспериментальные типы;
• отсутствие эффекта — убедиться, что сцена содержит поддерживаемые объекты;
• конфликт с другим модом — воспроизвести проблему в минимальном клиентском профиле;
• дефект одного объекта — отключить оптимизацию именно его типа;
• нестабильное время кадра — повторить тест после полной загрузки мира.
Менять следует один компонент за запуск, а вывод подтверждать повторяемым тестом.
Лицензия и авторство
Vanillin распространяется по MIT, канонический идентификатор SPDX — MIT. В публичной команде указаны jozufozu и Pepper_Bell. Локализация файлов разрешена при сохранении имени проекта, авторства и лицензионных уведомлений. Редакционные оценки и процедуры проверки не являются заявлениями авторов.
FAQ
Нужно ли устанавливать Vanillin на сервер?
Нет подтверждённой необходимости. Серверная сторона обозначена как unsupported, а клиентская — required. JAR предназначен для совместимого клиентского профиля.
Оптимизирует ли мод все сущности?
Нет. Поддержка создаётся отдельно для каждого типа. Стабильный перечень ограничен сундуками, шалкеровыми ящиками, колоколами и вагонетками; ещё несколько типов экспериментальны.
Можно ли использовать шейдеры?
В предоставленном описании Vanillin на Flywheel 1.0 отмечен как несовместимый с шейдерами. Будущую поддержку нельзя считать доступной без подтверждения для выбранной версии.
Почему FPS не изменился?
Сцена может содержать мало поддерживаемых объектов, либо узкое место находится в другой части игры. Сравнивать нужно одинаковые сцены и время кадра, а не единичное значение FPS.
Проверены ли файлы запуском?
Нет. Выполнены получение по официальному HTTPS, сверка хешей и статическая проверка архива. Фактическую работу необходимо подтвердить в собственном клиентском профиле.