LOD Server Support

LOD Server Support, или LSS, - серверное дополнение для Voxy, которое передаёт клиентам данные о дальнем рельефе в мультиплеере. С ним можно видеть полностью прорисованные LOD-террейны на сотни чанков вокруг, даже если эти места ещё никто не исследовал. Дополнительно мод отображает игроков далеко за пределами стандартной дистанции прорисовки Minecraft.

Обычно дальние LOD в одиночной игре строятся из уже посещённых мест. На сервере же игрок может уйти далеко от исследованной территории и увидеть лишь туман или незагруженный горизонт. LSS решает эту проблему: сервер подготавливает и передаёт данные о местности, а клиент с Voxy показывает их на большом расстоянии. Это полезно для исследования мира, ориентации на карте и поиска крупных ориентиров, не меняя обычную загрузку ближайших чанков.

Что меняется в мультиплеере

• Дальний рельеф. Игроки с Voxy видят ландшафт за пределами ванильной дистанции прорисовки. Исследовать местность заранее не требуется.
• Дальние игроки. Других участников можно заметить далеко от себя, за пределами обычной дальности отображения сущностей.
• Данные для карт. LOD Server Support может передавать данные в Xaero's World/Mini Map и [JourneyMap]. В версии 0.19.0 улучшена интеграция с JourneyMap и добавлена поддержка карт Незера и пещер в Xaero's World Map. На сервере также можно запретить клиентам добавлять LOD-рельеф на карты.
• Серверы с Distant Horizons. В экспериментальном режиме LSS может получать дальний рельеф с сервера, где запущен Distant Horizons 3.3.x или плагин DH Support. Для этой возможности установка LSS на сервер не обязательна, но при наличии LSS его данные имеют приоритет.

Это утилитарный проект для тех, кому важны дальний обзор и карты в сетевой игре. Он не заменяет Voxy: клиентам, которые хотят видеть LOD-рельеф, нужны оба проекта - Voxy и LOD Server Support.

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

LSS поддерживает Minecraft 26.3, 26.2, 26.1, 1.21.11, 1.21.10 и 1.21.1. Актуальная версия проекта - 0.19.0. Клиентский вариант доступен для Fabric на всех указанных версиях. Для Minecraft 26.3, 26.2, 26.1 и 1.21.1 также поддерживается клиент NeoForge с оговорками ниже.

Minecraft	Fabric	Paper / Purpur	Folia	NeoForge	Sponge
26.3	Да	Да	-	Да	Да
26.2	Да	Да	Да	Да	Да
26.1	Да	Да	Да	Да	Да
1.21.11	Да	Да	Да	-	Да
1.21.10	Да	Да	-	-	Да
1.21.1	Да	Да	-	Да	Да

Поддержка Folia и Sponge экспериментальная. NeoForge работает по принципу best effort; отображение дальних игроков на клиенте NeoForge доступно только для Minecraft 1.21.1. У Voxy пока нет версии для Minecraft 26.3, поэтому на этой версии клиенты получают заполнение карт и отображение дальних игроков, но не LOD-рельеф.

LSS совместим с AntiXray, Moonrise, C2ME, ViaVersion, ViaBackwards и большинством других модов, включая Create. На сервере можно одновременно запустить LSS и Distant Horizons: тогда к нему смогут подключаться клиенты обоих типов.

Версии LOD Server Support от 0.4.0 до текущей обратно и вперёд совместимы. Администратор может обновить сервер, не нарушая соединение со старыми клиентами; обновление клиента также не лишает совместимости со старыми серверами. Клиенты Voxy Server Side (VSS), прежнего названия проекта, совместимы с серверами LSS и наоборот.

Клиенты NeoForge

Для Minecraft 26.2 и 26.1 проверенный вариант - форк Foxy, загружающий обычный Fabric-файл Voxy в NeoForge. В форке исправлена проблема с Windows-библиотеками, которой нет в стандартном Foxy. Проверенные сочетания:

• Minecraft 26.2: Sodium 0.9.1 и Voxy 0.2.18-beta.
• Minecraft 26.1: Sodium 0.8.12 и Voxy 0.2.16-beta.

Для Minecraft 1.21.1 используйте Roxy, чтобы загрузить Fabric-файл Voxy в NeoForge. Проверенная связка: Roxy 0.2.0, Voxy 0.2.16-beta, Sodium 0.8.12 и Forgified Fabric API 0.116.15. Если дальние чанки Voxy не появляются, отключите окружающий туман в настройках графики.

Совместимость с серверами Distant Horizons

