Плагин WorldGuardFork (Paper/Folia) | Рекомендуется на каждый современный сервер! 7.0.17-v1.1

ЭТО НЕОФИЦИАЛЬНЫЙ ФОРК

Это независимый неофициальный форк WorldGuard 7.0.17, основанный на проекте EngineHub и его участников. Он не связан с EngineHub, не одобрен EngineHub и не поддерживается командой официального WorldGuard.

Цель форка — не заменить официальный проект во всех возможных сценариях, а сделать более сфокусированную сборку для современных серверов Paper/Folia: с полноценной русской и английской локализацией, удобным созданием регионов, понятной обратной связью игрокам и меньшим количеством старых подсистем, которые многим серверам больше не нужны.

Поддержку именно этой сборки предоставляет автор форка через You must be logged in to see this link.. По вопросам официального WorldGuard обращайтесь к его документации и сообществу.


ПОЧЕМУ СТОИТ ВЫБРАТЬ ЭТОТ ФОРК

• Это глубокая переработка, а не переименование JAR: относительно официальной 7.0.17 изменены 114 общих классов и добавлен 51 новый class-файл
• Полная локализация RU/EN: переведены конфиги, сообщения игрокам и консольные логи
• 318 настраиваемых сообщений на каждый язык с MiniMessage, click/hover-событиями, режимами chat/actionbar/title и индивидуальными задержками
• Нативные команды Paper Brigadier с контекстными подсказками миров, регионов, игроков, флагов и их значений
• Более удобные приваты: лимиты количества и объёма по группам, корректный объём полигонов, безопасное авторасширение и предварительный показ частицами
• Шаблоны регионов по мирам через отдельный regionDefaults.yml
• Разные сообщения для разных запрещённых команд, включая отдельные подкоманды
• Переработанный кэш запросов регионов с быстрым повторным доступом и точечным сбросом после изменений

СРАВНЕНИЕ С ОФИЦИАЛЬНЫМ WORLDGUARD 7.0.17


Форк лучше подходит серверу Paper/Folia, которому важны локализация, удобные приваты, гибкие шаблоны и чистый YAML-процесс.


ЛОКАЛИЗАЦИЯ И СООБЩЕНИЯ

При первой установке плагин предлагает выбрать ru или en. Для каждой локали в JAR находятся собственные шаблоны:

• 318 определений сообщений для каждого языка
• 86 настраиваемых текстов консольных логов для каждого языка
• MiniMessage с цветами, градиентами, click и hover
• Режим каждого сообщения: message, actionbar или title
• Индивидуальный cooldownMillis против спама одинаковыми сообщениями
• Проверка неизвестных MiniMessage-тегов, режимов, задержек и количества строк Title
• Валидация дублирующихся YAML-ключей, UUID, флагов, значений и конфликтующих групп лимитов
• Восстановление стандартных комментариев при сохранении конфигов через безопасную замену файла

Игровые сообщения, ошибки команд и логи не зашиты в один язык: их можно привести к стилю собственного проекта без правки JAR.


ПРИВАТЫ, ЛИМИТЫ И АВТОРАСШИРЕНИЕ

Лимиты по группам прав

Для каждой группы можно отдельно задать:

• максимальное количество регионов игрока;
• максимальный объём создаваемого региона.

Если игрок состоит сразу в нескольких настроенных группах, используется наибольшее разрешённое значение. Право worldguard.region.unlimited снимает эти ограничения.

Кубоиды и полигоны

Форк разрешает /rg claim для кубоидальных и полигональных выделений. Для полигона рассчитывается реальный объём с проверкой самопересечения и переполнения, поэтому лимит объёма применяется предсказуемо.

Безопасное авторасширение

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

Расширение останавливается у границ мира, лимита объёма или чужого региона. Пересечение с собственными регионами не мешает расширению. Для каждого направления вычисляется максимально допустимая дистанция, а визуализация заранее показывает итоговую форму.

Дополнительно можно включить claimOnlyInsideExistingRegions, если новые приваты должны создаваться только внутри уже существующих областей.


ВИЗУАЛИЗАЦИЯ ВЫДЕЛЕНИЙ

Границы завершённого выделения WorldEdit показываются частицами прямо в мире. Поддерживаются кубоиды и полигоны.

• Настраиваемые RGB-цвет, размер частиц и расстояние между точками
• Ограничение количества частиц за одно обновление
• Ограничение дистанции отображения
• Настраиваемый интервал обновления
• Учёт дальности обзора игрока и общий particle budget
• Предпросмотр формы после автоматического расширения
• Очистка выделения после успешного claim/define/redefine — стандартно через 30 секунд
• Максимальный срок жизни неизменённого завершённого выделения — стандартно 180 секунд
• Folia-aware планирование через global и entity scheduler

Стандартный цвет визуализации — #FDBE00.


ШАБЛОНЫ РЕГИОНОВ ПО МИРАМ

regionDefaults.yml позволяет описать общий шаблон * и отдельные правила для конкретных миров.

Для новых регионов можно заранее назначать:

• приоритет и родительский регион;
• владельцев и участников по UUID или группам;
• начальные флаги;
• категории запрещённых команд;
• собственное сообщение для каждой категории команд.

Отдельно настраивается регион __global__: его можно автоматически создать, заполнить флагами и очистить перечисленные значения через clearFlags. Опция применения к существующим регионам добавляет отсутствующие флаги и родителя, не заменяя вручную заданные значения.


СООБЩЕНИЯ ДЛЯ ЗАПРЕЩЁННЫХ КОМАНД

Новый map-флаг blocked-cmds-messages связывает команду или подкоманду с отдельным текстом отказа.


