Liubai

Liubai — клиентский графический оптимизатор, предназначенный для работы в мирах с масштабными техническими постройками. Он анализирует плавность игры и автоматически снижает нагрузку на рендеринг менее значимых объектов.

Мод отслеживает стабильность кадров и осторожно сокращает объем работы по отрисовке объектов, скрытых за стенами, далеких деталей, частиц, теней и тегов имен. Как только игра снова начинает работать плавно, Liubai постепенно восстанавливает детализацию, избегая резких скачков настроек в попытках достичь целевого FPS.

Важно понимать, что Liubai влияет исключительно на клиентскую графику. Он не отключает логику мобов или сущностей, не влияет на редстоун, рецепты или работу механизмов, а также не изменяет серверные процессы и показатели TPS.

Liubai может работать совместно с такими модами, как Entity Culling и Create / Flywheel.

Мод использует целевой FPS и текущую плавность игры для автоматического переключения между тремя уровнями нагрузки: NORMAL, HIGH и CRITICAL. Чтобы избежать постоянного переключения настроек вблизи целевого значения, система ждет стабилизации производительности перед снижением уровня нагрузки. Если лимит кадров в самой игре ниже целевого значения Liubai, мод использует меньшее число, чтобы не оставаться в режиме высокой нагрузки по ошибке.

В отсутствие других модов на оптимизацию видимости, Liubai использует собственные проверки. Он учитывает реальную видимую область каждого объекта вместо стандартного размера, признавая надежными только полностью сплошные блоки. По умолчанию объект должен быть подтвержден как скрытый дважды перед тем, как отрисовка будет приостановлена. Чтобы минимизировать фризы, система проверяет лишь ограниченное количество объектов за один кадр, а после движения игрока приоритет отдается проверке объектов в тех зонах, где старые результаты могут стать недействительными.

При высокой нагрузке Liubai анализирует размер далеких объектов на экране и скрывает те, что едва заметны. Для выпавших предметов и сфер опыта используется стабильный лимит на область, что предотвращает мерцание при изменении порядка обработки. Мод защищает критически важные объекты: игроков, боссов, снаряды, транспорт, а также светящиеся, горящие сущности и объекты, на которые указывает прицел. В пределах зоны безопасности объекты не скрываются из-за малого размера или большого количества похожих объектов.

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

По умолчанию выбран режим AUTO. Если Entity Culling установлен, он отвечает за определение скрытых объектов, и Liubai не дублирует эти проверки. В обоих случаях Liubai продолжает управлять рендерингом мелких далеких объектов, частиц и теней. Обратите внимание: объекты, скрытые Entity Culling, не учитываются в счетчиках Liubai, поэтому значение «скрытых объектов» может быть 0 — это нормальное поведение.

Для следующих версий предусмотрена выделенная поддержка:

`text
Create 6.0.10
Flywheel 1.0.6
`

В условиях нагрузки Liubai взаимодействует с правилами Flywheel, чтобы далекие машины обновлялись реже. Близкие механизмы сохраняют свою частоту обновления. Мод не удаляет и не перестраивает объекты, используемые Flywheel, и не останавливает логику механизмов. Для других версий, если они работают иначе, чем ожидается, Liubai отключает эту оптимизацию для обеспечения безопасного запуска.

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

`text
Sable 2.0.3
Create Aeronautics 1.3.0
Create 6.0.10
Flywheel 1.0.6
`

Liubai использует данные от Iris для определения моментов генерации теней. Во время их создания мод не применяет правила скрытия объектов, что снижает риск исчезновения мобов, спецэффектов и теней ванильных сущностей. Совместимость подтверждена, однако результаты с конкретными шейдерами требуют отдельной проверки.

Настройки доступны на английском и упрощенном китайском языках. Кнопка «Liubai Settings» находится в верхнем правом углу меню паузы (ESC).

Дополнительно можно включить панель производительности (HUD), которая отображает:

• Текущий уровень нагрузки
• Активный режим работы
• Количество объектов, не отрисованных в секунду
• Время, затраченное на проверку скрытых объектов (включая тайм-ауты)
• Статус частиц
• Показатели P95/P99 (самые медленные 5% и 1% кадров)

Панель HUD по умолчанию отключена и активируется в меню настроек.

Рекомендации по использованию:

• Оставьте режим occlusion на значении AUTO.
• При использовании Entity Culling не заставляйте оба мода одновременно проверять скрытые объекты.
• Для проверки работы оптимизации временно включите панель HUD.
• Для игры по сети устанавливайте мод только на клиент.

Конфигурационный файл находится по пути:

config/liubai-client.toml

Можно ли использовать Liubai вместе с Entity Culling?
Да, режим AUTO позволяет Entity Culling определять скрытые объекты, а Liubai управляет графической нагрузкой на оставшиеся видимые объекты.

Влияет ли мод на механизмы, редстоун или логику сущностей?
Нет, Liubai корректирует только клиентскую графику и частоту обновления отображаемых объектов, не затрагивая игровую логику.

Почему в панели производительности отображается 0 скрытых объектов?
Если используется Entity Culling, он выполняет проверки видимости, и эти объекты не попадают в статистику Liubai. Также счетчики могут быть нулевыми, если уровень нагрузки NORMAL или рядом нет подходящих объектов.