PrimeItems FREE VERSION

Осталось загрузок за 24 часа: 2

Создай кастомные предметы для вашего сервера

PrimeItems - Плагин Кастомных Предметов

## Описание

**PrimeItems** - это мощный плагин для Minecraft серверов, который добавляет более 70 уникальных кастомных зачарований и эффектов. Плагин позволяет создавать предметы с особыми способностями, которые значительно расширяют игровые возможности.

## Техническая информация

- **Версия плагина**: 1.0.0
- **Совместимость**: Minecraft 1.16.5 - 1.20.4
- **API**: Bukkit/Spigot/Paper
- **Java**: 8+
- **Зависимости**: Нет

## Установка

1. Скачайте файл `PrimeItems.jar`
2. Поместите его в папку `plugins` вашего сервера
3. Перезапустите сервер
4. Настройте конфигурацию в файле `plugins/PrimeItems/config.yml`

## Конфигурация

### Основные настройки

```yaml
# Основные настройки плагина
debug: false
language: "ru"

# Настройки эффектов
effects:
update-interval: 20 # Тики между обновлениями эффектов
max-effects-per-player: 50 # Максимальное количество эффектов на игрока
```

### Создание кастомных предметов

```yaml
items:
my_custom_sword:
name: "§6§lЛегендарный Меч"
material: "DIAMOND_SWORD"
lore:
- "§7Мощный меч с особыми способностями"
- "§7• Острота V"
- "§7• Кровожадность III"
glow: true
activation: "MAINHAND" # MAINHAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS, INVENTORY
effects:
SHARPNESS:
enabled: true
value: 5
BLOODTHIRST:
enabled: true
value: 3
```

## Команды

| Команда | Описание | Права | Алиасы |
|---------|----------|-------|--------|
| `/primeitems` | Основная команда плагина | `primeitems.use` | `/pi`, `/prime` |
| `/primeitems reload` | Перезагрузить конфигурацию | `primeitems.admin` | - |
| `/primeitems give <игрок> <предмет>` | Выдать кастомный предмет | `primeitems.give` | - |
| `/primeitems list` | Список всех предметов | `primeitems.list` | - |
| `/primeitems effects <игрок>` | Показать активные эффекты игрока | `primeitems.effects` | - |

## Права доступа

| Право | Описание |
|-------|----------|
| `primeitems.use` | Базовое использование плагина |
| `primeitems.admin` | Административные функции |
| `primeitems.give` | Выдача кастомных предметов |
| `primeitems.list` | Просмотр списка предметов |
| `primeitems.effects` | Просмотр активных эффектов |
| `primeitems.bypass` | Обход ограничений плагина |

## Кастомные Зачарования

Плагин добавляет 70+ уникальных зачарований, разделенных по категориям:

### Зачарования для Оружия (20 зачарований)
- **Кровожадность** - исцеление при убийстве мобов
- **Призрачный клинок** - атака сквозь блоки
- **Эхоудар** - задержанный второй удар
- **Разрушитель брони** - игнорирование брони
- **Клинок времени** - замедление целей
- **Душегуб** - призыв призраков
- **Огненный след** - огненная тропа
- **Ледяной клинок** - замораживание
- **Откат** - усиленное отбрасывание
- **Клинок-магнит** - притягивание предметов
- **Проворство** - автосбор добычи
- **Вампир** - исцеление при ударе
- **Вор** - кража опыта
- **Гнев** - урон при низком здоровье
- **Гром** - удары молнией
- **Двойной удар** - двойной урон
- **Мудрость** - больше опыта от мобов
- **Обезглавливатель** - получение голов
- **Отрава** - тошнота при критических ударах
- **Окисление** - ускорение поломки брони
- **Вампиризм ФТ** - регенерация при ударе
- **Стутор** - слабость и замедление

### Зачарования для Брони (10 зачарований)
- **Аура отталкивания** - отталкивание мобов
- **Фантомная броня** - невидимость после урона
- **Живая броня** - самовосстановление
- **Зеркальный щит** - отражение урона
- **Биоадаптация** - адаптация к мобам
- **Восстановление** - регенерация здоровья
- **Насыщение** - восстановление голода
- **Ночное зрение** - видимость в темноте
- **Огненный щит** - поджигание атакующих
- **Останавливающая сила** - уменьшение отбрасывания
- **Упорство** - защита от стрел

