## 🎮 Команды

### Основная команда: /aura

| Команда | Описание | Пример |
|---------|----------|--------|
| /aura give <игрок> <тип> | Выдать предмет ауры игроку | /aura give Steve protection |
| /aura remove <игрок> | Удалить активную ауру у игрока | /aura remove Steve |
| /aura reload | Перезагрузить конфигурацию | /aura reload |

### Права доступа
- aura.admin - доступ ко всем командам (по умолчанию только для операторов)

## 🎨 Типы аур (по умолчанию)

### 1. 🛡️ Protection (Защита)
- Длительность: 10 секунд
- Эффект: Блокирует весь урон
- Анимация: Защитная полусфера (hemisphere)
- Цвет: Золотой (255,215,0)
- Атрибуты: +10 броня, +5 прочность брони
- Эффекты: Сопротивление урону I

### 2. ⚡ Speed (Скорость)
- Длительность: 15 секунд
- Анимация: Спираль (spiral)
- Цвет: Голубой (0,255,255)
- Атрибуты: +0.05 скорость передвижения
- Эффекты: Скорость II

### 3. ⚔️ Strength (Сила)
- Длительность: 12.5 секунд
- Анимация: Двойная спираль (helix)
- Цвет: Красный (255,0,0)
- Атрибуты: +5.0 урон атаки
- Эффекты: Сила II

### 4. ❤️ Regeneration (Регенерация)
- Длительность: 20 секунд
- Анимация: Волны (wave)
- Цвет: Розовый (255,105,180)
- Атрибуты: +10.0 максимальное здоровье
- Эффекты: Регенерация II, Дополнительное здоровье I

### 5. ❄️ Frost (Мороз)
- Длительность: 17.5 секунд
- Анимация: Сфера (sphere)
- Цвет: Светло-голубой (173,216,230)
- Атрибуты: +0.5 сопротивление отбрасыванию
- Эффекты: Плавное падение, Подводное дыхание

### 6. 🔥 Fire (Пламя)
- Длительность: 15 секунд
- Анимация: Кольца (ring)
- Цвет: Оранжевый (255,69,0)
- Атрибуты: +3.0 урон атаки, +0.05 скорость атаки
- Эффекты: Огнестойкость

### 7. ⚫ Void (Бездна)
- Длительность: 14 секунд
- Анимация: Сфера (sphere)
- Цвет: Фиолетовый (75,0,130)
- Атрибуты: +5.0 броня, +0.03 скорость передвижения
- Эффекты: Ночное зрение, Невидимость

### 8. 🌿 Nature (Природа)
- Длительность: 16 секунд
- Анимация: Спираль (spiral)
- Цвет: Зеленый (34,139,34)
- Атрибуты: +6.0 максимальное здоровье, +2.0 удача
- Эффекты: Регенерация I, Насыщение

## 🎭 Типы анимаций

| Тип | Описание |
|-----|----------|
| circle | Круг частиц вокруг игрока |
| sphere | Полная сфера частиц |
| hemisphere | Защитная полусфера сверху |
| spiral | Вращающаяся спираль снизу вверх |
| wave | Волнообразное движение |
| helix | Двойная спираль ДНК |
| ring | Три концентрических кольца |

## ⚙️ Настройка конфигурации

### Структура config.yml

yaml
auras:
название_ауры:
duration: 200 # Длительность в тиках (20 тиков = 1 секунда)
particle: REDSTONE # Тип частицы
color: "255,255,0" # Цвет RGB (для REDSTONE)
particle-radius: 1.5 # Радиус эффекта
particle-count: 20 # Количество частиц
animation-type: circle # Тип анимации
activation-message: "§eАура активирована!"
deactivation-message: "§7Аура деактивирована."
item-material: FLOWER_BANNER_PATTERN # Материал предмета
item-name: "§eНазвание"
item-lore: # Описание предмета
- "§7Строка 1"
- "§7Строка 2"
attributes: # Модификаторы атрибутов
GENERIC_ARMOR: 10.0
GENERIC_MOVEMENT_SPEED: 0.05
effects: # Эффекты зелий
SPEED: 2 # Название: уровень
REGENERATION: 1


### 📝 Параметры ауры

#### Основные параметры
- duration - длительность в тиках (20 тиков = 1 секунда)
- particle - тип частицы Minecraft
- color - цвет RGB в формате "R,G,B" (только для REDSTONE)
- particle-radius - радиус анимации частиц
- particle-count - количество частиц в анимации
- animation-type - тип анимации (см. выше)

#### Сообщения
- activation-message - сообщение при активации
- deactivation-message - сообщение при деактивации

#### Предмет
- item-material - материал предмета (Material)
- item-name - название предмета (с цветовыми кодами)
- item-lore - список строк описания

#### Эффекты
- attributes - модификаторы атрибутов игрока
- effects - эффекты зелий с уровнем

### 🎨 Доступные типы частиц

