Плагін Minecraft WorldGuardExtraFlagsPlus

🔌 Про WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus — це розширення для плагіна WorldGuard, яке додає додаткові прапорці регіонів і поведінку. Воно розширює систему регіонів WorldGuard більш ніж 40 підтвердженими прапорцями для керування використанням предметів, телепортацією, лімітами входу, крафтом, зіткненням гравців, торгівлею з селянами та іншими правилами для окремих регіонів.

🎯 Призначення

Плагін закриває прогалини у вбудованих прапорцях WorldGuard, надаючи точний контроль над діями гравців і політиками регіонів. Він призначений для адміністраторів серверів, яким потрібне налаштування на рівні регіонів понад базові можливості WorldGuard, наприклад для створення захищених PvP-арен, лобі, поведінки hub або зон із обмеженим геймплеєм.

⚙️ Можливості

• Додає 40+ додаткових прапорців (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Нові прапорці, специфічні для plus: disable-completely, disable-throw, entry-min-level, entry-max-level, player-count-limit, villager-trade, lightning-damage, disable-collision, inventory-craft, permit-workbenches, deny-item-drops, deny-item-pickup, allow-block-place, deny-block-place, allow-block-break, deny-block-break.
• Налаштовувані повідомлення зберігаються у messages-wgefp.yml (затримка між повідомленнями для запобігання спаму).
• Додаткові інтеграції: підтримка PlaceholderAPI для числових плейсхолдерів, опційні packet-хуки PacketEvents або ProtocolLib для кращого блокування окремих предметів/атак.
• Взаємодія з EssentialsX: покращення прапорців godmode і fly вимикають godmode/fly в EssentialsX, коли ці прапорці заборонено.
• Підтримка Folia та async-безпечні обробники, де це можливо.
• Перевірка оновлень і експериментальний прапорець hide-players, а також експериментальна поведінка chambered-enderpearl.
• Прапорець console-command-repeat для повторного виконання команди в консолі, доки гравець перебуває в регіоні (вимкнено за замовчуванням).

🧩 Для кого це

• Власників і адміністраторів серверів, які використовують WorldGuard і потребують точнішого контролю регіонів.
• Серверів Survival, SMP, hub/lobby і PvP, яким потрібна поведінка, прив’язана до регіонів.
• Серверів на Paper або Folia, де потрібна підтримка async або специфічна для форку.

🏗️ Приклади використання

• Обмежити кількість гравців у регіоні арени за допомогою player-count-limit.
• Заборонити використання та кидання певних предметів (mace, trident, ender pearls) у зонах подій через disable-completely і disable-throw.
• Запобігти крафту в інвентарі (2x2) у безпечних зонах за допомогою inventory-craft або заблокувати використання верстака через permit-workbenches.
• Обмежити вхід у регіон за рівнем XP гравця або числовим значенням PlaceholderAPI через entry-min-level / entry-max-level.
• Запускати команду в консолі повторно, поки гравець залишається всередині регіону, за допомогою console-command-repeat.

⌨️ Команди

⚙️ Встановлення

📥 Налаштування

• Завантажте офіційний JAR і помістіть його в каталог plugins/ вашого сервера разом із WorldGuard.
• Якщо оновлюєтеся зі старого WorldGuardExtraFlags: перед запуском видаліть старий WorldGuardExtraFlags.jar — ці два плагіни не можуть співіснувати.
• Перезапустіть сервер і перевірте консоль сервера, щоб переконатися, що плагін і його прапорці завантажилися правильно.

📦 Залежності

• Обов’язково: WorldGuard (цей проєкт є розширенням для WorldGuard).
• Опційно / інтеграції: PlaceholderAPI (підтримка числових плейсхолдерів), PacketEvents або ProtocolLib (краще блокування на основі пакетів), EssentialsX (інтеграція для поведінки godmode/fly).

🧾 Конфігурація

• Повідомлення плагіна зберігаються у plugins/WorldGuard/messages-wgefp.yml і повністю налаштовуються; система затримки між повідомленнями налаштовується через конфіг плагіна.

🧠 Технічні примітки

• Проєкт оголошує api-version: 1.21 і націлений на сучасні артефакти Paper API; сумісність із Folia реалізована та підтверджена.
• Java bytecode і орієнтація на API відповідають сучасним серверним середовищам епохи 1.21.
• Плагін замінює стару поведінку permit-completely на disable-completely для ширшої семантики блокування предметів.
• Деякі функції (наприклад, повне блокування певних механік ривка списом) працюють надійніше, коли доступні PacketEvents або ProtocolLib.
• Плагін надає багато прапорців через стандартні команди прапорців WorldGuard (прапорці встановлюються через інтерфейс прапорців регіонів WorldGuard).

🤝 Коли цей плагін корисний

Якщо ви використовуєте WorldGuard і вам потрібні додаткові підтверджені прапорці регіонів для керування використанням предметів, правилами входу гравців, крафтом та іншою поведінкою для кожного регіону — особливо на серверах Paper або Folia — WorldGuard ExtraFlags Plus об’єднує ці можливості в системі прапорців WorldGuard без потреби в окремих плагінах для керування регіонами.