Быстрый старт
Четыре шага — и бот полностью готов поздравлять:
- Зарегистрируйте свой день рождения:
/birthday register day:15 month:6 - Настройте канал для поздравлений:
/config announcement #канал - Проверьте часовой пояс — по умолчанию
Europe/Moscow(MSK); если нужен другой:/config timezone Europe/Kyiv - Проверьте, что всё работает:
/test-birthday— пришлёт тестовое поздравление, не трогая вашу настоящую дату
Команды /birthday
/birthday register [user] day month [year]
Регистрирует день рождения — своё или, если указать user, чужое
(для этого нужно право Manage Roles). Год указывать
не обязательно.
/birthday update [user] day month [year]
Обновляет уже зарегистрированный день рождения — свой или чужой (с правом Manage Roles).
/birthday remove [user]
Удаляет день рождения — свой или чужой (с правом Manage Roles).
/birthday show [user]
Показывает день рождения — свой или любого другого участника.
/birthday list
Список всех дней рождения на сервере, отсортированный по месяцу и дню.
/birthday next [limit]
Ближайшие дни рождения (по умолчанию — 5, можно указать другое число).
Команды /config
Все команды настройки требуют право Manage Server на сервере.
/config announcement channel
Канал, куда бот публикует поздравления.
/config logs channel
Канал для служебных логов бота.
/config overview channel
Канал с авто-обновляемым списком всех дней рождения сервера — список перерисовывается при любой регистрации/изменении/удалении.
/config announcement-message message
Свой текст поздравления вместо стандартного. Доступны плейсхолдеры
{user} (упоминание именинника) и {ping}
(упоминание ping-роли, если настроена). Чтобы вернуть текст по
умолчанию, отправьте слово сброс.
/config timezone zone
Часовой пояс сервера в формате IANA, например Europe/Moscow
или Europe/Kyiv. По умолчанию — Europe/Moscow (MSK).
/config birthday-role role
Роль, которая выдаётся имениннику на один день.
/config ping-role role
Роль, которая упоминается в поздравлении вместе с именинником.
/config status
Показывает текущую конфигурацию бота на сервере.
Прочие команды
/helpik
Краткая справка по всем командам, прямо в Discord.
/test-birthday
Отправляет тестовое поздравление (требует право Manage Server) — чтобы проверить канал, роль и текст без ожидания настоящего дня рождения и без изменения вашей зарегистрированной даты.
Права, которые нужно выдать боту
При добавлении бота на сервер выдайте:
- View Channels — видеть каналы
- Send Messages — отправлять сообщения
- Embed Links — красивые embed-поздравления
- Read Message History — для overview-канала
- Use Slash Commands — собственно команды
- Mention Everyone — без этого пинг
@everyoneв поздравлении не сработает (сообщение всё равно придёт, но без уведомления) - Manage Roles (опционально) — нужно для роли именинника и для управления чужими днями рождения
Часто задаваемые вопросы
Как зарегистрировать день рождения другому участнику?
Укажите параметр user в /birthday register.
Для этого у вас должно быть право Manage Roles на
сервере.
Как удалить день рождения участника, который покинул сервер?
Включите Режим разработчика в настройках Discord (Настройки →
Расширенные), затем правый клик по участнику → Copy ID.
Полученный ID можно вставить вручную в параметр user
команды /birthday remove, даже если участника больше нет
на сервере.
Почему @everyone не пингует?
У роли бота нет права Mention Everyone на сервере. Сообщение всё равно отправляется, но Discord молча убирает уведомление. Выдайте право — Настройки сервера → Роли → роль бота.
Какой часовой пояс используется по умолчанию?
Europe/Moscow (MSK). Сменить можно командой
/config timezone.