SHADOWS STUDIOS
Shadows Studios Bot · 文档

机器人的所有功能,一一说明。

从邀请到最后一个模块:如何设置、需要哪些权限、每个功能做什么,以及所有命令和它们的选项。
01

入门

从邀请到机器人正常运行,只需五分钟。

  1. 1用“添加到 Discord”按钮把机器人加入你的服务器。你需要在该服务器上拥有管理服务器权限。
  2. 2在 bot.shadowsstudios.com 打开控制面板并用 Discord 登录:你会看到你管理的所有服务器。
  3. 3选择机器人与成员交流时使用的语言:第一次打开某个服务器时控制面板会询问,之后可在“设置 → 语言”中更改。共有十种语言,更改立即生效。
  4. 4逐个开启你需要的模块。其余的保持关闭,不会打扰。
  5. 5运行 /admin 诊断:它会检查机器人在每个已设置频道中的权限,并准确告诉你缺少什么。

把机器人的身份组拖到它需要分配或管理的身份组之上(服务器设置 → 身份组)。Discord 从不允许机器人管理比自己更高的身份组。

02

控制面板与 /admin 设置

机器人有两种设置方式,设置内容相同。

  • 控制面板(bot.shadowsstudios.com):功能最全。实时预览、图片上传、等级卡片、自动化和自定义命令都只在这里。
  • Discord 中的 /admin 设置:一个只有你能看到的面板,包含相同的模块,按类别分组。用手机时很方便。
  • 拥有管理员或管理服务器权限的成员,以及你在设置中添加为机器人主管的身份组,都能在控制面板中看到该服务器。每次请求都会在 Discord 上实时检查权限。
  • 放在频道里的面板(验证、自选身份组、工单)从 Discord 发布;控制面板负责修改它们的设置。
  • Game Hub:角色扮演、FiveM、暗黑破坏神 IV 以及之后的游戏都放在同一个可展开菜单里,侧边栏保持整洁。
  • 我的账号:Premium 与付款(可在“管理或取消”中处理订阅)、你的支持请求、你的数据,以及使用 Google Authenticator 的两步验证,用于保护登录和重要操作。
  • 指南与搜索:每个模块都有简短指南,在 Discord 中也可用 /info 指南 查看;顶部的搜索栏能找到任何设置,打错字也没关系。
03

命令的组织方式

Discord 每个服务器最多允许 100 个命令。机器人把自己的所有命令归入 9 个类别,剩下的名额都是你的。

  • /mod 管理 · /rp 角色扮演 · /ticket 支持 · /community 面向成员的一切 · /加密货币 加密货币 · /admin 服务器管理 · /custom 自定义命令 · /info 信息 · /申请 申请与请假。
  • 命令的名称和说明都跟随在控制面板中选择的服务器语言:设为意大利语时所有人看到 /mod avvisa,设为德语时看到 /mod verwarnen。更改语言后命令会重新注册。
  • Discord 把权限应用到类别上;之后每次使用时,机器人会检查具体命令所需的权限。
  • 要设置谁能看到某个类别:服务器设置 → 整合 → Shadows Studios Bot。
04

权限

邀请链接会请求管理员权限,这样每个模块都能立即运行。如果你想少给一些权限,机器人需要一组基础权限,每个模块只添加自己需要的部分。

  • 始终需要:查看频道、发送消息(含子区)、嵌入链接、附加文件、阅读消息历史、添加反应、使用应用命令。
  • 管理、自动审核、安全:管理消息、踢出成员、封禁成员、对成员禁言、查看审计日志。
  • 工单:管理频道、创建私密子区、管理子区。
  • 身份组(自动身份组、验证、自选身份组、等级、派系、Tebex):管理身份组。
  • 临时语音频道与 AFK:连接、说话、移动成员、管理频道。
  • 邀请追踪:管理服务器、创建邀请。服务器日志:查看审计日志。

大多数问题不是故障,而是某个频道缺少权限。/admin 诊断 会帮你找出来,并给出权限的准确名称。

05

工单

