Liubai

О Liubai

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

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

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

Возможности

Автоматическая настройка на основе производительности игры

• Использует целевой FPS и недавнюю плавность игры для автоматического переключения между уровнями нагрузки NORMAL / HIGH / CRITICAL;
• Ждёт, пока производительность стабилизируется, прежде чем понизить уровень нагрузки, что уменьшает частые переключения;
• Если собственное ограничение частоты кадров в игре ниже целевого значения Liubai, Liubai использует меньшее значение, чтобы ошибочно не оставаться в состоянии высокой нагрузки.

Аккуратные проверки объектов за стенами

• Если не установлен другой мод для оптимизации окклюзии, Liubai может использовать собственные проверки объектов, скрытых за стенами;
• Использует реальную видимую область, записанную игрой для каждого объекта, вместо того чтобы считать все объекты одинакового размера;
• Только полные твёрдые блоки считаются надёжным укрытием; объекты всё равно отрисовываются, когда чанки не загружены, их видимая область необычна или результат неопределён;
• По умолчанию объект должен быть подтверждён как скрытый дважды, прежде чем Liubai временно прекратит его отрисовку;
• За каждый кадр может выполняться лишь ограниченное число проверок в течение ограниченного времени; проверки, которые слишком сложны, чтобы завершиться, продолжаются в следующем кадре без отбрасывания более раннего надёжного результата;
• После перемещения игрока Liubai проверяет, всё ли ещё старая стена блокирует обзор, и даёт этим объектам приоритет, уменьшая подтормаживания, вызванные тем, что все старые результаты внезапно становятся недействительными.

Дальние детали и большие группы похожих объектов

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

Частицы, тени и никнеймы

• Решает, нужно ли показывать дальнюю частицу, ещё до её создания, уменьшая ненужную работу по созданию;
• Использует рекомендуемый лимит для существующих частиц и ограничивает количество дальних частиц, которые можно добавить за кадр;
• Снижает дальность отображения обычных теней сущностей и никнеймов, когда игра под нагрузкой;
• Защищает важные частицы, такие как взрывы, Totem of Undying и звуковые удары, а также тени и никнеймы важных сущностей.

Настройки и информация о производительности

• Предоставляет экраны конфигурации на упрощённом китайском и английском языках;
• Открывается напрямую кнопкой «Liubai Settings» в правом верхнем углу меню паузы по ESC;
• Необязательная экранная панель производительности (HUD) показывает текущий уровень нагрузки, активный режим работы, количество объектов, не отрисованных за секунду, время, затраченное на проверку скрытых объектов и проверки с истёкшим временем, состояние частиц и время кадров P95/P99, которые помогают показать самые медленные 5% и 1% кадров;
• Панель производительности отключена по умолчанию и может быть включена в настройках при необходимости.

Совместимость с модами

Entity Culling

Режим отсечения по умолчанию — AUTO:

• Если установлен Entity Culling, именно он решает, полностью ли скрыты обычные объекты, а Liubai не повторяет те же проверки видимости за стенами;
• Без Entity Culling Liubai использует собственные аккуратные проверки видимости;
• В обоих случаях Liubai продолжает обрабатывать мелкие далёкие объекты, частицы, тени, таблички с именами и то, как часто далёкие объекты из поддерживаемых модов обновляются на экране.

Entity Culling 1.10.5 был протестирован. Объекты, пропущенные Entity Culling, не попадают в информацию о производительности Liubai, поэтому при совместном использовании обоих модов число «пропущено скрытых объектов» у Liubai может быть равно 0. Это нормально.

Create и Flywheel

Следующие версии имеют отдельную поддержку и были протестированы:

Create 6.0.10
Flywheel 1.0.6

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

Другие версии Create / Flywheel не считаются поддерживаемыми автоматически. Если они работают не так, как ожидает Liubai, Liubai отключает эту дополнительную оптимизацию и оставляет исходное поведение Flywheel без изменений, чтобы игра всё равно могла безопасно запуститься.

Sable и Create Aeronautics

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

Sable 2.0.3
Create Aeronautics 1.3.0
Create 6.0.10
Flywheel 1.0.6

Iris

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

Подтверждено, что Iris запускается вместе с Liubai и позволяет войти в мир. Фактические результаты с тенями всё ещё требуют отдельного тестирования с разными наборами шейдеров, так что это не означает, что каждый набор шейдеров полностью поддерживается.

Рекомендуемые настройки

• После входа в мир откройте «Liubai Settings» в правом верхнем углу меню паузы по ESC.
• Оставьте режим отсечения на значении по умолчанию AUTO.
• При использовании Entity Culling не заставляйте оба мода одновременно проверять, скрыты ли обычные объекты.
• Чтобы проверить, активна ли оптимизация, временно включите экранную панель производительности (HUD).
• Liubai не нужно устанавливать на обычный выделенный сервер. Для мультиплеера устанавливайте его только на клиент, чтобы использовать его графические оптимизации.

Файл конфигурации:

config/liubai-client.toml

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

Можно ли использовать Liubai вместе с Entity Culling?

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

Влияет ли это на машины, Redstone или логику сущностей?

Нет. Liubai настраивает только клиентскую графику и то, как часто поддерживаемые отрисовываемые объекты обновляются на экране. Он не останавливает игровую логику.

Почему Liubai показывает 0 пропущенных скрытых объектов в панели производительности?

Когда Liubai работает вместе с Entity Culling, проверки видимости выполняет Entity Culling, и объекты, которые он пропускает, не попадают в информацию о производительности Liubai. Другие счётчики оптимизации также могут оставаться на 0, когда уровень нагрузки всё ещё NORMAL или когда рядом нет подходящих далёких объектов.

Почему после установки Liubai средний FPS меняется незначительно?

Результат зависит от мира и сборки модов каждого игрока. В одних ситуациях Liubai может дать заметный прирост FPS, а в других — почти незаметный или вовсе отсутствовать.