playerviewdistance

PlayerViewDistance

Дайте каждому игроку свою собственную серверную дальность прорисовки, не заставляя весь сервер платить за самую большую настройку.

PlayerViewDistance (PVD) — это мод и плагин для выделенного сервера для Fabric, Forge, NeoForge, Paper и Folia. Он управляет загрузкой и отправкой чанков для каждого игрока, точно объединяет близлежащие зоны покрытия и держит дорогостоящее планирование подальше от главного потока сервера.

Зачем использовать PVD?

• Дальность для каждого игрока: использует клиентский запрос каждого игрока или постоянное переопределение оператора.
• Меньше лишней загрузки: за пределами порога симуляции игрок с ограничением дальности 2 не заставляет PVD загружать дальность 8 только ради него.
• Планирование вне потока: геометрия, расчёты перекрытий, приоритизация и решения регулятора выполняются в одном объединяющем потоке планировщика.
• Безопасное поведение симуляции: PVD не меняет дальность симуляции, тики сущностей, Redstone, случайные тики или тикеты других модов.
• Адаптивный и совместимый: моды для производительности сервера могут понизить активную дальность, но не могут поднять её выше потолка PVD.
• Только для сервера: ванильные клиенты могут подключаться как обычно.

Влияние на производительность

На сервере с ограничением дальности прорисовки 12 и дальностью симуляции 4 игрок, запрашивающий дальность 4, не вносит никакой нагрузки от PVD за пределами порога симуляции, а другой игрок, желающий дальность 12, всё ещё может её использовать. Если многие игроки выбирают меньше серверного максимума, сервер избегает работы с чанками на максимальной дальности вокруг каждого из них.

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

Поддерживаемые платформы

Fabric требует Fabric Loader 0.19.3 и соответствующую Fabric API. Сборки для Fabric, Forge и NeoForge помещаются в директорию mods сервера. Сборка для Paper/Folia помещается в plugins.

Как выбирается дальность

PVD вычисляет потолок для каждого игрока:

Потолок PVD = min(ограничение мира/сервера,
                  настроенный максимум,
                  max(настроенный минимум, постоянное переопределение или клиентский запрос))

фактическая дальность = min(потолок PVD, все более низкие ограничения платформы или провайдера)

Более низкие ограничения от сервера, адаптивного регулятора или другого совместимого мода остаются в силе.

Например, /pvd set Steve 6 сохраняет дальность 6 для UUID Steve. Изменение клиентской дальности прорисовки Steve не заменит её. /pvd reset Steve удаляет переопределение и возвращает Steve к текущей дальности, запрошенной клиентом. Переопределения сохраняются при переподключениях и перезапусках сервера.

Команды

Команды требуют прав game-master на мод-загрузчиках или playerviewdistance.admin на Paper/Folia.

/pvd set <player> <2..32>
/pvd reset <player>
/pvd status
/pvd list
/pvd reload

/pvd list сообщает среднее значение и десять наибольших активных дальностей игроков, сохраняя вывод управляемым на больших серверах.

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

PVD включает специальную интеграцию для:

• C2ME и C2ME No Tick View Distance
• VMP (Very Many Players)
• Moonrise

Совместимость также охватывает ServerCore, Lithium, FerriteCore, ModernFix, Alternate Current, ScalableLux, Krypton, Let Me Despawn, Chunky, spark, распространённые загрузчики чанков и типичные серверные сборки модов, где доступны эти проекты.

PVD сохраняет принудительные, спавновые, портальные, симуляционные и сторонние тикеты чанков. На Paper/Folia и Moonrise он использует нативный загрузчик для каждого игрока вместо создания плагинных тикетов чанков.

Настройка

Конфигурация загрузчика модов хранится в config/. Paper и Folia используют plugins/PlayerViewDistance/.

{
  "schemaVersion": 2,
  "minViewDistance": 2,
  "maxViewDistance": 32,
  "governorProfile": "BALANCED",
  "telemetryIntervalSeconds": 60
}

Перезагрузка конфигурации транзакционна: недействительные файлы остаются нетронутыми, а последняя действительная конфигурация продолжает действовать. Переопределения UUID сохраняются атомарно в playerviewdistance-overrides.json.

Ссылки

• Исходный код
• Релизы
• Проблемы и поддержка
• Apache License 2.0