LOD Server Support

Поддержка LOD на серверах

Позволяет игрокам с Voxy видеть полностью отрисованный ландшафт на расстоянии сотен чанков на мультиплеерных серверах без необходимости сначала исследовать мир. Также включает отрисовку далёких игроков, так что вы можете видеть других игроков далеко за пределами ванильной дальности прорисовки. Мод даже может показывать далёкий ландшафт на серверах с Distant Horizons (экспериментально). Попробуйте вживую: зайдите на lod-server-support.modrinth.gg с установленными Voxy и этим модом. Поддерживает Minecraft 26.3, 26.2, 26.1, 1.21.11, 1.21.10 и 1.21.1. ▶YouTube · плеер загрузится по нажатию

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

Клиенты используют Fabric-мод на всех версиях; на 26.3, 26.2, 26.1 и 1.21.1 также работает клиент на NeoForge. У Voxy пока нет релиза для 26.3; до его выхода клиенты на 26.3 получают заполнение карты и далёких игроков, но без LOD-ландшафта. Поддерживаемые серверы:

Поддержка Folia и Sponge экспериментальная. Поддержка NeoForge — по мере возможностей, отрисовка далёких игроков доступна только на 1.21.1. Совместим с AntiXray, Moonrise, C2ME, ViaVersion/ViaBackwards и большинством других модов, включая Create. Может работать параллельно с Distant Horizons на одном сервере, поддерживая одновременно клиентов DH и Voxy. Может заполнять Xaero's World/Mini Map и JourneyMap на основе данных LOD. По умолчанию включено в новых установках; переключите «Map Ingestion» в настройках Sodium на клиенте, нажмите Apply, затем переподключитесь. LOD Server Support совместим как с более старыми, так и с более новыми версиями — от v0.4.0 до текущей. Операторы серверов могут свободно обновляться, чтобы воспользоваться улучшениями, не ломая клиентов на старых версиях, а клиенты могут обновляться, не нарушая совместимость со старыми серверами. На NeoForge (26.2 и 26.1) проверенный клиентский путь — наш форк Foxy (скачать со страницы релизов, он содержит исправление нативных библиотек для Windows, которого нет в стандартном Foxy), который загружает обычный Fabric- jar Voxy на NeoForge. Протестировано с Sodium 0.9.1 + Voxy 0.2.18-beta на 26.2 и Sodium 0.8.12 + Voxy 0.2.16-beta на 26.1.2, точные сочетания — в README Foxy. На NeoForge (1.21.1) используйте Roxy для загрузки Fabric- jar Voxy. Проверена работа с Roxy 0.2.0, Voxy 0.2.16-beta (сборка для 1.21.11), Sodium 0.8.12 и Forgified Fabric API 0.116.15. Если далёкие чанки Voxy не отображаются, отключите атмосферный туман в настройках графики. Серверы Distant Horizons (экспериментально, включено по умолчанию). Зайдите на сервер с Distant Horizons 3.3.x (или плагином DH Support), и далёкий ландшафт загрузится через Voxy, даже без LOD Server Support на сервере. Для лучших результатов мы всё же рекомендуем установить LOD Server Support и на сервер — при наличии он всегда имеет приоритет. Работает с Fabric-клиентами на всех версиях и NeoForge-клиентами на 26.2, 26.1 и 1.21.1. Не устанавливайте вместе с ним клиентский мод Distant Horizons. Отключается параметром «Allow DH Server Terrain» в настройках Sodium на клиенте (NeoForge: перезапустите игру). Не одобрено командой Distant Horizons. Voxy Server Side — тот же самый мод. Клиенты Voxy Server Side совместимы с серверами LOD Server Support и наоборот.

Установка

Установите LOD Server Support и на сервер (Fabric-мод LOD Server Support, плагин Paper, мод NeoForge или плагин Sponge), и на каждый клиент, которому нужны эти функции. Без LOD Server Support и на подключающемся клиенте, и на сервере он не будет работать (кроме серверов Distant Horizons, см. выше). Клиенты без LOD Server Support всё равно могут подключаться как обычно.

Настройка

