Связанные роли Discord

Связанные роли Discord

Связанные роли — это функция Discord. Администраторы сервера привязывают правила верификации к роли. Участники самостоятельно принимают эту роль, подключая свой аккаунт TrucklineMP. Discord проверяет правила и выдаёт роль, если они соответствуют требованиям.

Это работает на любом Discord-сервере. Данная функция не ограничивается только VTC.

TrucklineMP предоставляет две проверки, которые могут запрашивать администраторы:

Проверка	Значение
Account linked	У участника есть аккаунт TrucklineMP, подключённый через систему связанных ролей
TrucklineMP staff	Участник является сотрудником платформы TrucklineMP

---

Перед началом

Администраторам сервера

• Право Manage Roles или статус Администратора на сервере.
• Бот TrucklineMP, установленный на вашем сервере. Связанные роли TrucklineMP используют бота в качестве подключения приложения. Бот должен присутствовать на сервере, чтобы пункт TrucklineMP появился при добавлении требования.

Участникам

• Аккаунт TrucklineMP на сайте trucklinemp.com
• Доступ к меню сервера в десктопной версии для выполнения первого подключения (см. Получение роли)

---

Шаг 1: Добавление бота TrucklineMP

1. Откройте TrucklineMP в Discord.
2. Нажмите Add to Server.
3. Выберите ваш сервер и подтвердите предоставление разрешений.
4. Завершите установку.

Бот активирует требования для связанных ролей и слэш-команды, такие как /profile. Само по себе добавление бота не создаёт никаких ролей.

---

Шаг 2: Создание связанной роли (для администраторов)

Связанные роли настраиваются в параметрах самой роли, а не через отдельный мастер настройки.

1. Откройте Server Settings.
2. Перейдите в раздел Roles.
3. Нажмите Create Role или выберите уже существующую роль, доступ к которой вы хотите ограничить.
4. Дайте роли название и, при желании, задайте ей цвет. Нажмите Save Changes.
5. Откройте вкладку Links в верхней части редактора ролей.
6. Нажмите Add requirement.
7. В разделе Apps выберите TrucklineMP.
8. Добавьте нужные вам проверки (например, Account linked равно Yes).
9. Нажмите Save Changes.

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

Примеры ролей

Верифицированный участник

• Название роли: Verified (или на ваш выбор)
• Требование для связи: Account linked = Yes

Только для персонала платформы

• Название роли: TrucklineMP Staff
• Требование для связи: TrucklineMP staff = Yes

Вы можете добавить требования к уже существующей роли вместо создания новой. Откройте нужную роль, перейдите на вкладку Links и добавьте туда требование TrucklineMP.

---

Шаг 3: Ограничение доступа к каналам (необязательно)

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

1. Откройте Channel Settings для нужного канала.
2. Перейдите в раздел Permissions.
3. В разделе Add members or roles добавьте созданную вами связанную роль.
4. Сохраните изменения.

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

---

Получение роли (для участников)

Связанные роли не назначаются автоматически. Даже если у участника уже есть аккаунт TrucklineMP, он должен самостоятельно принять роль внутри сервера.

Вариант А: Через меню сервера

1. Нажмите на название сервера в левом верхнем углу клиента.
2. Выберите пункт Linked Roles.
3. Нажмите на желаемую роль.
4. Ознакомьтесь с отображаемыми требованиями.
5. Нажмите для подключения TrucklineMP.
6. Войдите в свой аккаунт TrucklineMP, если потребуется, а затем подтвердите подключение на экране авторизации Discord.
7. Вернитесь в Discord. Если вы соответствуете требованиям, роль будет вам выдана.

Вариант Б: Через закрытый канал

1. Откройте канал, требующий наличия связанной роли.
2. Следуйте инструкциям на экране для прохождения верификации и получения роли.
3. Завершите процесс подключения TrucklineMP, когда появится соответствующий запрос.

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

---

Как работает подключение TrucklineMP

Когда участник подключается через функцию связанных ролей:

