RegionRestore (Риджинрестор)

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

Возможности

• Восстанавливает шаблон на исходном месте или в указанных координатах другого мира.
• Хранит несколько снимков одного шаблона и позволяет выбрать активный снимок для восстановления.
• Создаёт обычные экземпляры регионов и пулы одинаковых арен для массового клонирования.
• Восстанавливает большие области по чанкам, без одновременной загрузки всего региона; освещение возвращается без тяжёлого пересчёта света.
• Может сбрасывать регион при запуске сервера, когда его покинул последний игрок либо по повторяющемуся таймеру.
• Перед отложенным восстановлением выводит обратный отсчёт игрокам рядом, всем в мире, всему серверу или никому.
• Открывает графическое меню управления шаблонами, экземплярами, пулами и таймерами через /rr gui.

Команды

Основная команда — /regionrestore; доступны сокращения /rr, /arena и /arenas.

• /rr selection wand — получить предмет для выделения: ПКМ задаёт две точки по очереди, ЛКМ показывает сведения о выделении.
• /rr selection create <name> — сохранить текущее выделение как шаблон.
• /rr template create <name> <minX> <minZ> <maxX> <maxZ> [world] — создать шаблон по координатам.
• /rr template list и /rr template info <name> — показать шаблоны и сведения о выбранном.
• /rr template setactive <name> <versionId> — назначить активный снимок шаблона.
• /rr restore <template> [version/active] [scope] — восстановить шаблон на исходной позиции.
• /rr restore at <template> <world> <x> <z> [version] — восстановить шаблон в заданном месте.
• /rr restore in <template> <seconds> [version] [scope] — запланировать восстановление с обратным отсчётом.
• /rr instance create <template> <chunkX> <chunkZ> [world] [version] [boot] [vacate] [interval] — создать экземпляр региона.
• /rr instance restore <instanceId> — восстановить экземпляр; /rr instance list all и /rr instance info <instanceId> — посмотреть созданные экземпляры.
• /rr cloner status [world] — проверить пулы клонов; /rr cloner restore [world] [template] — восстановить их экземпляры.
• /rr timer set instance <instanceId> <intervalSeconds> [scope] — назначить повторный сброс экземпляра.
• /rr timer set template <templateName> <intervalSeconds> [scope] — назначить сброс шаблона на исходном месте.
• /rr timer cancel id <instanceId> и /rr timer cancel template-all <templateName> — отменить таймеры.

Параметр области оповещения scope принимает значения NEARBY, WORLD, SERVER или NONE.

Права

• regionrestore.* — все права плагина.
• regionrestore.gui — меню управления.
• regionrestore.template.create, regionrestore.template.list, regionrestore.template.info, regionrestore.template.setactive, regionrestore.template.delete — работа с шаблонами.
• regionrestore.restore, regionrestore.restorein — восстановление регионов и отложенный сброс.
• regionrestore.instance.create, regionrestore.instance.list, regionrestore.instance.info, regionrestore.instance.delete, regionrestore.instance.restore — управление экземплярами.
• regionrestore.cloner.status, regionrestore.cloner.restore, regionrestore.cloner.regen — просмотр, восстановление и пересоздание пулов.
• regionrestore.timer.set, regionrestore.timer.cancel — повторные таймеры.
• regionrestore.wand, regionrestore.selection — выделение регионов.

Настройка

В конфиге mass-cloner для пула можно указать template-name, количество копий count, а также restore-on-boot=true для сброса при запуске и restore-on-vacate=true для сброса после ухода игроков. Задержка перед сбросом пустого региона задаётся ключом vacate-delay-seconds.

В разделе restore ключ max-concurrent-restores ограничивает число одновременных восстановлений и помогает сохранить стабильный TPS при массовых операциях.

Для вывода данных в сообщениях поддерживаются PlaceholderAPI, например %regionrestore_instance_count%, %regionrestore_template_count% и %regionrestore_pool_count%. С MiniPlaceholders используются варианты <regionrestore_instance_count>, <regionrestore_template_count> и <regionrestore_pool_count>.

Требования

Нужен сервер на основе PaperMC, включая Paper или Purpur. Для плейсхолдеров дополнительно используются PlaceholderAPI либо MiniPlaceholders.