WorldGuard: регионы, флаги и команды

Установка и какая версия нужна

1. Проверьте ядро: нужен сервер с Bukkit API, то есть Paper или Spigot. Ванильный сервер, Forge и Sponge не подходят.
2. Скачайте WorldEdit для Bukkit под свою версию Minecraft. Он обязателен, через него выделяются регионы.
3. Скачайте WorldGuard с dev.bukkit.org или Modrinth, положите оба jar в plugins и перезапустите сервер.

Каждая версия WorldGuard собрана под свои версии игры, старая на новом сервере не заработает. Соответствие по данным Modrinth:

WorldEdit для 1.21.4 и новее выходит в ветке 7.3.x и 7.4.x, релиз 7.4.5 покрывает версии от 1.21.4 до 26.2. Под 26.3 на момент написания есть только бета WorldEdit 7.4.6.

По умолчанию пользоваться плагином не может никто, кроме операторов. Администраторам выдайте worldguard.* через плагин прав.

Как создать регион и добавить игроков

Регион создаётся из выделения WorldEdit. Возьмите деревянный топор командой //wand, кликните левой кнопкой по одному углу и правой по противоположному. Чтобы регион шёл от бедрока до неба, расширьте выделение: //expand vert.

//wand
//expand vert
/rg define spawn
/rg addmember spawn g:builders
/rg addowner spawn Steve

/rg это сокращение /region. Имя региона уникально и не зависит от регистра. Новый регион сразу запрещает строить всем, кроме участников (members) и владельцев (owners). Группу из плагина прав добавляют с приставкой g:. Владельцев можно указать сразу: /rg define town Steve Alex.

Регионы бывают кубоидами и 2D-многоугольниками с высотой (//sel poly). Цилиндр и сферу WorldGuard не примет. Изменить границы: выделите новую область и выполните /rg redefine spawn. Изменения сохраняются сами с небольшой задержкой, принудительно командой /rg save.

Флаги: PvP, двери, взрывы, приветствие

Флаг ставится командой /rg flag <регион> <флаг> <значение>, снимается той же командой без значения. /rg flags spawn показывает все флаги, в игре значения можно менять кликом.

/rg flag spawn pvp deny
/rg flag spawn use allow
/rg flag spawn creeper-explosion deny
/rg flag spawn tnt deny
/rg flag spawn mob-spawning deny
/rg flag spawn greeting Добро пожаловать на спавн
/rg flag vip entry deny

• use: двери, рычаги, кнопки, нажимные плиты (без сундуков).
• chest-access: доступ к сундукам и другим инвентарям.
• block-break и block-place: отдельно ломание и установка блоков.
• entry и exit: по умолчанию действуют только на тех, кто не состоит в регионе.
• greeting и farewell: сообщение при входе и выходе, greeting-title выводит титр.
• fire-spread, lava-fire, leaf-decay, ice-melt: природные процессы.

Флаг можно ограничить группой региона: /rg flag mall pvp -g nonmembers deny. Доступны группы all, members, owners, nonmembers, nonowners. Если перекрываются два региона одного приоритета, deny всегда побеждает allow. Разработчики советуют не ставить защитные флаги ради полной защиты или снятия защиты: для этого есть участники и флаг passthrough.

Глобальный регион __global__

У каждого мира есть регион __global__ на всю карту с самым низким приоритетом. Он появляется, как только вы меняете его флаги. Так запрещают PvP во всём мире:

/rg flag __global__ pvp deny

Чтобы новички не могли строить в дикой местности, ставьте passthrough, а не build:

/rg flag __global__ passthrough deny

После этого строить можно только участникам глобального региона или внутри своих регионов. Флаг build deny на глобальном регионе ставить не надо: он сломает поршни во всём мире. Если после настройки никто не может строить, проверьте, что у __global__ нет build deny, passthrough deny по ошибке и лишних участников.

Пересечения, приоритеты и участки

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

/rg define pub
/rg setpriority pub 10

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

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

/rg define plot1
/rg setparent plot1 mall
/rg addowner plot1 Steve

Регион без физической области, только для общих флагов, создаётся с ключом -g: /rg define -g plot_template.

Почему WorldGuard не работает

• Не работает ни одна команда. Плагин не запустился: проверьте ядро командой version, версию WorldEdit и WorldGuard, ошибки в logs/latest.log.
• Игроки не могут строить без сообщения от плагина. Скорее всего это защита спавна Minecraft: в server.properties поставьте spawn-protection=0. Проверьте, что игрок не в режиме приключения.
• Непонятно, какой плагин блокирует. /wg debug testbreak <игрок> и /wg debug testplace <игрок> симулируют действие и пишут, кто его запретил.
• Защита не действует. У оператора или игрока со всеми правами есть обход worldguard.region.bypass.<мир>, проверяйте защиту с обычного аккаунта. Ещё причины: стоит build allow или passthrough allow, предмет из мода или другого плагина.
• Не работают поршни. Уберите флаг build deny.
• Какие регионы в этой точке? Кликните по блоку кожей (палочка региона, право worldguard.region.wand) и посмотрите /rg info.