带开单表单、认领和聊天记录的私密支持频道。

  1. 1用 /ticket 配置 设置 设定默认分类,并至少创建一种工单类型:每种类型都有自己的分类、工作人员身份组、日志频道、问题和消息。
  2. 2发布带开单按钮的面板:/ticket 配置 面板。
  3. 3成员点击按钮、填写表单,得到一个私密频道 ticket-0001,只有他本人和员工能看到。
  4. 4在工单内:认领、关闭、附带理由关闭、添加或移除成员。
  5. 5关闭时,机器人会保存完整的聊天记录:一个 Discord 风格的网页,发送到日志频道,也可以私信发送。频道会变成 closed-…:在你设定的小时数后删除之前,工作人员都可以重新打开它。
  • 每种工单类型的开单表单最多 5 个问题(短文本、长文本或下拉选择)。
  • 多种工单类型和多个面板(Premium):每种类型都有自己的分类、工作人员、可关闭工单的人、颜色和表单;在控制面板中最多 25 种。
  • 无活动自动关闭、每位成员的未关闭工单上限、黑名单、1 到 5 星评价。
  • 仅限买家的工单:表单会要求填写 Tebex 交易 ID,并在开单前进行核验。
06

管理与自动审核

经典命令,带身份组层级检查,再加上自动过滤。

  • /mod 封禁(也可限时,例如 3d)、/mod 踢出、/mod 禁言、/mod 警告、/mod 清理、/mod 慢速模式、/mod 锁定。
  • 警告可以在一定天数后失效:不再计数,但仍保留在历史记录中(/mod 记录)。
  • 自动审核:违禁词、刷屏、Discord 邀请链接、批量提及、全大写。默认全部关闭,阈值可调。违禁词、邀请和提及由 Discord 自带的 AutoMod 在任何人看到之前拦截,只有作者能看到原因;其他情况由机器人删除消息并私信告知作者。
  • /admin 违禁词 会导入公开的违禁词列表(10 种语言),不会改动你手动添加的词。
  • 拥有管理消息权限的员工默认不受影响,除非你为了测试开启“同样适用于员工”。
07

防突袭、防破坏与全服锁定

三种互相独立的防护,在你开启之前都处于关闭状态。

  • 防突袭:踢出(或仅记录)注册时间低于阈值的账号,并识别成批加入,可选自动锁定。
  • 防破坏:选择要监控的操作(删除或创建频道和身份组、权限更改、封禁、踢出、Webhook、表情、添加机器人、服务器设置),每项都有自己的上限,并设定超限者的处理方式:仅提醒、移除身份组、移除身份组并禁言、踢出或封禁。受信任的身份组和用户永远不会被检查。
  • 全服锁定:/mod 全服锁定 开启 让所有人无法在文字频道发言;/mod 全服锁定 关闭 会把一切精确恢复原状。

防破坏能阻止进一步的损害,但不会撤销已经发生的操作。服务器搭建好后,请用 /admin 备份 创建 备份服务器结构。

08

欢迎、验证与身份组

新成员看到什么,以及如何获得访问权限。

  • 欢迎:在频道和/或私信中发送嵌入消息,支持 {user}、{server}、{membercount},可选的告别消息,以及带头像的图片卡片,可自定义颜色、背景图、标题和名字下方的文字(实时预览)。
  • 验证:一个按钮,点击后给予已验证身份组(并移除可选的“未验证”身份组)。面板:/admin 验证 面板。
  • 自动身份组:成员加入时自动分配的身份组。
  • 自选身份组:最多 20 个面板,可用下拉菜单、按钮或反应,一次选一个或多个身份组。
09

等级、经济与社区

让服务器保持活跃的一切。

  • 等级:通过消息和语音获得经验,身份组奖励,可自定义背景的图形等级卡片(/community 等级 用户)。
  • 经济:金币、每日奖励、工作、身份组商店和小游戏(/community 金币、/community 商店)。
  • 抽奖:可设条件(身份组、等级、账号年龄、邀请数)、额外抽奖次数、定时开始和重新抽取。
  • Discord 原生投票(2 到 10 个选项,最长 32 天)、成员投票的建议、生日、提醒、AFK。
  • 临时语音频道、计数器、精选墙、置顶消息和数数游戏。
10

Game Hub · 角色扮演

