文档

将成员封禁出服务器。

永久封禁。该成员被移出服务器，在被解封之前无法重新加入。

/ban <用户> [原因] [私信] [可见性]

• 私信在封禁之前发出：一旦被封禁，机器人与该成员不再共处同一服务器，也就无法联系到对方。
• 处罚在调用 Discord 之前先行记录。若封禁失败（身份组层级、缺少权限），记录会被回滚：历史记录中不会留下幽灵处罚。
• 永久封禁会取消由 /tempban 安排的任何自动解封。
• 你不能封禁自己、机器人，也不能封禁最高身份组高于或等于你的成员。

临时封禁一名成员（到期自动解封）

按设定时长封禁。解封由机器人安排，并在到期时执行。

/tempban <用户> <时长> [原因] [私信] [可见性]

• 到期时，机器人会确认这次封禁期间没有被管理员重新施加：如果被重新施加了，它不会解除。
• 期间执行的 /ban 会取消自动解封。

通过 ID 解封用户。

解除封禁。由于此人已不在服务器上，需通过其 Discord ID 指定。

/unban <编号>

• 该 ID 可在开启开发者模式后，从 Discord 的封禁列表（服务器设置 → 封禁）中复制。
• 它是唯一一条默认员工等级为 3 的审核命令。

将成员踢出服务器。

踢出一位成员。他们仍可以凭新的邀请回来。

/kick <用户> [原因] [私信] [可见性]

• 私信在踢出之前发出，原因与 /ban 相同。

临时禁言成员。

Discord 原生的临时禁言：成员仍留在服务器上，但无法再发言、添加反应或在语音中说话。

/timeout <用户> <时长> [原因] [私信] [可见性]

• 最长时长为 28 天：这是 Discord 的限制，不是机器人的。
• 禁言到期后自行解除，无需机器人介入。

警告成员。

一次被记录在案的警告。不施加任何技术性处罚：它是一条痕迹，事后可查。

/warn <用户> [原因] [私信] [可见性]

• 警告和其他条目一样会获得处罚编号：它会出现在 /history 或 /sanction 中，并可用 /unwarn 撤销。

通过代码撤销一条警告

凭编号撤销某一条具体的警告。

/unwarn <代码>

• 撤销并不会让该条目从历史记录中消失：它会被标记为已解除。

查看成员的所有处罚记录。

一位成员的完整档案：所有处罚，从最近到最早。

/history <用户>

• 用消息上的按钮逐页浏览；每个条目都显示其编号、类型、原因和执行者。

通过 ID 显示处罚详情。

某次处罚的详细记录：类型、原因、管理员、日期，以及附加的内部备注。

/sanction <代码>

管理与处罚关联的备注。

附加在某次处罚上的内部备注。它们绝不会展示给相关成员：它们服务于管理员之间的沟通。

• 每次处罚最多 25 条备注。再多，记录就会超出 Discord 消息的最大长度。

删除一定数量的消息。

一次性删除某个频道最近的消息。

/clear <数量>

• Discord 拒绝批量删除超过 14 天的消息：这些会被跳过，机器人会报告实际删除了多少条。
• 日志中该删除操作记在管理员名下，而不是消息作者名下。

设置频道的慢速模式。

为同一成员的两条消息之间设定最短间隔。

/slowmode <seconds> [channel]

• 0 关闭慢速模式。最大值 21600 秒，对应 Discord 允许的 6 小时。

锁定频道（成员无法发送消息）。

取消 @everyone 身份组在该频道发言的权利。消息仍然可读。

/lock [channel] [原因]

解锁先前锁定的频道。

让被锁定的频道重新发声。

/unlock [channel] [原因]

为成员添加或移除身份组。

添加或移除身份组，无需进入服务器设置。

• 机器人只能处理层级低于自身的身份组。
• 你永远无法分配层级高于自己的身份组。而且，如果你是凭员工等级而不是“管理身份组”权限来使用它，带有敏感权限的身份组（管理员、管理身份组、封禁成员等）会被拒绝：豁免不该比它所替代的权限更大。

将所有人从一个语音频道移动到另一个。

一次性移动某个语音频道内的所有成员。

/massmove <来源> <目标> [可见性]

