[SimplePetsAddon] WorldGuard Addon

Что это за аддон и зачем он нужен

Если на вашем сервере стоит плагин SimplePets (позволяющий игрокам заводить питомцев) и WorldGuard (защита регионов), то рано или поздно вы столкнётесь с ситуацией, когда питомцы начинают мешать: заходят в зоны PvP, спавнятся на спавне, блокируют проходы в торговых зонах или просто портят атмосферу. Этот аддон решает проблему - он добавляет специальные флаги WorldGuard, которые позволяют гибко ограничивать поведение питомцев в разных регионах.

Проще говоря, вы сможете запретить питомцам появляться в одних зонах, разрешить - в других, и настроить, можно ли на них забираться или заезжать верхом. Всё это без танцев с бубном и правок плагинов.

Особенности

Аддон добавляет несколько новых флагов WorldGuard:

• allow-pet-spawn - разрешает или запрещает спавн питомца в регионе (по умолчанию - разрешено)
• allow-pet-enter - контролирует, может ли питомец зайти в регион (по умолчанию - разрешено)
• allow-pet-mounting - определяет, можно ли в этом регионе садиться на питомца верхом (по умолчанию - разрешено)
• allow-pet-riding - отвечает за возможность ездить на питомце в регионе (по умолчанию - разрешено)

Все флаги работают как обычно в WorldGuard: ставите deny - действие блокируется, allow - разрешается. Удобно, когда нужно сделать, например, зону, где питомцы вообще не появляются (спавн, PvP-арена), а вокруг - всё как обычно.

Установка

Аддон ставится поверх плагина SimplePets. Есть три способа:

Через команду (самый простой)

Просто напишите в чате:

/pet addon install WorldGuard

Плагин сам скачает и включит аддон. Если по какой-то причине не вышло - проверьте консоль на ошибки.

Через GUI

Введите /pet addon, нажмите на кнопку "Install Addons" (она в нижнем ряду), найдите в списке WorldGuard и кликните по нему. Если зависло на "Installing..." - пробуйте другой метод.

Вручную

1. Зайдите в папку плагина SimplePets
2. Откройте папку Addons (если её нет - создайте)
3. Скачайте jar-файл аддона из официального источника (например, на странице плагина)
4. Положите его в папку Addons
5. Перезапустите сервер - аддон загрузится

Конфигурация по умолчанию

После установки в папке аддона появится файл config.yml. Вот как он выглядит:

# Право на обход проверок
bypass-permission: pet.worldguard.bypass

checks:
  spawning:
    enabled: true
    # Сообщение при наведении на "питомец не может быть призван"
    reason: '&cYour pet is not able to be spawned in this area'

  mounting:
    enabled: true
    # Удалять питомца при блокировке или просто отменить действие?
    remove-pet: true

  moving:
    enabled: true
    remove-pet: true

  riding:
    enabled: true
    remove-pet: true
    # Спешивать игрока (игнорируется, если remove-pet: true)
    dismount: true

Пояснения:

• bypass-permission - право, дающее полный обход всех проверок в регионах.
• reason - сообщение, которое увидит игрок при попытке спавна (только при наведении на системное сообщение). Можно оставить пустым или null.
• remove-pet - решает, удалять ли питомца полностью или просто отменить действие (например, телепортировать обратно).

Важно знать

• Аддон требует, чтобы на сервере были установлены SimplePets и WorldGuard. Без них ничего не заработает.
• Флаги работают на уровне регионов WorldGuard. Если регион не настроен - действуют глобальные правила (по умолчанию всё разрешено).
• Если вы используете плагин для хостинга, например BungeeHost, установка в один клик тоже возможна - просто скопируйте файлы или используйте команду /pet addon install.

В целом, аддон лёгкий, не грузит сервер и решает конкретную проблему. Если на вашем проекте есть питомцы и регионы - без него никак.