### Зачарования для Луков (13 зачарований)
- **Стрела-магнит** - притягивание предметов
- **Гоминг** - самонаводящиеся стрелы
- **Сплит-шот** - разделение стрел
- **Обратный выстрел** - возврат стрел
- **Стрела-телепорт** - телепортация к стреле
- **Световая стрела** - освещение области
- **Ядовитый наконечник** - отравление
- **Стрела-взрыв** - взрывные стрелы
- **Стрела-заморозка** - замораживание
- **Вампирские стрелы** - исцеление
- **Снайпер** - увеличение скорости
- **Подрывник** - подрыв врагов
- **Наэлектризованные стрелы** - молнии

### Зачарования для Инструментов (12 зачарований)
- **Пингер** - защита от случайного ломания
- **Божье Касание** - ломание любых блоков
- **Паутина** - ломание соединенной руды
- **Мощный Удар** - отбрасывание
- **Тяжёлый** - усталость при копании
- **Нестабильный** - быстрый износ
- **Взрывная добыча** - взрывная добыча
- **Лесоруб** - рубка целых деревьев
- **Геологоразведчик** - поиск руд
- **Энергосбережение** - уменьшение износа
- **Удача фермера** - больше урожая
- **Озеленитель** - ускорение роста растений

### Зачарования для Рыбалки (3 зачарования)
- **Выживальщик** - автоготовка рыбы
- **Двойной улов** - больше предметов
- **Опытный рыбалов** - больше опыта

### Зачарования для Обуви (1 зачарование)
- **Попрыгун** - улучшенная прыгучесть

### Зачарования для Трезубца (2 зачарования)
- **Притяжение** - притягивание/отталкивание игроков
- **Скаут** - телепортация к трезубцу

## Стандартные Эффекты

Плагин поддерживает все стандартные эффекты зелий Minecraft (40+ эффектов).

## Стандартные Зачарования

Плагин поддерживает все стандартные зачарования Minecraft (40+ зачарований).

## Примеры Конфигурации

### Простой меч с эффектами

```yaml
items:
blood_sword:
name: "§4§lКровавый Меч"
material: "DIAMOND_SWORD"
lore:
- "§7Меч с кровожадными способностями"
- "§7• Острота V"
- "§7• Кровожадность III"
- "§7• Вампир II"
glow: true
activation: "MAINHAND"
effects:
SHARPNESS:
enabled: true
value: 5
BLOODTHIRST:
enabled: true
value: 3
VAMPIRE:
enabled: true
value: 2
```

## Известные проблемы

- Некоторые зачарования могут конфликтовать с другими плагинами
- Эффекты могут не применяться при быстром переключении предметов
- Производительность может снижаться при большом количестве активных эффектов

## Обновления

### Версия 1.0.0
- Первый релиз
- 70+ кастомных зачарований
- Поддержка всех стандартных эффектов и зачарований
- Система конфигурации
- Команды и права доступа

## Поддержка

Если у вас возникли проблемы или вопросы:

1. Проверьте консоль сервера на наличие ошибок
2. Убедитесь, что версия Minecraft совместима
3. Проверьте правильность конфигурации
4. Обратитесь к разработчику



# Подробная Документация Зачарований

## Зачарования для Оружия

### Кровожадность (BLOODTHIRST)
- **Уровни**: I-III
- **Описание**: При убийстве моба восстанавливает 1 сердце игроку
- **Применение**: Мечи, топоры, кирки
- **Механика**: Шанс срабатывания зависит от уровня зачарования
- **Пример использования**: Идеально для фарма мобов и PvP

### Призрачный клинок (PHANTOM_BLADE)
- **Уровни**: I
- **Описание**: Атака проходит сквозь блоки на 1 блок вперед
- **Применение**: Мечи
- **Механика**: Позволяет атаковать через стены и препятствия
- **Пример использования**: Тактические бои в закрытых пространствах

### Эхоудар (ECHO_STRIKE)
- **Уровни**: I-II
- **Описание**: После удара появляется задержанный второй удар через 0.5 сек
- **Применение**: Мечи, топоры
- **Механика**: Дополнительный урон с задержкой
- **Пример использования**: Комбо-атаки в PvP

