自定义命令让你可以为自己的服务器创建专属的斜杠命令。成员运行 /yourcommand,机器人就会回复你定义的消息或嵌入内容,完全不需要写代码。一切都在网页仪表盘里管理。

⚡ 工作原理
- 为你的服务器启用 自定义命令 功能。
- 打开专属的 自定义命令 页面。
- 点击 新建命令,选一个名称并写好回复。
- 保存,命令会自动注册到你的服务器上。
成员过一会儿就可以使用它。每当你添加、编辑或删除命令时,YAWBDB 都会替你重新注册服务器的命令。
更喜欢
!rules而不是/rules? 在 功能 → 文字命令 里设置一个文字前缀,这个页面上的每个命令也会响应它,简单模式和图模式都一样。详情,以及前缀无法覆盖的内容清单,请见:文字命令与前缀。
✍️ 创建命令
每个命令包含:
- 名称:成员在斜杠后输入的内容(
/rules、/socials等)。只能使用小写字母、数字、-和_,最长 32 个字符。 - 描述:Discord 在浏览你的命令时显示的简短文字。
- 命令类型:简单回复(文本或嵌入,能满足大多数需求)或高级图编辑器(可视化的节点编辑器,见下文)。
- 回复类型:对于简单命令,是纯文本消息或丰富的嵌入。
文本回复
直接写下机器人要发送的消息即可。适合快速回答、链接或服务器信息。
嵌入回复
用以下内容构建一张格式化的卡片:
- 标题 和 描述
- 颜色(十六进制,例如
#5865F2) - 图片 和 缩略图(URL)
- 页脚 文字
嵌入至少需要一个标题或一段描述。
🧩 高级模式:命令图
把命令切换到 高级(图编辑器),就可以在与等级奖励图相同的可视化节点编辑器里设计它的行为。你不再使用固定的回复,而是把节点串联起来:
- 触发器:每个图都以一个 命令被使用 触发器开始。每当有成员运行这个命令时它就会触发。
- 条件:拥有身份组 / 不拥有身份组、服务器助力者、时间窗口、星期几、服务器年龄与账号年龄、等级范围、XP 范围、连续天数、声望。
- 逻辑:AND / OR / NOT 门、随机分支、延迟、冷却、顺序。
- 动作:回复(发回的消息,必需)、分配/移除/交换身份组、给予 XP、发送私信、发布到频道、锁定/解锁频道、分配称号、临时 XP 倍率。
回复动作
命令图必须至少包含一个 回复 动作,那是成员会看到的消息。回复支持动态变量:{username}、{level}、{xp}、{streak}、{prestige}、{server}。如果某次运行时条件把所有的回复都过滤掉了,机器人只会用一个 ✓ 确认收到命令。
{prestige} 与 拥有声望 条件自然搭配:根据声望等级决定是否回复,然后在消息中说出这个等级。
你可以在不同的分支上添加多个回复动作,例如给助力者不同的回答,或者在多个回复之间随机选一个。
✨ 让助手来构建
图表助手 可以根据你的描述起草一个命令图,并提出来供你审阅。
ℹ️ 查看卡片在这里能做什么
每张卡片都有一个 (i) 按钮,显示它读取什么、哪个字段会让它什么都不做,以及它上面有效的变量。在命令图里尤其值得打开看看,因为命令携带的信息比等级事件少。
面板会把不可用的内容划掉,这样你一眼就能看出来,而不是在一个永远不会触发的图上才发现。命令知道成员的等级、XP、连续天数、声望、身份组、账号年龄和在服务器的时间,但它不知道这些值之前是多少,也没有 XP 事件或 Wordle 的上下文。因此,围绕变化而构建的卡片,比如 XP 阈值,在这里就没有可比较的对象。
面板的完整说明:奖励图。
创意
/daily:一个冷却节点(24 小时),接到 给予 XP + 回复(“这是你今天的奖励!”)。冷却期间,奖励分支会被跳过,机器人只会用 ✓ 确认。/color:检查一个身份组条件,然后随机分配几种颜色身份组之一,并用一条回复来确认。/vip:仅限助力者的分支,解锁一个频道并私密地回复。
图编辑器需要桌面屏幕,在手机上你只会看到只读的摘要。
⚙️ 选项
| 选项 | 作用 |
|---|---|
| 限制身份组 | 只有拥有所选身份组之一的成员才能使用该命令。留空则允许所有人使用。 |
| 冷却时间 | 每位成员两次使用之间的最短间隔(以秒为单位)。0 表示没有冷却。 |
| 回复仅对该成员可见 | 回复会以私密(临时)方式只显示给运行命令的人。 |
| 已启用 | 无需删除就可以开启或关闭一个命令。 |
🚫 保留名称
自定义命令不能重用机器人内置命令已经使用的名称(比如 rank、leaderboard、report、ticket、wordle、voice 等)。如果名称已被占用,仪表盘会告诉你。
每个命令名称在你的服务器上也必须是唯一的。
📦 限制
根据你的设置,每个服务器的自定义命令数量可能有限制。如果有限制,页面会显示你当前的数量与上限。Discord 本身也限制每个服务器的命令总数,这个总数与机器人的内置命令共用。
👍 推荐设置
- 启用该功能并打开自定义命令页面。
- 先创建一个简单的
/rules或/info文本命令。 - 再添加一个嵌入命令来做更丰富的内容,比如
/socials。 - 对仅限工作人员的命令使用 限制身份组。
- 给可能被人刷屏的命令加一个小小的冷却时间。
💡 最佳实践
- 名称要简短、好预测,方便成员猜到。
- 对只有提问者需要看到的回答,使用临时回复。
- 给好玩的或容易吵闹的命令加上冷却。
- 如果只是偶尔需要某个命令,就禁用它而不是删除它。