Connect · Protect · Grow

Бот, который делает ровно то, что вы включили

Kizora — модульный бот для Discord. Приветствие, модерация, автомодерация, журнал событий, уровни, поддержка и настраиваемые команды. Ничего не включается само: сервер получает те модули, которые выбрал администратор, и ни одного лишнего.

  • Без прав «Администратор»
  • Переписка не хранится
  • Открытый исходный код
10
модулей, и каждый включается отдельно
201
команд в справочнике, собранном из кода
2
разрешения Discord у панели: identify и guilds
0
прав «Администратор» — бот их не просит
Кому это

Один бот, две очень разные задачи

Основная часть Kizora рассчитана на любое сообщество. Family RP — отдельная вертикаль для семей GTA 5 RP, которая включается одним переключателем и не мешает остальным.

Для любого сервера

Встретить новичка и выдать роли, вести дела модерации с номерами, ловить приглашения и флуд, писать журнал событий, считать уровни и принимать обращения от участников.

Модули не зависят друг от друга без причины, а когда зависят — автомодерация заводит дело в модерации — панель показывает это до подтверждения, а не включает молча.

Что входит в модули

Family RP для GTA 5 RP

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

На сервере может быть одна активная семья. Архивная сохраняет все свои данные и не мешает создать новую.

Про Family RP
Модули

Выключенный модуль ничего не делает и ничего не удаляет

Он перестаёт выполнять операции, слушать события и работать по расписанию. История дел, журнал, опыт и обращения остаются на месте и возвращаются, если модуль включить снова.

  • ПриветствиеСообщение новичку, прощание, безопасные автороли.
  • МодерацияПредупреждения, тайм-ауты, кики и баны с журналом дел.
  • АвтомодерацияПриглашения, ссылки, слова, флуд, упоминания, капс.
  • Журнал сервераВходы и выходы, роли, ники, каналы. Без текста сообщений.
  • УровниОпыт за сообщения и голосовые, рейтинг, роли за уровень.
  • КомандыПолитики встроенных команд и свои команды сервера.
  • СообществоОбъявления и голосования для всего сервера.
  • Голосовые комнатыВременные приватные комнаты по входу в канал.
  • ПоддержкаПриём багов, идей и вопросов; работа команды по обращениям.
  • Family RPПолная система управления семьёй GTA 5 RP.
  • Права Discord по каждому модулю
Модерация

Каждое действие становится делом с номером

И ручное, и то, которое завёл фильтр. Одна история на участника, одно место, где видно, что с ним уже делали.

  • Действия Предупреждение, тайм-аут, кик, бан и разбан — из панели или командой в Discord.
  • Фильтры Приглашения, ссылки, слова, флуд, массовые упоминания и капс. Срабатывание заводит дело в модерации, а не теряется в логе.
  • Права Не хватает права Discord — панель называет, какого именно и какому модулю. Операция возвращает понятную ошибку вместо половины выполненного действия.
Уровни и сводки

Активность видно, а не приходится угадывать

Опыт за сообщения и за время в голосовых, рейтинг сервера, роли за уровень. Панель показывает то же самое, что команды в Discord, — это два входа в одно состояние, а не две системы.

Команды

Справочник собирается из кода, а не пишется руками

Переименование, не дошедшее до документации, роняет сборку. В справочнике есть поиск, фильтр по области и параметры каждой команды.

Discord · косая черта
  1. модерация предупреждениеВыдать предупреждение с причиной
  2. модерация тайм-аутВременно закрыть участнику возможность писать
  3. модерация делаПоказать журнал дел сервера
  4. уровень рейтингПоказать десятку по опыту
  5. поддержка панельОпубликовать панель приёма обращений
  6. серверПоказать сведения о сервере

Открыть справочник команд

Приватность

Журнал хранит факт, а не переписку

Что именно записывается, кто это видит и сколько оно живёт — описано целиком, а не одной строкой в политике.

  • Текста сообщений в журнале нет Кто отредактировал сообщение, где и когда — да. Что было написано — нет. Текст сохраняется только после отдельного осознанного включения, с исключениями по каналам и ролям, и живёт по своему короткому сроку.
  • Личные сообщения не журналируются никогда Ни при каком согласии и ни при каких настройках.
  • Токены Discord не покидают сервер Они не уходят в браузер, не попадают в логи и хранятся зашифрованными отдельным ключом. Токены и секреты, попавшие в текст, вырезаются до записи.
  • Панель просит два разрешения identify и guilds: кто вы и какими серверами управляете. Ни почты, ни сообщений. Пароль Discord Kizora не видит — вход идёт через Discord OAuth.
С чего начать

Четыре шага от входа до работающего сервера

  1. Войдите через Discord

    Запрашиваются только identify и guilds.

  2. Выберите сервер

    Из списка ваших. Панель никогда не открывает «первый попавшийся» сервер — выбор делает человек.

  3. Пригласите бота

    Ссылка ведёт в тот сервер, который вы выбрали, с правами под включённые модули.

  4. Включите модули

    Перед изменением панель показывает, что появится и что перестанет работать.

Вопросы

Короткие ответы на то, что спрашивают до установки

Нужны ли боту права «Администратор»?

Нет. Ссылка приглашения запрашивает права под те модули, которые включены, и ничего сверх них. Если права не хватает, панель называет недостающее по каждому модулю отдельно.

Что произойдёт, если выключить модуль?

Он перестанет выполнять новые операции, слушать события и работать по расписанию. Ничего не удаляется: история дел, журнал, опыт и обращения остаются и вернутся, если включить модуль снова.

Kizora читает переписку сервера?

Журнал по умолчанию хранит факт, а не текст. Сохранение текста — отдельное осознанное включение с исключениями по каналам и ролям и собственным коротким сроком хранения. Личные сообщения не журналируются никогда.

Обязателен ли модуль Family RP?

Нет. Это отдельная вертикаль для семей GTA 5 RP. Сервер, которому она не нужна, её просто не включает, и на остальные модули это никак не влияет.

Кто может менять настройки?

Владелец сервера и участники с правом Discord «Администратор» или «Управление сервером». Внутри Family RP действуют ранги самой семьи: администратор сервера не получает доступ к составу и казне только потому, что он администратор.

Можно ли развернуть Kizora у себя?

Да. Python 3.11, PostgreSQL 16, Red-DiscordBot для Discord-части и FastAPI для панели. Порядок, переменные окружения, systemd-юниты, Docker и nginx описаны в репозитории.

Добавьте Kizora и включите только нужное

Вход через Discord, выбор сервера, приглашение с правами под включённые модули. Ничего не начнёт работать само.