> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cakestudio.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройка PVE бустеров

> Подробное руководство по настройке, правам доступа, валютам и возможностям PVE бустеров регионов.

Система PVE бустеров позволяет игрокам активировать специальные временные или постоянные эффекты в границах своих приватных регионов.

***

## ⚡ Описание доступных бустеров

В CakeRegionsPlus по умолчанию доступны следующие типы бустеров:

1. **crop\_growth** (Ускорение роста культур) — увеличивает скорость роста растений в регионе на 10% (шанс 10% при каждом типе роста).
2. **spawner\_speed** (Ускорение спавнеров) — уменьшает время спавна мобов из спавнеров в регионе на 10%.
3. **mob\_kill\_effects** (Эффекты при убийстве мобов) — дает накладываемые эффекты зелий игрокам при убийстве враждебных мобов в регионе.
4. **no\_fuel\_decay** (Заморозка сгорания топлива) — временно приостанавливает расход топлива приватного блока.

***

## ⚙️ Файл конфигурации (`boosters.yml`)

Настройки бустеров находятся в файле `plugins/CakeRegionsPlus/modules/boosters.yml`. Вы можете настроить длительность, стоимость, тип оплаты и права для каждого бустера отдельно.

### Пример конфигурации:

```yaml theme={null}
boosters:
  crop_growth:
    name: "Ускорение роста культур"
    chance: 0.10
    permission: "cakeregions.booster.crop_growth" # Право на покупку бустера
    # Временная покупка:
    duration: 3600 # Длительность действия в секундах (1 час)
    cost-type: "VAULT" # Тип оплаты (VAULT, FUEL, ITEM)
    cost: 500 # Стоимость покупки
    
    # Перманентная покупка:
    permanent-enabled: true # Разрешена ли покупка навсегда
    permanent-cost-type: "ITEM"
    permanent-cost: 64
    permanent-cost-item: "DIAMOND" # Предмет оплаты (имя материала), если тип = ITEM

  spawner_speed:
    name: "Ускорение спавнеров"
    multiplier: 0.90
    permission: "cakeregions.booster.spawner_speed"
    duration: 1800
    cost-type: "FUEL" # Оплата топливом региона
    cost: 14400 # 4 часа (в секундах) топлива будет списано с баланса региона
    permanent-enabled: true
    permanent-cost-type: "VAULT"
    permanent-cost: 8000

  mob_kill_effects:
    name: "Эффекты при убийстве мобов"
    effects:
      - "SPEED:2:100" # Эффект:Уровень:Длительность(в тиках)
      - "REGENERATION:2:60"
    permission: "cakeregions.booster.mob_kill_effects"
    duration: 3600
    cost-type: "VAULT"
    cost: 1000
    permanent-enabled: false # Запрещено покупать навсегда
```

***

## 💳 Типы оплаты (Валюта)

Система поддерживает 3 типа валюты для временных и постоянных покупок:

* `VAULT` — списывает внутриигровую валюту с баланса игрока через плагин Vault (или другие плагины экономики, указанные в секции `economy:`).
* `FUEL` — списывает указанное количество секунд топлива с приватного региона. Игрок не сможет купить бустер, если в привате недостаточно топлива.
* `ITEM` — списывает указанное количество предметов из инвентаря игрока. Требуется настроить `cost-item` или `permanent-cost-item` (имя материала Bukkit, например `DIAMOND` или `NETHERITE_INGOT`).

***

## 🔒 Права доступа (Permissions)

* **Право на покупку конкретного бустера**: указывается в `permission:` в `boosters.yml`. Если не указано, право не требуется.
* **Право на переключение (Вкл/Выкл)**: `cakeregions.booster.toggle`. Позволяет игрокам временно включать и выключать купленные бустеры.

***

## 🚫 Отключение бустеров для определенных блоков

Вы можете полностью отключить поддержку бустеров для конкретных типов приватов. Для этого добавьте параметр `boosters-enabled: false` в конфигурационный файл блока привата (например, `plugins/CakeRegionsPlus/blocks/diamond.yml`):

```yaml theme={null}
# diamond.yml
radius: 10
max-members: 5
boosters-enabled: false # Меню бустеров будет недоступно для этого привата
```

По умолчанию `boosters-enabled` равен `true`.