Команды нормализуются без учёта регистра, namespace и лишних пробелов. Если точного совпадения нет, система ищет более короткий путь команды, а затем использует стандартное сообщение запрета. При необходимости содержимое этого технического map-флага можно скрыть из /rg info.


БЕЗОПАСНОСТЬ УПРАВЛЕНИЯ РЕГИОНАМИ

• Добавление офлайн-игрока во владельцы или участники требует повторить ту же команду в течение 30 секунд
• preventLastOwnerRemoval не позволяет случайно удалить последнего владельца
• Ошибка пересечения показывает конфликтующий регион, унаследованных владельцев и координаты пересечения
• Кликабельные элементы в /rg info, /rg list и интерфейсе флагов ускоряют типовые действия
• Режим списка по умолчанию требует явно выбрать my или global; при желании доступно прежнее поведение
• NPC и fake-player причины больше не получают безусловный обход защиты строительства
• Автоматическая миграция старых имён владельцев в UUID при загрузке YAML выполняется с одноразовой резервной копией
• Файлы регионов сохраняются через безопасную замену, уменьшая риск получить частично записанный YAML

ТОЧНЫЕ ОБЛАСТИ ДЕЙСТВИЯ МЕХАНИК

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


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


КОМАНДЫ И АВТОДОПОЛНЕНИЕ

Корневые команды:


Основные команды регионов:


Brigadier предлагает доступные миры, регионы, онлайн-игроков, флаги, группы флагов и допустимые значения. Парсер понимает кавычки, экранирование, -- и объединённые короткие параметры.


ПРАВА

Форк сохраняет стандартную модель прав WorldGuard с разрешениями по операциям и регионам. Ключевые узлы:


Операции redefine, remove, select, info, teleport, управление владельцами/участниками и установка флагов используют динамические узлы WorldGuard для конкретного региона и уровня доступа.


КОНФИГУРАЦИЯ И ХРАНЕНИЕ

• locale.yml — выбор ru или en при первом запуске
• config.yml — глобальные настройки, лимиты, визуализация, сообщения и механики
• messages.yml — все игровые сообщения
• logs.yml — тексты консольных логов
• regionDefaults.yml — шаблоны новых, существующих и глобальных регионов
• worlds/<мир>/config.yml — настройки конкретного мира
• worlds/<мир>/regions.yml — YAML-хранилище регионов
• cache/profiles.sqlite — локальный кэш профилей игроков

/wg reload перечитывает конфиги, сообщения, логи, шаблоны регионов и мировые настройки, а также сбрасывает связанные кэши и состояния сессий. Для смены локали и настроек интервала планировщика рекомендуется полный перезапуск.


СОВМЕСТИМОСТЬ И ОСОЗНАННЫЕ КОМПРОМИССЫ

Форк намеренно сужает область проекта до защиты регионов на современных Paper/Folia-серверах. Из официальной сборки удалены:

• старая blacklist-система и её отдельное логирование;
• SQL-хранилище регионов, Flyway и команды migratedb, migrateuuid, migrateheights;
• bStats;
• sign chest protection и интеграция CommandBook;
• встроенные report, profiler и debug-инструменты;
• общие команды /god, /ungod, /heal, /slay, /locate, /stack;
• команды /stopfire, /allowfire, /stoplag и /halt-activity;
• legacy-слои совместимости с обычным Spigot/CraftBukkit и PaperLib;
• флаги send-chat, receive-chat, notify-enter, notify-leave.

Добавлен новый флаг blocked-cmds-messages. Хранилище регионов — только YAML.

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

Некоторые внутренние классы и методы официального WorldGuard удалены или изменены. Базовые регионы и флаги сохранены, однако универсальная бинарная совместимость со всеми сторонними WG-аддонами не гарантируется. Проверяйте каждое расширение на тестовом сервере.


ТРЕБОВАНИЯ

• Paper или Folia 1.21.x
• Java 21+
• WorldEdit (Лучше FAWE) — обязательная зависимость, совместимая с вашей версией сервера

Форк имеет то же имя плагина WorldGuard, поэтому не может работать одновременно с официальным JAR.


УСТАНОВКА И ПЕРЕХОД С ОФИЦИАЛЬНОЙ СБОРКИ

1. Остановите сервер и сделайте полную резервную копию папки plugins/WorldGuard.
2. Удалите официальный JAR из папки plugins. Не запускайте две сборки одновременно.
3. Убедитесь, что установлена совместимая версия WorldEdit (Или FAWE), затем поместите JAR форка в plugins.
4. Запустите сервер один раз. Плагин создаст locale.yml и остановит собственную загрузку, пока язык не выбран.
5. Укажите locale: ru или locale: en и полностью перезапустите сервер.
6. При переходе с официальной 7.0.17 сгенерируйте новые глобальные и мировые конфиги: схема настроек форка отличается и автоматически не мигрирует старый config.yml.
7. YAML-файлы worlds/<мир>/regions.yml переносите сначала на тестовый сервер. SQL-регионы этим форком не загружаются.
8. До запуска игроков проверьте таблицы групп, категории команд и точные профили миров в regionDefaults.yml, особенно профиль мира spawn.
9. Проверьте сторонние аддоны, создание кубоидного и полигонального региона, флаги, авторасширение и перезагрузку на staging-сервере.

ЛИЦЕНЗИЯ, ИСХОДНИКИ И АВТОРСТВО

Основа проекта — You must be logged in to see this link., версия 7.0.17. Официальная документация: You must be logged in to see this link..

Форк распространяется на условиях GNU Lesser General Public License v3.0 (LGPL-3.0-only).

Сурсы для кодеров и пастеров: You must be logged in to see this link. (Поставьте звёздочку пожалуйста)

Авторство EngineHub относится к исходной базе WorldGuard. Автор этой сборки отвечает за собственные изменения и поддержку форка.