Simplex Trimmer (Симплекс Триммер)

Плагин для серверов Майнкрафт на Paper, который очищает выбранные миры от мало посещавшихся чанков и помогает освободить место на диске. Администратор выбирает измерения, порог активности InhabitedTime и время до технических работ; удаление выполняется при следующем полном запуске сервера до обычной загрузки миров.

Возможности

• Отдельная обработка верхнего мира, незера, энда и найденных пользовательских измерений.
• Поиск обычных и пользовательских папок миров, включая старые схемы размещения измерений; дополнительные корни указываются в world-trimmer.additional-world-roots.
• Меню инвентаря для Java-игроков: выбор целей, порога, отсчёта, подтверждения резервной копии и просмотр истории.
• При установленном Floodgate игрокам Бедрок доступны нативные формы для тех же действий.
• В консоли показываются измерение, процент выполнения, регионы .mca, освобождённое место и затраченное время. Полный журнал MCA Selector сохраняется в plugins/SimplexTrimmer/data-v12/logs/.
• История хранит размер до и после очистки, освобождённое место, статус и сведения по каждой цели.
• Перед запуском проверяются цели, состояние MCA Selector, совместимость Java, свободное место и блокировки миров. Прерванная или завершившаяся с ошибкой обработка переводит плагин в режим восстановления, который должен проверить администратор.

Команды

• /trimworld — открыть меню.
• /trimworld java — открыть меню инвентаря Java.
• /trimworld scan — обновить список измерений и их размеры.
• /trimworld update — скачать и проверить MCA Selector из официального выпуска.
• /trimworld ticks <20-1728000> — задать свой порог активности в тиках.
• /trimworld clear — очистить выбранные измерения.
• /trimworld history — открыть историю очисток.
• /trimworld status — показать состояние технических работ; работает и из консоли.
• /trimworld cancel — отменить текущий отсчёт.
• /trimworld recovery CONFIRM — снять режим восстановления после ручной проверки.
• /trimworld reload — перезагрузить конфигурацию, когда технические работы не идут.

Также доступны алиасы /simplextrimmer и /strimmer.

Права

trimmer.admin — доступ ко всем командам и меню; по умолчанию есть у оператора.

Настройка

Чанки удаляются по условию InhabitedTime < threshold: чанк со значением, равным порогу, остаётся. Редко посещаемая база, точка спавна, приват, вставленная структура или новое строение тоже могут иметь низкое InhabitedTime, поэтому перед каждой очисткой нужна полная резервная копия. Автоматической защиты регионов Lands, WorldGuard, GriefPrevention, приватов, построек и спавна нет.

После подтверждения задачи сервер штатно останавливается, а хостинг-панель или скрипт должны запустить его снова. В режиме STOP это делает панель, в RESTART используется настроенный механизм перезапуска Spigot. Не останавливайте сервер или MCA Selector принудительно во время обработки: автоматического отката нет, а уже изменённые измерения могут потребовать восстановления из копии.

Данные заданий, истории, журналов и состояния находятся в plugins/SimplexTrimmer/data-v12/. Полезные параметры конфигурации:

world-trimmer:
  restart-mode: STOP
  shutdown-warning-seconds: 30
  default-threshold-ticks: 600
  minimum-threshold-ticks: 20
  history-limit: 100
  additional-world-roots: []
  performance:
    heap: 2G
    process-threads: 2
    timeout-minutes: 120
  preflight:
    minimum-free-space-gib: 2

Удалённые чанки могут сгенерироваться заново при посещении; их ландшафт способен отличаться после смены генератора, датапаков или обновления игры.

Требования

Нужен сервер Paper или совместимая сборка с Bukkit/Paper API, MCA Selector и Java 21 или новее для MCA Selector. Сам плагин рассчитан на Java 17, но если серверу требуется более новая Java, используется она.

Для форм Майнкрафт Бедрок нужны отдельно настроенные Geyser и Floodgate. Бедрок-игроки могут управлять очисткой через Java-сервер Paper, но нативные миры Бедрок с базой LevelDB не обрабатываются. В качестве целей также не поддерживаются Folia, Fabric, Forge и среды, работающие только как прокси.