EnotPRO Logo EnotPRO

DelFromUserList

DelFromUserList — удаляет пользователя из указанного списка пользователей.

📝 Назначение

Используется для управления динамическими списками пользователей: удаление из чёрного списка после снятия наказания, очистка временных групп по окончании мероприятия и т.д.

Когда это нужно:

  • Снять пользователя с чёрного списка
  • Удалить участника из временной группы после завершения розыгрыша
  • Очистить список от определённых пользователей без полной очистки

💡 Совет: Если пользователя нет в списке, реакция не вызывает ошибку — просто ничего не делает.

⚙️ Параметры

Параметр Тип Обязательный Описание
Список пользователей Выбор из списка ✅ Да Имя списка, из которого нужно удалить пользователя
Пользователь ID или username ✅ Да Идентификатор удаляемого пользователя

📝 Форматы указания пользователя

Формат Пример Примечание
Числовой ID 123456789 Универсальный формат
Username (с @) @username Только для публичных username
Переменная ${user.id} Динамическое получение ID
Несколько через запятую 123456789, @user2, 987654321 Массовое удаление

⚠️ Важно: При массовом удалении идентификаторы разделяются запятой без пробелов или с пробелом после запятой.

🧪 Примеры использования

Пример 1: Удаление одного пользователя

Задача: Удалить пользователя из чёрного списка после снятия бана.

Параметры DelFromUserList:

  • Список пользователей: blacklist
  • Пользователь: ${user.id}

Пример 2: Удаление пользователя по username

Задача: Удалить пользователя из списка участников розыгрыша по команде администратора /remove @username.

Параметры DelFromUserList:

  • Список пользователей: contest_participants
  • Пользователь: @username

Пример 3: Массовое удаление

Задача: Очистить список от нескольких пользователей одним вызовом.

Параметры DelFromUserList:

  • Список пользователей: temp_group
  • Пользователь: 123456789, 987654321, @user3

Пример 4: Удаление через переменную

Задача: Удалить пользователя, ID которого сохранён в переменной.

Параметры DelFromUserList:

  • Список пользователей: winners
  • Пользователь: ${winner_id}

🔄 Особенности поведения

Ситуация Поведение
Список не существует Реакция вызовет ошибку
Пользователя нет в списке Ничего не происходит (ошибки нет)
Неверный формат ID Пользователь не будет удалён
Один из нескольких ID неверный Остальные удаляются, неверный игнорируется

🔗 Связанные реакции

Реакция Назначение
AddToUserList Добавить пользователя в список
LoadUserList Загрузить содержимое списка
ClearUserList Полностью очистить список

🔗 Связанные разделы

Раздел Описание
Списки пользователей Общая информация о списках
Условие InUserList Проверка вхождения в список
© 2025 EnotPRO. Все права защищены.