TopV × Discord

TopV Bot

133 512 Discord members reached
Прежде чем начать

Что нужно

  • Discord-сервер, где у тебя есть право Управление сервером (обычно владелец или админ).
  • Уже созданный профиль сервера TopV — /setup-server если ещё нет.
  • Около 2 минут. Настройка в один проход.
1Установка

Добавить бота в свой Discord

Нажми кнопку. Discord откроет запрос разрешений — прими. Бот появится на сервере с минимумом прав (чтение участников и ролей, отправка сообщений в выбранный канал). Больше ничего.

Discord — Authorize prompt
An external application
TopV wants to access your Discord server
ADD TO SERVER
R
My RP Server
Убедись, что он там
После закрытия окна TopV должен появиться в списке участников справа. Точка зелёная, когда бот онлайн.
Discord — Member list
Welcome to your server. Type / to see commands.
ONLINE — 12
TopVAPP
D
Damien (you)
I
ic3d_
S
speXtrum
2Верификация

Привязать бота к серверу TopV

В любом текстовом канале введи:

/topv-link
Discord — Slash command picker
TopV8 commands
/topv-linkПривязать этот Discord к профилю сервера или создателя TopV
Enter ↵
/topv-link

Discord попросит slug профиля — часть URL после topv.gg/servers/. Например, если профиль topv.gg/servers/saga-rp, введи saga-rp.

Проверка владения
Бот примет привязку только если твой Discord-аккаунт совпадает с тем, что зарегистрировал TopV-профиль. Анти-сквот встроен.
Подтверждение
Запусти /topv-status в любое время, чтобы увидеть статус связи.
Discord — Reply (only visible to you)
TopVAPPToday at 21:42(only visible to you)
Saga RP теперь привязан к 🏠 Server Saga RP

https://topv.gg/servers/saga-rp

Авто-sync каждые 6ч. /topv-sync для немедленного resync.
3Роли

Выбрать роли staff и roliste

Так бот знает, кто в команде, а кто роleplayer. Открой TopV-дашборд:

Открыть дашборд

Перейди на страницу редактирования сервера, прокрути до раздела Discord-роли и отметь нужные роли.

  • Staff роли — админы, модераторы и команда. Появляются с аватаром + бейджем роли, авто-sync.
  • Roliste роли — каждый участник с этой ролью получает свой TopV-профиль (персонаж, проекты, трофеи, отзывы). Навсегда.
TopV Dashboard — Discord roles
⚙️

Discord Roles

2 selected

Pick the Discord roles that represent your staff team and your players (rolistes). Staff will appear on your public profile, and rolistes will automatically get a player profile on TopV.

🛡️I SAST
I LSCSO
EMS
👤I Animateur
🎮I Streamer
👥I Partenaire
Staff
Citoyen
Roleplayer
Staff
Roliste
Resync по запросу
Запусти /topv-sync в любое время. Бот пересканирует участников и обновит профиль + индивидуальные.
4Уведомления

Выбрать канал уведомлений

Реши, куда бот публикует: результаты sync, новые трофеи, отзывы, напоминания Weekly Spotlight. Запусти:

/topv-channel #tvoj-kanal
Discord — Slash command (autocomplete)
/topv-channelchannel:
Text channel
général
staff-only
rolistes
annonces
↑↓navigateselectesccancel
+
/topv-channelchannel:|
Discord — Reply (only visible to you)
TopVAPPToday at 21:42(only visible to you)
✅ Уведомления TopV теперь будут отправляться в #salon-staff

Совет: выбери приватный staff-only канал — большинство сообщений для тебя и команды.

Требуемое разрешение
Убедись, что бот может читать и писать в выбранном канале. Иначе /topv-status покажет ошибку.
5Трофеи RP

Активировать систему трофеев

Этот шаг опционален. Если хочешь, чтобы сообщество вознаграждало RP-моменты:

/topv-trophy-setup
Discord — Bot reply
TopVAPPToday at 21:42
⚙️ Конфигурация трофеев
Выбери канал, где награды трофеев будут публично анонсироваться, затем нажми Подтвердить.\n\n*Чтобы управлять, кто может использовать `/eval`, используй разрешения Discord (Настройки → Интеграции → TopV).*
✅ Подтвердить конфигурацию

