Документация
Всё, что нужно знать до того, как нажать «Добавить бота», и сразу после.
Быстрый старт
- Вход. Панель просит у Discord только
identifyиguilds: кто вы и какими серверами управляете. Ни почты, ни сообщений. - Выбор сервера. После входа открывается «Мои серверы». Панель никогда не открывает «первый попавшийся» сервер — выбор делает человек.
- Приглашение. Ссылка ведёт в тот сервер, который вы выбрали, с правами под включённые модули. Права «Администратор» бот не запрашивает.
- Настройка. Включите модули. Перед изменением панель показывает, что появится и что перестанет работать.
Что дальше
Дальше всё делается либо в панели, либо командами в Discord — это два входа в одно и то же. Полный список команд с параметрами и правами — в справочнике.
Модули и права
Модуль — это «мы этим пользуемся». Выключенный модуль перестаёт выполнять новые операции, слушать события и работать по расписанию, но ничего не удаляет: история дел, журнал, опыт и обращения остаются на месте и вернутся, если модуль включить снова.
Некоторым модулям нужен другой: автомодерация работает поверх модерации, потому что каждое срабатывание фильтра заводит дело. Такие зависимости показываются до подтверждения, а не включаются молча.
Права Discord по модулям
| Модуль | Права | Intents |
|---|---|---|
| Основа | Просмотр каналов, отправка сообщений, встроенные ссылки | — |
| Приветствие | Отправка сообщений, встроенные ссылки, управление ролями | members |
| Модерация | Исключение, баны, тайм-ауты, отправка сообщений | members |
| Автомодерация | Управление сообщениями, тайм-ауты, чтение истории | message_content |
| Журнал сервера | Отправка сообщений, встроенные ссылки, просмотр журнала аудита | members |
| Уровни | Отправка сообщений, управление ролями | — |
| Команды | Отправка сообщений | — |
| Сообщество | Отправка сообщений, встроенные ссылки | — |
| Голосовые комнаты | Управление каналами, перемещение в голосовых | voice_states |
| Поддержка | Сообщения, встроенные ссылки, приватные ветки и их ведение | — |
| Family RP | Сообщения, ссылки, управление ролями и каналами | members, voice_states |
Если права не хватает, модуль не ломается молча: панель называет недостающее право по каждому модулю отдельно, а операция возвращает понятную ошибку вместо половины выполненного действия.
Кто что может
- Настройки сервера — владелец сервера, участник с правом Discord «Администратор» или «Управление сервером».
- Внутри Family RP — ранги и права самой семьи. Администратор сервера не получает доступ к составу и казне только потому, что он администратор.
- Политики команд могут только сузить доступ к встроенной команде. Выдать право, которого у человека нет, политика не может — это отдельная проверка в сервисе.
Две системы прав не смешиваются в обе стороны: ранг в семье не даёт выключить модерацию сервера, а «Управление сервером» не даёт трогать состав и казну.
Приватность и сроки хранения
- Журнал по умолчанию хранит факт, а не переписку. Кто отредактировал сообщение, где и когда — да. Что было написано — нет.
- Текст сообщений сохраняется только после отдельного осознанного включения, с исключениями по каналам и ролям, и живёт по собственному короткому сроку (по умолчанию 7 суток против 30 у самого журнала).
- Личные сообщения не журналируются никогда, ни при каком согласии.
- Токены и секреты, попавшие в текст, вырезаются до записи.
- OAuth-токены Discord не покидают сервер: они не уходят в браузер, не попадают в логи и хранятся зашифрованными отдельным ключом.
- Обращения в поддержку видны их автору и команде поддержки сервера. Публичная доска показывает только то, что команда опубликовала явно, и никогда не раскрывает автора.
Поддержка
На технических серверах модуль поддержки вешает панель с кнопками «Сообщить об ошибке», «Предложить идею», «Задать вопрос» и «Другая обратная связь». Обращение получает номер и приватную ветку; автор видит ответы, команда — внутренние заметки. Файлы и скриншоты добавляются в ветку после создания: модальное окно Discord вложений не принимает.
Обращение может открыть любой участник сервера — семья для этого не нужна. От спама защищают предел открытых обращений и пауза между отправками; обе границы объясняют себя текстом, а не молчанием.
Family RP
Family RP — необязательный вертикальный модуль для семей GTA 5 RP. Внутри у него собственный список из тринадцати модулей: набор, мероприятия, капты, отчёты, активность, казна, склад, транспорт, руководство, ИИ-помощник, голосования, автоматизация.
На одном Discord-сервере может быть одна активная семья. Архивная семья сохраняет все свои данные и не мешает создать новую.
Kizora и модуль Family RP не аффилированы с Majestic RP и не являются официальным продуктом проекта.
Развернуть у себя
Проект разворачивается из исходников: Python 3.11, PostgreSQL 16,
Red-DiscordBot для Discord-части и FastAPI для панели. Порядок,
переменные окружения, systemd-юниты, Docker и nginx описаны в
репозитории — docs/deployment/vps.md.
Настройка приложения в Discord Developer Portal — адреса возврата,
intents и ключ шифрования токенов — в
docs/deployment/discord-app.md.