Перейти с другого бота

Переход с другого бота уровней — это три шага: перенести уровни участников, дать участникам попробовать Colossus рядом со старым ботом и переключиться. Всё это делается в разделе История уровней на вкладке Импорт (раздел Настройки). Пока вы не переключитесь, Colossus ничего не объявляет и не меняет роли, так что можно не спешить.

Чтобы запускать импорт уровней, нужно соответствующее право — оно есть в шаблонах «Менеджер» и «Администратор». На просмотр импорта и на проверку заявок участников — отдельные права; см. Дать доступ команде. Переход доступен на любом тарифе.

Перенести уровни

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

Если у бота нет собственного способа с файлом, последним в списке его способов предлагается Загрузить его файл экспорта — файл всё равно можно загрузить.

Что нужно для каждого способа

• Таблица лидеров читается прямо у бота. MEE6 и Lurkr отдают только публичную таблицу лидеров: в панели MEE6 включите «Make my server's leaderboard public», а в панели Lurkr выставьте для таблицы лидеров видимость Public. Kiai отвечает только приложению, которое авторизовал ваш сервер: выполните команду /application authorize, которую покажет диалог, разрешите чтение уровней и запустите чтение. Уровни Tatsu общие для всего Discord, а не для вашего сервера, поэтому вместо них переносятся очки сервера — они засчитываются как XP на вашей кривой. Предложение под выбранным способом показывает, с какого уровня начинается чтение; поднимите этот уровень, чтобы пропустить участников ниже него.
• Сообщения о повышении уровня читаются из истории вашего сервера: уровень каждого участника берётся из последнего сообщения о повышении, которое старый бот о нём опубликовал. Участники, о которых бот ни разу не объявлял или чьё сообщение удалено, будут пропущены. Чтобы читать эти сообщения, Colossus нужен интент Message Content; см. Настройки сервера. Если вы меняли текст сообщения старого бота, введите его в предложение под выбранным способом: {user} — там, где упоминался участник, и {level} — там, где назывался уровень. Для варианта Другой бот укажите Discord ID бота.
• Файл — экспорт в CSV или JSON со столбцом userId и столбцом уровня или XP для каждого участника; данные точны для всех, кто есть в файле. Строки только с XP получают уровень по кривой, выбранной в поле Формула пересчёта XP; сначала там стоит кривая самого бота. Если в файле есть участники выше максимального уровня вашей кривой, сначала поднимите его на странице Получение XP.
• Роли-награды поднимают каждого участника, у которого есть одна из ваших ролей-наград, как минимум до её уровня. Сначала добавьте как награды роли, которые старый бот выдавал на каждом уровне. Этот способ срабатывает сразу, без проверки.
• Участники сами называют уровень — это способ для бота, которого Colossus вообще не может прочитать: каждый участник вводит уровень, который у него был, а вы его одобряете; см. Найти недостающих участников.

Некоторые способы переносят и настройки старого бота: роли-награды, темп, кривую уровней, канал, куда он публиковал повышения уровня, и его сообщение о повышении уровня. Каждая такая настройка ждёт, приглушённая, на своей странице, пока вы её не примените или не отклоните, а в разделе История уровней есть ссылки на них.

Проверить результат перед применением

Чтение таблицы лидеров, сообщений или файла создаёт запуск: он идёт в фоне, а потом ждёт вас в разделе История уровней. Нажмите Проверить, чтобы увидеть, что произойдёт, если его учесть: скольких участников он повысит, понизит или оставит на месте. Список можно отфильтровать: Повышаются, Понижаются, Без изменений, Не появлялись и Ушли. Для каждого участника видно, что сообщал о нём старый бот, его текущий уровень и уровень с этим запуском. Здесь же перечислены роли-награды, которые будут выданы и сняты, если учесть запуск; до переключения ни одна из них не меняется.

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

Участник никогда не окажется ниже того, что Colossus насчитал по его собственной истории на этом сервере. С учтённым запуском он получает большее из двух: то, что сообщил о нём старый бот, плюс всё заработанное здесь после чтения — или то, что даёт его активность здесь. Если один и тот же участник есть в нескольких запусках, учитывается тот, что ставит его выше всего.

Найти недостающих участников

Когда уровни перенесены, блок Перенести пропущенных предлагает способы добрать участников, которых чтение пропустило:

• По ролям-наградам — поднять участников до уровня ролей-наград, которые у них есть, как описано выше.
• Разрешить заявки — участник вводит на вашем сервере команду /заявить-уровень с уровнем, который у него был. Ничего не учитывается, пока вы не проверите заявку: каждая ждёт на странице Заявки на уровень во вкладке Заявки рядом с текущим уровнем участника здесь, а вы нажимаете Одобрить или Отклонить. Сначала сверьтесь со старым ботом — например, вызовите его /ранг для этого участника, пока бот ещё на сервере. У участника может быть только одна ожидающая заявка: новый /заявить-уровень её заменяет. Участники могут подавать заявки, когда вы сохранили настройки и уровни включены — как во время пробного режима. Отключить заявки можно в соответствующей строке раздела История уровней.

Дать участникам попробовать

Два шага перехода появляются в разделе История уровней, когда есть откуда переходить: на сервере есть другой бот уровней или уровни уже перенесены. Там кнопка Начать пробный режим включает уровни в пробном режиме. Участники могут пользоваться /ранг, /лидеры и заявками на уровень рядом со старым ботом, а Colossus продолжает считать, но ничего не объявляет и не меняет роли. Проверьте за это время, что уровни выглядят правильно, и настройте награды; раздел предупредит о ролях-наградах, которые Colossus пока не может выдавать. Если уровни уже работают в полную силу, перед возвратом к пробному режиму Colossus попросит подтверждения: пробный режим останавливает объявления и изменения ролей до переключения.

Переключиться

Когда будете готовы, нажмите Перейти…, затем Перейти сейчас. С этого часа уровнями вместо старого бота занимается Colossus: участники сохраняют свои уровни, о повышениях объявляется, роли-награды выдаются и снимаются. Если какой-то запуск ещё ждёт проверки, учтите его до переключения, чтобы участники начали уже с ним.

Затем выключите уровни у старого бота или удалите его, чтобы участники не получали по два объявления и по два набора ролей. Пока старый бот на сервере, раздел будет об этом напоминать.

Кнопка Отменить переход возвращает всё к состоянию до переключения. XP и уровни участников не меняются, а объявления и роли-награды продолжают работать; если возвращаете уровни старому боту, снова запустите пробный режим.