### Разрушитель брони (ARMOR_BREAKER)
- **Уровни**: I-III
- **Описание**: Игнорирует 50% брони цели
- **Применение**: Мечи
- **Механика**: Процент игнорирования брони зависит от уровня
- **Пример использования**: Эффективно против тяжелой брони

### Клинок времени (TIME_BLADE)
- **Уровни**: I-II
- **Описание**: Замедляет цель на 3 сек после удара
- **Применение**: Мечи
- **Механика**: Накладывает эффект замедления
- **Пример использования**: Контроль противников в бою

### Душегуб (SOUL_REAPER)
- **Уровни**: I
- **Описание**: Убийство моба имеет шанс призвать его призрака, который атакует других мобов
- **Применение**: Мечи
- **Механика**: Призыв призраков для помощи в бою
- **Пример использования**: Фарм мобов с поддержкой

### Огненный след (FIRE_TRAIL)
- **Уровни**: I-II
- **Описание**: Оставляет за собой огненную тропу, поджигая блоки и мобов
- **Применение**: Мечи
- **Механика**: Создает огненные блоки за игроком
- **Пример использования**: Контроль территории и урон по площади

### Ледяной клинок (ICE_BLADE)
- **Уровни**: I-II
- **Описание**: Замораживает воду вокруг при ударе и замедляет мобов
- **Применение**: Мечи
- **Механика**: Превращает воду в лед и замедляет цели
- **Пример использования**: Бои в воде и контроль мобов

### Откат (KNOCKBACK_ENHANCED)
- **Уровни**: I-III
- **Описание**: Отбрасывает цель на 3-5 блоков назад
- **Применение**: Мечи, топоры
- **Механика**: Усиленное отбрасывание в зависимости от уровня
- **Пример использования**: Контроль позиционирования в бою

### Клинок-магнит (BLADE_MAGNET)
- **Уровни**: I
- **Описание**: Притягивает выпавшие предметы с радиуса 5 блоков после убийства
- **Применение**: Мечи
- **Механика**: Автоматический сбор дропа
- **Пример использования**: Удобство при фарме

### Проворство (AGILITY)
- **Уровни**: I
- **Описание**: Перемещает всю добычу объекта непосредственно в инвентарь
- **Применение**: Оружие
- **Механика**: Автоматический сбор добычи в инвентарь
- **Пример использования**: Фарм без потери предметов

### Вампир (VAMPIRE)
- **Уровни**: I-III
- **Описание**: Шанс исцелить себя при ударе
- **Применение**: Оружие
- **Механика**: Исцеление зависит от уровня зачарования
- **Пример использования**: Выживание в длительных боях

### Вор (THIEF)
- **Уровни**: I-III
- **Описание**: Шанс украсть опыт у игроков
- **Применение**: Мечи
- **Механика**: Кража опыта при атаке игроков
- **Пример использования**: PvP с получением опыта

### Гнев (RAGE)
- **Уровни**: I-V
- **Описание**: Наносит больше урона за каждое недостающее здоровье
- **Применение**: Оружие
- **Механика**: Урон увеличивается при низком здоровье
- **Пример использования**: Рискованные бои с высоким уроном

### Гром (THUNDER)
- **Уровни**: I-V
- **Описание**: Шанс ударить молнией
- **Применение**: Оружие
- **Механика**: Призыв молний при атаке
- **Пример использования**: Массовый урон по площади

### Двойной удар (DOUBLE_STRIKE)
- **Уровни**: I-II
- **Описание**: Шанс нанести двойной урон
- **Применение**: Мечи
- **Механика**: Шанс критического урона
- **Пример использования**: Быстрое убийство целей

### Мудрость (WISDOM)
- **Уровни**: I-V
- **Описание**: Мобы дают больше опыта
- **Применение**: Оружие
- **Механика**: Множитель опыта от мобов
- **Пример использования**: Быстрое прокачивание

### Обезглавливатель (BEHEADER)
- **Уровни**: I-II
- **Описание**: Шанс получить голову игрока или моба
- **Применение**: Оружие
- **Механика**: Получение голов как трофеев
- **Пример использования**: Коллекционирование голов

