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

⭐ ГЛАВНОЕ ПРАВИЛО: main.yml vs limit.yml

📌 Если limit.yml → Enable: true (лимиты ВКЛЮЧЕНЫ)
Тогда limit.yml имеет ПРИОРИТЕТ над main.yml для лимитов!

# limit.yml
Enable: true                    # ← ключевой переключатель
default-max-regions: 10         # ← ЭТО значение будет использоваться

# main.yml  
max-regions-per-player: 5       # ← ИГНОРИРУЕТСЯ (так как Enable: true)

📌 Если limit.yml → Enable: false (лимиты ВЫКЛЮЧЕНЫ)
Тогда main.yml вступает в силу как запасной вариант.

⚠️ Важное замечание о флагах по умолчанию

Флаги по умолчанию, указанные в main.yml → regions.default-flags, НЕ ИСПОЛЬЗУЮТСЯ.
Вместо них применяются жёстко заданные значения в коде (RegionManager.setDefaultRegionFlags()). Для обычных регионов это:

build=deny, break=deny, place=deny, interact=allow, use-items=deny, pvp=allow, mob-spawning=allow, explosions=deny, creeper-explosion=deny, tnt-explosion=deny, time-lock=allow, entry=allow, exit=allow, chest-access=deny, enderchest=deny, block-chat=allow, enter-notify=deny, exit-notify=deny.

📁 Основные настройки (config.yml)

settings:
  default-language: "ru"        # Язык плагина (ru/en)
  debug: false                   # Режим отладки
  auto-update-config: true       # Автообновление конфига
  save-regions-individually: true
  auto-save-interval: 6000       # Интервал автосохранения (тики)
  max-regions-per-player: 5      # Лимит регионов по умолчанию
  enable-global-regions: true    # Глобальные регионы
  creeper-cancel-effects: true
  auto-time-sync: true
  notify-owners-on-entry: true
  notify-owners-on-exit: false

updates:
  check-for-updates: true
  resource: "modrinth"
  check-interval: 24             # Часы
  notify-admins: true

📁 Полная конфигурация (main.yml)

version: "1.0.0"
config-version: 3

# Администраторы плагина
admin-user:
  - "KillerYTuber1"
  - "Neonix98"

regions:
  max-regions-per-player: 5      # ⚠️ Используется ТОЛЬКО если limit.yml Enable: false
  allow-overlap: false
  default-priority: 0

  naming:
    blocked-names: ["admin", "global", "world", "server", "owner", "region", "mine", "protected"]
    min-length: 3
    max-length: 16
    allow-special-chars: true
    allow-spaces: false

  # Флаги по умолчанию (НЕ ИСПОЛЬЗУЮТСЯ – см. предупреждение выше)
  default-flags: {...}

  selection-tools:
    selection-wand:
      enabled: true
      material: "WOODEN_AXE"
      name: "&6Топор для выделения"
      lore: ["&7ЛКМ - установить позицию 1", "&7ПКМ - установить позицию 2", "&7Shift + ПКМ - проверить регион"]
    selection-info:
      enabled: true
      material: "STICK"
      name: "&bПроверка регионов"
      lore: ["&7ПКМ по блоку - проверить регион"]

# База данных (пока не реализована)
database:
  type: "sqlite"
  sqlite:
    filename: "regions.db"

# API (пока не реализован)
api:
  enable-api: true
  rest-api:
    enabled: false
    port: 8080

📊 Лимиты регионов (limit.yml)

⚠️ ВАЖНО: Этот файл имеет ПРИОРИТЕТ над main.yml для лимитов!
Если Enable: true - используются настройки из limit.yml.
Если Enable: false - используются настройки из main.yml.

# ГЛОБАЛЬНОЕ ВКЛЮЧЕНИЕ/ВЫКЛЮЧЕНИЕ
Enable: true

# НАСТРОЙКИ РАЗМЕРОВ РЕГИОНОВ
size-limits:
  enable-size-checks: true
  min-size: 5
  max-size: 100000
  max-height: 256

# НАСТРОЙКИ КОЛИЧЕСТВА РЕГИОНОВ
default-max-regions: 5

# ПРИОРИТЕТ ПРОВЕРКИ
check-priority: permission-first

# ЛИМИТЫ ПО ПЕРМИШЕНАМ
permission-limits:
  - permission: "regionmc.limit.10000"
    limit: 10000
  - permission: "regionmc.limit.20000"
    limit: 20000
  - permission: "regionmc.limit.50000"
    limit: 50000
  - permission: "regionmc.limit.100000"
    limit: 100000
  - permission: "regionmc.limit.unlimited"
    limit: -1
  
  - permission: "regionmc.maxregions.5"
    max-regions: 5
  - permission: "regionmc.maxregions.10"
    max-regions: 10
  - permission: "regionmc.maxregions.20"
    max-regions: 20
  - permission: "regionmc.maxregions.unlimited"
    max-regions: -1

# ЛИМИТЫ ПО ГРУППАМ
group-limits:
  default:
    size: 26000
    max-regions: 5
  vip:
    size: 32000
    max-regions: 10
  premium:
    size: 40000
    max-regions: 20
  elite:
    size: 50000
    max-regions: 30
  admin:
    size: -1
    max-regions: -1

default-limit: 100000

💡 limit: -1 = безлимитно | max-height: -1 = безлимитная высота

🎨 Цвета и форматы (ColorUtils.yml)

# Стандартные цвета Minecraft
minecraft-colors:
  black: "&0"
  dark-blue: "&1"
  dark-green: "&2"
  red: "&c"
  green: "&a"
  yellow: "&e"

# MiniMessage форматы
minimessage-examples:
  basic-colors:
    - "Красный текст"
    - "Зеленый текст"
    - "Синий текст"
    - "Желтый текст"
    - "Золотой текст"
    - "Бирюзовый текст"
    - "Белый текст"
    - "Темно-красный текст"

  formatting:
    - "Жирный текст"
    - "Курсивный текст"
    - "Подчеркнутый текст"
    - "Зачеркнутый текст"
    - "Зашифрованный текст"

  gradients:
    - "Градиент от красного к синему"
    - "Золотой градиент"

  hex-colors:
    - "<#FF0000>Красный HEX"
    - "<#00FF00>Зеленый HEX"
    - "<#0000FF>Синий HEX"
    - "<#FFA500>Оранжевый HEX"

💡 Поддерживаются HEX цвета, градиенты и MiniMessage форматы