- Документация
- https://modrinth.com/mod/sodiumleafculling
Sodium Leaf Culling — клиентский мод, который меняет обработку внутренних граней листвы в конвейере построения мешей Sodium. Подтверждённая сборка предназначена для Minecraft 1.21.1 с Fabric и требует Fabric API и Sodium. Серверная сторона не поддерживается. Проект распространяется по лицензии MIT, в публичной команде указан Txni.
В кроне присутствует много наложенных прозрачных граней, включая почти невидимые игроку поверхности. Мод внедряется в этап, на котором Sodium формирует геометрию чанков, и упрощает либо отбрасывает часть внутренних элементов.
Это узкоспециализированная графическая оптимизация. Она не ускоряет генерацию мира, серверные тики, работу существ, сеть или загрузку ресурсов. Потенциальная польза выше в густом лесу и возле больших декоративных деревьев, а в сценах без листвы эффект может отсутствовать.
Режим по умолчанию называется Solid Aggressive. В крупных скоплениях листвы внутренняя часть кроны переводится в непрозрачное представление, близкое к быстрому режиму графики, тогда как наружный слой сохраняет более детальное отображение. Внешне дерево должно оставаться узнаваемым, а скрытая глубоко внутри геометрия обрабатывается проще.
Подход ориентирован в том числе на использование шейдеров в плотных лесах, где множество прозрачных поверхностей может создавать дополнительную нагрузку. Однако прирост не гарантирован: результат зависит от видеокарты, разрешения, шейдеров, дальности прорисовки и состава конкретной сцены.
Hollow применяет более традиционное отсечение: мод старается удалить вершины и грани внутри сплошной массы листьев, сохраняя видимую оболочку. Этот режим отличается от Solid Aggressive и по методу, и по возможному влиянию на изображение.
Сравнивать режимы лучше в одном месте при неизменных настройках. Полезно осмотреть естественный лес, крупную крону, вид изнутри дерева и участок с прозрачными соседними блоками. При использовании шейдеров проверку стоит повторить отдельно с ними и без них.
Sodium Leaf Culling подходит игрокам, которые уже используют Sodium на клиенте Fabric и хотят уменьшить нагрузку, связанную с листвой. Типичные сценарии выбора:
• просадки или рывки чаще возникают в лесных биомах;
• используются шейдеры, чувствительные к прозрачной геометрии;
• нужна клиентская оптимизация без изменения сервера;
• пользователь готов проверить совместимость с собственным ресурспаком и набором графических модов.
Серверного ускорения этот JAR не даёт и Sodium с Fabric API не заменяет.
Для представленного файла подтверждена строго определённая комбинация:
• Minecraft 1.21.1;
• загрузчик Fabric;
• Fabric API — обязательная зависимость;
• Sodium — обязательная зависимость;
• клиентская сторона — обязательна;
• серверная сторона — не поддерживается.
Фраза о ветке 1.21+ описывает направление проекта, но не доказывает работу этого JAR на каждом последующем выпуске. Нельзя автоматически переносить совместимость на любые более новые выпуски ветки 1.21. Fabric-сборку также не следует помещать в профиль другого загрузчика.
Перед установкой нужно закрыть игру и сохранить копию текущего профиля. Порядок действий:
• Убедиться, что профиль запускает Minecraft 1.21.1 через Fabric.
• Проверить наличие совместимых Fabric API и Sodium.
• Поместить sodiumleafculling-fabric-1.0.1-1.21.1.jar в папку mods нужного профиля.
• Удалить возможную старую или дублирующую копию того же мода.
• Запустить именно изменённый профиль.
Ручные команды или неподтверждённые правки конфигурации для базовой установки не нужны.
Сначала проверяют корректность загрузки. Игра должна открыться без сообщения об отсутствующих Fabric API или Sodium, а журнал не должен содержать ошибки инициализации Sodium Leaf Culling. Затем в мире осматривают листву снаружи, изнутри кроны и рядом с другими прозрачными блоками.
Для сравнения производительности нужен воспроизводимый сценарий:
• Выбрать сохранённую точку в густом лесу.
• Зафиксировать разрешение, шейдеры, дальность прорисовки и лимит кадров.
• Сравнить одинаковое направление камеры с модом и без него.
• Проверить не только частоту кадров, но и рывки при перестроении чанков.
• Отдельно оценить Solid Aggressive и Hollow.
Отсутствие заметного прироста не доказывает ошибку: ограничивающим фактором может быть другая часть системы.
Агрессивное упрощение может менять вид кроны с необычными текстурами, шейдерами или при ракурсе изнутри: часть скрытой геометрии намеренно обрабатывается иначе.
Следует учитывать основные границы:
• подтверждён только Fabric-файл для Minecraft 1.21.1;
• серверную производительность он не улучшает;
• эффект зависит от количества листвы и графического конвейера;
• другие моды рендеринга могут вмешиваться в тот же этап построения мешей;
• статическая проверка архива не подтверждает запуск в любой сборке.
Пропавшие наружные грани, мерцание или повреждённые кроны требуют проверки сочетания версий и временного отключения других дополнений, меняющих рендеринг чанков.
Подтверждённый файл:
• имя: sodiumleafculling-fabric-1.0.1-1.21.1.jar;
• версия: 1.0.1;
• размер: 299711 байт;
• SHA-1: 792d25eab5876b3cd0d3b2b3e7b93d3d3a65836a;
• SHA-512: e9418149ccfb5365416fe1a54c991d8eba604d5dc751e1241f5904b6cda927eb99a13e296ed86297111423401dbfbe6d9de8a3ff77b93a142c31e848df814271.
Файл получен по официальному HTTPS и локально сверён с опубликованными хешами. Структура архива и внутренние пути прошли статическую проверку. Динамический запуск не выполнялся, поэтому проверка подтверждает целостность полученного файла, но не его работу в конкретном профиле.
Обновление проверяют по всей связке Minecraft, Fabric, Fabric API и Sodium. Перед заменой сохраняют старый JAR, конфигурацию и резервную копию важных миров.
Безопасная последовательность:
• Закрыть игру.
• Удалить старую сборку Sodium Leaf Culling.
• Установить один файл для той же версии игры и загрузчика.
• Проверить зависимости.
• Сначала открыть тестовый мир, затем основной.
Для отката возвращают прежний JAR и, если они менялись одновременно, прежние совместимые зависимости. Старую и новую версии нельзя оставлять рядом: дублирование может остановить загрузку ещё до входа в игру.
При остановке запуска сначала сверяют Minecraft, Fabric и обе обязательные зависимости. Журнал загрузчика обычно показывает, какой компонент отсутствует, задублирован или имеет неподходящую версию.
При графическом дефекте полезно последовательно:
• отключить шейдеры;
• вернуть стандартный ресурспак;
• выбрать другой режим отсечения;
• убрать прочие моды, меняющие меши чанков или листву;
• повторить проверку в новом мире с тем же набором файлов.
Если прироста нет, стоит проверить сцену с большим количеством листьев, отключить ограничение кадров для измерения и убедиться, что система не упирается в другой ресурс. Оценка должна опираться на повторяемый тест, журнал и конкретный визуальный симптом.
Нет. Для Sodium Leaf Culling указана обязательная клиентская сторона и неподдерживаемая серверная. JAR размещается только в совместимом клиентском профиле.
Нет. Sodium является обязательной зависимостью. Дополнение использует его конвейер построения геометрии и без Sodium не выполняет заявленную функцию.
Подтверждена только версия 1.21.1. Обозначение 1.21+ нельзя считать доказательством совместимости каждого более нового выпуска.
Нет. Он сокращает часть работы с листвой, но итог зависит от сцены и конфигурации. При другом узком месте разница может быть небольшой.
Solid Aggressive сильнее упрощает внутреннюю часть больших крон, сохраняя детальную наружную оболочку. Hollow ближе к удалению скрытых внутренних граней. Выбор делают после визуального и производительного сравнения в своём профиле.
Назначение мода
В кроне присутствует много наложенных прозрачных граней, включая почти невидимые игроку поверхности. Мод внедряется в этап, на котором Sodium формирует геометрию чанков, и упрощает либо отбрасывает часть внутренних элементов.
Это узкоспециализированная графическая оптимизация. Она не ускоряет генерацию мира, серверные тики, работу существ, сеть или загрузку ресурсов. Потенциальная польза выше в густом лесу и возле больших декоративных деревьев, а в сценах без листвы эффект может отсутствовать.
Скриншоты и внешний вид
Режим Solid Aggressive
Режим по умолчанию называется Solid Aggressive. В крупных скоплениях листвы внутренняя часть кроны переводится в непрозрачное представление, близкое к быстрому режиму графики, тогда как наружный слой сохраняет более детальное отображение. Внешне дерево должно оставаться узнаваемым, а скрытая глубоко внутри геометрия обрабатывается проще.
Подход ориентирован в том числе на использование шейдеров в плотных лесах, где множество прозрачных поверхностей может создавать дополнительную нагрузку. Однако прирост не гарантирован: результат зависит от видеокарты, разрешения, шейдеров, дальности прорисовки и состава конкретной сцены.
Режим Hollow
Hollow применяет более традиционное отсечение: мод старается удалить вершины и грани внутри сплошной массы листьев, сохраняя видимую оболочку. Этот режим отличается от Solid Aggressive и по методу, и по возможному влиянию на изображение.
Сравнивать режимы лучше в одном месте при неизменных настройках. Полезно осмотреть естественный лес, крупную крону, вид изнутри дерева и участок с прозрачными соседними блоками. При использовании шейдеров проверку стоит повторить отдельно с ними и без них.
Для кого предназначен проект
Sodium Leaf Culling подходит игрокам, которые уже используют Sodium на клиенте Fabric и хотят уменьшить нагрузку, связанную с листвой. Типичные сценарии выбора:
• просадки или рывки чаще возникают в лесных биомах;
• используются шейдеры, чувствительные к прозрачной геометрии;
• нужна клиентская оптимизация без изменения сервера;
• пользователь готов проверить совместимость с собственным ресурспаком и набором графических модов.
Серверного ускорения этот JAR не даёт и Sodium с Fabric API не заменяет.
Совместимость и зависимости
Для представленного файла подтверждена строго определённая комбинация:
• Minecraft 1.21.1;
• загрузчик Fabric;
• Fabric API — обязательная зависимость;
• Sodium — обязательная зависимость;
• клиентская сторона — обязательна;
• серверная сторона — не поддерживается.
Фраза о ветке 1.21+ описывает направление проекта, но не доказывает работу этого JAR на каждом последующем выпуске. Нельзя автоматически переносить совместимость на любые более новые выпуски ветки 1.21. Fabric-сборку также не следует помещать в профиль другого загрузчика.
Установка
Перед установкой нужно закрыть игру и сохранить копию текущего профиля. Порядок действий:
• Убедиться, что профиль запускает Minecraft 1.21.1 через Fabric.
• Проверить наличие совместимых Fabric API и Sodium.
• Поместить sodiumleafculling-fabric-1.0.1-1.21.1.jar в папку mods нужного профиля.
• Удалить возможную старую или дублирующую копию того же мода.
• Запустить именно изменённый профиль.
Ручные команды или неподтверждённые правки конфигурации для базовой установки не нужны.
Проверка после установки
Сначала проверяют корректность загрузки. Игра должна открыться без сообщения об отсутствующих Fabric API или Sodium, а журнал не должен содержать ошибки инициализации Sodium Leaf Culling. Затем в мире осматривают листву снаружи, изнутри кроны и рядом с другими прозрачными блоками.
Для сравнения производительности нужен воспроизводимый сценарий:
• Выбрать сохранённую точку в густом лесу.
• Зафиксировать разрешение, шейдеры, дальность прорисовки и лимит кадров.
• Сравнить одинаковое направление камеры с модом и без него.
• Проверить не только частоту кадров, но и рывки при перестроении чанков.
• Отдельно оценить Solid Aggressive и Hollow.
Отсутствие заметного прироста не доказывает ошибку: ограничивающим фактором может быть другая часть системы.
Ограничения и визуальные компромиссы
Агрессивное упрощение может менять вид кроны с необычными текстурами, шейдерами или при ракурсе изнутри: часть скрытой геометрии намеренно обрабатывается иначе.
Следует учитывать основные границы:
• подтверждён только Fabric-файл для Minecraft 1.21.1;
• серверную производительность он не улучшает;
• эффект зависит от количества листвы и графического конвейера;
• другие моды рендеринга могут вмешиваться в тот же этап построения мешей;
• статическая проверка архива не подтверждает запуск в любой сборке.
Пропавшие наружные грани, мерцание или повреждённые кроны требуют проверки сочетания версий и временного отключения других дополнений, меняющих рендеринг чанков.
Файл, хеши и степень проверки
Подтверждённый файл:
• имя: sodiumleafculling-fabric-1.0.1-1.21.1.jar;
• версия: 1.0.1;
• размер: 299711 байт;
• SHA-1: 792d25eab5876b3cd0d3b2b3e7b93d3d3a65836a;
• SHA-512: e9418149ccfb5365416fe1a54c991d8eba604d5dc751e1241f5904b6cda927eb99a13e296ed86297111423401dbfbe6d9de8a3ff77b93a142c31e848df814271.
Файл получен по официальному HTTPS и локально сверён с опубликованными хешами. Структура архива и внутренние пути прошли статическую проверку. Динамический запуск не выполнялся, поэтому проверка подтверждает целостность полученного файла, но не его работу в конкретном профиле.
Обновление и откат
Обновление проверяют по всей связке Minecraft, Fabric, Fabric API и Sodium. Перед заменой сохраняют старый JAR, конфигурацию и резервную копию важных миров.
Безопасная последовательность:
• Закрыть игру.
• Удалить старую сборку Sodium Leaf Culling.
• Установить один файл для той же версии игры и загрузчика.
• Проверить зависимости.
• Сначала открыть тестовый мир, затем основной.
Для отката возвращают прежний JAR и, если они менялись одновременно, прежние совместимые зависимости. Старую и новую версии нельзя оставлять рядом: дублирование может остановить загрузку ещё до входа в игру.
Диагностика проблем
При остановке запуска сначала сверяют Minecraft, Fabric и обе обязательные зависимости. Журнал загрузчика обычно показывает, какой компонент отсутствует, задублирован или имеет неподходящую версию.
При графическом дефекте полезно последовательно:
• отключить шейдеры;
• вернуть стандартный ресурспак;
• выбрать другой режим отсечения;
• убрать прочие моды, меняющие меши чанков или листву;
• повторить проверку в новом мире с тем же набором файлов.
Если прироста нет, стоит проверить сцену с большим количеством листьев, отключить ограничение кадров для измерения и убедиться, что система не упирается в другой ресурс. Оценка должна опираться на повторяемый тест, журнал и конкретный визуальный симптом.
FAQ
Нужно ли устанавливать мод на сервер?
Нет. Для Sodium Leaf Culling указана обязательная клиентская сторона и неподдерживаемая серверная. JAR размещается только в совместимом клиентском профиле.
Заменяет ли он Sodium?
Нет. Sodium является обязательной зависимостью. Дополнение использует его конвейер построения геометрии и без Sodium не выполняет заявленную функцию.
Подойдёт ли файл для любой Minecraft 1.21?
Подтверждена только версия 1.21.1. Обозначение 1.21+ нельзя считать доказательством совместимости каждого более нового выпуска.
Гарантирует ли мод повышение FPS?
Нет. Он сокращает часть работы с листвой, но итог зависит от сцены и конфигурации. При другом узком месте разница может быть небольшой.
Как выбрать между Solid Aggressive и Hollow?
Solid Aggressive сильнее упрощает внутреннюю часть больших крон, сохраняя детальную наружную оболочку. Hollow ближе к удалению скрытых внутренних граней. Выбор делают после визуального и производительного сравнения в своём профиле.