### Отрава (POISON_WEAPON)
- **Уровни**: I-III
- **Описание**: При нанесении критических ударов противнику на 1 секунду с шансом 7.5% будет выдаваться эффект тошноты
- **Применение**: Оружие
- **Механика**: Тошнота при критических ударах
- **Пример использования**: Дебафф противников

### Окисление (OXIDATION)
- **Уровни**: I
- **Описание**: Ускоряет поломку брони противника при атаке этим мечом
- **Применение**: Мечи
- **Механика**: Ускорение износа брони врага
- **Пример использования**: Разрушение брони противников

### Вампиризм ФТ (VAMPIRISM_FT)
- **Уровни**: I-III
- **Описание**: При ударе есть шанс получить эффект регенерации
- **Применение**: Оружие
- **Механика**: Регенерация с разной скоростью по уровням
- **Пример использования**: Поддержание здоровья в бою

### Стутор (STUTOR)
- **Уровни**: I
- **Описание**: Накладывает на противника эффекты слабости и замедления при ударе мечом
- **Применение**: Мечи
- **Механика**: Комбинированный дебафф
- **Пример использования**: Ослабление противников

## Зачарования для Брони

### Аура отталкивания (REPULSION_AURA)
- **Уровни**: I-II
- **Описание**: Отбрасывает мобов, приблизившихся ближе 1 блока
- **Применение**: Броня
- **Механика**: Пассивная защита от приближения
- **Пример использования**: Защита от мобов

### Фантомная броня (PHANTOM_ARMOR)
- **Уровни**: I
- **Описание**: Игрок становится невидимым на 3 сек после получения урона
- **Применение**: Броня
- **Механика**: Невидимость при получении урона
- **Пример использования**: Тактическое отступление

### Живая броня (LIVING_ARMOR)
- **Уровни**: I-III
- **Описание**: Восстанавливает 1% прочности при каждом шаге
- **Применение**: Броня
- **Механика**: Самовосстановление при движении
- **Пример использования**: Долговечность брони

### Зеркальный щит (MIRROR_SHIELD)
- **Уровни**: I-II
- **Описание**: Отражает 25% урона обратно атакующему
- **Применение**: Броня
- **Механика**: Отражение урона атакующему
- **Пример использования**: Контратака при получении урона

### Биоадаптация (BIO_ADAPTATION)
- **Уровни**: I-III
- **Описание**: Постепенно снижает урон от одного типа мобов, если часто с ними сражаешься
- **Применение**: Броня
- **Механика**: Адаптация к определенным типам мобов
- **Пример использования**: Специализация против конкретных мобов

### Восстановление (REGENERATION_ENCHANT)
- **Уровни**: I-IV
- **Описание**: Восстанавливает здоровье каждые несколько секунд
- **Применение**: Нагрудник, элитра
- **Механика**: Постоянная регенерация здоровья
- **Пример использования**: Поддержание здоровья

### Насыщение (SATURATION_ENCHANT)
- **Уровни**: I-II
- **Описание**: Восстанавливает голод каждые несколько секунд
- **Применение**: Шлем
- **Механика**: Постоянное восстановление голода
- **Пример использования**: Отсутствие необходимости в еде

### Ночное зрение (NIGHT_VISION_ENCHANT)
- **Уровни**: I
- **Описание**: Даёт эффект «Ночное зрение»
- **Применение**: Шлем
- **Механика**: Постоянное ночное зрение
- **Пример использования**: Исследование темных мест

### Огненный щит (FIRE_SHIELD)
- **Уровни**: I-IV
- **Описание**: Шанс поджечь атакующих
- **Применение**: Нагрудник, элитра
- **Механика**: Поджигание атакующих
- **Пример использования**: Контратака при получении урона

### Останавливающая сила (STOPPING_POWER)
- **Уровни**: I-III
- **Описание**: 100% шанс уменьшить отбрасывание
- **Применение**: Поножи
- **Механика**: Снижение отбрасывания
- **Пример использования**: Стабильность в бою

### Упорство (PERSISTENCE)
- **Уровни**: I-III
- **Описание**: Уменьшает длительность дебаффов от стрел
- **Применение**: Броня
- **Механика**: Снижение длительности дебаффов от стрел
- **Пример использования**: Защита от дальних атак

## Зачарования для Луков и Арбалетов

