TopV × Discord

TopV Bot

添加到我的 Discord查看所有命令 ↓
127 711 Discord members reached
开始之前

你需要什么

  • 一个你拥有以下权限的 Discord 服务器: 管理服务器 (通常是所有者或管理员)。
  • 已创建的 TopV 服务器档案 — /setup-server 如果你还没有的话。
  • 约 2 分钟。设置一次完成。
1安装

将机器人添加到你的 Discord

点击下方按钮。Discord 会打开权限请求 — 接受它。机器人以最低权限加入你的服务器(读取成员和角色,在你选择的频道发送消息)。仅此而已。

添加到我的 Discord
Discord — Authorize prompt
An external application
TopV wants to access your Discord server
ADD TO SERVER
R
My RP Server
确认机器人在那
弹窗关闭后,你应该能在 Discord 右侧的成员列表中看到 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 会询问你的 TopV 服务器档案的 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

每 6 小时自动同步。立即同步运行 /topv-sync。
3角色

选择 staff 和 roliste 角色

这是机器人识别团队成员和角色扮演者的方式。打开你的 TopV 仪表板:

打开仪表板

进入服务器编辑页面,滚动到以下部分: Discord 角色 中,勾选你想要的角色。

  • Staff 角色 — 管理员、版主和团队。带头像 + 角色徽章显示,自动同步。
  • 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
按需重新同步
随时运行 /topv-sync 强制刷新。机器人重新扫描成员并更新你的档案和个人档案。
4通知

选择通知频道

决定机器人发布位置:sync 结果、新奖杯、评论、Weekly Spotlight 提醒。运行:

/topv-channel #your-channel
Discord — Slash command (autocomplete)
/topv-channelchannel:
Text channel
général
staff-only
rolistes
annonces
↑↓navigate↵selectesccancel
+
/topv-channelchannel:|
Discord — Reply (only visible to you)
TopVAPPToday at 21:42(only visible to you)
✅ TopV 通知现在将发送到 #salon-staff

专业提示:选择仅 staff 的私密频道 — 大多数消息是给你和你的团队的。

所需权限
确保机器人能在所选频道读取和发送消息。否则 /topv-status 会显示错误。
5RP 奖杯

激活奖杯系统

此步骤可选。如果你希望社区奖励出色的 RP 时刻:

/topv-trophy-setup
Discord — Bot reply
TopVAPPToday at 21:42
⚙️ 奖杯配置
选择奖杯奖励将公开宣布的频道,然后点击验证。\n\n*要管理谁可以使用 `/eval`,使用 Discord 原生权限(服务器设置 → 集成 → TopV)。*
✅ 验证配置

机器人询问哪些频道适用于 /eval 以及哪些角色可以使用(通常是 staff + 资深 rolistes)。内置反滥用:

  • 同一作者两次 /eval 之间的冷却时间。
  • 每位评估者每日上限(防刷)。
  • 基于角色的门禁 — 只有配置的角色可以使用 /eval。
  • 完整审计日志:每个奖杯点都可追溯到评估者和频道。

激活后,任何拥有正确角色的成员都可以输入 /eval @player 在合适的频道。该点计入玩家的 TopV 排名。

Discord — Slash command picker
TopV8 commands
/eval评估此玩家的 RP
Enter ↵
/evalplayer:@Dr Stone
Discord — Bot reply
IppoJinEvoVerse Académie | FAused/eval
TopVAPPToday at 21:42
TopV — 奖杯系统
🏆 RP 评估
点击下方按钮评估 @Dr Stone 的 RP 技能。\n\n每个点都计入他们在 TopV.gg 的进度和排名
评估者: IppoJin · EvoVerse Académie | FA
🎭Fear RP
🎬RP 连贯性
🎪戏剧
😰Pain RP
🗣️Improvisation
👑支柱
参考

所有斜杠命令

/topv-link

将此 Discord 服务器绑定到你的 TopV 服务器档案。

/topv-sync

强制刷新 staff 和 rolistes 同步。更改角色后使用。

/topv-status

显示当前验证状态、链接的 TopV slug、最后同步日期。

/topv-channel

选择用于 sync、奖杯、评论和 Weekly Spotlight 提醒的频道。

/topv-trophy-setup

配置 /eval 的奖杯频道和合格角色。可选。

/eval @player

向角色扮演者授予一个奖杯点。仅在配置的频道。

/topv-help

显示所有命令以及 RP 奖杯系统的工作原理摘要。

/topv-unlink

删除此服务器与你的 TopV 档案之间的链接。

信任

权限与隐私

机器人能做什么

  • 读取你的成员列表(特权 GUILD_MEMBERS intent — 经 Discord 批准)。
  • 读取角色分配(只读)以识别 staff 和 rolistes。
  • 在 /topv-channel 设置的频道发送消息。
  • 在它有访问权限的任何频道监听斜杠命令。

机器人不能做什么

  • 对任何成员进行封禁、踢出或超时。
  • 创建、编辑或删除频道。
  • 修改任何角色 — 仅读取访问。
  • 向你的成员发送 DM。
  • 读取消息内容(无 MESSAGE_CONTENT intent)。
帮助

故障排除与常见问题

›/topv-link 显示「未授权」

你的 Discord 账户不是目标 TopV 档案的所有者。使用正确账户登录 TopV,或通过 /dashboard 先转移所有权。

›Staff 列表未显示在我的档案上

确保在仪表板中至少标记一个角色为「staff」,然后运行 /topv-sync。如果仍然为空,检查机器人能否看到这些角色。

›Roliste 档案未创建

相同逻辑 — 在仪表板中标记至少一个角色为「roliste」并运行 /topv-sync。成员需要拥有至少一个这些角色。档案在几秒内创建。

›/eval 显示频道不合格

再次运行 /topv-trophy-setup 并将当前频道添加到合格列表。奖杯点仅从你明确批准的频道计入。

›我以后可以卸载机器人吗?

是的,随时可以。先运行 /topv-unlink 断开链接(让你的档案知道服务器不再连接),然后从你的 Discord 踢出机器人。除了验证记录外不会保留你的任何数据。

›需要付费吗?

不需要。机器人是且将保持免费。没有相关的追加销售。Premium TopV 计划存在(排名可见性、Weekly Spotlight 等),但与机器人完全独立。

一条命令。Staff 已验证,玩家已列出,奖杯已计数。

添加到我的 Discord返回首页