Zones

Zones

Этот плагин позволяет администраторам серверов и игрокам создавать защищённые регионы в своём мире Minecraft и управлять ими. Он предоставляет гибкую систему для определения областей, настройки прав и контроля взаимодействий внутри этих областей.

Возможности

• Создание регионов: Создавайте регионы с помощью выделения в игре или вручную по координатам.
• Подрегионы: Создавайте подрегионы внутри существующих регионов для более точного контроля.
• Управление правами: Настраивайте детальные права для игроков внутри регионов, контролируя такие действия, как ломание, установка, взаимодействие и многое другое.
• Управление участниками: Добавляйте и удаляйте участников регионов с определёнными правами.
• Контроль пересечения регионов: Настраивайте, могут ли регионы пересекаться.
• Обход прав: Разрешайте определённым игрокам обходить ограничения регионов.
• Конфигурация: Настраивайте сообщения и параметры регионов через файлы конфигурации.
• Визуализация маяками: Визуализируйте выбранные регионы с помощью временных маяков.

Команды

Плагин предоставляет следующие команды:

• /zone create: Создаёт новый регион по текущему выделению.

  • Использование: /zone create
  • Требуется выделить две точки левым и правым кликом; если выделения нет, оно начнётся.
  • Запрещает создание, если новый регион пересекается с существующим, если только не установлено право zones.create.overlap.

• /zone subcreate: Создаёт новый подрегион внутри существующего региона по текущему выделению.

  • Использование: /zone subcreate [regionKey]
  • regionKey необязателен; если не указан, будет использован регион на месте игрока.
  • Требуется выделить две точки левым и правым кликом; если выделения нет, оно начнётся.
  • Игрок должен считаться админом региона или иметь право zones.subcreate.other

• /zone delete: Удаляет существующий регион.

  • Использование: `/zone delete `
  • Требуется regionKey удаляемого региона.
  • Игрок должен быть владельцем региона или иметь право zones.delete.other

• /zone expand: Расширяет существующий регион на указанную величину.

  • Использование: `/zone expand [overlap]`
  • Игрок должен быть админом региона или иметь право zones.expand.other
  • Если overlap установлен в true и у игрока есть право zones.expand.overlap,
  • регион будет расширен, даже если он пересекается с другими регионами.

• /zone info: Показывает информацию о регионе.

  • Использование: /zone info [regionKey]
  • Если regionKey не указан, будет использован регион на месте игрока.
  • Чтобы увидеть участников региона, игрок должен быть админом региона или иметь право zones.info.other

• /zone list: Показывает список всех регионов, в которых игрок является участником.

  • Использование: /zone list
  • Показывает только регионы, в которых игрок является участником, если только у игрока нет права zones.list.other

• /zone cancel: Отменяет текущее выделение региона.

  • Использование: /zone cancel

• /zone set: Устанавливает право для участника региона.

  • Использование: `/zone set `
  • `` — ключ региона.
  • `` — для кого установить право.
  • например, Player1 — чтобы создать или изменить группу, используйте +group-GROUPNAME, где GROUPNAME может быть любым именем.
  • `— устанавливаемое право (например,role, break, place, interact`).
  • `` — значение для права (
  • например, owner, true, false, *, !*, GRASS_BLOCK, !GRASS_BLOCK).

• /zone rename: Переименовывает регион.

  • Использование: `/zone rename `
  • `— ключ региона,` — новое имя региона.
  • Игрок должен быть админом региона или иметь право zones.rename.other

• /zone select: Выбирает регион.

  • Использование: /zone select [regionKey]
  • Если regionKey не указан, будет использован регион на месте игрока.
  • Визуально подсвечивает регион в мире с помощью частиц.
  • Игрок должен быть участником региона или иметь право zones.select.other

• /zone mode: Меняет режим выделения.

  • Использование: `/zone mode `
  • `` — новый режим для игрока.
  • например, 3d для 3D-режима выделения, 2d для 2D-режима выделения.

• /zone save: Вручную сохраняет все регионы в файл.

  • Использование: /zone save
  • Только для админов, требует разрешение zones.save (по умолчанию не выдаётся)

