Приглашения
Модуль отвечает на вопрос «по чьему приглашению зашёл этот человек» — и честно говорит, когда ответа нет.
Начнём с ограничения
Единственный способ узнать — держать снимок счётчиков всех приглашений и сравнивать его с новым после каждого входа: у какого кода счётчик вырос, тот и сработал.
Отсюда четыре случая, когда ответ неизвестен:
| Случай | Почему так |
|---|---|
| Несколько сразу | Два человека зашли одновременно по разным кодам — какой чей, Discord не сообщает |
| Бот был офлайн | Снимок устарел, сравнивать было не с чем |
| Фирменная ссылка | У vanity-ссылки сервера нет обычного счётчика |
| Нет права у бота | Без права «Управление сервером» бот не видит приглашений вовсе |
Модуль, который в этих случаях назначает пригласившим случайного, портит именно ту статистику, ради которой существует. Поэтому «не знаем» — полноценный ответ, а не пустое поле.
Перед настройкой
- Модуль Приглашения включён.
- У бота есть право Управление сервером — без него модуль не работает вовсе.
- Есть Просмотр журнала аудита, Отправка сообщений, Управление ролями и интент «Участники сервера».
Что показывает
- кто кого привёл;
- сколько человек привёл каждый;
- рейтинг пригласивших, до 50 позиций;
- состояние определения по каждому входу.
Что делать с ушедшими
Настройка на выбор:
| Вариант | Что считает |
|---|---|
| Оставить в счёте | Человек приходил — приглашение засчитано |
| Вычесть | Считаем только тех, кто остался |
Первый вариант проще объяснить, второй честнее отражает пользу.
Награды
За достижение порога можно выдать роль: например, роль «Амбассадор» за 10 приглашённых. Наград — до 25, порог — до 10000.
Роль выдаётся с обычными проверками: Безопасные роли. Если Discord отказал, награда помечается невыданной, а не считается выданной молча.
Отдельно можно добавить участнику ручной бонус к счёту — например, за офлайн-набор.
Это не рефералы Family RP
Рефералы в Family RP считают приглашения внутрь семьи и платят за них очками семьи. Здесь — вход на сервер и счётчики сервера. Общего у них ровно столько же, сколько у слова «пригласил».
Права
- Kizora:
invites.manage— учёт, бонусы и награды. - Discord у бота: Управление сервером (обязательно), Просмотр журнала аудита, Отправка сообщений, Управление ролями.
Частые проблемы
- Все входы «неизвестно». У бота нет права «Управление сервером».
- Пропали данные за период. Бот был недоступен — снимок счётчиков устарел.
- Награда не выдалась. Роль не проходит проверку безопасности или выше роли бота.