Файлы конфигурации создаются при первом запуске по пути config/lss-server-config.yaml на Fabric, NeoForge и Sponge или plugins/LodServerSupport/lss-server-config.yaml на Paper. Клиентские настройки находятся в config/lss-client-config.yaml. Настройки сгруппированы по функциям и задокументированы прямо в файле, включая единицы измерения и требования к перезапуску/переподключению. Отредактируйте YAML и выполните /lsslod reload на сервере или /lss reload на клиенте.

Команды

Сервер (Fabric, NeoForge, Paper и Sponge)

• /lsslod stats — показать статистику передачи по каждому игроку
• /lsslod diag — показать подробную диагностику (конфигурация, пропускная способность, глубина очередей)
• /lsslod reload — перезагрузить настройки сервера из YAML; настройки, для которых всё ещё нужен перезапуск, будут указаны
• /lsslod store status — показать статус хранилища LOD (состояние, счётчики попаданий/промахов, размер)
• /lsslod store backfill start|stop|status — управлять фоновым предварительным обходом (не на Paper)
• /lsslod help — список всех команд

Клиент (Fabric и NeoForge)

• /lss reload — перезагрузить настройки клиента из YAML; настройки, для которых всё ещё нужно переподключение, будут указаны
• /lss clearcache — очистить локальный кэш колонок, заставляя заново запросить все чанки с сервера
• /lss reset — стереть LOD этого мира (локальный кэш и сохранённые данные Voxy) и заново их подгрузить
• /lss diag — показать диагностику на стороне клиента (соединение, пропускная способность, прогресс сканирования, бюджет запросов)

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

Включи LOD-хранилище. Установи enabled: true в storage.lod_store (требуется перезапуск). Оно кэширует предобработанные LOD-данные на диск, экономя CPU, но с недостатком — дополнительным расходом дискового пространства, который может быть сравним с размером файлов вашего мира. На Fabric, NeoForge и Sponge при включённом LOD-хранилище запускается задача обратного заполнения. Максимальная экономия CPU достигается только после заполнения хранилища. Проверить прогресс задачи можно командой /lsslod store backfill status. Если ваш мир намного больше области, которую обычно посещают игроки, можно сэкономить место на диске, установив enabled: false в storage.lod_store.backfill. Paper заполняет хранилище по мере выдачи террейна. Используй ограничители пропускной способности и генерации, чтобы ограничить CPU. Затраты CPU у LOD Server Support — это по сути то, сколько колонок в секунду он выдаёт плюс сколько чанков генерирует, и эти конфиги ограничивают именно это:

• network.bandwidth.per_player_mib_per_second / network.bandwidth.global_mib_per_second ограничивают скорость выдачи чанков. Они намеренно считают несжатые байты, чтобы сжатие не поднимало незаметно реальный потолок. Фактическое использование сети зависит от сжатия и террейна.
• generation.concurrency.global / generation.concurrency.per_player ограничивают генерацию новых чанков — безусловно, самое дорогое, что может запустить LOD Server Support. На сервере, исследующем новые территории, это доминирует, и снижение этого параметра даёт наибольшую экономию. Установка enabled: false в generation останавливает новую генерацию; существующие задачи завершатся.
• storage.disk.max_concurrent_reads ограничивает количество одновременных чтений LOD с диска, чтобы LOD-трафик не монополизировал дисковый ввод-вывод, необходимый для загрузки ванильных чанков. Автоматическое значение 0 подходит большинству серверов; снизьте до 1 или 2, если загрузка игровых чанков подтормаживает во время стриминга LOD, повысьте, если загрузка LOD кажется медленной на быстром NVMe-накопителе. Отключи повторное сканирование LOD-хранилища на Paper. Установи resweep_interval_seconds: 0 в storage.lod_store. Это уменьшает периодические проверки, но на Paper возможно пропустить обновления чанков, так что могут выдаваться старые LOD. Предгенерируй мир. Очевидно, лучшее, что можно сделать для игрового опыта — избежать генерации чанков, предгенерировав карту с помощью такого инструмента, как Chunky.

Распространение

Этот мод распространяется под лицензией MIT, распространение с указанием авторства приветствуется, а модпаки могут ссылаться напрямую на официальный проект на Modrinth. Согласно политике Modrinth в отношении повторной загрузки: XANTHA через Voxy Server Side имеет явное разрешение правообладателя распространять этот мод и его производные на Modrinth.