角色通道
描述
用户指南
发布一条带按钮的消息:点击按钮的成员会获得一个或多个角色,前提是他已经拥有您要求的角色。非常适合在成员完成第一步之后开放某个专属板块的访问权限。
功能介绍
- 在您指定的频道中发布自定义 Embed 及配套按钮。
- 在授予任何角色之前检查必需角色。
- 一键授予要发放的角色,无需工作人员介入。
- 在频道中以私密方式回复(临时消息):无论成功还是拒绝都不会干扰对话。
- 按钮长期有效:机器人重启后仍能正常工作。
本模块不是 AutoRole、Role Gate 或 RoleRoster
有四个模块都与角色相关,但各自分工明确:
| 模块 | 原理 |
|---|---|
| 角色通道 | 一个带条件的按钮:如果您拥有角色 A 和 B,那么就能获得角色 C。 |
| AutoRole | 带下拉菜单的面板,每个人自由选取,也可以取消已选的角色。没有任何条件。 |
| Role Gate | 在加入时自动授予角色、角色互换,以及移除不活跃成员的角色。无需点击。 |
| RoleRoster | 一份名册:显示某个角色的成员列表。不授予任何角色。 |
总结:四者之中只有角色通道会在授予角色之前设置条件。
快速开始(管理员)
- 打开仪表板 → 工具与工作人员分类 → 安全通道。
- 点击新建通道。
- 填写内部名称(不会在 Discord 上显示)并选择部署频道。
- 填写要授予的角色——这是必填项——如有需要还可填写必需角色。
- 自定义 Embed 和按钮,然后保存。
- 在列表中点击发送图标,将面板发布到该频道。
命令
本模块没有任何 Discord 命令:全部配置在仪表板中完成,成员只需使用面板上的按钮。
在仪表板中设置
通道列表会为每个通道显示名称、频道、必需角色和授予的角色,并提供三项操作:发布面板、修改、删除。
配置窗口分为四个区块:
- 基本信息:内部名称(必填)和部署频道(必填)。
- 条件与收益:
- 必需角色——可选。如果留空,所有人都可以点击。
- 要授予的角色——必填,一个或多个角色。
- 外观(Embed):标题、描述和颜色。
- 按钮:显示文本和表情符号(带表情符号选择器)。
非高级服务器的通道数量上限为 1 个(默认值,可由 TennoCore 团队调整)。
须知事项
- 机器人需要管理角色权限,并且它的角色必须位于它要授予的角色之上。否则成员会收到提及角色层级问题的错误消息。
- 必需角色以与(AND)方式校验:成员必须拥有列出的全部角色。若有缺失,机器人会明确告知缺哪些。
- 已经拥有该通道全部角色的成员只会收到一条提示信息,不会产生任何变化。
- 通道永远不会移除角色。若需要切换式(获取 / 交回)的效果,请使用 AutoRole。
- 修改通道不会修改已发布的消息:文本、颜色和按钮文字仍是原来的。请重新发布面板以获得更新后的消息,然后删除旧消息。
- 请勿在服务器中留下同一个通道的多个副本:机器人重启后只有最后一次发布的消息会被重新激活,旧的按钮会失效。
- 在仪表板中删除通道不会删除已发布到 Discord 的消息:按钮仍然可见,但不再起作用。请手动删除该消息。
- 目标频道必须是机器人可以发言的频道;如果该频道在此期间已被删除,发布会失败。
- 角色通道也支持定制机器人:当 TennoCore 不在该服务器上时,按钮由您自己的机器人处理。