Начало работы

Настройка займёт несколько минут. Нужна учётная запись Discord с правом Управлять сервером на сервере, который будет отслеживать Colossus.

Войти через Discord

На главной странице Colossus нажмите Войти через Discord. Discord попросит разрешения передать, кто вы и на каких серверах состоите. По этому списку Colossus покажет серверы, которые вы можете подключить. Сам вход ничего не добавляет на сервер.

Если вы уже управляете одним сервером в Colossus, сразу откроется его панель. Если серверов нет или их несколько, откроется страница Ваши серверы.

Выбрать сервер

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

Если нужного сервера в списке нет, значит, у вас нет на нём права «Управлять сервером». Получите это право или войдите под учётной записью, у которой оно есть, затем нажмите Обновить список.

Выбрать тариф

На шаге Выберите тариф доступны Free, Pro и Titan. Что входит в каждый из них, сравнивает страница тарифов. Сменить тариф можно в любой момент.

Нажмите Начать бесплатно, чтобы выбрать Free, или Продолжить, чтобы выбрать платный тариф. Free и Pro работают через общего бота Colossus. На Titan работает ваш собственный бот под вашим именем, и для этого нужны два дополнительных шага: подключите своего бота.

Добавить бота на сервер

Нажмите Добавить в Discord. Discord откроется в новой вкладке, и ваш сервер в нём уже будет выбран. Нажмите Продолжить, затем Авторизовать.

Discord запросит такие права:

• Администратор — чтобы Colossus читал все каналы, публиковал сообщения о повышении уровня и выдавал роли за уровни, не запрашивая права заново. Эту галочку можно снять.
• Управлять сервером — чтобы Colossus видел приглашения на сервер и показывал, кто привёл каждого участника.
• Просматривать каналы и Читать историю сообщений — чтобы видеть активность, которую он считает.
• Управлять ветками.

Без последних четырёх прав Colossus работать не может, поэтому они останутся, даже если снять галочку «Администратор». Но без права «Администратор» Colossus не сможет публиковать сообщения о повышении уровня и выдавать роли-награды. Если вы пользуетесь уровнями, выдайте роли Colossus права Управлять ролями, Отправлять сообщения, Встраивать ссылки, Прикреплять файлы и Использовать внешние эмодзи в разделе Настройки сервера → Роли и перетащите её выше ролей, которые бот должен выдавать.

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

Подключить своего бота

На Titan Colossus работает через приложение Discord, которое создаёте вы. Поэтому у бота ваше имя и собственные лимиты запросов.

1. Создайте приложение в Discord Developer Portal и нажмите Приложение создано.
2. На странице Bot этого приложения нажмите Reset Token и скопируйте показанный токен. Вставьте его в поле Токен бота и нажмите Подключить. Colossus хранит токен в зашифрованном виде и больше никогда его не показывает.
3. На той же странице Bot, в блоке Privileged Gateway Intents, включите Server Members, Message Content и Presence. Нажмите Проверить снова, затем Продолжить установку.
4. Добавьте бота на сервер через Discord, как описано в разделе Добавить бота на сервер.

Если на сервере 10 000 участников или больше, Discord после добавления проверяет бота, который использует эти интенты, и даёт 90 дней на ответ.

Оплатить тариф

Если вы выбрали платный тариф, нажмите Перейти к оплате. С общим ботом можно нажать Решить позже и оформить подписку позже в разделе Настройки → Тариф и оплата. Собственный бот остаётся не в сети, пока тариф не оплачен, и начинает записывать данные, как только пройдёт платёж.

Открыть панель управления

Пока Colossus подключает бота, показан шаг Настройка. Обычно это занимает меньше минуты.

На Pro и Titan флажок Импортировать историю сообщений этого сервера уже отмечен. Импорт читает все каналы, ветки и публикации форума, которые видит бот, начиная с новых сообщений. Так графики покажут прошлое сервера, а не начнутся с сегодняшнего дня. Импорт идёт в фоне, остановить его можно в разделе Настройки.

На тарифах с командой здесь же можно выбрать роли или участников, которые тоже смогут открывать панель. Доступ можно изменить и позже — см. Дать доступ команде.

Нажмите Открыть панель. Откроется раздел Главная. Об остальном рассказывает страница Как устроена панель управления.

Уровни есть на всех тарифах, но сначала выключены. Включите их, когда будете готовы, или сначала перейдите с бота уровней, которым пользуетесь сейчас. Подробнее — в разделе Уровни.

Если что-то пошло не так

• Вход отклонён или истёк. Начните заново с главной страницы. Если вы нажали «Отмена» в Discord, ничего передано не было.
• Сервер уже закреплён за другой командой. На этом сервере уже работает Colossus. Тот, кто управляет этой командой, может добавить вас в её настройках.
• Настройка не удалась. Нажмите Повторить на странице настройки или откройте панель и продолжите оттуда.

Не получается? Напишите на contact@dislace.com.