命令

游戏服务器命令和 Saba-chan 自身命令(含斜杠命令)的完整列表,以及注册别名创建个人快捷方式的方法。

游戏服务器命令

基本语法

Saba-chan <服务器> <命令> [参数…]
  • 前缀 默认为 Saba-chan。可以在应用的 Discord 服务器 → 机器人设置 标签页的 命令前缀 中按 Discord 服务器分别修改。默认值随该 Discord 服务器设定的机器人语言(未设置时为 PC 应用语言)而定(韩语 사바쨩、日语 サバちゃん,其他 Saba-chan)。
  • 前缀后面必须跟一个空格。像 Saba-chanx 这样的输入不会被识别为命令。
  • <服务器> 是实例名称、服务器别名,或模块名称及其别名。机器人按 实例名称 → 服务器别名 → 模块别名 的顺序查找。示例:minecraft、mc、마크……
  • 如果同一款游戏运行了多个服务器,模块别名无法确定唯一的服务器,请使用实例名称或服务器别名。
  • <命令> 是每个模块定义的操作。示例:start、시작、say、말……
  • 有些命令不需要指定服务器(全局命令)。见下文 全局命令。

大小写 不敏感。START、Start 和 start 都一样。

机器人按以下顺序解析消息:

  1. 确认前缀 + 空格。
  2. 先检查彩蛋和音乐命令(由 Server-chan 直接处理)。
  3. 其余全部发送到你电脑上的 Saba-chan。它会先检查全局命令(help、list),否则将消息视为 <服务器> <命令>。
  4. 如果 Saba-chan 无法识别输入,且该 Discord 服务器开启了会说话的 Saba-chan,它会将其转换为准确的命令并再尝试一次。

同样的命令也可以作为斜杠命令 /<服务器名称> 使用。在 命令 一栏选择这台服务器上可用的命令,再填写随后出现的 参数 栏。Discord 会显示你的等级可以使用的命令和参数候选项。

全局命令

无需指定服务器即可直接输入的命令。只要等级不是禁止,任何人都可以使用。

命令作用
Saba-chan help / Saba-chan 도움 / Saba-chan 도움말显示用法以及此 Discord 服务器中可用的模块和别名
Saba-chan list / Saba-chan 목록列出机器人可以控制的服务器及其状态
Saba-chan <服务器>显示该服务器可用的命令

可以按 Discord 服务器(节点)限制可见的实例。在受限的服务器中,即使是 list 也只显示允许的实例。在应用的 Discord → Discord 服务器 → 实例 标签页中配置。

所有模块共用的命令

无论模块类型如何,Saba-chan 默认处理的三条命令。

英文作用韩语别名(内置)
start启动服务器시작、실행、켜기
stop停止服务器정지、끝내기、끄기
status当前状态상태、상황、확인

示例:

Saba-chan minecraft start
Saba-chan 마크 시작
Saba-chan palworld stop
Saba-chan 팰월드 상태

各模块的命令(游戏控制台命令)

每个游戏模块在 module.toml 的 [[commands.fields]] 下定义自己的命令,并在 [aliases.commands] 下为其设置别名。这些命令经由你电脑上的 Saba-chan 发送到游戏服务器控制台(stdin);Palworld 使用其 REST API。

命令的风险决定了所需的等级(默认预设:安全 = 访客、注意 = 用户、危险 = 管理员)。执行前是否弹出确认按钮,取决于该 Discord 服务器的确认设置(初始只对危险命令确认,见 Discord 机器人 §5)。

以下整理了四款官方模块游戏的命令。韩语别名是随模块包附带的默认值;用户可以自行添加(见 创建自己的快捷方式)。

Minecraft(模块别名:마인크래프트、마크、mc、minecraft)

命令韩语别名说明风险
say말、채팅、메시지公告安全
give지급、줘、item给予物品危险
save-all저장保存世界安全
save-flush无保存到磁盘安全
save-off无关闭自动保存注意
save-on无开启自动保存安全
list无玩家列表安全
weather날씨、웨더更改天气危险
difficulty난이도、어려움更改难度危险
gamemode겜모드、게임모드更改游戏模式危险
time시간设置时间危险
tp텔레포트、이동传送危险
kick킥、추방踢出玩家危险
ban밴、차단封禁玩家危险
pardon언밴、해제解除封禁危险
op오피指定管理员危险
deop디옵解除管理员危险
whitelist화이트리스트、화리白名单危险
seed无查看种子安全

Palworld(模块别名:팰월드、팔월드、pw、palworld)

命令韩语别名说明风险
announce공지、공지사항、알림公告安全
info정보、인포信息安全
players플레이어、접속자、유저玩家列表注意
metrics无指标安全
settings无查看设置安全
save저장保存世界安全
shutdown종료、셧다운停止危险
kick킥、강퇴、추방踢出玩家危险
ban밴、차단、영구밴封禁玩家危险
unban언밴、차단해제解除封禁危险

Project Zomboid(模块别名:좀보이드、프로젝트 좀보이드、프좀、pz、zomboid、project zomboid)

命令韩语别名说明风险
servermsg공지、공지사항、알림、메시지公告安全
players플레이어、접속자、유저玩家列表安全
save저장、세이브保存世界安全
kick킥、강퇴、추방踢出玩家危险
banuser밴、차단、영구밴封禁玩家危险
unbanuser언밴、차단해제解除封禁危险
adduser유저추가、계정추가添加用户危险
setaccesslevel无设置访问等级危险
teleport无传送注意
teleportto无传送到坐标注意
createhorde无生成尸群危险
godmod无无敌模式危险
invisible无隐身危险
startrain无开始下雨注意
stoprain无停止下雨注意
chopper无直升机事件注意
gunshot无枪声注意
additem无给予物品危险
addxp无给予经验危险
showoptions无查看选项安全
reloadoptions无刷新选项危险
changeoption无更改选项危险
quit종료、셧다운停止危险

Terraria(模块别名:테라리아、테라、terraria)

命令韩语别名说明风险
help无帮助安全
playing접속자、플레이어、목록玩家列表安全
clear无清空控制台安全
save저장保存世界安全
say말、공지、채팅公告安全
version无版本安全
time无游戏时间安全
port无端口安全
maxplayers无最大人数安全
motd无每日消息安全
password无查看密码注意
dawn无黎明注意
noon无正午注意
dusk无黄昏注意
midnight无午夜注意
settle无水体稳定注意
seed无查看种子安全
kick킥、추방踢出玩家危险
ban밴、차단封禁玩家危险
exit-nosave无不保存直接停止危险

自定义模块也是同样的方式。模块开发者按照 模块指南 在 module.toml 中注册命令后,这些命令会自动出现在机器人帮助、斜杠命令和别名系统中。

创建自己的快捷方式

称呼服务器和命令的词按服务器分别设置。在应用的服务器界面 → Discord 标签页中修改,保存后无需重启即可生效。这些称呼属于该服务器,因此在所有已连接的 Discord 服务器中都用同样的词称呼。

称呼服务器的词

在 称呼服务器的词 中添加词语。即使不设置,也可以用服务器名称称呼;如果同一款游戏只有这一个服务器,还可以用游戏名称(例如 마크)和模块别名称呼(界面中显示为 默认:)。

  • 词语为不含空格的 1~32 个字符,每项最多 10 个。
  • 与其他服务器的名称、ID、称呼,模块名称、游戏名称、模块别名,以及 help、도움말、list、목록 等保留词重复时不会保存,界面中会显示原因。

称呼命令的词

在同一界面中为每个命令添加称呼。它们排在模块内置别名之前,原始命令名称始终可用。音乐命令的别名不能在这里修改。

同一款游戏有多个服务器时

如果同一款游戏运行了多个服务器,仅凭游戏名称无法判断是哪个服务器,所以最好为每个服务器设置不同的称呼。

模块包级别的别名(面向模块开发者)

若要把默认的韩语别名内置到你开发的模块中,请在 module.toml 中添加以下内容。别名只能指向 [[commands.fields]] 中定义的命令(或内置的 start/stop/status)。

[aliases]
module_aliases = ["내게임", "ig", "mygame"]

[aliases.commands]
start = { aliases = ["시작", "켜기"], description = "Start the server" }
custom_thing = { aliases = ["뭐시기", "그거"], description = "Do the thing" }

每个别名请保持为不含空格的单个词。聊天命令以空格分词,因此含空格的别名无法使用。完整的模块开发细节请参阅 模块开发指南。

按节点的实例权限

当多个 Discord 服务器(= Server-chan 的节点)连接到同一个 Saba-chan 时,可以限制每个 Discord 服务器能控制哪些实例。

在应用的 Discord → Discord 服务器 → 实例 标签页中选择 仅限选定的实例。它以实例 ID 列表的形式保存在 nodeSettings 中:

{
  "relay": {
    "nodeSettings": {
      "<guildId>": {
        "allowedInstances": ["<实例 ID>", "<实例 ID>"]
      }
    }
  }
}

在受限的 Discord 服务器中,list 命令只显示允许的实例,斜杠命令也只为这些实例创建,列表之外的服务器会被回复为找不到。


Saba-chan 命令

Saba-chan 斜杠命令

这是在 Discord 中输入 / 后出现的 Saba-chan 自身命令。操作游戏服务器的 /<服务器> 命令请参阅上面的 游戏服务器命令。能在哪里使用取决于服务器的连接状态。

如果在 Discord 服务器设置中关闭 saba 前缀,下面的 /saba … 命令会直接展开为 /status、/permission 这样的根命令。服务器管理类命令即使展开,也只对有服务器管理权限的人显示。样式在应用的 Discord 服务器设置(或 CLI bot slash)中按服务器修改。

在已连接的服务器中(/saba …)

命令对象作用
/saba status任何人连接到此服务器的电脑的状态
/saba connect [code]管理服务器权限用应用中获得的配对码连接电脑。代码留空则立即连接此账号下已连接的所有电脑(要使用的服务器在应用中选择)。首次使用的账号需先注册
/saba disconnect连接者・服务器所有者断开此服务器与电脑的连接
/saba permission level [user]连接者选择用户则设置该用户的命令等级,留空则设置服务器默认等级。选择用户时还可以选择 Remove(解除)
/saba sleep连接者让 Saba-chan 在此服务器上休眠(忽略所有消息)
/saba wake连接者唤醒休眠的 Saba-chan
/saba assign kind连接者・服务器所有者将当前频道分配为 会说话的 Saba-chan・音乐・通知・游戏聊天・状态板 之一。在已分配的频道中再次执行则取消
/saba language language连接者Saba-chan 在此服务器上回复所用的语言(Auto = 跟随应用/服务器语言)
/saba big-emoji state连接者・服务器所有者开启或关闭自定义表情放大(默认关闭)
/saba settings连接者此服务器上会说话的 Saba-chan 的设置
/saba reading连接者此服务器上会朗读的 Saba-chan 的音量・语速・音调和称呼名字
/saba web任何人Saba-chan 网页链接(5 分钟,仅能使用一次,仅你自己可见)
/saba update连接者更新已连接电脑上的 Saba-chan
/saba help任何人用法以及此处可用的命令列表

sleep 只在 Saba-chan 清醒时出现在列表中,wake 只在休眠时出现。尚未连接电脑的服务器只会显示 connect・assign・language・settings・reading・web・big-emoji・help,并且由 Discord 服务器所有者或有服务器管理权限的人使用,而不是“连接者”(assign 只能分配会说话的 Saba-chan 和音乐,见 Discord 机器人 §2.5)。

成员右键菜单:右键点击服务器成员 → 应用 → Change Saba-chan level,可以选择该成员的命令等级(仅限已连接电脑的服务器,且只有连接者可用)。

表情符号放大(/settings › Language & commands › Emoji upscale)

开启后,如果有人只发送了一个自定义表情而没有文字,Saba-chan 会删除该消息,并以带有发送者名字和头像的大图重新发布。以回复形式发送的,会回复到同一条消息。只发送两个自定义表情时,会按发送顺序无缝拼接成一张图发布。混有动态表情时会成为一起动的 GIF,长度不同则较短的一方循环(最长 10 秒)。普通表情(😀)和贴纸保持原样。由于需要删除原消息,机器人在该频道必须拥有 管理消息・附加链接 权限,没有的话什么都不会做。

频道功能(/saba assign)

在频道中输入 /saba assign kind:<类型>,该频道就成为对应功能的频道。在同一频道再次输入同一类型则取消(也可以在应用的 Discord 服务器 → 服务器管理 标签页的 Saba-chan 分配 中选择)。通知・游戏聊天・状态板只能在已连接电脑的服务器中分配。一个频道只能有一种类型。

类型频道数作用
会说话的 Saba-chan多个(最多 20 个)Saba-chan 用 AI 理解该频道里的话并回复,会说话的 Saba-chan 只在这些频道中对话
音乐一个无需前缀直接输入音乐命令。普通消息会被删除,请作为音乐专用频道使用(见下文 音乐频道)
通知一个通知服务器崩溃・意外启动、更新、备份结果、计划重启预告。崩溃通知上会带有 重启 按钮
游戏聊天一个将游戏服务器内的聊天转发到该频道。只转发开启了聊天转发的服务器的聊天,与通知频道分开发送
状态板一个为当前已开启的每个服务器放置一张卡片,状态变化时更新

状态板为每个已开启的服务器放置一张卡片。卡片上显示游戏横幅(仅限有横幅的游戏)、服务器名称、开启标记、在线人数、运行时间,如果有多台电脑还会带上电脑名称。只显示对该 Discord 服务器开放的服务器(应用的 实例 标签页);服务器关闭或电脑离线时卡片会被删除。没有已开启的服务器时,会留下一张“没有开放的服务器”卡片。频道主题(语音频道则是频道状态)中也会显示当前已开启的游戏名称(仅在有管理频道权限时)。状态板频道由机器人管理卡片,请作为状态板专用频道使用。机器人重新启动时,会删除该频道里的机器人消息并重新放置卡片。

我的账号命令(/mysaba …)

将 Saba-chan 安装到你的 Discord 账号后(完成连接的回复里会附带安装链接按钮),在任何服务器、任何私信中都可以使用。这些是与我的电脑相关的命令,所以没有放在服务器的 /saba 中,回复仅你自己可见。

命令作用
/mysaba webSaba-chan 网页链接(5 分钟,仅能使用一次)。与 /saba web 相同
/mysaba my-pcs连接到我的账号的电脑列表。改名・删除
/mysaba agent查看・断开连接到我的账号的 AI 代理

在与 Saba-chan 机器人的私信中,使用 /saba status・connect・web・my-pcs・agent・help(作用相同)。

音乐 /music

/music 内容:<歌曲标题・链接,或操作>。在开启音乐的服务器中可用。详细用法见下文 音乐命令。

游戏战绩 /stats

/stats game:<游戏> name:<昵称> [platform:<服务器・平台>]。查询战绩并以摘要卡片显示,在开启了会说话的 Saba-chan 的服务器中还会附上一句话。游戏・平台栏输入文字会出现匹配的候选项(最近用过的游戏排在前面)。

  • 支持的游戏:英雄联盟、云顶之弈、绝地求生、冒险岛、失落的方舟、FC Online、突袭、跑跑卡丁车 Drift、皇室战争、部落冲突、荒野乱斗、堡垒之夜、Apex 英雄、永恒轮回、守望先锋 2、Dota 2、原神、Roblox。每款游戏也可以用别名查找(例如 LOL)。
  • name 栏的格式因游戏而异:英雄联盟・云顶之弈为 名字#标签,守望先锋为 Battletag,原神为 UID,Supercell 游戏为 #标签。
  • 英雄联盟・云顶之弈可以在 name 前加上服务器:KR 名字#标签、[kr] 名字#标签、kr:名字#标签。不加时,会选择与我的 Discord 语言相符的服务器。
  • 如果服务器的 查询结果仅自己可见 设置已开启,回复只有发起查询的人能看到。

会朗读的 Saba-chan /tts

进入语音频道后,在要写字的频道发送 /tts,Saba-chan 就会在我所在的语音频道朗读我在该频道写的文字。再次发送则关闭,我离开语音频道时也会关闭。没有需要填写的栏。

  • 在游戏聊天频道开启时,发到该频道的游戏内聊天也会一并朗读。
  • 读过的文字会被删除(机器人拥有管理消息权限时)。以前缀开头的文字,仅在不是命令时才会朗读。
  • 每条文字最多 100 字,每人每分钟最多 500 字、每小时最多 15000 字。超出的文字会保留,并只通知我自己。
  • 音量・语速・音调以及在文字前加上“某某,”的称呼,通过 /saba reading 或应用的 Discord 服务器 → 会朗读的 Saba-chan 标签页设置。

Discord 服务器管理 /clear /autoclear /mute /lock /slowmode

拥有对应 Discord 权限的人,或在已连接电脑的服务器中 Saba-chan 等级为管理员以上的人可以使用。机器人也必须拥有同样的权限。在应用的 Discord 服务器 → 服务器管理 标签页中也可以做同样的事。

命令所需权限作用
/clear [count] [member] [period]管理消息从最近的开始删除此频道的消息(count 留空则最多 1000 条)。用 member 只删除该成员的消息,用 period(最近 10 分钟~7 天)只删除该时间段的消息。置顶消息和 Saba-chan 面板(播放器・状态板卡片・公告)会保留。超过 14 天的消息一次最多只删除 50 条。结果仅你自己可见
/autoclear keep:<期限>管理消息在此频道中每 15 分钟删除超过保留期限(1 小时・6 小时・12 小时・1 天・3 天・7 天)的消息。用 Off 关闭
/mute member:<成员> duration:<期限> [reason]成员超时用 Discord 超时禁止该成员发言・反应・语音。期限为 10 分钟~28 天,以及 Forever、Unmute(解除)。如果在语音频道中会被移出。原因会记录在审计日志中
/lock [duration]管理频道锁定此频道,使 @everyone 无法发言。duration(10 分钟~1 天)留空则锁定到手动解除,用 Remove 解除。另外获得许可的角色和管理员仍可发言
/slowmode interval:<间隔>管理频道修改此频道的慢速模式(5 秒~6 小时)。用 Off 关闭

静音也可以用前缀命令:Saba-chan mute @成员 1h、Saba-chan mute forever(回复该成员的消息)、Saba-chan unmute。

Saba-chan 运营者专用 /operator

仅限 Saba-chan 运营者使用的命令(page、block、unblock、list)。普通用户看不到。

音乐命令

音乐是云端机器人的功能。音频播放由 Server-chan 旁的官方音乐服务器负责,而不是你的电脑,所以即使电脑关机也能使用。默认开启,可以在应用的 Discord 服务器 → 音乐 标签页中关闭。

模块别名:music 和 dj 在任何语言下都可用;在机器人语言为韩语的 Discord 服务器中,음악、ㄴㄹ 和 ㅇㅇ 也可用。

Saba-chan music <命令> [参数]
Saba-chan dj <命令> [参数]

还有一些便捷的快捷方式:

  • Saba-chan <链接>:无需模块名称,立即播放。YouTube・SoundCloud 的歌曲链接会原样播放;Spotify・Apple Music 的歌曲・专辑・播放列表链接,会根据曲名和歌手在 YouTube 上找到同一首歌来播放(列表取前 100 首,逐首在播放时查找)。SoundCloud 播放列表(/sets/)暂不支持。
  • 如果第一个词是音乐命令,可以省略模块名称,例如 Saba-chan play lofi、Saba-chan skip、Saba-chan pause。例外是 help、도움 和 list,它们会交给全局命令处理,因此音乐帮助请使用 Saba-chan music help。
  • 如果模块后面跟的不是命令,例如 Saba-chan music <搜索词>,会被视为搜索并播放。

斜杠命令 /music 内容:<歌曲标题・链接,或操作>:仅在开启音乐的服务器中存在。输入的文字如果是音乐命令(stop、volume 50 ……)就执行该操作,否则直接播放该文字。栏位为空时,会列出当前播放状态下可用的操作(暂停・继续播放・下一首・停止 ……);输入文字后,在匹配的操作之后会出现“直接播放”和“搜索后选择”。

完整命令列表(英文 / 韩语别名)。韩语别名仅在机器人语言为韩语的 Discord 服务器中被识别。

英文通用别名韩语别名说明
playp재생、ㅈㅅ立即播放第一个搜索结果或链接
searchfind검색、ㄱㅅ从 5 个搜索结果中选择并添加
pause无일시정지、ㅇㅅㅈㅈ暂停
resume无계속、ㄱㅅㄱ继续
skips、next다음、ㄷㅇ下一首
previousprev、back이전上一首
stopleave、disconnect、dc정지、ㅈㅈ停止并离开语音频道
queueq、list대기열、ㄷㄱㅇ显示队列
npnowplaying、now지금、ㅈㄱ正在播放
volume [0~200 | +n | -n]vol、v볼륨、ㅂㄹ显示或调整音量(也支持 +10/-10 这样的相对值)
shufflerandom섞기、ㅅㄱ随机打乱队列
looprepeat반복、ㅂㅂ开启循环(关闭请用 loopoff)
loopoffunloop반복해제、ㅂㅂㅎㅈ关闭循环
radioautoplay라디오、ㄹㄷㅇ用推荐曲目自动填充
normalizenorm、loudnorm정규화、볼륨평탄화、ㅈㄱㅎ切换曲目间的音量标准化
help无도움、ㄷㅇ말音乐帮助

示例:

Saba-chan music play lofi hip hop
Saba-chan dj search ado 우주미아
Saba-chan music volume 50
Saba-chan skip
Saba-chan https://youtu.be/xxxxx

音乐频道

在频道中运行 /saba assign kind:音乐(或在应用的 Discord 服务器 → 服务器管理 标签页的 Saba-chan 分配 中选择),该频道就成为音乐频道。在那里,消息会被直接解释为音乐命令,无需前缀。不是命令的内容会被视为搜索并播放。

play lofi
skip
stop
https://youtu.be/xxxxx

机器人会在音乐频道中显示一个播放器界面,展示当前曲目和队列(可在应用的 音乐 标签页中关闭)。音乐频道中的普通消息会被删除,因此请选择一个专用于音乐的频道。

要播放曲目或从搜索结果中选择,发出命令的用户必须已经在语音频道中。

彩蛋

机器人有一些隐藏的一句话反应,在前缀后输入特定的单个词时就会出现。即使电脑关机也能触发。这里就不剧透了,因为自己去发现才是一半的乐趣。


命令不起作用时的快速检查清单

症状首先检查
机器人没有反应确认前缀(默认 Saba-chan + 空格)。配对必须已完成,应用中的 命令转发 必须开启,且机器人没有处于 /saba sleep 状态。
回复“找不到服务器”顺序是 <服务器> <命令>。如果同一款游戏运行了多个服务器,请使用实例名称或服务器别名。
回复“没有权限”你的等级不足以执行该命令所需的等级。请让节点所有者使用 /saba permission 授予等级。
音乐命令没有反应此 Discord 服务器是否开启了音乐?你是否在语音频道中?是否使用了机器人语言以外语言的别名?
添加了别名却不触发确认已在应用中保存,并且没有与其他模块的别名重复。
仅在某个 Discord 服务器中命令被拦截该实例可能不在该服务器允许的实例(实例 标签页)中。

更深入的诊断请参阅 故障排查,机器人本身的设置请参阅 Discord 机器人 & Server-chan。