REDSTONE, FLAME, SOUL_FIRE_FLAME, END_ROD, 
ENCHANTMENT_TABLE, HEART, SNOWFLAKE, VILLAGER_HAPPY,
CRIT, CLOUD, SPELL_WITCH, DRAGON_BREATH и др.


### 📊 Доступные атрибуты

GENERIC_MAX_HEALTH           - Максимальное здоровье
GENERIC_MOVEMENT_SPEED - Скорость передвижения
GENERIC_ATTACK_DAMAGE - Урон атаки
GENERIC_ATTACK_SPEED - Скорость атаки
GENERIC_ARMOR - Броня
GENERIC_ARMOR_TOUGHNESS - Прочность брони
GENERIC_KNOCKBACK_RESISTANCE - Сопротивление отбрасыванию
GENERIC_LUCK - Удача


### 🧪 Доступные эффекты зелий

SPEED, SLOW, FAST_DIGGING, SLOW_DIGGING,
INCREASE_DAMAGE, HEAL, HARM, JUMP, CONFUSION,
REGENERATION, DAMAGE_RESISTANCE, FIRE_RESISTANCE,
WATER_BREATHING, INVISIBILITY, BLINDNESS,
NIGHT_VISION, HUNGER, WEAKNESS, POISON,
WITHER, HEALTH_BOOST, ABSORPTION, SATURATION,
GLOWING, LEVITATION, LUCK, UNLUCK,
SLOW_FALLING, CONDUIT_POWER, DOLPHINS_GRACE,
BAD_OMEN, HERO_OF_THE_VILLAGE


## 💡 Примеры создания кастомных аур

### Пример 1: Аура невидимости

yaml
auras:
stealth:
duration: 200
particle: SMOKE_NORMAL
color: "128,128,128"
particle-radius: 1.0
particle-count: 15
animation-type: circle
activation-message: "§8Вы стали невидимым..."
deactivation-message: "§7Невидимость исчезла"
item-material: GLASS
item-name: "§8Аура Тени"
item-lore:
- "§7Делает вас невидимым"
- "§7на 10 секунд"
attributes:
GENERIC_MOVEMENT_SPEED: 0.02
effects:
INVISIBILITY: 0
NIGHT_VISION: 0


### Пример 2: Аура прыжков

yaml
auras:
jump:
duration: 300
particle: CLOUD
color: "255,255,255"
particle-radius: 1.2
particle-count: 25
animation-type: wave
activation-message: "§f§lПРЫЖОК АКТИВИРОВАН!"
deactivation-message: "§7Способность к прыжкам вернулась к норме"
item-material: RABBIT_FOOT
item-name: "§f⬆ Аура Прыжка ⬆"
item-lore:
- "§7Позволяет прыгать очень высоко"
- "§fДлительность: 15 секунд"
attributes: {}
effects:
JUMP: 3
SLOW_FALLING: 0


## 🎯 Использование

### Для игроков

1. Получите предмет ауры от администратора
2. Возьмите предмет в руку
3. Нажмите ПКМ (правая кнопка мыши)
4. Аура активируется и предмет исчезнет
5. Наслаждайтесь эффектами!

Ограничения:
- Может быть активна только одна аура одновременно
- Аура исчезает при выходе с сервера
- Предмет одноразовый

### Для администраторов

Выдать ауру игроку:
/aura give <игрок> <тип>


Принудительно удалить ауру:
/aura remove <игрок>


Перезагрузить конфигурацию после изменений:
/aura reload


## 🎓 Дополнительные примеры

### Аура молнии

yaml
auras:
lightning:
duration: 150
particle: ELECTRIC_SPARK
color: "135,206,250"
particle-radius: 1.8
particle-count: 60
animation-type: helix
activation-message: "§b§l⚡ ЭЛЕКТРИЧЕСКИЙ РАЗРЯД! ⚡"
deactivation-message: "§7Молния исчезла..."
item-material: LIGHTNING_ROD
item-name: "§b§l⚡ Аура Молнии ⚡"
item-lore:
- "§7Призывает силу грозы"
attributes:
GENERIC_ATTACK_SPEED: 0.1
GENERIC_MOVEMENT_SPEED: 0.04
effects:
SPEED: 3
GLOWING: 0


### Аура тьмы

yaml
auras:
darkness:
duration: 250
particle: SMOKE_LARGE
color: "0,0,0"
particle-radius: 2.0
particle-count: 80
animation-type: sphere
activation-message: "§0§lТЬМА ПОГЛОЩАЕТ ВСЁ"
deactivation-message: "§7Тьма отступила..."
item-material: BLACK_CONCRETE
item-name: "§0§l⬛ Аура Абсолютной Тьмы ⬛"
item-lore:
- "§7Окутывает врагов тьмой"
- "§0Длительность: 12.5 сек"
attributes:
GENERIC_ARMOR: 8.0
effects:
BLINDNESS: 0
INVISIBILITY: 0
NIGHT_VISION: 0