1. Discord открывает страницу авторизации TrucklineMP.
2. Участник входит в аккаунт TrucklineMP (если вход ещё не был выполнен).
3. TrucklineMP отправляет метаданные подключения в Discord (привязка аккаунта, статус персонала и отображаемое имя).
4. Discord сверяет эти данные с требованиями роли во вкладке Links.

Этот процесс независим от раздела Settings → Connections на сайте trucklinemp.com. Та страница предназначена для восстановления аккаунта и привязки профиля. Связанные роли всегда используют внутрисерверный процесс подключения, запускаемый через пункт Linked Roles в меню сервера или через закрытый канал.

Если TrucklineMP сообщает, что аккаунт Discord не совпадает с существующей привязкой на веб-сайте, участник должен использовать один и тот же аккаунт Discord везде или предварительно обновить свои подключения на сайте TrucklineMP.

Статус принадлежности к персоналу считывается из TrucklineMP. При его изменении на веб-сайте Discord может обновить метаданные подключения для участников, которые уже выполнили привязку.

---

Команды бота

При установленном боте доступны следующие слэш-команды:

Команда	Описание
/profile [user]	Просмотр профиля участника на TrucklineMP, если он завершил подключение через связанную роль
/about	Информация о платформе TrucklineMP

Если команда /profile сообщает, что пользователь не привязал свой аккаунт, это означает, что он не завершил процесс самостоятельного получения связанной роли на данном сервере.

Владельцы VTC также могут использовать команды /verify-server и /vtc после прохождения верификации сервера в TrucklineMP. Эти команды никак не связаны с настройкой связанных ролей.

---

Важные детали

• Только самостоятельное получение. Подходящие под требования участники не получают роль до тех пор, пока не запросят её через меню Linked Roles или закрытый канал.
• Индивидуально для серверов. Подключение на одном сервере не предоставляет связанных ролей на другом. У каждого сервера свои собственные роли и требования.
• Видимость для администраторов. Участники, соответствующие требованиям, но не принявшие роль, могут не отображаться в списке участников этой роли до её фактического получения.
• Изменение требований. Если вы отредактируете требования роли во вкладке Links, доступ к закрытым каналам немедленно обновится для участников, переставших соответствовать проверкам.
• ПК для первого получения. В справочных материалах Discord отмечается, что получение роли через закрытый канал в первый раз может потребовать использования десктопного приложения. После этого мобильная версия обычно корректно работает для тех каналов, к которым у вас уже есть доступ.

---

Устранение неполадок

Пункт TrucklineMP не появляется при добавлении требования

• Убедитесь, что бот TrucklineMP установлен на сервере.
• Перезагрузите страницу/окно Server Settings → Roles → Links после установки бота.
• Убедитесь, что у вас есть право Manage Roles или права Администратора.

Участник соответствует требованиям, но не имеет роли

• Он должен запросить роль самостоятельно через название сервера → Linked Roles или через закрытый канал.
• Привязка Discord в разделе Settings → Connections на сайте trucklinemp.com не даёт связанных ролей.

Участник потерял доступ после отключения

• Удаление подключения TrucklineMP аннулирует право на получение связанной роли. Ему необходимо подключиться снова через пункт Linked Roles.

Роль персонала не обновилась

• Попросите участника открыть пункт Linked Roles на сервере и переподключить TrucklineMP, либо подождите, пока Discord обновит метаданные подключения.

---

Рекомендации

• Создайте простую роль Verified с проверкой Account linked перед открытием каналов только для участников.
• Ограничивайте доступ к приватным каналам с помощью этой связанной роли вместо выдачи её вручную.
• Закрепите короткую заметку в канале #rules или #welcome, призывающую участников использовать меню название сервера → Linked Roles.
• Не удаляйте бота TrucklineMP с сервера, чтобы требования к ролям и команда /profile продолжали работать.

---

Связанные руководства

• Подключения — Привязка Discord и других аккаунтов на TrucklineMP
• Верификация Discord для VTC — Необязательно: отобразите Discord-сервер вашей VTC в профиле на TrucklineMP