Бот спрашивает, какие каналы подходят для /eval и какие роли могут его использовать (обычно staff + старшие rolistes). Защита от злоупотреблений встроена:

  • Кулдаун между двумя /eval от одного автора.
  • Дневной лимит на оценщика (анти-флуд).
  • Гейтинг по ролям — только настроенные роли могут использовать /eval.
  • Полный audit log: каждое очко прослеживается до оценщика и канала.

После активации любой участник с нужной ролью может ввести /eval @player в подходящем канале. Очко учитывается в рейтинге TopV игрока.

Discord — Slash command picker
TopV8 commands
/evalОценить RP этого игрока
Enter ↵
/evaligrok:@Dr Stone
Discord — Bot reply
IppoJinEvoVerse Académie | FAused/eval
TopVAPPToday at 21:42
TopV — Система Трофеев
🏆 Оценка RP
Оцени RP-навыки @Dr Stone, нажав кнопку.\n\nКаждое очко учитывается в прогрессе и рейтинге на TopV.gg
Оценщик: IppoJin · EvoVerse Académie | FA
🎭Fear RP
🎬Когерентность RP
🎪Театр
😰Pain RP
🗣️Improvisation
👑Опора
Справка

Все slash команды

/topv-link

Привязывает этот Discord-сервер к твоему TopV-профилю.

/topv-sync

Принудительный sync staff + rolistes. После смены ролей.

/topv-status

Показывает статус верификации, связанный slug TopV, последний sync.

/topv-channel

Выбери канал для sync, трофеев, отзывов и Weekly Spotlight напоминаний.

/topv-trophy-setup

Настраивает каналы трофеев и допустимые роли для /eval. Опционально.

/eval @player

Даёт очко трофея игроку. Только в настроенных каналах.

/topv-help

Показывает все команды и обзор системы трофеев RP.

/topv-unlink

Удаляет связь между этим сервером и твоим TopV-профилем.

Доверие

Разрешения и приватность

Что бот МОЖЕТ делать

  • Чтение списка участников (Privileged GUILD_MEMBERS intent — одобрено Discord).
  • Чтение назначений ролей (только чтение) — для идентификации staff и rolistes.
  • Отправлять сообщения в канал, заданный /topv-channel.
  • Слушать slash commands в каналах, к которым есть доступ.

Что бот НЕ может

  • Банить, кикать или мутить участников.
  • Создавать, редактировать или удалять каналы.
  • Изменять роли — только чтение.
  • Отправлять DM участникам.
  • Читать содержимое сообщений (без intent MESSAGE_CONTENT).
Помощь

Решение проблем и FAQ

/topv-link говорит 'Не авторизован'

Твой Discord-аккаунт не владелец TopV-профиля. Войди с правильным аккаунтом или передай владение через /dashboard.

Список staff не появляется на профиле

Убедись, что отметил хотя бы одну роль как 'staff' в дашборде, затем запусти /topv-sync. Если пусто, проверь, видит ли бот эти роли.

Профили rolistes не создаются

Та же логика — отметь хотя бы одну роль как 'roliste' в дашборде и запусти /topv-sync. У участников должна быть хотя бы одна из этих ролей. Профили создаются за секунды.

/eval говорит, что канал не подходит

Запусти /topv-trophy-setup снова и добавь текущий канал в список разрешённых. Очки засчитываются только из явно одобренных каналов.

Могу ли я удалить бота позже?

Да, в любое время. Сначала запусти /topv-unlink (чтобы профиль знал, что сервер больше не подключён), затем удали бота. Никакие твои данные не сохраняются помимо записи верификации.

Это что-то стоит?

Нет. Бот бесплатный и таким останется. Никаких связанных upsell. Premium TopV планы существуют (видимость в рейтингах, Weekly Spotlight, и т.д.) но полностью независимы от бота.

Одна команда. Staff верифицирован, игроки в списке, трофеи подсчитаны.