Wiki / Reference / 文字命令与前缀

文字命令与前缀

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

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

默认情况下,YAWBDB 只响应斜杠命令。如果你的成员更愿意输入 !rank 而不是 /rank,就设置一个前缀,机器人的一部分功能就可以通过普通消息来使用了。

本页是前缀能覆盖什么、不能覆盖什么的完整清单,并且对每一项例外,都说明了为什么无法解除。


⚙️ 设置前缀

面板 → 你的服务器 → 功能,在页面顶部的 文字命令 卡片中设置。

设置在哪里 在服务器本身上,而不是在某个功能上,所以无论自定义命令是否开启,你都能找到它。
接受什么 1 到 5 个字符,不含空格。! ? . - $ ; % 都可以,!!、像 yb 这样的短单词或一个表情符号也可以。
拒绝什么 /(Discord 占用了它)、@、# 和 <(以这些开头的消息是提及或频道链接)、>(会打开引用块)、`(会打开代码块)。
关闭它 清空该字段并保存。文字命令会立即停止。
默认值 空。在你设置之前,你的服务器上不会有任何变化。

更改会立刻传达给机器人,不需要等待,也不需要重启。

单词前缀覆盖的范围比你想的更广。 如果前缀是 yb,每条以这两个字母开头的消息都会被检查。除非后面的内容指向一个真实的命令,否则它仍然保持沉默,但使用标点符号作为前缀是更稳妥的习惯。


✅ 前缀能用的功能

假设前缀是 !:

你自己的自定义命令

输入 等同于
!rules /rules
你在 自定义命令 页面上创建的任何命令 它对应的斜杠版本

简单模式和图模式的自定义命令都可以使用。这是前缀存在的主要原因。

游戏

输入 备注
!hangman 字母仍然从下拉菜单中选择。
!trivia 按钮的工作方式与斜杠命令完全相同。
!rps [choice] [opponent] !rps rock、!rps @someone,或者两者以任意顺序组合。
!love <member> [other] 第二位成员默认为你自己。
!8ball <question> 命令之后的所有内容都是问题。
!bingo start / !bingo stop

等级与统计

输入 备注
!rank [@user]
!leaderboard [page]
!top
!boosters 答复会在 30 秒后被删除,见下文。
!trends <type> messages、members 或 activity。

生日、建议和你自己的审核记录

输入 备注
!birthday set <day> <month> [year] !birthday set 14 7 或 !birthday set 14 July 1990。日为 1 到 31,月为 1 到 12 或其英文名称,年份是可选的。
!birthday get [@user] 默认为你自己。
!birthday next [count] 1 到 25 个即将到来的生日,默认为 10 个。
!birthday remove / !birthday forget 停止在这里公布,或在所有地方删除。
!suggest <suggestion> 命令之后的所有内容都是建议,最多 2000 个字符。
!my-history 你在这个服务器上自己的审核记录。

它们遵循与斜杠版本相同的设置:服务器上必须启用 生日 和 建议 功能,必须设置建议频道,并且生日的修改锁定和冷却时间照常适用。

其他任何内容都只会被当作你的自定义命令来尝试。以前缀开头但没有指向任何命令的消息,完全不会得到任何回应,没有错误,也没有噪音。

如果选项写错了,机器人会回复你本该输入的那一行,例如 Usage: !bingo <start|stop>。


🚫 前缀无法覆盖的功能及原因

机器人的 32 个命令中,有 14 个响应文字命令。 另外 18 个,按它们无法使用的原因分组如下。

Discord 的权限设置决定了谁可以运行这些命令

/ban、/unban、/mute、/unmute、/kick、/warn、/softban、/history、/clear-history、/reason、/info。

这些命令有意保持仅限斜杠。 斜杠命令带有一个由 Discord 本身强制执行的权限要求,服务器还可以在 Server Settings → Integrations → YAWBDB 中,按命令、按身份组、按频道进一步收紧它。文字消息完全不经过这些检查。开放 !ban 就会悄悄地给所有人一个绕过你在 Discord 中设置的限制的办法,所以它不会被开放。

请使用斜杠版本,面板自己的审核页面同样可用。

这些命令会打开弹出窗口,而消息做不到

/form、/wordle play。

Discord 只允许机器人在响应交互(斜杠命令、按钮、菜单)时打开表单。消息不是交互,所以没有表单可以打开。这是 Discord 的限制,而不是 YAWBDB 的设置。

这些命令本意是保持低调

/report、/ticket。

消息会被整个频道的人看到。当着所有人的面举报某人或开启工单,和私下做这些事不是一回事,所以它们保留在可以私密回应的地方。

这些命令需要语音上下文,或者消息无法携带的选项

/voice、/voice-chat、/record、/record-storage。

它们作用于你当前连接的语音频道,有些还会用私密的列表或录音来回应。输入的消息既没有你的语音上下文,也没有这些选项,所以它们在设计上保持仅限斜杠。如果你带着前缀输入其中一个,例如 !voice,机器人会说明原因,并指向斜杠版本,而不是保持沉默。

清单之外的另一个

右键操作「Save Message」同样仅限斜杠:上下文菜单操作在结构上就没有对应的文字版本。


📌 需要预期的两点差异

答复是公开的。 斜杠命令可以私密地回复,只有你能看到。消息回复做不到。当某个命令通常会私密地回应时(!boosters、!birthday、!suggest、!my-history、你设为临时的自定义命令、冷却提示),机器人会在频道里回复,并在 30 秒后删除它的答复。这样能保持频道整洁,但并不会让答复变成秘密。这些私密答复从不会提及任何人,所以用 !birthday next 列出成员不会提醒任何人。你输入的那条消息会留在频道里,所以如果你不想显示出生年份,就不要把它写进去。

命令消息不会获得 XP。 运行命令的消息是命令,而不是聊天,所以不计入等级。它仍然会像其他任何消息一样,受到 Automod 和 Honeypot 的检查。


🔗 另请参阅