- Документация
- https://modrinth.com/plugin/chunkmanager
ChunkManager — серверный плагин для оптимизации загрузки и выгрузки чанков. Он предназначен для Bukkit-, Spigot-, Paper- и Folia-серверов, устанавливается как JAR в папку plugins и не требует клиентской установки.
Заявленный принцип работы включает динамическое изменение радиуса загрузки чанков, временное кэширование недавно выгруженных областей и наблюдение за производительностью сервера. Плагин также предоставляет средства анализа миров, принудительной оптимизации и освобождения памяти.
Загрузка и выгрузка чанков при перемещениях, телепортациях и работе нескольких миров создаёт серверную нагрузку. ChunkManager управляет этой частью процесса.
Проект относится к категориям management, optimization и utility. Он работает с чанк-нагрузкой и не заменяет общее профилирование остальных частей сервера.
Практические задачи ChunkManager:
• адаптировать радиус загрузки к нагрузке;
• кэшировать недавно выгруженные чанки;
• показывать статистику миров и регионов;
• предоставлять инструменты обслуживания;
• помогать диагностировать чанк-нагрузку.
Плагин заявлен для Bukkit, Spigot, Paper и Folia. Стороны обозначены как client=unsupported и server=required. Это означает, что JAR устанавливается только на сервер; игрокам не требуется добавлять его в клиентский профиль.
Подтверждённые версии Minecraft:
• 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5 и 1.20.6;
• 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10 и 1.21.11;
• 26.1, 26.1.1, 26.1.2 и 26.2.
Поддержка версии в метаданных означает заявленную совместимость, но не гарантирует одинаковое поведение на каждой сборке ядра и с любым набором плагинов. Перед обновлением рабочего сервера необходима проверка на тестовой копии.
Динамический радиус загрузки меняется с учётом нагрузки. Кэш недавно выгруженных чанков предназначен для ускорения повторного обращения и сокращения частых циклов выгрузки и загрузки.
Плагин отслеживает состояние сервера и может выгружать наиболее удалённые от игроков чанки. Эффект зависит от онлайна, числа миров, перемещений и других плагинов.
Высокоуровневая схема выглядит так:
• Плагин наблюдает за показателями.
• Корректирует радиус загрузки.
• Кэширует недавно выгруженные чанки.
• Выгружает удалённые области.
• Предоставляет статистику и ручные операции.
Точные пороги и алгоритм выбора чанков в основе не раскрыты.
В официальном описании перечислены административные команды:
• /cm — открытие графического интерфейса;
• /chunkstatus — просмотр показателей производительности;
• /chunkreload — перезагрузка конфигурации плагина;
• /optimizechunks — принудительная оптимизация чанков;
• /chunkgc — операция освобождения памяти;
• /chunksummary — сводный анализ мира;
• /maintenance — переключение режима обслуживания;
• /chunklang — изменение языка;
• /chunkanalyze [world] — анализ сложности чанков выбранного мира;
• /chunkregions — статистика регионов;
• /chunkmetrics — расширенные метрики.
Для функций указано разрешение chunkmanager.admin; его следует выдавать только доверенным администраторам. Более детальная матрица прав не приведена.
Освобождение памяти не заменяет поиск утечки или ошибочной настройки.
Плагин использует файл config.yml. В опубликованном примере присутствуют группы параметров, связанные с:
• радиусом загрузки чанков вокруг игрока;
• временем хранения записей в кэше;
• максимальным числом чанков, загружаемых за тик;
• предельным размером кэша;
• уровнем журналирования.
Параметры связаны: радиус меняет охват, лимит за тик — темп обработки, а размер кэша — баланс повторных загрузок и памяти.
Универсальные значения не подтверждены. Настройку следует проверять на тестовой среде, сохраняя конфигурацию и оценивая TPS, память и задержки загрузки.
Подтверждённая процедура установки:
• Остановить совместимый сервер.
• Поместить выбранный JAR в папку plugins.
• Запустить сервер и проверить загрузку плагина.
• Убедиться, что создана конфигурация.
• Проверить доступ администратора к диагностическим функциям.
• Провести наблюдение на тестовом мире.
• Перед применением на основном сервере сохранить резервные копии.
В выбранных метаданных обязательные project dependencies не указаны. Это означает отсутствие перечисленных обязательных зависимостей, но не отменяет требования совместимого серверного ядра.
При переходе между версиями 1.3.5 и 1.3.6 не следует одновременно оставлять оба JAR в папке plugins. Конкретная процедура миграции конфигурации в основе не описана, поэтому обновление лучше сначала проверить на копии сервера.
Предоставлены два артефакта.
ChunkManager-1.3.6.jar:
• размер — 392 131 байт;
• версия — 1.3.6;
• SHA-512: e6e5a079bf29e27da2484ca3343e86f2e511b6dff6875f17639254007b5ac5dd7b4a7d6dbcbe52921ec33cf15471ecc1bb22a43b7e47173a5edf67b7d96855f6;
• SHA-1: 4381897eff1962250d98bbf76d3c7f6f92b9bf6c.
ChunkManager-1.3.5.jar:
• размер — 645 506 байт;
• версия — 1.3.5;
• SHA-512: bec2c0da13d6f5644e2358d045ef2233aac4de6997506c2a8913d5122ab34c180ce710151190016104f5532c1e236346a5a6e0fbdeacab05fe8d8905dcb04fc9;
• SHA-1: ded895df4a9cd752234b0dfd83f092416b315f00.
Хеши позволяют проверить совпадение локального файла с опубликованным артефактом. Для новой установки логично рассматривать 1.3.6 как более поздний из двух предоставленных выпусков, но выбор должен учитывать совместимость конкретного сервера и результаты теста.
ChunkManager распространяется по лицензии MIT. Это определяет условия использования самого проекта, но не заменяет лицензии серверного ядра и других установленных плагинов.
JAR-файлы получены по официальному HTTPS и локально сверены по опубликованным хешам. Архивы прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому не подтверждены фактическая загрузка на каждом ядре, отсутствие конфликтов и реальный эффект на производительность.
В основе нет результатов нагрузочных испытаний, гарантированного прироста TPS, рекомендуемого объёма памяти или универсального набора параметров. Плагин следует оценивать как инструмент управления и диагностики чанк-нагрузки, а не как автоматическое решение любой серверной проблемы.
Нет. Он устанавливается на сервер, а клиентская сторона указана как unsupported.
В выбранных метаданных обязательные project dependencies не перечислены. Требуется совместимое серверное ядро одной из заявленных платформ.
Folia входит в подтверждённый список платформ. Конкретное сочетание версии ядра и других плагинов всё равно следует проверить на тестовом сервере.
Такого требования нет. Команда подтверждена как средство освобождения памяти, но регулярность и полезность зависят от ситуации и не должны назначаться без наблюдения.
Нет. Проведены получение по официальному HTTPS, сверка хешей и статическая проверка структуры и путей.
Заявленный принцип работы включает динамическое изменение радиуса загрузки чанков, временное кэширование недавно выгруженных областей и наблюдение за производительностью сервера. Плагин также предоставляет средства анализа миров, принудительной оптимизации и освобождения памяти.
Назначение плагина
Загрузка и выгрузка чанков при перемещениях, телепортациях и работе нескольких миров создаёт серверную нагрузку. ChunkManager управляет этой частью процесса.
Проект относится к категориям management, optimization и utility. Он работает с чанк-нагрузкой и не заменяет общее профилирование остальных частей сервера.
Практические задачи ChunkManager:
• адаптировать радиус загрузки к нагрузке;
• кэшировать недавно выгруженные чанки;
• показывать статистику миров и регионов;
• предоставлять инструменты обслуживания;
• помогать диагностировать чанк-нагрузку.
Скриншоты и внешний вид
Поддерживаемые платформы и стороны
Плагин заявлен для Bukkit, Spigot, Paper и Folia. Стороны обозначены как client=unsupported и server=required. Это означает, что JAR устанавливается только на сервер; игрокам не требуется добавлять его в клиентский профиль.
Подтверждённые версии Minecraft:
• 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5 и 1.20.6;
• 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10 и 1.21.11;
• 26.1, 26.1.1, 26.1.2 и 26.2.
Поддержка версии в метаданных означает заявленную совместимость, но не гарантирует одинаковое поведение на каждой сборке ядра и с любым набором плагинов. Перед обновлением рабочего сервера необходима проверка на тестовой копии.
Как работает управление чанками
Динамический радиус загрузки меняется с учётом нагрузки. Кэш недавно выгруженных чанков предназначен для ускорения повторного обращения и сокращения частых циклов выгрузки и загрузки.
Плагин отслеживает состояние сервера и может выгружать наиболее удалённые от игроков чанки. Эффект зависит от онлайна, числа миров, перемещений и других плагинов.
Высокоуровневая схема выглядит так:
• Плагин наблюдает за показателями.
• Корректирует радиус загрузки.
• Кэширует недавно выгруженные чанки.
• Выгружает удалённые области.
• Предоставляет статистику и ручные операции.
Точные пороги и алгоритм выбора чанков в основе не раскрыты.
Подтверждённые команды и право доступа
В официальном описании перечислены административные команды:
• /cm — открытие графического интерфейса;
• /chunkstatus — просмотр показателей производительности;
• /chunkreload — перезагрузка конфигурации плагина;
• /optimizechunks — принудительная оптимизация чанков;
• /chunkgc — операция освобождения памяти;
• /chunksummary — сводный анализ мира;
• /maintenance — переключение режима обслуживания;
• /chunklang — изменение языка;
• /chunkanalyze [world] — анализ сложности чанков выбранного мира;
• /chunkregions — статистика регионов;
• /chunkmetrics — расширенные метрики.
Для функций указано разрешение chunkmanager.admin; его следует выдавать только доверенным администраторам. Более детальная матрица прав не приведена.
Освобождение памяти не заменяет поиск утечки или ошибочной настройки.
Конфигурация на подтверждённом уровне
Плагин использует файл config.yml. В опубликованном примере присутствуют группы параметров, связанные с:
• радиусом загрузки чанков вокруг игрока;
• временем хранения записей в кэше;
• максимальным числом чанков, загружаемых за тик;
• предельным размером кэша;
• уровнем журналирования.
Параметры связаны: радиус меняет охват, лимит за тик — темп обработки, а размер кэша — баланс повторных загрузок и памяти.
Универсальные значения не подтверждены. Настройку следует проверять на тестовой среде, сохраняя конфигурацию и оценивая TPS, память и задержки загрузки.
Установка и первичная проверка
Подтверждённая процедура установки:
• Остановить совместимый сервер.
• Поместить выбранный JAR в папку plugins.
• Запустить сервер и проверить загрузку плагина.
• Убедиться, что создана конфигурация.
• Проверить доступ администратора к диагностическим функциям.
• Провести наблюдение на тестовом мире.
• Перед применением на основном сервере сохранить резервные копии.
В выбранных метаданных обязательные project dependencies не указаны. Это означает отсутствие перечисленных обязательных зависимостей, но не отменяет требования совместимого серверного ядра.
При переходе между версиями 1.3.5 и 1.3.6 не следует одновременно оставлять оба JAR в папке plugins. Конкретная процедура миграции конфигурации в основе не описана, поэтому обновление лучше сначала проверить на копии сервера.
Файлы, версии и контрольные суммы
Предоставлены два артефакта.
ChunkManager-1.3.6.jar:
• размер — 392 131 байт;
• версия — 1.3.6;
• SHA-512: e6e5a079bf29e27da2484ca3343e86f2e511b6dff6875f17639254007b5ac5dd7b4a7d6dbcbe52921ec33cf15471ecc1bb22a43b7e47173a5edf67b7d96855f6;
• SHA-1: 4381897eff1962250d98bbf76d3c7f6f92b9bf6c.
ChunkManager-1.3.5.jar:
• размер — 645 506 байт;
• версия — 1.3.5;
• SHA-512: bec2c0da13d6f5644e2358d045ef2233aac4de6997506c2a8913d5122ab34c180ce710151190016104f5532c1e236346a5a6e0fbdeacab05fe8d8905dcb04fc9;
• SHA-1: ded895df4a9cd752234b0dfd83f092416b315f00.
Хеши позволяют проверить совпадение локального файла с опубликованным артефактом. Для новой установки логично рассматривать 1.3.6 как более поздний из двух предоставленных выпусков, но выбор должен учитывать совместимость конкретного сервера и результаты теста.
Лицензия, безопасность и ограничения
ChunkManager распространяется по лицензии MIT. Это определяет условия использования самого проекта, но не заменяет лицензии серверного ядра и других установленных плагинов.
JAR-файлы получены по официальному HTTPS и локально сверены по опубликованным хешам. Архивы прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому не подтверждены фактическая загрузка на каждом ядре, отсутствие конфликтов и реальный эффект на производительность.
В основе нет результатов нагрузочных испытаний, гарантированного прироста TPS, рекомендуемого объёма памяти или универсального набора параметров. Плагин следует оценивать как инструмент управления и диагностики чанк-нагрузки, а не как автоматическое решение любой серверной проблемы.
FAQ
Нужен ли плагин игрокам?
Нет. Он устанавливается на сервер, а клиентская сторона указана как unsupported.
Есть ли обязательные зависимости?
В выбранных метаданных обязательные project dependencies не перечислены. Требуется совместимое серверное ядро одной из заявленных платформ.
Можно ли использовать ChunkManager на Folia?
Folia входит в подтверждённый список платформ. Конкретное сочетание версии ядра и других плагинов всё равно следует проверить на тестовом сервере.
Такого требования нет. Команда подтверждена как средство освобождения памяти, но регулярность и полезность зависят от ситуации и не должны назначаться без наблюдения.
Проверялся ли JAR динамически?
Нет. Проведены получение по официальному HTTPS, сверка хешей и статическая проверка структуры и путей.