Экспериментальная функция включена по умолчанию. На сервере с Distant Horizons 3.3.x или плагином DH Support дальний рельеф может загружаться через Voxy даже без LSS на стороне сервера. Для наиболее предсказуемой работы рекомендуется установить LSS и на сервер: его данные будут использоваться в первую очередь.

Функция работает с клиентами Fabric на всех поддерживаемых версиях, а также с NeoForge-клиентами на Minecraft 26.2, 26.1 и 1.21.1. Не устанавливайте клиентский мод Distant Horizons одновременно с этой функцией. Отключить её можно параметром Allow DH Server Terrain в настройках Sodium; на NeoForge после изменения потребуется перезапустить игру. Команда разработчиков Distant Horizons официально этот режим не поддерживает.

Установка

Установите LOD Server Support на сервер и на каждый клиент, которому нужны дальний рельеф и дальние игроки. На сервере подойдёт Fabric-мод, плагин для Paper или Sponge либо мод NeoForge - выбор зависит от платформы сервера. Клиенту нужен соответствующий вариант LSS и установленный Voxy.

Без LSS на сервере и подключающемся клиенте основные функции не заработают. Исключение - экспериментальная поддержка серверов 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 - повторная загрузка клиентских настроек.
• /lss clearcache - очистка локального кэша столбцов; после этого данные будут запрошены с сервера заново.
• /lss reset - удаление LOD текущего мира из локального кэша и хранилища Voxy с последующей повторной загрузкой.
• /lss diag - сведения о соединении, скорости передачи, прогрессе сканирования и лимите запросов.

Производительность сервера

Основная нагрузка LSS зависит от количества столбцов, передаваемых за секунду, и объёма генерации новых чанков. Для настройки есть отдельные ограничения на пропускную способность, генерацию и чтение диска.

Включите хранилище LOD, если серверу важно не обрабатывать одни и те же данные повторно. В storage.lod_store задайте enabled: true; для этого потребуется перезапуск. Подготовленные данные кэшируются на диске и экономят процессорное время, но занимают дополнительное место - объём может быть сопоставим с файлами мира.

На Fabric, NeoForge и Sponge после включения хранилища запускается фоновое заполнение. Максимальная экономия CPU появится после его завершения; прогресс показывает /lsslod store backfill status. Если размер мира намного больше территории, где обычно играют, можно отключить предварительное заполнение через storage.lod_store.backfill. На Paper хранилище наполняется по мере передачи рельефа.

Ограничьте скорость передачи и генерации, если LSS заметно нагружает сервер:

• network.bandwidth.per_player_mib_per_second и network.bandwidth.global_mib_per_second задают лимит передачи на игрока и на весь сервер. Счётчик использует объём данных до сжатия, чтобы компрессия не обходила заданный предел. Реальная нагрузка на сеть зависит от сжатия и типа местности.
• generation.concurrency.global и generation.concurrency.per_player ограничивают параллельную генерацию чанков. Именно она обычно создаёт наибольшую нагрузку при исследовании новых территорий. Если отключить generation, новые задачи генерации остановятся, а уже запущенные завершатся.
• storage.disk.max_concurrent_reads ограничивает число одновременных чтений LOD с диска. Значение 0 включает автоматический выбор и обычно подходит большинству серверов. Если обычные чанки подтормаживают во время передачи LOD, попробуйте 1 или 2; на быстром NVMe-накопителе лимит можно увеличить, если дальний рельеф загружается медленно.

На Paper параметр storage.lod_store.resweep_interval_seconds: 0 отключает периодическую повторную проверку чанков и снижает фоновую нагрузку. Есть компромисс: при таком режиме сервер может пропустить обновление чанка и выдать клиенту устаревший LOD.

Для большого мира полезно заранее сгенерировать территорию с помощью Chunky. Тогда игроки реже запускают генерацию новых чанков, а серверу проще передавать дальние данные без резких пиков нагрузки.

Карты и дальний рельеф

Интеграция с Xaero's World Map и JourneyMap передаёт картам сведения из LOD-хранилища, чтобы исследованная карта могла заполняться без обычного приближения игрока к каждому чанку. В новых установках Map Ingestion включён по умолчанию. Если данные не появляются, проверьте этот параметр в настройках Sodium на клиенте, нажмите Apply и подключитесь к серверу заново. Администратор может запретить такое заполнение на стороне сервера.

Это особенно полезно на больших картах: можно заранее оценить направление хребтов, береговую линию и расположение крупных участков суши. Но LOD-карта не заменяет обычную загрузку чанков для взаимодействия с миром - она предназначена для дальнего обзора и картографических данных.