Effect Manager — это мощный инструмент для управления эффектами в Minecraft. Он позволяет игрокам с соответствующими правами выдавать себе любые ванильные эффекты, очищать их, а также использовать заранее настроенные наборы эффектов (группы).

Плагин полностью настраивается через веб-интерфейс. Вы можете создавать собственные псевдонимы для эффектов (например, "скорость" для minecraft:speed), формировать уникальные группы для различных игровых ситуаций (PvP, паркур и т.д.), а также устанавливать максимальную длительность и уровень для каждого эффекта, чтобы игроки не могли злоупотреблять командами.

Пример действия

• Игрок вводит команду, чтобы получить эффект силы с максимальными параметрами из конфига:

  @effect give сила
  

• Игрок вводит команду, чтобы получить эффект скорости 2-го уровня на 2 минуты:

  @effect give скорость 120 2
  

• Бот выполняет серверную команду /effect give <ник_игрока> minecraft:speed 120 1 true.

• Бот отвечает в чат (текст и цвета настраиваются):

  &aВыдан эффект &eскорость&a на &b2 минуты&a (ур. &b2&a).

• Игрок хочет получить набор эффектов для PvP:

  @effect pvp
  

• Бот последовательно выдает все эффекты, настроенные в группе "pvp".

Какие команды/функции добавляет

Основная команда: @effect

Подкоманда	Аргументы	Описание	Пример
give	<эффект> [длительность] [уровень]	Выдает указанный эффект. Если длительность и уровень не указаны, используются максимальные значения из конфига.	@effect give сила @effect give скорость 120 2
clear	[эффект]	Очищает эффекты. Если эффект указан, снимает только его. Если нет — снимает все.	@effect clear @effect clear сила
<название_группы>	-	Выдает набор эффектов, настроенных в effect-groups.json.	@effect pvp

Все существующие настройки

Ключ	Тип	Описание
aliases	json_file	Файл effect-aliases.json. Позволяет задавать псевдонимы, максимальную длительность и максимальный уровень для каждого эффекта.
groups	json_file	Файл effect-groups.json. Позволяет создавать наборы эффектов с указанием ID, длительности и уровня.
commandDelay	number	Задержка в миллисекундах между отправкой команд при выдаче группы эффектов. Помогает избежать анти-спам систем сервера.

Настройка сообщений

Здесь вы можете настроить все ответы бота, используя стандартные цветовые коды Minecraft (&a, &e, &c и т.д.).

Ключ	Описание	Переменные
giveSuccess	Успешная выдача эффекта.	{effect}, {duration}, {level}, {formatted_duration}
clearSuccess	Успешная очистка одного эффекта.	{effect}
clearAllSuccess	Успешная очистка всех эффектов.	-
groupStart	Начало выдачи группы эффектов.	{group}
groupSuccess	Успешная выдача группы эффектов.	{group}
errorInvalidSubcommand	Игрок ввел неверную подкоманду.	-
errorMissingEffect	Игрок не указал название эффекта.	-
errorEffectNotFound	Указанный эффект не найден в псевдонимах.	{effect}
errorGroupNotFound	Указанная группа не найдена в конфиге.	{group}
insufficientPermissions	У игрока недостаточно прав.	-

Информация для разработчиков

Права (Permissions)

Плагин автоматически создает и регистрирует следующие права:

• effect.give: Дает доступ к @effect give.
• effect.clear: Дает доступ к @effect clear.
• effect.group.<название_группы>: Динамически создается для каждой группы из файла config/effect-groups.json. Например, для группы pvp будет создано право effect.group.pvp.

Важно: Все права на группы (effect.group.*) автоматически выдаются системной группе Admin.