为 FiveM、RedM 和 Minecraft 服务器打造。每个部分都有独立开关。

  • 派系与执勤:带身份组的职级,招募/晋升/开除,自动更新的组织架构,执勤时长和每周报告。
  • 角色:角色卡可选审核;当前角色会显示在记录和文件中。
  • 记录:使用游戏货币的罚款、逮捕、备注和账单;用 /rp 记录 案底 查看市民的案底。
  • 活动:报名、名额限制和候补名单;匿名聊天(对成员匿名,对员工从不匿名)。
  • 游戏服务器状态:在线玩家、重启公告和语音频道计数器,使用 /rp 服务器。
11

Game Hub · FiveM

把你的 FiveM(或 RedM)服务器连接到机器人,并在 Discord 中执行它的命令。属于 Premium。

  • 连接:在控制面板 → Game Hub → FiveM 中生成密钥并下载已为你的机器人配置好的 shadows-bridge 资源。支持 ESX、QBCore、Qbox 和独立服务器,无需开放端口。
  • 服务器命令:bridge 会自动读取已注册的命令(控制台、框架、txAdmin 和自定义脚本)及其参数。你可以逐个开启,并选择哪些角色可以使用。
  • 在 Discord 中:/rp fivem 执行 会提示已开启的命令;不带参数时会打开表单,每个参数一个字段(例如 setjob:ID、职业、等级)。/rp fivem 状态 显示服务器是否已连接。
  • 日志:每条命令都会发到所选频道,包含使用者、参数、服务器、日期和结果。

命令以服务器控制台的权限运行:只开启需要的命令。server.cfg 中需要加入 add_ace resource.shadows-bridge command allow 这一行,面板会和密钥一起提供给你复制。

12

Game Hub · Diablo IV

游戏事件、服务器提醒和命令查询。属于高级版。

  • 实时事件:世界首领、地狱狂潮和军团的当前状态、距结束或开始的时间、下次出现、刷新间隔、区域以及已知的首领名称,使用 /community diablo 事件。
  • 提醒:为每个事件选择频道、要提及的身份组以及提前多久提醒(控制面板 → Game Hub → 暗黑破坏神 IV)。每位成员可用 /community diablo 关注 自行开启或关闭该身份组。
  • 构筑:当前赛季深坑排行榜顶端最常用的构筑,可按职业筛选,附层数、用时和通关链接,以及 Mobalytics 链接(/community diablo 构筑)。

事件时间、当前赛季和构筑会通过 Helltides.com 自动更新;在两次更新之间,机器人会自行推算开始、结束和刷新。

13

主播、免费游戏与更新

在你选择的频道中自动发布公告。

  • 主播与社交平台:Twitch、Kick、YouTube、Bluesky、Mastodon、Tumblr 以及 RSS/播客订阅。每个服务器最多 15 个来源。
  • 免费游戏:Epic、Steam、GOG 及其他来源,每款只公告一次。/community 免费游戏 显示当前的免费活动。
  • 游戏更新:每款游戏一个身份组和一个频道,成员自选关注;可从 RSS、Steam 新闻或 GitHub Releases 自动发布。
  • 定期与定时消息:带实时预览的嵌入消息,在你想要的时间发布。
14

加密货币

不离开 Discord 就能查看价格、接收提醒,所有服务器免费使用。

  • /加密货币 价格、/加密货币 图表(从 24 小时到一年)、/加密货币 涨跌榜(前 100 名中当天涨跌最大的币种)以及 /加密货币 换算(在币种和法币之间换算)。
  • 价格提醒通过私信发送(/加密货币 提醒):高于或低于某个价格,或 24 小时涨跌幅达到某个百分比。每条提醒只触发一次,之后暂停,直到你重新开启。
  • 关注列表(/加密货币 关注列表)和偏好:你的计价货币、提醒开关,以及在你选定时间私信发送的每日摘要。这些设置属于你本人,在所有服务器通用。
  • 管理员可以选择服务器的默认货币,并发布一个公开的价格面板,最多 10 种币,每 5 分钟更新一次。

价格来自 Binance 的公开市场数据,仅供参考,不构成投资建议。

15

Tebex

购买核验,按套餐自动发放身份组。

  1. 1在 Tebex 中打开 Servers(Game Server Integration),复制该服务器的 Secret Key。
  2. 2把它粘贴到 /admin 设置 → Tebex(或控制面板)。每个 Discord 服务器都有自己的密钥。
  3. 3把每个套餐 ID 与它应发放的 Discord 身份组对应起来。
  4. 4买家用交易 ID 运行 /ticket 验证购买:如果付款已完成,就会获得身份组。