• /zone load: Вручную загружает все регионы из файла.

  • Использование: /zone load
  • Только для админов, требует разрешение zones.load (по умолчанию не выдаётся)

• /zone import: Импортирует регионы из другого плагина.

  • Использование: `/zone import `
  • Сейчас поддерживается только WorldGuard.
  • Только для админов, требует разрешение zones.import (по умолчанию не выдаётся)

Использование

Создание региона

1. Введите команду /zone create, чтобы начать создание.
2. Левый клик по блоку задаёт первый угол региона. Появится зелёный маяк.
3. Правый клик по блоку задаёт второй угол региона. Появится красный маяк.
4. Введите команду /zone create, чтобы создать регион.

Создание субрегиона

1. Введите команду /zone subcreate, чтобы начать создание.
2. Выберите два угла субрегиона, как описано выше.
3. Введите команду /zone subcreate, чтобы создать субрегион внутри региона, в котором вы стоите, или введите `/zone subcreate `, чтобы создать субрегион внутри указанного региона.

Настройка разрешений

1. Введите команду `/zone set `, чтобы настроить разрешения для участника региона.

   • Пример: `/zone set Player1 break true` разрешает "Player1" ломать блоки в указанном регионе.
   • Пример: `/zone set Player2 break GRASS_BLOCKразрешает "Player2" ломать только блокиGRASS_BLOCK` в указанном регионе.
   • Пример: `/zone set Player3 interact !OAK_DOORзапрещает "Player3" взаимодействовать сOAK_DOOR` в указанном регионе.
   • Пример: `/zone set Player4 place *` разрешает "Player4" ставить все блоки в указанном регионе.
   • Пример: `/zone set Player5 break !*` запрещает "Player5" ломать все блоки в указанном регионе.

• Группы:

  • Чтобы назначить группу, установите значение разрешения group в имя группы.
  • напр.: Создайте группу и назначьте разрешение: `/zone set +group-some-group-name break true`
  • напр. `/zone set ExamplePlayer group some-group-name`
  • Теперь ExamplePlayer наследует разрешение break от группы some-group-name

Просмотр информации о регионе

1. Введите команду /zone info, чтобы посмотреть информацию о регионе, в котором вы стоите.
2. Введите команду `/zone info `, чтобы посмотреть информацию о конкретном регионе.

Интеграции

WorldGuard

Zones поддерживает импорт регионов WorldGuard через команду /zone import WorldGuard. Чтобы использовать эту функцию, у вас должен быть установлен и включён WorldGuard. Zones автоматически импортирует все Cuboid-регионы, включая их участников.

WorldEdit

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

PlaceholderAPI

Zones предоставляет несколько плейсхолдеров для использования с плагином PlaceholderAPI, отображающих информацию о регионе, в котором стоит игрок. Сейчас поддерживаются следующие плейсхолдеры:

• %zones_get_name%
• %zones_get_key%
• %zones_get_members%
• %zones_get_owner%
• %zones_get_min%
• %zones_get_min_x%
• %zones_get_min_y%
• %zones_get_min_z%
• %zones_get_max%
• %zones_get_max_x%
• %zones_get_max_y%
• %zones_get_max_z%
• %zones_is_member%
• %zones_can_place_hand%
• %zones_can_break_target%
• `%zones_can__%`

Особенности реализации

• Конфигурация YAML: Плагин использует файлы YAML для конфигурации и хранения, что делает их удобными для чтения и изменения. Дополнительные варианты хранения запланированы в будущих релизах.
• Система разрешений: Система разрешений спроектирована гибкой и детальной, что позволяет тонко контролировать взаимодействия игроков.
• Событийная модель: Плагин использует систему событий Bukkit для обработки взаимодействий игроков, что делает его эффективным и отзывчивым.
• Кэширование: Плагин использует систему кэширования для повышения производительности при проверке разрешений.

Участие в разработке

Мы рады вашему вкладу в плагин! Если у вас есть идеи для новых функций, исправлений багов или улучшений, смело отправляйте pull request или открывайте issue.

Лицензия

Этот плагин распространяется под лицензией MIT.