文档
USMAN Bot 使用指南
4 步开始使用
- 添加机器人：点击“添加到 Discord”按钮，将机器人添加到你的服务器。它会自动获得所需权限（Discord 会创建名为“USMAN Bot”的身份组）。你必须在该服务器上拥有“管理服务器”权限。
- 登录面板：使用 Discord 登录，然后在列表中选择你的服务器（只显示机器人所在且你拥有管理权限的服务器）。
- 填写 VRChat 信息：机器人的专用账号和群组 ID（“VRChat”模块）。
- 选择频道和身份组：在菜单中选择后点击“保存”。新设置会在几秒内生效。
面板
侧边栏列出所有模块。你的修改会先保存为草稿，直到点击“保存”（页面底部的栏）。你输入的密码和密钥不会再次显示，仅用标记表示已保存。要切换服务器，请使用侧边栏顶部的选择器。
模块
| 模块 | 功能 |
|---|---|
| 封禁名单 | 机器人会在一个频道中维护一条消息，显示群组的被封禁者，自动更新，并通过表情回应 ⏮️ ⬅️ ➡️ ⏭️ 翻页。临时封禁会显示剩余时间。标题和文字使用服务器语言。可设置每页数量和刷新频率。 |
| 群组日志 | VRChat 群组的每个操作（封禁、身份组、邀请等）都会发布到一个频道。使用机器人命令执行的操作也会记录在这里，并注明操作的 Discord 成员。 |
| 实例 | 群组实例开启时在频道中提醒；也可以在 VRChat 群组发布帖子（标题和内容可自定义，带防刷屏间隔）。 |
| 管理员和成员 | 两个频道，分别显示群组管理员名单和成员名单，并保持更新。 |
| 权限 | 选择哪些 Discord 身份组可以使用 /ban、/tempban、/unban 和 /mod。服务器管理员不会被自动授权：如有需要，请添加他们的身份组。 |
| VRChat | 专用账号、群组 ID（grp_…）、要分配的管理员身份组、可选的 2FA 密钥，以及 VRChat 要求时输入 2FA 验证码。 |
| 数据与隐私 | 导出你的所有数据、删除全部数据，或让机器人退出服务器。 |
Discord 命令
| 命令 | 效果 |
|---|---|
/ban <用户名> [原因] | 将玩家从 VRChat 群组中永久封禁。 |
/tempban <用户名> <时长> [原因] | 临时封禁玩家：时长结束后自动解封。 |
/unban <用户名> | 解封玩家（如有临时封禁则一并取消）。 |
/mod 添加 <用户名> | 授予该 VRChat 玩家群组管理员身份组。 |
/mod 移除 <用户名> | 移除该身份组。 |
/vrchat 状态 | 显示 VRChat 账号的连接状态。 |
/vrchat 身份组 | 列出群组的身份组及其 ID。 |
/vrchat 验证码 <验证码> | 输入 VRChat 要求的 2FA 验证码。 |
/tempban 的时长
时长为数字加单位：s = 秒，m = 分钟，h = 小时，d = 天。示例：30m（30 分钟）、12h（12 小时）、7d（7 天）、1h30m（1 小时 30 分）。最短 10 秒，最长 365 天。解封是自动的，即使期间机器人重启也不受影响。对临时封禁的玩家使用 /ban 会将其变为永久封禁。
命令语言
命令名称、选项和回复会以你的 Discord 应用语言显示（英语、法语、西班牙语或中文，默认英语）。机器人在服务器中的日志和消息使用服务器语言。
这些命令仅限你在“权限”中选择的身份组使用。每个操作都会记录在日志频道中。
VRChat 账号
- 为机器人创建一个专用的 VRChat 账号，并将其加入你的群组，授予具有相应权限的身份组（查看封禁、管理封禁、管理身份组、查看日志等）。否则 VRChat 会返回“You don’t have permission”。
- 群组 ID 形如
grp_xxxxxxxx-xxxx-…（位于 vrchat.com 上群组页面的网址中）。 - 如果该账号使用应用程序两步验证，请将其 TOTP 密钥粘贴到面板中：机器人会自动生成验证码。否则，请在面板提示时输入你收到的验证码。
- 本服务使用 VRChat 非官方 API：过度使用可能会被 VRChat 限制，因此最小时间间隔设有下限。
你的数据
请参阅隐私政策。简而言之：只存储必要的数据，密钥已加密，移除机器人时所有数据都会被删除，并且你可以随时通过“数据与隐私”模块导出或清除数据。
常见问题
我的服务器没有出现在列表中
机器人必须已在该服务器中，并且你必须拥有“管理服务器”权限。请退出后重新登录以刷新列表。
封禁名单中出现“You don’t have permission”
机器人的 VRChat 账号在群组中没有所需的身份组或权限。
命令没有出现
请使用“添加到 Discord”按钮重新邀请机器人（需要 applications.commands 权限范围），然后等待一分钟。
机器人不在某个频道发言
请检查它的身份组是否能查看该频道，并在其中发送消息和嵌入内容。缺少该权限的频道会在菜单中标出。
面板要求输入 2FA 验证码
VRChat 通过邮件或应用发送了验证码：请在“VRChat”模块中输入。
需要帮助？加入我们的 Discord 服务器，或发送邮件至 [email protected]。