WorldGuard — плагін для захисту територій та створення приватних регіонів у Minecraft
WorldGuard — плагін для захисту територій та створення приватних регіонів у Minecraft
Залежність: WorldEdit
WorldGuard — це плагін для серверів Minecraft, який створює захищені зони, керує правилами поведінки світу і блокує небажані дії гравців. Це один з найстаріших проєктів у Bukkit-екосистемі. І він досі залишається базовим інструментом захисту майже на кожному великому сервері. За замовчуванням після встановлення жодна функція не активна: адміністратор сам вмикає лише те, що потрібно конкретному серверу.
Найвідоміша частина плагіна — система регіонів. Поряд з нею працюють глобальні правила світу (вибухи, спавн мобів, погода), чорний список предметів і блоків та інтеграція з прапорами поведінки.
Регіони — основа захисту території
Регіон — це названа об'ємна зона з власниками, учасниками, пріоритетом і набором правил. Форма обмежена двома варіантами: куб і двовимірний полігон із заданою висотою.
Щоб створити регіон, спочатку треба виділити територію через WorldEdit (це і є головна причина залежності), а потім зареєструвати її командою:
/rg define spawn
Свіжостворений регіон одразу забороняє будівництво всім, окрім учасників і власників. Додати їх можна так:
/rg addmember spawn g:builders
/rg addowner spawn wizjany
Основні команди регіонів
Команда | Що робить |
| створює регіон із поточного виділення WorldEdit |
| змінює форму існуючого регіону |
| видаляє регіон |
| показує власників, учасників, прапори |
| виводить усі регіони світу |
| встановлює прапор регіону |
| відкриває інтерактивний список прапорів (значення змінюються кліком) |
| примусово зберігає зміни (звичайне збереження автоматичне, з невеликою затримкою) |
Регіони можуть перекриватися. У такому випадку діє правило: щоб щось зробити, гравцю потрібен дозвіл в усіх регіонах, які перекривають точку. Перевизначити поведінку дозволяє пріоритет (/rg setpriority) або passthrough, який робить регіон "прозорим" для перевірок будівництва — корисно, коли регіон потрібен лише для PvP-арени без захисту блоків.

Виведення /rg list в чаті
Прапори регіонів
Прапори (flags) — це окремі правила, які прив'язуються до конкретного регіону. Їх десятки, і вони покривають майже всі ігрові механіки: бій, погоду, мобів, рух, повідомлення на вході та виході. Найчастіше використовують для:

Інтерактивний список прапорів /rg flags
Захист і взаємодія:
build — глобальний прапор, який охоплює все одразу (ламання, ставлення, взаємодія, бій, сон у ліжку, доступ до інвентарів). Працює "неявно" через систему учасників, і вручну його чіпати не рекомендовано.
interact — використання дверей, важелів, кнопок, верхових тварин.
block-break / block-place — окремо для ламання і ставлення блоків.
chest-access — доступ до скринь, діжок та шалкерів .
pvp — бої гравець проти гравця.
tnt — детонація і пошкодження від TNT.
Моби, вогонь і вибухи:
creeper-explosion — чи завдають вибухи криперів шкоди блокам.
mob-spawning — повне відключення спавну мобів, разом із командами і яйцями.
deny-spawn — список конкретних типів мобів, які не з'являються (наприклад, cow,pig).
fire-spread — поширення вогню.
enderman-grief / ravager-grief — чи ламають ендермен і опустошувач блоки.
Рух і повідомлення:
entry / exit — заборона входу або виходу (за замовчуванням стосується тих, хто не є учасником).
greeting / farewell — текстове повідомлення в чаті при вході/виході.
greeting-title / farewell-title — те саме, але великим заголовком на екрані. Через \n додається підзаголовок.
enderpearl — чи можна використовувати ендер-перлини.
Лікування і карти:
heal-amount + heal-delay — автоматичне лікування на N хелф-хартів кожні N секунд (зручно для лазаретів).
feed-amount + feed-delay — те саме для голоду.
game-mode — режим, який примусово вмикається при вході в регіон.
blocked-cmds — список заборонених команд у зоні.
time-lock — фіксований час доби в тіках (від 0 до 24000).
Приклад — налаштування, яке лікує гравців до половини шкали здоров'я:
/rg flag hospital heal-delay 1
/rg flag hospital heal-amount 2
/rg flag hospital heal-max-health 10

Гравець заходить у регіон зі встановленим прапором greeting-title — на екрані з'являється великий привітальний заголовок з підзаголовком.
Конфігурація
Основні налаштування знаходяться у plugins/WorldGuard/config.yml і plugins/WorldGuard/worlds/<світ>/config.yml. Нижче — ключові параметри, з якими стикається кожен адміністратор.
Параметр | Що робить |
| вмикає всю систему регіонів. При false команди /rg працюють, але прапори і захист не застосовуються |
| предмет, який служить інструментом для перевірки регіону у точці кліку. Окремий від WorldEdit-палички — на новій версії за замовчуванням використовується новий блок-листя |
| максимальний об'єм одного регіону, який гравець може взяти через /rg claim (у блоках) |
| скільки регіонів може створити одна людина. Для окремих груп прав ліміт перевизначається |
| при true нові регіони можна створювати лише всередині батьківських — основа для системи плотів |
| вмикає прапори fire-spread, water-flow, lava-flow, lava-fire. При true зростає навантаження на сервер |
| блокує створення порталів у Незер, які перетинають межу чужого регіону |
| при true мобів, які атакують невразливих гравців у регіоні з прапором invincible, прибирає з гри |
| виводить у консоль зведення увімкнених функцій при старті сервера. Зручно для перевірки, що нічого зайвого не активне |
| при |
| при |
| при |
| при |
| глобальна заборона активації TNT |
| перемикає чорний список у режим білого: дозволено лише те, у чому явно стоїть allow |
| якщо лійка намагається перенести предмет туди, де її дія заборонена, вона ламається. Запобігає лагам від нескінченних спроб переміщення |
Команди адміністратора
Окремий блок команд починається на /wg. Найкорисніші:
/wg report -p— створює файл зі звітом про стан сервера, версії всіх плагінів і налаштування WorldGuard. Підходить для надсилання у баг-репорти./wg profile -p <секунди>— профілює CPU сервера протягом N секунд. Допомагає знайти важкі тіки./wg flushstates— скидає кеш стану гравців (потрібно після ручного редагування файлів регіонів)./wg reload— перечитує конфіг без перезапуску сервера./stoplag— миттєво зупиняє розповсюдження вогню і деякі інші важкі процеси, поки адміністратор розбирається з причиною лагу.
Висновок
WorldGuard обмежує те, що можуть робити гравці у конкретних зонах світу Minecraft. Сильні сторони — гнучкість прапорів і пріоритетів, можливість будувати ієрархію регіонів і керувати правилами через групи прав, а також робота "з коробки" з більшістю популярних плагінів. Слабкі — крива входу (для повноцінного налаштування доведеться розібратися з документацією) і відсутність вбудованого GUI для звичайних гравців: усе робиться командами. WorldGuard оптимальний для серверів з активною адмін-командою, які потребують точного контролю над поведінкою світу — публічних PvE/RPG.
Встановлення
Типове встановлення займає близько 5 хвилин. Порядок однаковий; відрізняються лише лоадер і відповідна збірка.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.











