v2.5.8 发布说明

BotShade 已更新至 v2.5.8。本次发布的重点是 扩展自定义事件。

现在可以在 有消息发布时，以及 有人加入、离开或移动语音频道时 运行自定义事件。同时，事件发送的消息现在可以使用 按钮、选择菜单与 Components V2，点击之后的处理也可以在事件中搭建。

构建器也变得更易用。现在可以在画面顶部 通过标签页在命令与事件之间切换，事件的筛选中 分类与用户也可以从列表中选择 了。

如有任何问题，欢迎通过 支持 随时告知我们。

本文目录：

• 亮点
• 现在可以以消息与语音频道为触发运行事件
• 事件中现在可以使用按钮、选择菜单与 Components V2
• 构建器的改进
• 身份组面板设置画面的改进
• 已修复的缺陷
• 关于兼容性
• 支持与社区

亮点

• 自定义事件新增了 “消息已发送” 触发。
• 自定义事件新增了 “加入了语音频道”“离开了语音频道”“移动了语音频道” 这 3 个触发。
• 自定义事件发送的消息现在可以使用 按钮、选择菜单与 Components V2。
• 事件的条件分支中，现在可以选择 “点击按钮的用户” 作为判定对象。
• 构建器顶部的选择栏中，现在可以 通过标签页在命令与事件之间切换 打开。
• 事件的筛选改为 可逐项展开与折叠的列表，分类与用户现在可以 从列表中选择。
• 修复了 新建的 Bot 中，工单与欢迎消息未在一开始就启用 的缺陷。
• 修复了 单独权限设置中身份组与用户的 ID 在画面上显示为错误值 的缺陷。

现在可以以消息与语音频道为触发运行事件

我们为自定义事件新增了以下 4 个触发。与语音相关的 3 个触发归入新设的 “语音” 分类。

以上触发均支持按频道、分类、身份组、用户与条件表达式进行 筛选。对“移动了语音频道”按频道或分类筛选时，以 移动目标 频道为对象。

在事件中，可以通过变量引用消息、成员与频道的信息。“消息已发送”中可以使用表示发布时间的 {Message.createdAt}，“移动了语音频道”中可以使用表示移动来源的 {Before.mention} 与表示移动目标的 {After.mention}（ID 为 {Before.id} / {After.id}）。

关于“消息已发送”

• Bot 与 Webhook 发布的消息，以及系统消息（加入通知、置顶通知等）不会触发。 Bot 自身发送的消息也不会再次触发事件而形成循环。加入、置顶与助力各自另有专用的触发。
• 如需读取消息正文，需要在 Discord Developer Portal 中为 Bot 启用“Message Content Intent”。 未启用时事件本身仍会运行，但正文将被视为空。
• 服务器内的 所有消息 都会成为触发。建议设置频道等筛选，将运行范围限定在需要的地方。

关于语音频道的触发

• 静音、屏幕共享、切换摄像头等 所在频道不变的操作不会触发。

事件中现在可以使用按钮、选择菜单与 Components V2

自定义事件发送的消息现在可以附加 按钮 与 选择菜单。与命令一样，点击之后的处理也可以在事件中搭建。Components V2 的消息现在也可以从事件发送。

此前在事件中，按钮与选择菜单会被移除、仅发送正文，而 Components V2 的消息则完全不会发送。

以下几点与命令不同，使用前请确认。

• 事件发送的按钮任何人都可以点击。 命令的按钮只有执行命令的人才能操作，而事件中不存在“执行者”。如需限定可点击的人，请在按钮之后紧接着放置 身份组、用户或权限的条件分支。设置画面中也会显示相同的说明。
• 按钮被点击后，点击者将成为处理的主体。 在条件分支中，可以选择新增的 “点击按钮的用户” 作为判定对象。点击之后的处理中，{Command.user} / {Command.channel} / {Command.guild} 指点击者及其所在位置。{Event.user} 等表示事件信息的变量在点击后保持不变。
• 仅点击者可见的消息（ephemeral）仅可在点击之后的处理中使用。 在此之前的位置，将作为普通消息发送到频道。
• 事件发送的按钮约可使用 5 分钟。 指定为“永久”的面板在事件中也会作为 5 分钟的临时按钮发送。
• 从按钮打开的输入表单（模态框）在事件中仍不会显示。
• 等待点击的按钮数量较多时，按钮可能会以 无法点击的状态 发送。此时会在日志中留下提示。

同时，我们将事件构建器中的显示改为 适用于事件的措辞。此前显示为“执行命令的用户”“执行命令的频道”的位置，现在显示为“事件的对象用户”“事件的发生频道”。这仅是显示上的变更，已保存的设置内容不会改变。

构建器的改进

• 现在可以在构建器顶部的选择栏中切换打开命令与事件。 选择栏新增了“命令”“事件”2 个标签页，选择另一种类的项目时会跳转到对应的构建器。存在未保存的更改时，将与以往一样显示确认画面。
• 事件的筛选改为可逐项展开与折叠的列表。 与自定义命令的选项列表形式相同，标题中显示编号与种类。此前需要粘贴 ID 的 分类与用户，现在也可以从列表中选择 指定。已选择的对象会以与其他设置画面相同外观的标签排列。另外，筛选对象以 ID 而非名称显示。
• 从事件构建器的区块列表中移除了“选择”分类。 该分类中没有任何可在事件中使用的区块，始终显示为空。
• 整理了命令与事件构建器中的说明文字。 移除了约 200 处仅是换一种说法复述项目名称的说明与示例，使上限、格式、默认值、注意事项等需要确认的说明更易于阅读。

身份组面板设置画面的改进

关于在 v2.5.7 中新增的 挂载到已有消息，现在可以在设置画面中确认那些不报错却不起作用的条件。

• 挂载到已有消息仅适用于反应式。 方式不是反应式的行会在设置画面中显示警告。
• 从 Bot 面板切换为已有消息时，Bot 之前发送的面板消息不会被自动删除。 该消息的按钮在 Bot 重启后将不再响应，烦请手动删除。设置画面的说明中也已注明这一点。
• 挂载目标必须是 Bot 可以查看的频道中的消息。 在 Bot 无法查看的频道中，Bot 收不到表情反应，因此不会有任何反应。

已修复的缺陷

• 修复了 新建的 Bot 中，工单与欢迎消息未在一开始就启用 的缺陷。在 v2.5.0 中变更新建 Bot 的默认设置时，这 2 项功能未被反映。今后新建的 Bot 将如说明所述，从一开始就启用这些功能。已创建的 Bot 的设置不会改变。 如需使用，请在设置画面中启用。
• 修复了 在单独权限设置中登记的身份组与用户的 ID，在画面上显示为末尾数位不同的值 的缺陷。原因是在画面上处理位数较多的 ID 时，数值被取整了。如果您曾因错误的显示而删除并重新登记设置，烦请确认对象是否正确。

关于兼容性

此前使用的 Bot、命令与自定义事件的定义在 v2.5.8 中仍可照常运行。无需迁移设置。

作为变更点，请确认以下内容。

• 包含按钮、选择菜单或 Components V2 的事件的行为将发生变化。 此前移除按钮与选择菜单、仅发送正文的事件，今后将附带按钮与选择菜单发送。此前未发送的 Components V2 消息也将开始发送。由于事件的按钮 任何人都可以点击，如您有此类事件，请确认点击之后的处理内容。

支持与社区

如有疑问、缺陷反馈或功能建议，欢迎通过以下任一方式与我们联系：

• 支持页面 —— 咨询表单
• status.botshade.com —— 服务运行状态

今后也请多多支持 BotShade。