每笔交易只能兑换一次。已退款和拒付的付款会被拒绝。

16

自动化与自定义命令

在控制面板中创建你自己的规则和命令。

  • 自动化:“发生 X 时,执行 Y”。触发条件:关键词、反应、定时、成员里程碑(等级、邀请数、在服天数)。
  • 每个自动化执行 1 到 5 个动作:发送消息、添加或移除身份组、删除消息、警告、禁言或踢出。
  • 自定义命令:通过 /custom 执行 加上命令名称使用,不占用服务器的命令名额;可设允许的身份组、回复频道和 1 到 5 个动作。每个服务器最多 20 个。
17

服务器备份

身份组、类别、频道和权限的快照。

  • /admin 备份 创建 保存服务器结构;每个服务器保留最近 10 份备份。
  • /admin 备份 恢复 只重建缺少的部分(按名称比对),从不重复创建。
  • 消息不包含在内:Discord 没有提供可靠的方式来保存消息。
  • /admin 清空服务器 会删除所有频道、类别和身份组。只有服务器所有者能运行,且需要多次确认。
18

Free 与 Premium

所有基础功能永久免费。Premium 按服务器开通,按月或按年。

  • Free:欢迎、验证、自动身份组、管理、服务器日志、1 种工单类型和聊天记录、最多 10 个活动嵌入消息、自选身份组、语音频道、计数器、AFK、等级、经济、生日、提醒、免费游戏、统计、加密货币。
  • Premium:每个服务器独立的机器人形象、安全防护、自动审核、多种工单类型、无限嵌入消息、申请与表单、游戏更新、精选墙、置顶消息、数数游戏、完整的 Game Hub(角色扮演、FiveM 和暗黑破坏神 IV)、邀请追踪、投票、建议、抽奖、自动化、自定义命令、主播与社交平台、Tebex 和模板。
  • 开通方式:付款后 Premium 会直接加到所选服务器,或者你会通过私信收到一个密钥,可在控制面板或用 /admin premium 兑换 兑换。
  • 你可以在 Premium 页面把 Premium 转移到你管理的另一个服务器(每 7 天一次)。
  • 到期前 7 天,服务器所有者会收到私信。之后 Premium 模块暂停,但不会删除任何内容;开启自动续订的服务器在等待付款期间有 3 天宽限期。
  • 取消订阅:我的账号 → Premium 与付款 → 管理或取消。Premium 会保留到已付费周期结束;PayPal 付款为一次性付款,不会续订。
19

你的数据

机器人保存了什么,以及如何查看。

  • 设置、等级、金币、工单和历史记录都保存在机器人自己的数据库中,并有自动备份。
  • 在控制面板的我的账号页面,每位用户都能按服务器查看机器人保存的关于自己的数据,并以 JSON 格式下载。
  • 在同一页面,你可以自行删除生日、提醒、AFK 状态、角色卡,以及你的加密货币价格提醒、关注列表和偏好。警告、处罚和角色扮演记录由员工保留。
  • 付款通过 Stripe(银行卡、Apple Pay、Google Pay)或 PayPal 完成:我们永远不会接触到银行卡信息。
  • 机器人不保存任何账单信息:地址、税号、收据和发票都由 Stripe 处理(PayPal 付款由 PayPal 处理)。机器人只记录谁付了款、哪个方案以及为哪个服务器。
  • 两步验证 只保存加密的密钥,恢复码只以指纹形式保存:无法被读回。
  • 机器人更新时,服务器所有者会收到私信;点击消息下方的按钮即可关闭这类通知。
20

全部命令

根据机器人的代码生成,因此始终与机器人一致。名称使用本页面的语言;在 Discord 中则跟随你的服务器语言。每条下方显示英文名称。

/mod管理:封禁、踢出、禁言、警告、清理消息、锁定频道

/mod 封禁

英文名称: /mod ban

永久或限时封禁一名成员

用法
/mod 封禁 <用户> [原因] [删除天数] [时长]
选项
用户必填
要封禁的用户
原因可选
封禁原因
删除天数可选
要删除多少天内的消息(0-7)
时长可选
限时封禁,例如 12h、3d、1d12h(留空 = 永久)
1 / 14

还有问题?

在联系页面给我们留言并选择“机器人支持”:我们会阅读每一条消息。