• 适合把大家集合起来办活动，或在不断开任何人的情况下清空一个语音频道。

配置欢迎和告别消息

打开一个交互面板：欢迎消息、告别消息、频道、生成的横幅和配色都在这里设置，无需记住任何子命令。

/welcome

• 文本中可用的变量：{user}, {username}, {displayname}, {tag}, {id}, {server}, {membercount}。
• 告别消息独立于欢迎消息：频道不同，开关也不同。
• 每位新成员到来时都会生成一张横幅，使用为该服务器选定的配色。

设置并自定义服务器日志系统。

日志配置面板：21 种事件，可逐一开关。

• 这些事件分为 5 个类别：消息, 成员, 审核, 语音, 服务器。
• 每个类别都能指向自己的频道：审核在一边，消息在另一边。
• 消息内容从不存入数据库：它只出现在发布的嵌入消息里，仅此而已。
• /logs disable 会清除配置，而不只是暂停它。

设置并自定义工单系统。

工单系统的配置面板：类型、表单、团队、对话记录。

• 最多 25 种工单类型，这是 Discord 下拉菜单的上限。每种都有自己的表情、颜色、欢迎消息和开单表单。
• 关闭时，对话会以 HTML 形式归档到选定的归档频道。

设置网站验证（按钮 + 身份组）。

通过网站验证：成员在 Discord 里点击一个按钮，在 omniaze.com 上完成，回来时获得身份组。

• 隔离身份组是可选的：没有它，验证只是添加一个身份组；有它，验证还会把成员带出等候区。
• 如果面板消息被删除，或改动了措辞，/verify panel 可以重新发布或更新它。

配置用于验证新成员的验证码。

门口的验证：新来者必须完成一道验证码才能拿到身份组。

• 分类是必填的：若成员关闭了私信，机器人会在该分类下创建一个临时验证频道，仅其本人可见，之后删除。
• 默认设置：3 次尝试、5 分钟作答时间，失败则踢出。间隔、尝试次数和处罚方式在控制台中修改。
• 在通过验证之前，成员会留在隔离身份组里：你随时可以手动放行他们。

配置反突袭保护。

检测异常的加入浪潮，并自动作出反应。

• 默认为：10 秒内 8 次加入即触发防护，新来者会被放入隔离。
• 三种可能的反应：仅警报、隔离，或踢出。
• 账号年龄可作为过滤条件（默认 168 小时）：更早创建的账号可以毫发无损地穿过浪潮。此项设置在控制台中完成。

创建可自助领取的身份组按钮。

自助身份组面板：一条消息、若干按钮，每个按钮对应一个身份组。

• 每个服务器最多 25 个面板，每个面板最多 25 个身份组。
• 叠加模式：成员可以随意领取和交还任意身份组。唯一模式：面板中一次只能持有一个身份组，先前的会被自动移除。
• 面板分两步搭建：先用 create 建立消息，然后每个按钮用一次 addrole。

设置临时语音频道（加入即创建）。

按需创建的语音频道：加入触发频道，就会创建一个由该成员拥有的频道。

• 临时频道一空即被删除：不留痕迹，无需清理。
• 其拥有者可以重命名它、限制其访问权限，或限定人数上限。

创建和管理抽奖。

抽奖，到期时自动开奖。

• 可接受的时长：从 10 秒到 28 天。格式自由：30m、2h、1h30m、3d。
• 每个服务器最多 20 场进行中的抽奖，每次开奖最多 20 位中奖者。
• 若首位中奖者始终没有出面，reroll 可以事后重新抽出一位。

管理成员的经验值。

手动调整某位成员的经验，不影响排行榜的其余部分。

• give 和 remove 是相对调整，set 是绝对设定。
• 由此次调整触发的升级，会像平常一样发布公告。

自动发布 Twitch 和 YouTube 开播通知。

管理允许使用管理功能的管理团队身份组。

权限控制的核心：三个员工等级绑定到你服务器上的身份组，并为每条审核命令设定一个最低等级。

• 持有 Discord 原生权限的成员照样通行：员工等级只开放权限，绝不关闭权限。
• /staff manage 打开完整面板；子命令则用于快速操作。
• 一位成员的等级，取自其等级最高的员工身份组。

管理允许控制音乐的 DJ 身份组。

