\[SIZE=3\]\[B\]Основные функции\[/B\]\[/SIZE\]

- \[B\]Активация промокодов\[/B\]: Игроки используют /promo <код> для получения наград.
- \[B\]Гибкая настройка\[/B\]: Промокоды задаются в config.yml с поддержкой любых консольных команд.
- \[B\]Одноразовые и многоразовые промокоды\[/B\]: Контролируйте, сколько раз можно использовать код.
- \[B\]Перезагрузка конфига\[/B\]: /promoreload обновляет настройки без перезапуска сервера.
- \[B\]Помощь для админов\[/B\]: /promohelp показывает команды, права и примеры настройки.
- \[B\]Интеграция с LuckPerms\[/B\]: Полная поддержка прав (svortexpromo.use, svortexpromo.reload, svortexpromo.admin).
- \[B\]Обфускация\[/B\]: Код защищён с помощью maven-shade-plugin.
- \[B\]Совместимость\[/B\]: Работает с Essentials, LuckPerms и другими плагинами.

\[SIZE=3\]\[B\]Команды и права\[/B\]\[/SIZE\]

| Команда | Описание | Право | По умолчанию |
| --- | --- | --- | --- |
| /promo <код> | Активировать промокод | svortexpromo.use | Все |
| /promoreload | Перезагрузить конфиг | svortexpromo.reload | Операторы |
| /promohelp | Показать помощь админам | svortexpromo.admin | Операторы |

\[SIZE=2\]\[B\]Примеры настройки прав (LuckPerms)\[/B\]\[/SIZE\]

- Дать всем доступ к промокодам:

```
/lp group default permission set svortexpromo.use true
```
- Дать админам доступ к перезагрузке и помощи:

```
/lp group admin permission set svortexpromo.reload true
/lp group admin permission set svortexpromo.admin true
```
- Дать игроку все права:

```
/lp user Player478 permission set svortexpromo.* true
```

\[SIZE=3\]\[B\]Установка\[/B\]\[/SIZE\]

1. \[B\]Требования\[/B\]:
- Сервер: Paper 1.17.1.
- Java: 17.
- Опционально: LuckPerms (5.4.36 или новее).
2. \[B\]Установка\[/B\]:
- Скачайте SvortexPromocodes-1.0.jar (\[URL\_ДЛЯ\_СКАЧИВАНИЯ\]).
- Поместите в папку plugins.
- (Рекомендуется) Установите LuckPerms-Bukkit-5.4.36.jar.
- Перезапустите сервер.
3. \[B\]Настройка\[/B\]:
- Отредактируйте config.yml в plugins/SvortexPromo.
- Пример:

```
promocodes:
welcome:
command: "give %player% diamond 1"
single-use: true
used-by: []
bonus:
command: "eco give %player% 100"
single-use: false
used-by: []
```
- Перезагрузите конфиг: /promoreload.

\[SIZE=3\]\[B\]Пример использования\[/B\]\[/SIZE\]

- Игрок вводит /promo welcome → Получает 1 алмаз.
- Админ добавляет промокод в config.yml → /promoreload → Игроки используют новый код.
- Админ выполняет /promohelp → Видит команды и права.
- Сообщайте об ошибках или предлагайте функции в теме форума!
- Тестируйте плагин и делитесь впечатлениями