### Стрела-магнит (ARROW_MAGNET)
- **Уровни**: I
- **Описание**: Притягивает к себе выпавшие предметы в радиусе 8 блоков
- **Применение**: Лук, арбалет
- **Механика**: Притягивание предметов к стрелку
- **Пример использования**: Сбор дропа на расстоянии

### Гоминг (HOMING_ARROW)
- **Уровни**: I-II
- **Описание**: Стрела слегка корректирует траекторию к цели
- **Применение**: Лук, арбалет
- **Механика**: Самонаводящиеся стрелы
- **Пример использования**: Точная стрельба по движущимся целям

### Сплит-шот (SPLIT_SHOT)
- **Уровни**: I
- **Описание**: Стрела разделяется на 3 при ударе
- **Применение**: Лук, арбалет
- **Механика**: Разделение стрелы на несколько
- **Пример использования**: Атака нескольких целей

### Обратный выстрел (RETURN_SHOT)
- **Уровни**: I
- **Описание**: Стрела возвращается к стрелку после попадания
- **Применение**: Лук, арбалет
- **Механика**: Возврат стрелы после попадания
- **Пример использования**: Экономия стрел

### Стрела-телепорт (TELEPORT_ARROW)
- **Уровни**: I
- **Описание**: Игрок телепортируется к месту попадания стрелы
- **Применение**: Лук, арбалет
- **Механика**: Телепортация к стреле
- **Пример использования**: Быстрое перемещение

### Световая стрела (LIGHT_ARROW)
- **Уровни**: I
- **Описание**: Освещает область на 10 сек после попадания
- **Применение**: Лук, арбалет
- **Механика**: Временное освещение области
- **Пример использования**: Исследование темных мест

### Ядовитый наконечник (POISON_TIP)
- **Уровни**: I-III
- **Описание**: Наносит яд на 5 сек
- **Применение**: Лук, арбалет
- **Механика**: Отравление целей
- **Пример использования**: Дебафф противников

### Стрела-взрыв (EXPLOSIVE_ARROW)
- **Уровни**: I-II
- **Описание**: Взрывается при попадании (небольшой радиус)
- **Применение**: Лук, арбалет
- **Механика**: Взрыв при попадании
- **Пример использования**: Урон по площади

### Стрела-заморозка (FREEZE_ARROW)
- **Уровни**: I
- **Описание**: Замораживает цель и воду вокруг
- **Применение**: Лук, арбалет
- **Механика**: Замораживание целей и воды
- **Пример использования**: Контроль противников

### Вампирские стрелы (VAMPIRE_ARROWS)
- **Уровни**: I-III
- **Описание**: Шанс восстановить здоровье при попадании стрелы
- **Применение**: Лук, арбалет
- **Механика**: Исцеление при попадании
- **Пример использования**: Поддержание здоровья на расстоянии

### Снайпер (SNIPER)
- **Уровни**: I
- **Описание**: Увеличивает скорость полёта стрелы
- **Применение**: Лук, арбалет
- **Механика**: Увеличение скорости стрел
- **Пример использования**: Быстрая и точная стрельба

### Подрывник (DEMOLITION)
- **Уровни**: I
- **Описание**: Подрывает врага
- **Применение**: Лук, арбалет
- **Механика**: Взрыв при попадании
- **Пример использования**: Мощные атаки

### Наэлектризованные стрелы (ELECTRIC_ARROWS)
- **Уровни**: I-III
- **Описание**: Шанс, что стрела вызовет молнию
- **Применение**: Лук, арбалет
- **Механика**: Призыв молний
- **Пример использования**: Массовый урон

## Зачарования для Инструментов

### Пингер (PINGER)
- **Уровни**: I
- **Описание**: Выдает эффект утомления 5 на 5 секунд перед последним касанием
- **Применение**: Кирка
- **Механика**: Предупреждение о поломке инструмента
- **Пример использования**: Защита от случайной поломки

### Божье Касание (DIVINE_TOUCH)
- **Уровни**: I
- **Описание**: Позволяет ломать блоки, например спавнеры, после использования кирка ломается
- **Применение**: Кирка
- **Механика**: Ломание любых блоков с поломкой инструмента
- **Пример использования**: Разрушение защищенных блоков

### Паутина (WEB)
- **Уровни**: I
- **Описание**: Ломает руду которая соединена
- **Применение**: Кирка
- **Механика**: Ломание соединенной руды
- **Пример использования**: Эффективная добыча руды