允许控制当前播放的身份组。

• DJ 指的是：服务器所有者、管理员、持有“管理服务器”权限的成员，或持有此处所添加身份组的成员。
• 在没有配置 DJ 身份组时，仅限 DJ 的命令因此只回应上述三类人，并不会因此对所有人开放。
• 员工身份组（/staff）是另一份名单：它们不赋予 DJ 身份。

更改本服务器的机器人语言。

整个服务器的机器人语言：嵌入消息、菜单、错误提示，以及命令的名称和描述。

/语言 <语言>

• 十三种完整语言。更改一秒内生效，无需重启。
• 成员个人的语言不参与其中：这是一项服务器设置。

备份并还原你的服务器结构。

为服务器的结构（身份组、频道、权限）拍下快照，稍后再恢复。

• 每位所有者保留 3 份备份。超出后，用 delete 删掉一份。
• 编号通过私信发送：正是它让恢复成为可能，绝不能流传到频道里。
• 备份不含任何消息：它不是聊天记录。
• 恢复会在当前服务器中重建结构，因此把编号导入别处，就能克隆一个服务器。

列出所有可用命令。

所有可用命令的交互式菜单，按你有权使用的范围筛选。

/help

• 在私信中同样可用。

显示成员的等级和等级卡。

即时生成的等级卡片：等级、已获经验、在服务器排行榜中的名次。

/rank [user]

显示服务器的经验值排行榜。

服务器按经验排列的排行榜，逐页查看。

/leaderboard

显示用户的信息。

一位成员的资料：加入服务器的时间、账号创建时间、身份组、ID。

/userinfo [user]

显示本服务器的信息。

服务器的资料：成员数、频道、身份组、加成等级、创建日期。

/serverinfo

显示用户的头像。

以完整尺寸显示头像，并附下载链接。

/avatar [user]

• 在私信中同样可用。

查看机器人的延迟。

Discord 网关延迟与机器人的响应时间。

/ping

• 在私信中同样可用。

给某人一个拥抱。

一条娱乐命令，不影响任何配置。

/hug <user>

拍打某人（纯属娱乐）。

一条娱乐命令，不影响任何配置。

/slap <user>

播放歌曲或将其加入队列。

发起一次搜索或接收一个链接，并把结果加入队列。

/play <query> [source]

• 你必须已连接到某个语音频道；机器人会到那里与你会合。
• 播放列表链接会一次性加入其中的全部曲目。
• 播放依赖专门的音频基础设施：若它不可用，该命令会如实说明，其余一切不受影响。

跳过当前歌曲。

跳到队列中的下一首。

/skip

暂停当前歌曲。

暂停播放，并保留确切的播放位置。

/pause

• 仅限 DJ：服务器所有者、管理员、持有“管理服务器”权限的成员，或持有由 /dj add 添加的身份组的成员。参见 /dj。

恢复播放。

继续已暂停的播放。

/resume

• 仅限 DJ：服务器所有者、管理员、持有“管理服务器”权限的成员，或持有由 /dj add 添加的身份组的成员。参见 /dj。

停止音乐并清空队列。

停止播放，清空队列并离开语音频道。

/stop

• 仅限 DJ：服务器所有者、管理员、持有“管理服务器”权限的成员，或持有由 /dj add 添加的身份组的成员。参见 /dj。

显示当前队列。

完整的队列，逐页查看，并显示总时长。

/queue

显示正在播放的歌曲。

当前曲目，附进度条。

/nowplaying

设置循环模式。

循环当前曲目、整个队列，或不循环。

/loop <mode>

• 仅限 DJ：服务器所有者、管理员、持有“管理服务器”权限的成员，或持有由 /dj add 添加的身份组的成员。参见 /dj。

更改播放音量。

播放音量，从 1 到 150。

/volume [volume]

• 仅限 DJ：服务器所有者、管理员、持有“管理服务器”权限的成员，或持有由 /dj add 添加的身份组的成员。参见 /dj。
• 超过 100 之后，音质会迅速劣化。

清空队列中所有即将播放的曲目。

清空后续曲目，不打断正在播放的这一首。

/clearqueue

显示当前曲目的歌词。

当前曲目的歌词，在可用时显示。

/lyrics