自定义命令 | Noxyr 文档

什么是自定义命令

自定义命令是 Noxyr 已有命令的新名称。$store 可以运行 $shop，$done 可以运行 $ticket close，$gnitro 可以运行 $giveaway create，并已将奖品预填为 Discord Nitro。成员以“服务器前缀 + 新名称”的消息形式输入，机器人便会运行真正的命令。

它不会添加任何新功能。真正的命令仍按其自身的权限、模块开关和冷却时间运行，因此自定义名称不会让任何人获得原本没有的权限。原来的名称也会与新名称一同继续可用。

创建一个自定义命令

打开仪表盘，选择你的服务器，然后进入“控制”，再进入“自定义命令”。
点击“新建自定义命令”，或打开“模板”并点击某一项，即可直接添加现成的命令。
在“触发词”框中输入新名称，例如 store。
在“命令”框中选择它要运行的命令；如果该命令有多个操作（工单有关闭、认领、重命名等），还需选择相应的操作。
可选：为某个选项连接一个“值”来预设，例如将 prize 设为 Discord Nitro。
停止编辑约一秒后，更改会自动保存。“保存”按钮旁的状态会显示保存的时间。

自定义命令属于前缀命令：它们以 $store 这样的消息形式使用，不在 / 菜单中。Discord 只允许机器人注册它自己的斜杠命令，而不能为每台服务器单独注册。

图形视图与简单列表

此页面提供同一列表的两种视图。图形视图会将每个自定义命令显示为一个连接到“命令”的“触发词”，并将“值”连接到其选项中：将一个圆点拖到另一个圆点上即可连接，点击连线即可剪断，拖动方框标题即可移动方框。“整理”会重新对齐所有内容。

简单列表以普通行的形式显示相同的内容，包括名称、命令选择器和预设值。两种视图任选其一即可，切换视图不会改变任何设置。

左侧面板以“旧名称 → 新名称”的形式列出每个自定义命令。每一项都有开关，可在不删除的情况下暂停某个名称，同时还有删除按钮。

模板

点击一次即可添加一个完成的自定义命令。你已在使用的名称对应的模板会显示为灰色。

音乐: $p（播放）、$np（正在播放）、$s（跳过）、$q（队列）、$dc（离开）、$vol（音量）、$repeat（循环队列）、$bass（低音增强滤镜）、$247（24/7 播放）
工单: $done（工单关闭）、$claim（工单认领）、$faqs（工单 faq-list）
商店: $store（shop）、$vouch（review submit）
社区: $gnitro（giveaway create，奖品为 Discord Nitro）、$apply（application apply）、$lb（leaderboard）
管理: $purge（clear）

预设值与带类型的选项

每次运行自定义命令时都会填入预设值。成员在名称后输入的任何内容都会附加在后面，因此即使奖品已预设，$gnitro 1h 1 依然有效。如果成员通过名称输入相同的选项（prize:“Gift card”），则其输入的值会优先于预设值。

值: 最多 200 个字符，不能包含双引号或换行。
可选项: 带固定列表的选项（例如循环模式或滤镜）只接受该列表中的值。
数字: 整数和数字选项只接受数字；是/否选项可接受 yes、no、on、off、true 和 false。
文件: 文件选项不能预设。

名称规则

字符: 可使用字母、数字、- 和 _，最多 32 个字符。输入时空格会自动变为短横线，且名称会转为小写。
真实命令名称: 自定义命令不能使用 Noxyr 真实命令的名称。真实名称始终优先。
唯一性: 每个名称在每台服务器中只能使用一次。
数量上限: 每台服务器最多 100 个自定义命令。

编辑器上方会列出任何阻止保存的问题。点击某个问题即可跳转到需要修正的输入框。

更改前缀

左侧面板底部的“前缀”输入框会更改整台服务器的前缀，包括自定义命令和所有普通命令。最多输入 5 个不含空格的字符，例如 !、?、. 或 n!，然后点击保存。留空则使用默认前缀 $。页面上的每个名称都会立即更新为新前缀。

同样的设置也可以在“设置”页面中找到，或在 Discord 中使用 /prefix set 进行设置。

自定义机器人

如果服务器运行的是 Noxyr 自定义机器人，它会以相同的前缀响应相同的自定义命令。无需重复设置。