### Мощный Удар (POWER_STRIKE)
- **Уровни**: I
- **Описание**: Даёт кирке эффект отбрасывания
- **Применение**: Кирка
- **Механика**: Отбрасывание при ударе
- **Пример использования**: Защита от мобов

### Тяжёлый (HEAVY)
- **Уровни**: I
- **Описание**: Даёт эффект усталости на 10 секунд при ломании блока киркой
- **Применение**: Кирка
- **Механика**: Усталость при копании
- **Пример использования**: Ограничение скорости копания

### Нестабильный (UNSTABLE)
- **Уровни**: I
- **Описание**: Быстрее израсходует прочность инструмента, он будет быстрее ломаться
- **Применение**: Инструменты
- **Механика**: Ускоренный износ
- **Пример использования**: Временные мощные инструменты

### Взрывная добыча (EXPLOSIVE_MINING)
- **Уровни**: I-V
- **Описание**: Шанс добыть блоки взрывом
- **Применение**: Кирка
- **Механика**: Взрывная добыча блоков
- **Пример использования**: Массовая добыча ресурсов

### Лесоруб (LUMBERJACK_ENCHANT)
- **Уровни**: I
- **Описание**: Срубает целое дерево
- **Применение**: Топор
- **Механика**: Рубка всего дерева одним ударом
- **Пример использования**: Быстрая заготовка древесины

### Геологоразведчик (GEOLOGIST)
- **Уровни**: I
- **Описание**: Подсвечивает редкие руды в радиусе 8 блоков
- **Применение**: Кирки, лопаты, топоры
- **Механика**: Подсветка редких руд
- **Пример использования**: Поиск ценных ресурсов

### Энергосбережение (ENERGY_SAVER)
- **Уровни**: I-III
- **Описание**: Уменьшает износ инструмента на 50%
- **Применение**: Инструменты
- **Механика**: Снижение износа инструментов
- **Пример использования**: Долговечность инструментов

### Удача фермера (FARMER_LUCK)
- **Уровни**: I-III
- **Описание**: Увеличивает шанс получения дополнительных семян/урожая при сборе
- **Применение**: Инструменты
- **Механика**: Увеличение дропа урожая
- **Пример использования**: Эффективное фермерство

### Озеленитель (GREEN_THUMB)
- **Уровни**: I
- **Описание**: Работает как костная мука на растениях, но без костной муки за счёт прочности инструмента
- **Применение**: Мотыга
- **Механика**: Ускорение роста растений
- **Пример использования**: Быстрое выращивание урожая

## Зачарования для Рыбалки

### Выживальщик (SURVIVOR)
- **Уровни**: I
- **Описание**: Автоматически готовит рыбу, если поймана сырая
- **Применение**: Удочка
- **Механика**: Автоматическая готовка рыбы
- **Пример использования**: Удобство при рыбалке

### Двойной улов (DOUBLE_CATCH)
- **Уровни**: I-III
- **Описание**: Увеличивает количество пойманных предметов
- **Применение**: Удочка
- **Механика**: Увеличение количества дропа
- **Пример использования**: Эффективная рыбалка

### Опытный рыбалов (EXPERIENCED_FISHER)
- **Уровни**: I-III
- **Описание**: Увеличивает количество опыта, получаемого от рыбалки
- **Применение**: Удочка
- **Механика**: Множитель опыта от рыбалки
- **Пример использования**: Быстрое получение опыта

## Зачарования для Обуви

### Попрыгун (JUMPER)
- **Уровни**: I
- **Описание**: Даёт прыгучесть 1
- **Применение**: Ботинки
- **Механика**: Улучшенная прыгучесть
- **Пример использования**: Улучшенная мобильность

## Зачарования для Трезубца

### Притяжение (ATTRACTION)
- **Уровни**: I
- **Описание**: Притягивает игроков в любой броне к игроку на 4 блока и отталкивает игроков без брони на 4 блока от него
- **Применение**: Трезубец
- **Механика**: Притягивание/отталкивание игроков
- **Пример использования**: Контроль позиционирования в PvP

