テンプレート変数
カスタムコマンド、ようこそ・お別れメッセージ、自動応答、レベルアップメッセージなど、ダッシュボードに変数ピッカーが出る場所ならどこでも使えます。Kovu が送信時に値を埋め込みます。
このページの内容
基本このセクションへのリンク
Kovu があなたの代わりに送るすべてのメッセージで使えます。
| 変数 | 内容 |
|---|---|
{user} | ユーザーをメンション |
{server} | サーバー名 |
{channel} | チャンネル名 |
{prefix} | サーバーのコマンドプレフィックス |
メンションこのセクションへのリンク
| 変数 | 内容 |
|---|---|
{everyone} | @everyone に通知 |
{here} | @here に通知 |
{@name} | ユーザー名でユーザーをメンション例: {@kovu} |
{&role} | 名前でロールをメンション例: {&Gamers} |
{#channel} | 名前でチャンネルにリンク例: {#rules} |
ユーザーこのセクションへのリンク
| 変数 | 内容 |
|---|---|
{user.id} | ユーザーの ID |
{user.name} | ユーザー名 |
{user.username} | ユーザー名 |
{user.displayname} | サーバーのニックネーム、グローバル表示名、ユーザー名のいずれか |
{user.globalname} | ユーザーのグローバル表示名 |
{user.nick} | ユーザーのサーバーニックネーム (または表示名) |
{user.tag} | ユーザー名 (旧アカウントは name#1234) |
{user.idname} | ユーザー名 (ID) |
{user.discrim} | ユーザーの旧タグ (discriminator) |
{user.mention} | ユーザーをメンション |
{user.avatar} | ユーザーのアバターの URL |
{user.createdat} | アカウントの作成日時 |
{user.joinedat} | ユーザーがサーバーに参加した日時 |
{user.bot} | ユーザーがボットなら "true" |
サーバーこのセクションへのリンク
| 変数 | 内容 |
|---|---|
{server.id} | サーバーの ID |
{server.name} | サーバーの名前 |
{server.icon} | サーバーアイコンの URL |
{server.membercount} | メンバー数 |
{server.ownerid} | オーナーの ID |
{server.owner} | オーナーをメンション |
{server.createdat} | サーバーの作成日時 |
{server.boosts} | ブースト数 |
{server.boostlevel} | ブーストレベル (0-3) |
チャンネルこのセクションへのリンク
| 変数 | 内容 |
|---|---|
{channel.id} | チャンネルの ID |
{channel.name} | チャンネルの名前 |
{channel.mention} | チャンネルにリンク |
{channel.topic} | チャンネルのトピック |
ロールこのセクションへのリンク
| 変数 | 内容 |
|---|---|
{role} | ロール名 (ロールが文脈にある場合) |
{role.id} | ロールの ID |
{role.name} | ロールの名前 |
{role.mention} | ロールをメンション |
{role.color} | ロールの色 (16 進) |
{role.membercount} | ロールを持つメンバー |
| 変数 | 内容 |
|---|---|
{time} | 現在の時刻 (24 時間制) |
{time12} | 現在の時刻 (12 時間制) |
{date} | 現在の日付 |
{datetime} | 現在の日付と時刻 (24 時間制) |
{datetime12} | 現在の日付と時刻 (12 時間制) |
{timestamp} | 現在の Unix タイムスタンプ (秒) |
引数このセクションへのリンク
カスタムコマンドの後にメンバーが入力する内容 (例: `?hug @kovu`)。
| 変数 | 内容 |
|---|---|
$N | N 番目の引数 (1 から数える)カスタムコマンド例: You chose $1 |
$N+ | N 番目以降のすべての引数カスタムコマンド例: Reason: $2+ |
操作このセクションへのリンク
カスタムコマンドの実行時の動作を変えます。
| 変数 | 内容 |
|---|---|
{delete} | コマンドを呼び出したメッセージを削除カスタムコマンド |
{silent} | ボットの通常の応答を出さないカスタムコマンド |
{noeveryone} | @everyone/@here には通知しない |
{!command} | 別のボットコマンドを実行カスタムコマンド例: {!role $1 Regulars} |
制限このセクションへのリンク
カスタムコマンドを使える人と場所を決めます。
| 変数 | 内容 |
|---|---|
{require:role} | このロールを持つメンバーだけが使えます (または serverMod)カスタムコマンド例: {require:Staff} |
{require:#channel} | このチャンネルでのみ使えますカスタムコマンド |
{not:role} | このロールを持つメンバーは使えませんカスタムコマンド |
{not:#channel} | このチャンネルでは使えませんカスタムコマンド |
出力このセクションへのリンク
応答を別の場所に送ります。
| 変数 | 内容 |
|---|---|
{respond:#channel} | 応答を別のチャンネルに送るカスタムコマンド |
{dm} | ユーザーに応答を DM する |
{dm:user} | 特定のユーザーに応答を DM するカスタムコマンド |
ランダムこのセクションへのリンク
毎回ランダムに選びます。
| 変数 | 内容 |
|---|---|
{choose:a;b;c} | ランダムに 1 つ選ぶ例: {choose:pie;cake;ice cream} |
{choice} | {choose} の結果を入れる場所 |
{chooseN:a;b} | 複数の独立した選択に使う番号付き choose例: {choose2:red;blue} ... {choice2} |
{choiceN} | {chooseN} を入れる場所 |
メッセージブロックこのセクションへのリンク
Kovu用に書くメッセージは、メッセージデザイナーで積み重ねるブロックでできています。Discordがアプリのメッセージを組み立てるのと同じ方法です。変数はすべてのブロックのテキスト、リンク、画像で使えます。
| ブロック対象 | 内容 |
|---|---|
| テキスト | Markdownテキスト：見出し、リスト、引用、マスクリンク、変数。 |
| カード | 左側に色付きバーがあり、ほかのブロックを入れる枠。サーバーの埋め込みの色を使うか、色を選ぶか、バーなしにできます。 |
| セクション | 1〜3個のテキストと、その横にサムネイル画像かリンクボタン。 |
| ギャラリー | 1〜10枚の画像をグリッドで表示。それぞれに代替テキストを付けられ、ネタバレとして隠すこともできます。 |
| 区切り | ブロック間の余白。小か大、線の有無を選べます。 |
| ボタン | 最大5個のリンクボタンの行。メッセージ埋め込みでは、アクションとして設定したボタンやメニューも行に入れられます。 |
| モジュールの部品 | モジュールが自分の部品を置く場所。チケットパネルのボタン、リアクションロールメニューのロール、ウェルカムカードなど。置かない場合は、Kovuがいつもの位置に入れます。 |
- 新しいメッセージは1つのテキストから始まり、色を付けてカードに入れられます。ブロックを追加すると、まず画像付きカードなどの既成レイアウトが表示されます。
- 1つのメッセージには最大40個のコンポーネント（ブロック、ボタン、行、モジュール自身のボタンもすべて数えます）と約4,000文字のテキストを入れられます。デザイナーは編集中に両方を数えます。
- テキストだけのメッセージは、リンクボタンの有無にかかわらず通常のメッセージとして送信されるので、リンクのプレビューが残ります。
以前に保存したメッセージ
テキストと埋め込みのクラシックレイアウトのまま、これまでどおり送信されます。ブロックに切り替えるには、メッセージを開いてレイアウトを切り替えます。Kovuは変更前と変更後を表示し、見た目が変わる点を一覧にします。たとえば埋め込みの作成者やフッター横の小さなアイコン、横並びのフィールドは縦に並びます。キャンセルすれば何も変わりません。