Dynamic Performance

Dynamic Performance

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

Идеально подходит для владельцев серверов, которые хотят сохранить максимально возможный комфорт игры даже на слабом железе.

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

1. Динамическое масштабирование: Проверяя MSPT сервера (миллисекунды на тик), мод динамически подстраивается под идеальные настройки, обеспечивая максимально возможную производительность сервера.
2. Расширяемая конфигурация: Тип масштабирования, а также интервал проверки полностью настраиваются под возможности вашего железа.
3. Гибкость и совместимость: Мод работает в одиночной и многопользовательской игре, поддерживает Fabric и NeoForge и совместим со всеми другими модами на производительность.
4. Понятность: Благодаря встроенным командам для проверки текущего состояния сервера, просмотра активной конфигурации и перезагрузки изменений конфига легко понять, что именно происходит.

Как это работает

Dynamic Performance отслеживает текущий MSPT, проверяя его примерно каждые 15 секунд. Подробнее см. раздел Конфигурация.

Дополнительно: здоровый сервер стремится к 20 TPS (тиков в секунду) и, следовательно, максимум к 50 MSPT. Так что порог лага должен быть примерно на этом значении.

Кроме того, если MSPT превышает порог лага, сервер начинает снижать настройки согласно уровням производительности, пока не перестанет превышать порог. То же самое касается восстановления: если MSPT ниже порога восстановления, сервер начинает повышать настройки на основе упомянутых уровней, теперь в обратном порядке.

Если MSPT остаётся между порогами лага и восстановления, изменения масштабирования не производятся. Сервер считается стабильным. Подробнее см. раздел Состояния производительности.

Установка

После добавления мода в ваш мир или на сервер вы сможете открыть панель «О моде», полностью управляемую мышью:

/dp about

или

/dynamicperformance about

Статус

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

/dp status

или

/dynamicperformance status

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

Сообщаются следующие состояния производительности:

• Optimal: все настроенные уровни восстановлены.
• Stable: MSPT находится между порогами восстановления и лага.
• Scaling Down: MSPT высокий, и настройки всё ещё можно снизить.
• Lagging: MSPT высокий, но все настроенные уровни уже на минимальных значениях.
• Scaling Up: настройки восстанавливаются.

Конфигурация

Файл конфигурации создаётся по пути:

./config/dynamic-performance.json

Содержимое по умолчанию:

{
  "interval": 15,
  "lag_threshold": 45.0,
  "recovery_threshold": 30.0,
  "levels": [
    {
      "type": "SIMULATION_DISTANCE",
      "max": 16,
      "min": 8,
      "increment": 1
    },
    {
      "type": "MOB_CAP_PERCENTAGE",
      "max": 100,
      "min": 75,
      "increment": 5
    },
    {
      "type": "SIMULATION_DISTANCE",
      "max": 8,
      "min": 5,
      "increment": 1
    },
    {
      "type": "MOB_CAP_PERCENTAGE",
      "max": 75,
      "min": 30,
      "increment": 15
    },
    {
      "type": "VIEW_DISTANCE",
      "max": 20,
      "min": 4,
      "increment": 2
    }
  ]
}

> В этом конфиге самое заметное изменение — дальность прорисовки — оставлено последним запасным вариантом, а нагрузка на сервер снижается раньше за счёт simulation distance и спавна мобов.

### Опции

- `interval`: Как часто, в секундах, проверяется и корректируется производительность сервера.
- `lag_threshold`: Значение MSPT, при котором начинается снижение.
- `recovery_threshold`: Значение MSPT, при котором или ниже которого начинается повышение обратно.
- `levels`: Упорядоченные правила масштабирования для дальности прорисовки, simulation distance и процента лимита мобов.

### Типы уровней

Поддерживаемые типы уровней:

- `VIEW_DISTANCE`: Изменяет дальность прорисовки сервера.
- `SIMULATION_DISTANCE`: Изменяет simulation distance сервера.
- `MOB_CAP_PERCENTAGE`: Изменяет лимит мобов как процент от ванильных лимитов мобов.

У каждого уровня есть:

- `max`: Наибольшее значение, до которого мод может восстановить эту настройку.
- `min`: Наименьшее значение, до которого мод может снизить эту настройку.
- `increment`: Размер шага при повышении или понижении.

> Порядок важен. Снижение идёт по списку сверху вниз, а повышение обратно — снизу вверх.

### Активная конфигурация

Активную конфигурацию можно посмотреть в игре с помощью:

```mcfunction
/dp config

или

/dynamicperformance config

На скриншоте показан конфиг по умолчанию, перечисленный выше.

Перезагрузка

После редактирования файла конфига примените изменения без перезапуска, выполнив:

/dp reload

или

/dynamicperformance reload

Если конфиг некорректен, команда сообщает об ошибке и оставляет активным предыдущий корректный конфиг.

Участие и проблемы

Я рад:

• Сообщениям об ошибках
• Запросам на новые функции
• Pull request'ам

Пожалуйста, открывайте issues или PR на GitHub.

Лицензия

Этот проект лицензирован под LGPLv3 License. Подробности см. в LICENSE.