### Скаут (SCOUT)
- **Уровни**: I
- **Описание**: Притягивать игрока к месту, куда упал сам трезубец
- **Применение**: Трезубец
- **Механика**: Телепортация к трезубцу
- **Пример использования**: Быстрое перемещение

---

**Всего зачарований**: 70+ уникальных кастомных зачарований
**Категории**: Оружие, Броня, Луки, Инструменты, Рыбалка, Обувь, Трезубец
**Совместимость**: Все версии Minecraft 1.16.5+


# Команды и Права Доступа

## Основные Команды

### `/primeitems` (Основная команда)
- **Описание**: Основная команда плагина
- **Права**: `primeitems.use`
- **Алиасы**: `/pi`, `/prime`
- **Использование**:
```
/primeitems
/pi
/prime
```

### `/primeitems reload`
- **Описание**: Перезагрузить конфигурацию плагина
- **Права**: `primeitems.admin`
- **Использование**:
```
/primeitems reload
```
- **Функции**:
- Перезагружает `config.yml`
- Обновляет все кастомные предметы
- Применяет новые настройки эффектов
- Очищает кэш эффектов

### `/primeitems give <игрок> <предмет>`
- **Описание**: Выдать кастомный предмет игроку
- **Права**: `primeitems.give`
- **Использование**:
```
/primeitems give PlayerName my_custom_sword
/primeitems give @a blood_sword
```
- **Параметры**:
- `<игрок>` - имя игрока или селектор (@a, @p, @r)
- `<предмет>` - ID предмета из конфигурации

### `/primeitems list`
- **Описание**: Показать список всех кастомных предметов
- **Права**: `primeitems.list`
- **Использование**:
```
/primeitems list
```
- **Функции**:
- Показывает все доступные предметы
- Отображает их ID и названия
- Показывает количество эффектов

### `/primeitems effects <игрок>`
- **Описание**: Показать активные эффекты игрока
- **Права**: `primeitems.effects`
- **Использование**:
```
/primeitems effects PlayerName
/primeitems effects @p
```
- **Функции**:
- Показывает все активные эффекты
- Отображает их уровни и длительность
- Показывает источник эффектов

## Система Прав

### Базовые Права

#### `primeitems.use`
- **Описание**: Базовое использование плагина
- **Включает**:
- Использование основной команды `/primeitems`
- Получение эффектов от кастомных предметов
- Взаимодействие с предметами плагина
- **Рекомендация**: Выдавать всем игрокам

#### `primeitems.admin`
- **Описание**: Административные функции
- **Включает**:
- Команду `/primeitems reload`
- Доступ к отладочной информации
- Управление настройками плагина
- **Рекомендация**: Только для администраторов

### Права на Предметы

#### `primeitems.give`
- **Описание**: Выдача кастомных предметов
- **Включает**:
- Команду `/primeitems give`
- Возможность выдавать любые предметы
- Использование селекторов игроков
- **Рекомендация**: Для модераторов и администраторов

#### `primeitems.list`
- **Описание**: Просмотр списка предметов
- **Включает**:
- Команду `/primeitems list`
- Просмотр всех доступных предметов
- Информацию о предметах
- **Рекомендация**: Для всех игроков

#### `primeitems.effects`
- **Описание**: Просмотр активных эффектов
- **Включает**:
- Команду `/primeitems effects`
- Просмотр эффектов любого игрока
- Отладочную информацию об эффектах
- **Рекомендация**: Для модераторов

### Специальные Права

#### `primeitems.bypass`
- **Описание**: Обход ограничений плагина
- **Включает**:
- Игнорирование лимитов эффектов
- Обход проверок совместимости
- Доступ к экспериментальным функциям
- **Рекомендация**: Только для разработчиков

## Примеры Настройки Прав

### Для LuckPerms

```yaml
# Базовые права для всех игроков
groups:
default:
permissions:
- primeitems.use
- primeitems.list

# Права для VIP игроков
vip:
permissions:
- primeitems.use
- primeitems.list
- primeitems.effects

# Права для модераторов
moderator:
permissions:
- primeitems.use
- primeitems.list
- primeitems.effects
- primeitems.give

# Права для администраторов
admin:
permissions:
- primeitems.*
```

### Для PermissionsEx

