コマンドの使い方
コマンドの呼び出し方
コマンドはsb#コマンド名 パラメータ パラメータのようにして呼び出します。 sb#はsb.、またはsb. に置き換えることが出来ます。パラメータの見方
パラメータの型
パラメータにはいくつか種類があります。
型名 | 説明 | 入力 | 判定 |
文字列 | 文字列。何でも入ります。 全体を"で囲むことで空白付きの文字列を渡すことが出来ます。 |
Hello | OK |
123 | OK | ||
456 | OK | ||
"1 2 3" | OK | ||
数値 | 数値。数字で指定します。 小数は渡せません。 |
123 | OK |
456 | OK | ||
ABC | NG | ||
1.5 | NG | ||
小数 | 小数。数値型とは違い、小数を渡すことが出来ます。 | 123 | OK |
456 | OK | ||
1.5 | OK | ||
ABC | NG | ||
Y/N | Yes/No。 様々な表記に対応していますが、日本語には対応していません。 True/Falseが推奨されています。 |
Yes | OK |
y | OK | ||
true | OK | ||
t | OK | ||
0 | OK | ||
disable | OK | ||
off | OK | ||
a | NG | ||
はい | NG | ||
オン | NG | ||
時間 | 今からの時間を指定します。00d00h00m00s、00:00:00の形式で指定します(前者は使わない物は省略可能) | 1d | OK |
1h | OK | ||
30m | OK | ||
1h30m | OK | ||
1m30s | OK | ||
1:30:00 | OK | ||
time | NG | ||
date | NG | ||
オプション | オプションを=で指定します。 | A=B | OK |
A=B C=D | OK | ||
A:B | NG | ||
A,B | NG | ||
ロール | Discordのロール。 メンション、ID、ロール名のどれかで渡して下さい。 |
@Admin | OK |
835513560913281065 | OK | ||
Admin | OK | ||
チャンネル | Discordのチャンネル。 メンション、ID、チャンネル名のどれかで渡して下さい。 |
#一般 | OK |
721267221841707139 | OK | ||
一般 | OK | ||
メンバー | サーバーのメンバー。 メンション、ID、ニックネーム、ユーザー名のどれかで渡して下さい。 |
@名無し。 | OK |
686547120534454315 | OK | ||
[管理者]名無し。 | OK | ||
Nanashi.#1225 | OK |
必須パラメータ
<>で囲まれたパラメータは必ず指定する必要があります。
構文 | 入力 | 判定 |
command <パラメータ1> | command テスト | OK |
command | NG | |
command <パラメータ1> <パラメータ2> | command テスト テスト2 | OK |
command テスト | NG | |
実例 | ||
get_role_member <ロール> | get_role_member @Admin | OK |
get_role_member | NG |
省略可パラメータ
[]で囲まれたパラメータは省略することができます。
構文 | 入力 | 判定 |
command [パラメータ1] | command テスト | OK |
command | OK | |
command <パラメータ1> [パラメータ2] | command テスト テスト2 | OK |
command テスト | OK | |
command | NG | |
実例 | ||
shorten <URL> [短縮ID] | shorten https://sevenbot.jp sevenbot | OK |
shorten https://sevenbot.jp | OK | |
shorten | NG |
また、指定された型に変換出来なかった場合、そのパラメータは無視されます。
構文 | 入力 | 判定 |
command [数値1] <パラメータ1> | command 123 テスト | OK |
command テスト | OK | |
実例 | ||
vote <タイトル> [長さ] [複数投票] <選択肢...> | vote SevenBotの使い勝手 1d y 良い 悪い | OK |
vote SevenBotの使い勝手 1d 良い 悪い | OK | |
vote SevenBotの使い勝手 y 良い 悪い | OK | |
vote SevenBotの使い勝手 良い 悪い | OK | |
vote SevenBotの使い勝手 | NG |
可変長パラメータ
...で終わっているパラメータは複数の値を渡すことが出来ます。
構文 | 入力 | 判定 |
command <パラメータ1...> | command テスト テスト テスト | OK |
command テスト テスト | OK | |
実例 | ||
role [複数選択] <ロール...> | role @赤色 @緑色 | OK |
role @赤色 | OK |
空白無視パラメータ
>や]が開いたまま終わっているパラメータは空白を無視して取得します。
"もそのまま値に入るので注意して下さい。
構文 | 入力 | 判定 |
command <パラメータ1 | command テスト | OK |
command テスト テスト | OK | |
実例 | ||
event_send <イベント名> [メッセージ | event_send join !mention さんが参加しました。 | OK |
event_send join !mentionが参加しました。 | OK |
SevenBotのサイトはsevenbo.tkからsevenbot.jpへ移行しました。