Wiki / Core Features / 自定义命令

自定义命令

更新者 Maxime_48 · 1小时前 · 浏览量:102

语言: English Français Deutsch Español Português (Brasil) Italiano Nederlands Polski Türkçe Русский 日本語 한국어 中文

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

自定义命令页面:两个命令,一个文本回复和一个嵌入回复,附带冷却时间和身份组限制


⚡ 工作原理

  1. 为你的服务器启用 自定义命令 功能。
  2. 打开专属的 自定义命令 页面。
  3. 点击 新建命令,选一个名称并写好回复。
  4. 保存,命令会自动注册到你的服务器上。

成员过一会儿就可以使用它。每当你添加、编辑或删除命令时,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 本身也限制每个服务器的命令总数,这个总数与机器人的内置命令共用。


👍 推荐设置

  1. 启用该功能并打开自定义命令页面。
  2. 先创建一个简单的 /rules 或 /info 文本命令。
  3. 再添加一个嵌入命令来做更丰富的内容,比如 /socials。
  4. 对仅限工作人员的命令使用 限制身份组。
  5. 给可能被人刷屏的命令加一个小小的冷却时间。

💡 最佳实践

  • 名称要简短、好预测,方便成员猜到。
  • 对只有提问者需要看到的回答,使用临时回复。
  • 给好玩的或容易吵闹的命令加上冷却。
  • 如果只是偶尔需要某个命令,就禁用它而不是删除它。