WgAddon

Плагин для Minecraft (Paper 1.21+) расширяющий возможности WorldGuard для контроля грифа в определённых зонах.

📋 Возможности

• ✅ Контроль падающих блоков (песок, гравий) - не падают в защищённых регионах
• ✅ Контроль поршней (обычных и липких) - не могут двигать блоки в/из защищённых зон
• ✅ Контроль Визера - не может ломать блоки и взрывать в защищённых регионах
• ✅ Гибкая настройка через config.yml
• ✅ Два режима работы: белый список или чёрный список регионов

🔧 Установка

1. Убедитесь, что на сервере установлен WorldGuard
2. Скомпилируйте плагин: ./gradlew build
3. Скопируйте build/libs/WGAddon-1.0-SNAPSHOT.jar в папку plugins/
4. Перезапустите сервер
5. Настройте plugins/WGAddon/config.yml

⚙️ Конфигурация

Режим 1: Разрешить везде, кроме указанных зон

grief:
  mode: "allow_everywhere_except_safe"
  safe-regions:
    - spawn
    - market
  safe-worlds:
    - world_nether_safe
  allowed-regions: []

features:
  falling_blocks: true
  pistons: true
  wither: true

cleanup:
  falling_block_mark_ms: 1000

Логика: Гриф разрешён везде, но запрещён в регионах spawn, market и мире world_nether_safe.

---

Режим 2: Запретить везде, кроме указанных зон

grief:
  mode: "allow_only_listed"
  safe-regions: []
  safe-worlds: []
  allowed-regions:
    - pvp_arena
    - wasteland

features:
  falling_blocks: true
  pistons: true
  wither: true

cleanup:
  falling_block_mark_ms: 1000

Логика: Гриф запрещён везде, но разрешён только в регионах pvp_arena и wasteland.

---

📖 Параметры конфигурации

Параметр	Тип	Описание
grief.mode	String	allow_everywhere_except_safe или allow_only_listed
grief.safe-regions	List	Список ID регионов, где гриф запрещён (для режима 1)
grief.safe-worlds	List	Список миров, где гриф запрещён (для режима 1)
grief.allowed-regions	List	Список ID регионов, где гриф разрешён (для режима 2)
features.falling_blocks	Boolean	Включить контроль падающих блоков
features.pistons	Boolean	Включить контроль поршней
features.wither	Boolean	Включить контроль Визера
cleanup.falling_block_mark_ms	Long	Время (мс) отслеживания падающих блоков

---

🎯 Примеры использования

Пример 1: Защита спавна и торговой зоны

grief:
  mode: "allow_everywhere_except_safe"
  safe-regions:
    - spawn
    - market
    - admin_base

Результат: Игроки могут грифить везде, кроме этих 3 регионов.

---

Пример 2: PvP арена с разрушаемыми блоками

grief:
  mode: "allow_only_listed"
  allowed-regions:
    - pvp_arena
    - destruction_zone

Результат: Гриф возможен только в этих 2 регионах, везде остальное защищено.

---

Пример 3: Защита от Визера во всех мирах, кроме End

grief:
  mode: "allow_everywhere_except_safe"
  safe-worlds:
    - world
    - world_nether

features:
  wither: true
  falling_blocks: false
  pistons: false

Результат: Визер может ломать блоки только в мире End (world_the_end).

---

🛠️ Сборка

# Windows
.\gradlew.bat build

# Linux/Mac
./gradlew build

JAR-файл появится в build/libs/

---

📝 Требования

• Java 21+
• Paper 1.21+ (или совместимые форки: Purpur, Pufferfish)
• WorldGuard 7.0.14+

---

🐛 Отладка

При запуске плагин выводит в лог:

[WGAddon] WgAddon loaded. Mode: allow_everywhere_except_safe

Если плагин не загружается:

1. Проверьте наличие WorldGuard
2. Убедитесь, что версия Java 21+
3. Проверьте корректность config.yml

---

📜 Лицензия

Проект разработан для bedepay.

---

🤝 Поддержка

При обнаружении багов или предложений создайте Issue в репозитории.