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 | Проверка вхождения в список |