BotShadeBot 機能（モジュール）
埋め込みメッセージ
「埋め込みメッセージ」は、Discord の埋め込み(Embed)を作って送る機能です。ダッシュボードではサーバーごとに名前を付けた埋め込みのテンプレートを作れ、Discord 上では /embed コマンドで作成・編集・送信できます。すべてのプランで利用できます。
埋め込みエディタは、リマインダーやログなど他の機能の埋め込み編集画面と共通です。
埋め込みエディタ
| タブ | 編集する内容 |
|---|---|
| 基本設定 | タイトル(最大 256 文字)・タイトル URL・説明(最大 4096 文字)・カラー |
| 著者 (Author) | 著者名(最大 256 文字)・著者 URL・アイコン URL |
| 画像設定 | メイン画像(下部に大きく表示)・サムネイル(右上に小さく表示)の URL |
| フッター | フッターテキスト・フッターアイコン URL・タイムスタンプの表示 |
| フィールド | 名前と値の組。「Inline」をオンにすると横に並べて表示されます |
- 説明とフィールドの値は Markdown に対応しています。
- タイトル・説明・著者名・各 URL・フィールドなどの欄では、送信時にユーザー名やサーバー名に置き換わる変数を使えます。詳しくは変数の概要をご覧ください。
- プレビューは BotShade の配色で描かれるため、Discord 上とは色味が異なります。URL 欄に変数を入れた場合も、プレビューではリンクや画像にならず文字のまま表示されますが、送信時には値に置き換えられます。
- カラーの書き方は 色の指定 をご覧ください。
- 画像やアイコンの URL は送信するまで確認されません。リンク切れや誤った URL は、送信した埋め込みに画像が表示されないかたちで現れます。
ダッシュボードで埋め込み設定を削除しても、保存バーで「保存」をクリックするまで削除は確定しません。
コマンド
コマンドはサーバー内でのみ使え、応答は本人にだけ表示されます。既定では「サーバー管理(manage_guild)」権限を持つメンバーだけが使えます。有効化と権限の変更はコマンド権限設定をご覧ください。
| コマンド | できること | 主な引数 |
|---|---|---|
/embed create | 名前を付けて新しい埋め込みを作成します。同じサーバーに同じ名前があると作成されません。 | name |
/embed edit | 編集パネルを開き、プレビューを見ながら各部分・フィールドの編集や埋め込みの削除を行います。変更は確定時に自動保存されます。 | name(候補は部分一致で最大 25 件表示) |
/embed send | 作成済みの埋め込みを指定したチャンネルへ送信します。 | name、channel |
作成直後の埋め込みには、タイトル 新しいEmbed と説明 `/embed edit`で編集してください。 が仮に入っています。
編集パネルの制約
- パネルを操作できるのは
/embed editを実行した本人だけです。 - 操作のないまま 180 秒が経過すると期限切れになります。
- カラーは 7 文字までで、
#FF00FF・FF00FF・#F0Fなどの色コードや、red・blurpleなどの色の名前を入力できます。解釈できない値はエラーにならずに無視され、それまでの色が残ります。空欄にすると色を消せます。randomは使えません。
パネルから埋め込みを削除すると確認が表示され、60 秒で期限切れになります。確定すると埋め込みは完全に削除され、元に戻せません。
上限
| 項目 | Free | Plus | Pro | Max |
|---|---|---|---|---|
| フィールド数 | 5 個 | 10 個 | 25 個 | 25 個 |
| 1 サーバーの埋め込み数 | 5 個 | 25 個 | 100 個 | 無制限 |
| タイトルに付ける URL | ✕ | ○ | ○ | ○ |
| 自動フッター(ブランド表記) | 送信時に自動付与 | 付きません | 付きません | 付きません |
フィールドの 25 個は Discord 側の上限でもあるため、どのプランでも超えられません。
/embed edit の編集パネルで入力できる文字数は次のとおりです。ダッシュボードのエディタとは説明の上限が異なります。
| 項目 | 上限 |
|---|---|
| タイトル | 256 文字 |
| 説明 | 2000 文字 |
| フィールドの名前 | 256 文字 |
| フィールドの値 | 1024 文字 |
| カラー | # を含めて 7 文字 |
説明が Discord 側の埋め込み説明の上限を超えると、送信時に Discord 側で受け付けられず失敗することがあります。コマンドにクールダウンはありません。
エラーと対処
| メッセージ | 原因と対処 |
|---|---|
この操作を実行する権限がありません。 | 実行したメンバーに権限がありません。サーバー管理者が権限を付与するか、コマンド権限設定で許可してください。 |
エラー: {channel.mention} にメッセージを送信する権限がありません。 | Bot が送信先チャンネルにメッセージを送れません。Discord 側で Bot にそのチャンネルの送信権限を付与してください。 |
エラー: {name} という名前の埋め込みが見つかりません。 | 指定した埋め込みがありません。名前の入力ミスか、別の管理者が削除した可能性があります。 |
エラー: Embedが見つかりません。 | 編集パネルを開いている間に、別の管理者がその埋め込みを削除しました。 |
エラー: `{name}` という名前の埋め込みは既に存在します。 | 同じサーバーに同じ名前の埋め込みがあります。別の名前にしてください。 |
エラー: フィールドは{max_fields}個までしか追加できません。 | プランのフィールド数の上限に達しています。 |
エラー: This feature is only available for premium users. | Free の Bot ではタイトルに URL を設定できません。 |
他のユーザーの操作です。 | 他のメンバーが開いた編集パネルは操作できません。自分で /embed edit を実行してください。 |
タイムアウトしました。操作をやり直してください。 | 時間内に操作が行われず期限切れになりました。操作をやり直してください。 |
この操作はサーバー内でのみ実行できます。 | DM では使えません。サーバー内で実行してください。 |
編集または削除できるフィールドがありません。 | フィールドが 1 つもありません。先にフィールドを追加してください。 |
関連ページ
最終更新: