コマンド
ゲームサーバーのコマンドとサバちゃん自身のコマンド(スラッシュコマンドを含む)の全一覧と、呼び名を登録して自分専用のショートカットを作る方法。
ゲームサーバーのコマンド
基本の書式
サバちゃん <サーバー> <コマンド> [引数…]
- プレフィックス の既定値は
サバちゃんです。アプリの Discord サーバー → ボット設定 タブの コマンドプレフィックス で、Discord サーバーごとに変更できます。既定値はその Discord サーバーのボット言語(未設定なら PC アプリの言語)に従います(韓国語사바쨩、日本語サバちゃん、その他Saba-chan)。 - プレフィックスの後ろには 必ずスペースが必要 です。
サバちゃんxのような入力はコマンドとして認識されません。 <サーバー>はインスタンス名、サーバーのエイリアス、モジュール名またはそのエイリアスです。ボットは インスタンス名 → サーバーのエイリアス → モジュールのエイリアス の順に検索します。例:minecraft、mc、마크、…- 同じゲームのサーバーを複数動かしている場合、モジュールのエイリアスでは1つに絞れないため、インスタンス名かサーバーのエイリアスを使ってください。
<コマンド>はモジュールごとに定義された操作です。例:start、시작、say、말、…- サーバーを指定せずに使えるコマンド(グローバルコマンド)もあります。下の グローバルコマンド を参照してください。
大文字・小文字 は区別しません。
START、Start、startはすべて同じです。
ボットはメッセージを次の順に解釈します。
- プレフィックス + スペースを確認します。
- イースターエッグとうたうサバちゃんのコマンドを先に確認します(リレー側で直接処理)。
- それ以外はすべて PC のサバちゃんに送ります。サバちゃんはまずグローバルコマンド(
help、list)を確認し、そうでなければメッセージを<サーバー> <コマンド>として扱います。 - サバちゃんが入力を認識できず、その Discord サーバーでおしゃべりサバちゃんがオンになっている場合は、正確なコマンドに変換してもう一度試します。
同じコマンドはスラッシュコマンド
/<サーバー名>としても使えます。command欄でそのサーバーで使えるコマンドを選び、続いて表示されるarg欄を埋めます。Discord が、自分のレベルで使えるコマンドと引数の候補を表示します。
グローバルコマンド
サーバーを指定せずにそのまま入力できるコマンドです。禁止レベルでなければ誰でも使えます。
| コマンド | 動作 |
|---|---|
サバちゃん help / サバちゃん 도움 / サバちゃん 도움말 | 使い方と、この Discord サーバーで使えるモジュールとエイリアスを表示 |
サバちゃん list / サバちゃん 목록 | ボットが操作できるサーバーを状態付きで一覧表示 |
サバちゃん <サーバー> | そのサーバーで使えるコマンドを表示 |
Discord サーバー(ノード)ごとに、表示するインスタンスを制限できます。制限されたサーバーでは、
listでも許可されたインスタンスだけが表示されます。アプリの Discord → Discordサーバー → インスタンス タブで設定します。
すべてのモジュールに共通のコマンド
モジュールの種類に関係なく、サバちゃんが標準で処理する3つのコマンドです。
| 英語 | 動作 | 韓国語のエイリアス(同梱) |
|---|---|---|
start | サーバーを起動 | 시작、실행、켜기 |
stop | サーバーを停止 | 정지、끝내기、끄기 |
status | 現在の状態 | 상태、상황、확인 |
例:
サバちゃん minecraft start
サバちゃん 마크 시작
サバちゃん palworld stop
サバちゃん 팰월드 상태
モジュールごとのコマンド(ゲームのコンソールコマンド)
各ゲームモジュールは、module.toml の [[commands.fields]] に独自のコマンドを定義し、[aliases.commands] でエイリアスを付けます。これらのコマンドは PC のサバちゃんを経由してゲームサーバーのコンソール(stdin)に送られ、Palworld は REST API で処理されます。
リスク によって、コマンドごとに必要なレベルが決まります(既定のプリセット:安全 = ゲスト、注意 = ユーザー、危険 = 管理者)。実行前に確認ボタンを表示するかどうかは、Discord サーバーの聞き返し設定に従います(最初は危険なコマンドのみ。Discord Bot §5)。
公式モジュール4つのゲームのコマンドをまとめます。韓国語のエイリアスはモジュールバンドルに同梱された既定値で、ユーザーが追加できます(自分専用のショートカットを作る を参照)。
Minecraft(モジュールのエイリアス:마인크래프트、마크、mc、minecraft)
| コマンド | 韓国語のエイリアス | 説明 | リスク |
|---|---|---|---|
say | 말、채팅、메시지 | お知らせ | 安全 |
give | 지급、줘、item | アイテムを渡す | 危険 |
save-all | 저장 | ワールドを保存 | 安全 |
save-flush | なし | ディスクに保存 | 安全 |
save-off | なし | 自動保存をオフにする | 注意 |
save-on | なし | 自動保存をオンにする | 安全 |
list | なし | プレイヤー一覧 | 安全 |
weather | 날씨、웨더 | 天候を変更 | 危険 |
difficulty | 난이도、어려움 | 難易度を変更 | 危険 |
gamemode | 겜모드、게임모드 | ゲームモードを変更 | 危険 |
time | 시간 | 時刻を設定 | 危険 |
tp | 텔레포트、이동 | テレポート | 危険 |
kick | 킥、추방 | プレイヤーをキック | 危険 |
ban | 밴、차단 | プレイヤーを BAN | 危険 |
pardon | 언밴、해제 | BAN 解除 | 危険 |
op | 오피 | オペレーターに指定 | 危険 |
deop | 디옵 | オペレーターを解除 | 危険 |
whitelist | 화이트리스트、화리 | ホワイトリスト | 危険 |
seed | なし | シード値を確認 | 安全 |
Palworld(モジュールのエイリアス:팰월드、팔월드、pw、palworld)
| コマンド | 韓国語のエイリアス | 説明 | リスク |
|---|---|---|---|
announce | 공지、공지사항、알림 | お知らせ | 安全 |
info | 정보、인포 | 情報 | 安全 |
players | 플레이어、접속자、유저 | プレイヤー一覧 | 注意 |
metrics | なし | メトリクス | 安全 |
settings | なし | 設定を表示 | 安全 |
save | 저장 | ワールドを保存 | 安全 |
shutdown | 종료、셧다운 | 停止 | 危険 |
kick | 킥、강퇴、추방 | プレイヤーをキック | 危険 |
ban | 밴、차단、영구밴 | プレイヤーを BAN | 危険 |
unban | 언밴、차단해제 | BAN 解除 | 危険 |
Project Zomboid(モジュールのエイリアス:좀보이드、프로젝트 좀보이드、프좀、pz、zomboid、project zomboid)
| コマンド | 韓国語のエイリアス | 説明 | リスク |
|---|---|---|---|
servermsg | 공지、공지사항、알림、메시지 | お知らせ | 安全 |
players | 플레이어、접속자、유저 | プレイヤー一覧 | 安全 |
save | 저장、세이브 | ワールドを保存 | 安全 |
kick | 킥、강퇴、추방 | プレイヤーをキック | 危険 |
banuser | 밴、차단、영구밴 | プレイヤーを BAN | 危険 |
unbanuser | 언밴、차단해제 | BAN 解除 | 危険 |
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 | 밴、차단 | プレイヤーを BAN | 危険 |
exit-nosave | なし | 保存せずに停止 | 危険 |
自作のモジュールも同じ仕組みです。モジュール開発者が モジュールガイド のとおり
module.tomlにコマンドを登録すれば、ボットのヘルプ、スラッシュコマンド、エイリアスに自動で反映されます。
自分専用のショートカットを作る
サーバーとコマンドの呼び名は、サーバーごとに決めます。アプリのサーバー画面 → Discord タブで変更し、保存すると再起動なしで反映されます。呼び名はサーバーに紐付いているので、接続したすべての Discord サーバーで同じ呼び名が使えます。
サーバーの呼び名
サーバーの呼び名 に単語を追加します。決めなくてもサーバー名で呼べ、同じゲームのサーバーがそのサーバー1つだけなら、ゲーム名(例:마크)とモジュールのエイリアスでも呼べます(画面には 既定: と表示されます)。
- 単語はスペースなしの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" }
各エイリアスはスペースを含まない1単語にしてください。チャットコマンドはスペースで単語を区切るため、スペースを含むエイリアスでは呼び出せません。モジュール開発の詳細は モジュール開発ガイド を参照してください。
ノードごとのインスタンス権限
複数の Discord サーバー(= リレーのノード)が同じサバちゃんに接続している場合、Discord サーバーごとに操作できるインスタンスを制限できます。
アプリの Discord → Discordサーバー → インスタンス タブで 選んだものだけ を選びます。nodeSettings にインスタンス ID の一覧として保存されます。
{
"relay": {
"nodeSettings": {
"<guildId>": {
"allowedInstances": ["<インスタンスID>", "<インスタンスID>"]
}
}
}
}
制限された Discord サーバーでは、list コマンドは許可されたインスタンスだけを表示し、スラッシュコマンドもそれらに対してのみ作成され、許可されていないサーバーは見つからないものとして応答されます。
サバちゃんのコマンド
サバちゃんのスラッシュコマンド
Discord で / を入力すると表示される、サバちゃん自身のコマンドです。ゲームサーバーを扱う /<サーバー> コマンドは、上の ゲームサーバーのコマンド を参照してください。どこで使えるかは、サーバーの接続状態によって異なります。
以下の
/saba …コマンドは、Discord サーバーの設定でsabaの接頭を切ると、/status、/permissionのようにサブコマンドがそのままルートに展開されます。サーバー管理コマンドは、展開されてもサーバー管理権限を持つ人にだけ表示されます。形はアプリの Discord サーバー設定(または CLI のbot slash)でサーバーごとに変更します。
接続したサーバーで(/saba …)
| コマンド | 対象 | 動作 |
|---|---|---|
/saba status | 誰でも | このサーバーに接続された PC の状態 |
/saba connect [code] | サーバー管理権限 | アプリで受け取ったペアリングコードで PC を接続。コードを空にすると、このアカウントに接続した PC をすべてすぐ接続する(使うサーバーはアプリで選ぶ)。初めて使うアカウントなら登録から |
/saba disconnect | 接続した人・サーバーオーナー | このサーバーと PC の接続を解除 |
/saba permission level [user] | 接続した人 | ユーザーを選ぶとそのユーザーのコマンドレベルを、空にするとサーバーの既定レベルを設定。ユーザーを選んだときは 解除 も選べる |
/saba sleep | 接続した人 | このサーバーでサバちゃんをスリープさせる(すべてのメッセージを無視) |
/saba wake | 接続した人 | スリープ中のサバちゃんを起こす |
/saba assign kind | 接続した人・サーバーオーナー | 今のチャンネルを おしゃべりサバちゃん・うたうサバちゃん・通知・ゲームチャット・Status board のいずれかに割り当てる。すでに割り当てられたチャンネルでもう一度実行すると解除 |
/saba language language | 接続した人 | このサーバーでサバちゃんが返答する言語(Auto = アプリ/サーバーの言語に従う) |
/saba big-emoji state | 接続した人・サーバーオーナー | 絵文字アップスケール(カスタム絵文字の拡大表示)をオン/オフ(既定はオフ) |
/saba settings | 接続した人 | このサーバーのおしゃべりサバちゃんの設定 |
/saba reading | 接続した人 | このサーバーの読み上げサバちゃんの音量・速度・ピッチと名前の呼び上げ |
/saba web | 誰でも | サバちゃんウェブのリンク(5分、1回限り、自分にだけ見える) |
/saba update | 接続した人 | 接続された PC のサバちゃんをアップデート |
/saba help | 誰でも | 使い方と、この場所で使えるコマンドの一覧 |
sleep は起きているときだけ、wake はスリープ中だけ一覧に表示されます。まだ PC を接続していないサーバーには connect・assign・language・settings・reading・web・big-emoji・help だけが表示され、「接続した人」の代わりに Discord サーバーのオーナーか サーバー管理権限を持つ人が使います(割り当てはおしゃべりサバちゃんとうたうサバちゃんのみ。Discord Bot §2.5)。
メンバーの右クリックメニュー: サーバーのメンバーを右クリック → アプリ → Change Saba-chan level で、その人のコマンドレベルを選べます(PC を接続したサーバーで、接続した人のみ)。
絵文字アップスケール(/settings › Language & commands › Emoji upscale)
オンにすると、テキストなしでカスタム絵文字1つだけを送ったメッセージをサバちゃんが削除し、送った人の名前とプロフィール画像を付けた大きな画像として投稿し直します。返信として送ったものは、同じメッセージへの返信として投稿します。カスタム絵文字を2つだけ送ると、送った順に隙間なく並べた1枚の画像として投稿します。動く絵文字が混ざると一緒に動く GIF になり、長さが違えば短いほうが繰り返されます(最大10秒)。通常の絵文字(😀)とスタンプはそのままにします。元のメッセージを削除する必要があるため、ボットにそのチャンネルの メッセージの管理・リンクの添付 権限が必要で、なければ何もしません。
チャンネル機能(/saba assign)
チャンネルで /saba assign kind:<種類> を実行すると、そのチャンネルが該当する機能のチャンネルになります。同じチャンネルで同じ種類をもう一度実行すると解除されます(アプリの Discord サーバー → サーバー管理 タブの サバちゃんの割り当て でも選べます)。通知・ゲームチャット・ステータスボードは、PC を接続したサーバーでのみ割り当てられます。1つのチャンネルが持てる種類は1つだけです。
| 種類 | チャンネル数 | 内容 |
|---|---|---|
おしゃべりサバちゃん | 複数(20まで) | このチャンネルの発言をサバちゃんが AI で理解して返答し、おしゃべりサバちゃんはこのチャンネルでのみ会話します |
うたうサバちゃん | 1つ | プレフィックスなしで音楽コマンドを入力します。通常のメッセージは削除されるので、音楽専用のチャンネルにしてください(下の うたうサバちゃんのチャンネル) |
通知 | 1つ | サーバーのクラッシュ・予期しない起動、アップデート、バックアップの結果、予約再起動の予告を知らせます。クラッシュ通知には 再起動 ボタンが付きます |
ゲームチャット | 1つ | ゲームサーバー内のチャットをこのチャンネルに転送します。チャット転送をオンにしたサーバーのチャットだけが届き、通知チャンネルとは別に送られます |
Status board | 1つ | 起動中のサーバーごとにカードを1枚表示し、状態が変わるたびに更新します |
ステータスボード は、起動中のサーバーごとにカードを1枚置きます。カードにはゲームのバナー(バナーのあるゲームのみ)、サーバー名、起動中の表示、接続人数、稼働時間が表示され、PC が複数ある場合は PC 名が付きます。この Discord サーバーに開いているサーバー(アプリの インスタンス タブ)だけが対象で、サーバーが停止したり PC がオフラインになったりするとカードは削除されます。起動中のサーバーがない場合は「開いているサーバーなし」のカードが1枚残ります。チャンネルのトピック(ボイスチャンネルではチャンネルステータス)にも、いま起動中のゲーム名が表示されます(チャンネル管理権限があるときのみ)。ステータスボードのチャンネルはボットがカードを管理するので、ステータスボード専用のチャンネルにしてください。ボットを再起動すると、そのチャンネルのボットのメッセージを削除してカードを表示し直します。
自分のアカウントのコマンド(/mysaba …)
サバちゃんを自分の Discord アカウントにインストールすると(接続を終えた返信にインストールリンクのボタンが付きます)、どのサーバーでも、どの DM でも使えます。自分の PC に関するコマンドなので、サーバーの /saba には置かず、返信は自分にだけ見えます。
| コマンド | 動作 |
|---|---|
/mysaba web | サバちゃんウェブのリンク(5分、1回限り)。/saba web と同じ |
/mysaba my-pcs | 自分のアカウントに接続した PC の一覧。名前の変更・削除 |
/mysaba agent | 自分のアカウントに接続された AI エージェントの確認・切断 |
サバちゃんボットとの DM では、/saba status・connect・web・my-pcs・agent・help を使います(同じ動作)。
うたうサバちゃん /music
/music query:<曲名・リンク、または操作>。うたうサバちゃんがオンのサーバーにあります。詳しい使い方は、下の うたうサバちゃんのコマンド を参照してください。
ゲームの戦績 /stats
/stats game:<ゲーム> name:<ニックネーム> [platform:<サーバー・プラットフォーム>]。戦績を探してサマリーカードで表示し、おしゃべりサバちゃんがオンのサーバーでは一言添えます。game 欄と platform 欄は、文字を入力すると合う候補が表示されます(最近使ったゲームが先)。
- 対応ゲーム:League of Legends、チームファイト タクティクス(TFT)、PUBG、メイプルストーリー、ロストアーク、FC オンライン、サドンアタック、カートライダー ラッシュプラス、クラッシュ・ロワイヤル、クラッシュ・オブ・クラン、ブロールスターズ、フォートナイト、Apex Legends、Eternal Return、オーバーウォッチ 2、Dota 2、原神、Roblox。ゲームごとにエイリアスでも探せます(例:롤)。
name欄の形式はゲームごとに異なります:LoL・TFT は名前#タグ、オーバーウォッチはバトルタグ、原神は UID、Supercell のゲームは#タグ。- LoL・TFT は
nameの前にサーバーを付けられます:KR 名前#タグ、[kr] 名前#タグ、kr:名前#タグ。付けない場合は、自分の Discord の言語に合ったサーバーを選びます。 - サーバーの 照会結果は自分だけに表示 の設定がオンなら、返答は呼び出した人にだけ見えます。
読み上げサバちゃん /tts
ボイスチャンネルに入ってから、文章を書くチャンネルで /tts を送ると、そのチャンネルに書いた自分の文章をサバちゃんが自分のボイスチャンネルで読み上げます。もう一度送るとオフになり、自分がボイスチャンネルを出てもオフになります。入力する欄はありません。
- ゲームチャットのチャンネルでオンにすると、そのチャンネルに届くゲーム内チャットも一緒に読み上げます。
- 読み上げた文章は削除します(ボットにメッセージの管理権限があるとき)。プレフィックスで始まる文章は、コマンドでないときだけ読み上げます。
- 1つの文章は100文字まで、1人あたり1分に500文字・1時間に15000文字まで読み上げます。あふれた文章は残し、自分にだけ知らせます。
- 音量・速度・ピッチと、文章の前に「名前さん、」を付けるかどうかは、
/saba readingかアプリの Discord サーバー → 読み上げサバちゃん タブで決めます。
Discord サーバー管理 /clear /autoclear /mute /lock /slowmode
その作業に合った Discord 権限を持つ人か、PC を接続したサーバーでサバちゃんのレベルが管理者以上の人が使います。ボットにも同じ権限が必要です。アプリの Discord サーバー → サーバー管理 タブでも同じことができます。
| コマンド | 必要な権限 | 動作 |
|---|---|---|
/clear [count] [member] [period] | メッセージの管理 | このチャンネルの投稿を新しいものから削除します(count を空にすると1000件まで)。member でその人の投稿だけ、period(直近10分〜7日)でその期間の投稿だけを削除します。ピン留めした投稿とサバちゃんのパネル(プレイヤー・ステータスボードのカード・お知らせ)は残します。14日を過ぎた投稿は一度に50件までしか削除しません。結果は自分にだけ見えます |
/autoclear keep:<期間> | メッセージの管理 | このチャンネルで保管期間(1時間・6時間・12時間・1日・3日・7日)を過ぎた投稿を15分ごとに削除します。Off でオフにします |
/mute member:<メンバー> duration:<期間> [reason] | メンバーをタイムアウト | Discord のタイムアウトで、そのメンバーの投稿・リアクション・音声を止めます。期間は10分〜28日と forever(無期限)、off(解除)で解きます。ボイスチャンネルにいる場合は退出させます。理由は監査ログに残ります |
/lock [duration] | チャンネルの管理 | このチャンネルで @everyone が投稿できないようにロックします。duration(10分〜1日)を空にすると解除するまで、Remove で解除します。個別に許可された役職と管理者は引き続き投稿できます |
/slowmode interval:<間隔> | チャンネルの管理 | このチャンネルのスローモード(5秒〜6時間)を変更します。Off でオフにします |
ミュートはプレフィックスコマンドでもできます:サバちゃん mute @メンバー 1h、サバちゃん mute forever(そのユーザーのメッセージへの返信として)、サバちゃん unmute。
リレー運営者専用 /operator
リレーの運営者だけが使うコマンドです(page、block、unblock、list)。一般ユーザーには表示されません。
うたうサバちゃんのコマンド
うたうサバちゃん(音楽)はクラウドボットの機能です。音声の再生は PC ではなくリレーサーバーの隣にある 公式の音楽サーバー が担当するため、PC の電源が切れていても動作します。最初からオンになっており、アプリの Discord サーバー → うたうサバちゃん タブでオフにできます。
モジュールのエイリアス:music と dj はどの言語でも使えます。ボットの言語が韓国語の Discord サーバーでは、음악、ㄴㄹ、ㅇㅇ も使えます。
サバちゃん music <コマンド> [引数]
サバちゃん dj <コマンド> [引数]
次のような 便利なショートカット もあります。
サバちゃん <リンク>: モジュール名なしですぐに再生します。YouTube・SoundCloud の曲のリンクはそのまま再生し、Spotify・Apple Music の曲・アルバム・プレイリストのリンクは、曲名とアーティスト名で YouTube から同じ曲を探して再生します(リストは最初の100曲で、曲ごとに再生するときに探します)。SoundCloud のプレイリスト(/sets/)にはまだ対応していません。- 最初の単語がうたうサバちゃんのコマンドなら、
サバちゃん play lofi、サバちゃん skip、サバちゃん pauseのようにモジュール名を省略できます。ただしhelp、도움、listはグローバルコマンドに渡されるため、うたうサバちゃんのヘルプにはサバちゃん music helpを使ってください。 サバちゃん music <検索語>のように、モジュールの後ろにコマンド以外のものが続く場合は、検索語として扱われて再生されます。
スラッシュコマンド /music query:<曲名・リンク、または操作>: うたうサバちゃんがオンのサーバーにだけあります。入力した文がうたうサバちゃんのコマンド(stop、volume 50 …)ならその操作を、そうでなければその文でそのまま再生します。欄が空のときは、いまの再生状態で使える操作(一時停止・再開・次へ・停止 …)が一覧で表示され、文字を入力すると合う操作の後ろに「すぐ再生」と「検索して選ぶ」が表示されます。
全コマンド一覧(英語 / 韓国語のエイリアス)。韓国語のエイリアスは、ボットの言語が韓国語の Discord サーバーでのみ認識されます。
| 英語 | 共通のエイリアス | 韓国語のエイリアス | 説明 |
|---|---|---|---|
play | p | 재생、ㅈㅅ | 検索結果の1件目またはリンクをすぐに再生 |
search | find | 검색、ㄱㅅ | 5件の検索結果から選んで追加 |
pause | なし | 일시정지、ㅇㅅㅈㅈ | 一時停止 |
resume | なし | 계속、ㄱㅅㄱ | 再開 |
skip | s、next | 다음、ㄷㅇ | 次の曲 |
previous | prev、back | 이전 | 前の曲 |
stop | leave、disconnect、dc | 정지、ㅈㅈ | 停止してボイスチャンネルから退出 |
queue | q、list | 대기열、ㄷㄱㅇ | キューを表示 |
np | nowplaying、now | 지금、ㅈㄱ | 再生中の曲 |
volume [0~200 | +n | -n] | vol、v | 볼륨、ㅂㄹ | 音量の表示または調整(+10/-10 のような相対値も可) |
shuffle | random | 섞기、ㅅㄱ | キューをシャッフル |
loop | repeat | 반복、ㅂㅂ | リピートをオンにする(オフは loopoff) |
loopoff | unloop | 반복해제、ㅂㅂㅎㅈ | リピートを解除 |
radio | autoplay | 라디오、ㄹㄷㅇ | おすすめ曲で自動的に埋める |
normalize | norm、loudnorm | 정규화、볼륨평탄화、ㅈㄱㅎ | 曲間の音量の正規化を切り替え |
help | なし | 도움、ㄷㅇ말 | うたうサバちゃんのヘルプ |
例:
サバちゃん music play lofi hip hop
サバちゃん dj search ado 우주미아
サバちゃん music volume 50
サバちゃん skip
サバちゃん https://youtu.be/xxxxx
うたうサバちゃんのチャンネル
チャンネルで /saba assign kind:うたうサバちゃん を実行すると(またはアプリの Discord サーバー → サーバー管理 タブの サバちゃんの割り当て で選ぶと)、そのチャンネルが うたうサバちゃんのチャンネル になります。このチャンネルでは プレフィックスなし でメッセージがそのままうたうサバちゃんのコマンドとして解釈され、コマンド以外の入力は検索語として扱われて再生されます。
play lofi
skip
stop
https://youtu.be/xxxxx
うたうサバちゃんのチャンネルには、ボットが再生中の曲とキューを示すプレイヤー画面を表示します(アプリの うたうサバちゃん タブでオフにできます)。このチャンネルの通常のメッセージは削除されるため、音楽専用のチャンネルを選んでください。
曲を再生したり検索結果から選んだりするには、コマンドを出すユーザーが 先にボイスチャンネルに入っている 必要があります。
イースターエッグ
ボットには、プレフィックスの後ろに特定の1単語を入力すると出てくる、隠れた一言リアクションがいくつかあります。PC の電源が切れていても動作します。自分で見つける楽しみのために、ここでは紹介しません。
コマンドが動かないときのクイックチェックリスト
| 症状 | まず確認すること |
|---|---|
| ボットが反応しない | プレフィックス(既定 サバちゃん + スペース)を確認します。ペアリングが完了していること、アプリで コマンド中継 がオンであること、ボットが /saba sleep の状態でないことが必要です。 |
| 「サーバーが見つからない」という返答 | 順序は <サーバー> <コマンド> です。同じゲームのサーバーを複数動かしている場合は、インスタンス名かサーバーのエイリアスを使ってください。 |
| 「権限がない」という返答 | そのコマンドに必要なレベルに自分のレベルが足りません。ノードオーナーに /saba permission でレベルを付与してもらってください。 |
| うたうサバちゃんのコマンドが動かない | このサーバーでうたうサバちゃんがオンになっているか、コマンドを入力した人がボイスチャンネルに入っているか、ボットの言語と異なる言語のエイリアスを使っていないかを確認してください。 |
| エイリアスを追加したのに反応しない | アプリで保存したか、他のモジュールと重複するエイリアスでないかを確認してください。 |
| 特定の Discord サーバーでだけコマンドがブロックされる | そのサーバーの許可されたインスタンス(インスタンス タブ)に、該当のインスタンスが含まれていない可能性があります。 |
より詳しい診断は トラブルシューティング、ボットの設定自体については Discord Bot & クラウドリレー を参照してください。