```yaml
groups:
default:
permissions:
- primeitems.use
- primeitems.list
vip:
permissions:
- primeitems.use
- primeitems.list
- primeitems.effects
moderator:
permissions:
- primeitems.use
- primeitems.list
- primeitems.effects
- primeitems.give
admin:
permissions:
- primeitems.*
```

### Для GroupManager

```yaml
groups:
Default:
permissions:
- primeitems.use
- primeitems.list
VIP:
permissions:
- primeitems.use
- primeitems.list
- primeitems.effects
Moderator:
permissions:
- primeitems.use
- primeitems.list
- primeitems.effects
- primeitems.give
Admin:
permissions:
- primeitems.*
```

## Примеры Использования Команд

### Выдача предметов игрокам

```bash
# Выдать меч конкретному игроку
/primeitems give Steve blood_sword

# Выдать всем игрокам онлайн
/primeitems give @a magic_bow

# Выдать случайному игроку
/primeitems give @r guardian_armor
```

### Проверка эффектов

```bash
# Проверить свои эффекты
/primeitems effects @p

# Проверить эффекты другого игрока
/primeitems effects PlayerName

# Проверить эффекты ближайшего игрока
/primeitems effects @p
```

### Административные команды

```bash
# Перезагрузить конфигурацию
/primeitems reload

# Посмотреть список всех предметов
/primeitems list

# Основная команда (показывает помощь)
/primeitems
```

## Настройка Автоматической Выдачи

### Через консоль сервера

```bash
# Выдать предмет всем игрокам при входе на сервер
/primeitems give @a welcome_sword
```

### Через плагины событий

```yaml
# Пример для плагина Events
events:
player_join:
commands:
- "primeitems give {player} starter_kit"
```

## Мониторинг и Отладка

### Команды для отладки

```bash
# Проверить активные эффекты игрока
/primeitems effects PlayerName

# Перезагрузить конфигурацию при изменениях
/primeitems reload

# Посмотреть список всех предметов
/primeitems list
```

### Логи и отладка

```yaml
# В config.yml
debug: true # Включить отладочные сообщения
```

## Важные Замечания

### Безопасность
- Не выдавайте права `primeitems.admin` обычным игрокам
- Используйте `primeitems.give` только для доверенных модераторов
- Регулярно проверяйте активные эффекты игроков

### Производительность
- Ограничивайте количество активных эффектов на игрока
- Используйте `primeitems.reload` только при необходимости
- Мониторьте использование команд через логи

### Совместимость
- Убедитесь, что все игроки имеют права `primeitems.use`
- Проверяйте совместимость с другими плагинами
- Тестируйте команды на тестовом сервере

---

**Всего команд**: 5 основных команд
**Всего прав**: 6 категорий прав
**Совместимость**: LuckPerms, PermissionsEx, GroupManager


# Техническая Документация

## Общая Информация

### Основные Характеристики
- **Название плагина**: PrimeItems
- **Версия**: 1.0.0
- **Автор**: PrimeItems Team
- **Лицензия**: MIT
- **Язык программирования**: Java 8+

### Совместимость

#### Версии Minecraft
- **Минимальная версия**: 1.16.5
- **Максимальная версия**: 1.20.4
- **Рекомендуемая версия**: 1.19.4+

#### API и Платформы
- **Bukkit API**: 1.16.5+
- **Spigot**: 1.16.5+
- **Paper**: 1.16.5+
- **Purpur**: 1.16.5+
- **Tuinity**: 1.16.5+

#### Java
- **Минимальная версия**: Java 8
- **Рекомендуемая версия**: Java 11+
- **Поддерживаемые архитектуры**: x64, ARM64

## Архитектура Плагина

### Основные Компоненты

#### ConfigManager
- **Назначение**: Управление конфигурацией плагина
- **Функции**:
- Загрузка и сохранение конфигурации
- Создание кастомных предметов
- Валидация настроек
- **Файлы**: `config.yml`

#### EffectManager
- **Назначение**: Управление эффектами игроков
- **Функции**:
- Применение и удаление эффектов
- Отслеживание активных эффектов
- Обновление эффектов в реальном времени
- **Интервал обновления**: 20 тиков (1 секунда)

#### EffectType (Enum)
- **Назначение**: Определение всех доступных эффектов
- **Содержит**:
- 70+ кастомных зачарований
- 40+ стандартных эффектов зелий
- 40+ стандартных зачарований