バックアップ
バックアップは、Discord サーバーの構成(ロール・チャンネル・カテゴリー・絵文字・ステッカー・Ban・各種サーバー設定など)を丸ごと保存しておける機能です。誤ってチャンネルやロールが消えてしまったときに備えて、サーバーの「設計図」を控えておけます。
ダッシュボードのバックアップページでは、保存済みバックアップの中身をくわしく確認したり、不要になったバックアップを削除したりできます。バックアップの作成や復元そのものは、Discord 上で Bot のコマンドを使って行います。
バックアップは本来プレミアム向けの機能ですが、現在ベータ版のあいだは全ユーザーに無料でプレミアムが付与されているため、追加の費用なくどなたでもご利用いただけます。(ベータ終了後はプレミアム限定になる予定です。)
ダッシュボードからは新しいバックアップを作成できません。作成は Bot のコマンド「/backup create」で行い、ダッシュボードでは保存済みバックアップの内容確認と削除のみができます。
このページでできること
- バックアップコマンド(「
/backup create」「/backup load」「/backup info」)の有効・無効と、誰が使えるかの権限を設定する - 「保存済みバックアップ」の一覧を見る
- 各バックアップを展開して、ロール・チャンネル・絵文字などの中身をくわしく確認する
- 不要なバックアップを削除する
バックアップの「作成」「復元」そのものは Discord 上の Bot コマンドで行います。
バックアップページを開く
メニューから「バックアップ」を開く
ダッシュボードで対象の Bot を開き、メニュー(サーバー管理グループ)から「バックアップ」を選びます。
ベータ終了後にプレミアムが付与されていない場合は、メニューから開けず、プレミアムのご案内が表示されます。
「機能の有効化」をオンにする
「機能の有効化」をオンにすると、この機能が有効になります。
コマンド権限設定
「コマンド権限設定」では、バックアップに関する 3 つのコマンドごとに、利用可否と誰が使えるかの権限を設定できます。
| コマンド | 説明 |
|---|---|
| 「/backup create」 | 新しいバックアップを作成します。 |
| 「/backup load」 | バックアップから復元します。 |
| 「/backup info」 | バックアップ情報を表示します。 |
各コマンドの行を開くと、次の設定が表示されます。
| 設定項目 | 内容 |
|---|---|
| 「コマンドを有効化」 | このコマンド自体を利用可能にするかどうかを切り替えます。 |
| 「個別権限設定を有効化」 | オンにすると BotShade 独自の権限設定を使い、オフのときは通常の Discord 権限判定を使います。 |
| 「Discord権限より個別設定を優先」 | 個別権限設定を Discord の既存権限より優先して強制適用します(後述の注意を参照)。 |
各コマンドの行には現在の状態を示すバッジ(「有効」または「無効」)が表示され、「Discord権限より個別設定を優先」を有効にしている場合は「強制上書き」バッジも表示されます。
コマンドの有効・無効を切り替える
コマンドの行を開く
「コマンド権限設定」の中から、設定したいコマンド(例: 「/backup create」)の行を開きます。
「コマンドを有効化」を切り替える
「コマンドを有効化」のスイッチで、そのコマンドを使えるようにするか(オン)、使えなくするか(オフ)を切り替えます。
誰がコマンドを使えるかを設定する
標準では通常の Discord 権限で利用可否が判定されますが、「個別権限設定を有効化」をオンにすると、BotShade 独自のロール・権限指定が使える「詳細権限設定」が利用でき、次のリストを設定できます。
| リスト | 内容 |
|---|---|
| ホワイトロールリスト | 許可するロールを指定します。リストに含まれるロールは常にアクセスが許可されます。 |
| ブラックロールリスト | 拒否するロールを指定します。リストに含まれるロールはアクセスが拒否されます。 |
| ホワイト権限リスト | 許可する権限条件を設定します。条件に一致するメンバーはアクセスが許可されます。 |
| ブラック権限リスト | 拒否する権限条件を設定します。条件に一致するメンバーはアクセスが拒否されます。 |
「/backup load」はサーバー構成を復元(上書き)する、いわば「やり直しのきかない」操作です。誰かが誤って実行すると、現在のサーバー構成が書き換わるおそれがあります。「/backup load」を使えるロールや権限はできるだけ厳しく制限し、信頼できる管理者だけが実行できるようにしてください。
「Discord権限より個別設定を優先」について
「Discord権限より個別設定を優先」をオンにすると、Discord 側の既存権限よりも BotShade 独自の個別権限設定を優先して強制的に適用します。このスイッチは「個別権限設定を有効化」をオンにしている場合のみ操作できます(オフのときは「個別権限設定を有効化すると利用できます。」と表示されます)。
このスイッチを切り替えようとすると、「危険な権限上書きの確認」という確認画面が表示されます。内容を確認し、問題なければ「確定する」を、やめる場合は「キャンセル」をクリックします。
「Discord権限より個別設定を優先」を有効にすると、管理者向けコマンドであっても BotShade 独自の個別権限設定で強制的に上書きされます。意図しない権限の付与や制限につながる可能性があるため、設定内容を十分に確認したうえで利用してください。とくに「/backup load」での誤実行には注意してください。
バックアップを作成する
バックアップの作成は Discord 上で Bot に「/backup create」コマンドを実行して行います。作成されたバックアップは、しばらくするとダッシュボードの「保存済みバックアップ」一覧に表示されます。
「/backup create」を実行すると、Bot はその時点でのサーバーの状態を 1 つのスナップショット(控え)として保存します。既定では次の内容がまとめて取り込まれます。
- ロール(色・ロール一覧への表示(hoist)・メンション可否などの設定を含む。Bot や連携が自動で作成する管理対象ロールは対象外です)
- チャンネルとカテゴリー(テキスト・ボイス・カテゴリーの名前や並び順、権限上書き、テキストチャンネルのトピック・低速モード・年齢制限(NSFW)など)
- カスタム絵文字
- ステッカー
- Ban(理由が設定されていれば理由も)
- サーバー設定(サーバー名・AFK チャンネル・システムチャンネルなど)
作成に成功すると、実行した本人だけに見える(エフェメラルな)メッセージで バックアップを作成しました。 と表示され、バックアップの名前と ID が知らされます。バックアップには 8 文字の固有 ID が自動で割り当てられます。
作成時に保存する内容を選ぶ
「/backup create」には、どの要素を保存するかを切り替えるオプションが用意されています。いずれも既定はオン(保存する)です。
| オプション | 内容 | 既定 |
|---|---|---|
| 「name」 | バックアップの名前。省略すると Backup YYYY-MM-DD HH:MM 形式(UTC の作成日時)で自動的に付けられます。 | 自動生成 |
| 「channel」 | チャンネル・カテゴリーを保存するか。 | オン |
| 「role」 | ロールを保存するか。 | オン |
| 「emoji」 | カスタム絵文字を保存するか。 | オン |
| 「sticker」 | ステッカーを保存するか。 | オン |
| 「ban」 | Ban 情報を保存するか。 | オン |
| 「setting」 | サーバー設定(名前・AFK チャンネル・システムチャンネル)を保存するか。 | オン |
実行前に「/backup info」などで内容を確認することをおすすめします。
保存済みバックアップを確認する
「保存済みバックアップ」セクションには、保存済みのバックアップが一覧で表示され、保存数(例: 「3 個のバックアップ」)も表示されます。
各バックアップに表示される情報:
- サーバーアイコン
- サーバー名(保存当時の名前)
- バックアップの ID
- メンバー数(保存当時のメンバー数)
- ロール数・チャンネル数のバッジ(例: ロールの数や「ch」の数)
バックアップの中身を確認する
バックアップの行を展開する
一覧から確認したいバックアップの行を開くと、保存内容の詳細が表示されます。
サーバー概要を確認する
詳細の先頭には、保存当時のサーバーの概要が表示されます。サーバーアイコン・サーバー名のほか、次のような情報がバッジや統計で表示されます。
- ID(サーバーの ID)
- メンバー数(「メンバー」)
- 「大規模サーバー」の表示(大規模サーバーとして扱われていた場合)
- ロール・カテゴリー・テキストch・ボイスch・絵文字・ステッカーの各件数
各カテゴリーの中身を確認する
サーバー概要の下に、保存されている各要素が折りたたみ式のセクションとして並びます。各セクションは開閉でき、見出しの右側に件数が表示されます。
詳細で確認できる項目は次のとおりです(データがある項目のみ表示されます)。
| セクション | 表示される内容 |
|---|---|
| 「ロール」 | ロール名の一覧。ロールの色がそのまま反映され、「@everyone」、ロール一覧に表示される設定のロールには「(表示)」、管理者権限を持つロールには「[管理者]」が付きます。 |
| 「カテゴリー」 | カテゴリー名の一覧。チャンネルへの権限上書きがある場合は「権限上書き」とその件数が表示されます。 |
| 「テキストチャンネル」 | テキストチャンネル名の一覧。所属カテゴリー名、年齢制限チャンネルの「NSFW」、低速モードの秒数(「低速」)、トピック設定の有無(「トピック」)が表示されます。 |
| 「ボイスチャンネル」 | ボイスチャンネル名の一覧。所属カテゴリー名、ビットレート(kbps)、人数上限(「上限」)が表示されます。 |
| 「絵文字」 | 保存されたカスタム絵文字の一覧(画像と名前)。 |
| 「ステッカー」 | 保存されたステッカーの名前の一覧。 |
| 「Ban」 | Ban されていたユーザーの一覧(ユーザー ID と、設定されていれば理由)。 |
| その他設定 | AFK タイムアウト、「認証レベル:」、「コンテンツフィルター:」など、サーバーの各種設定。 |
ここに表示されるのは、バックアップを作成した時点での内容です。最新のサーバーの状態とは異なる場合があります。
バックアップから復元する
バックアップからの復元は、Discord 上で「/backup load」コマンドを実行して行います。backup_id を指定すると、Bot は保存されたスナップショットの内容でサーバーを作り直します。
復元はやり直しのきかない操作です。Bot は復元前に、サーバーの既存のロールとチャンネルをいったんすべて削除してから、バックアップの内容で作り直します。削除されたチャンネル内のメッセージなどは元に戻せません。実行する前に、本当に復元してよいかをよく確認してください。
「/backup load」を実行すると、まず本人だけに見える確認ダイアログが表示されます。
⚠️ **警告: サーバーの復元を行いますか?**
Backup ID: `<id>`
現在のチャンネル、ロール、設定などが削除され、バックアップの内容で上書きされます。
**この操作は取り消せません。**内容を確認して実行を選ぶと、⏳ 復元処理を開始します... (これには時間がかかる場合があります) と表示され、復元が始まります。Bot は次の順で処理を進めます。
既存の構成を削除する
サーバーの既存のロールとチャンネルを削除します。Bot や連携が作成した管理対象ロール、および「@everyone」ロールは削除されず、「@everyone」の権限はバックアップの内容で上書きされます。
ロールを作り直す
保存されていたロールを並び順どおりに作成し直します。
チャンネル構成を作り直す
カテゴリー・テキストチャンネル・ボイスチャンネルを作成し直し、保存されていた権限上書きを再設定します。
サーバー設定・Ban・絵文字・ステッカーを反映する
サーバー名・AFK チャンネル・システムチャンネルを更新し、Ban を再適用し、カスタム絵文字とステッカーをアップロードし直します。
すべて成功すると 復元が完了しました。 と表示されます。一部の手順だけ問題が起きた場合は 復元が完了しましたが、一部のステップで問題が発生しました。 と表示され、ロール: 成功 チャンネル: 成功 のように手順ごとの結果が一覧で示されます。
復元時に保存対象を選べるオプション(channel / role / emoji / sticker / ban / setting)も用意されており、いずれも既定はオンです。
別のサーバーで作成したバックアップは復元できません。backup_id を知っていても、現在のサーバーで作られたバックアップでない場合は このバックアップは別のサーバーで作成されたため、復元できません。 と表示され、復元は行われません。
「/backup info」で詳細を確認する
「/backup info」コマンドでも、Discord 上でバックアップの詳細を確認できます。backup_id を指定すると、本人だけに見えるカード形式で次の情報が表示されます。
- バックアップの名前とサーバーアイコン
- バックアップの ID
- 作成日時
- 保存当時のメンバー数
- チャンネルの構成(カテゴリーの下にテキストチャンネル・ボイスチャンネルがぶら下がる形)
- ロールの一覧
このカードには 2 つのボタンが付いています。
| ボタン | 動作 |
|---|---|
| 「データを更新 (上書き)」 | 現在のサーバーの状態を取り込み、このバックアップを上書きします。 |
| 「削除」 | このバックアップを完全に削除します。 |
これらのボタンを押すと、別のメッセージで確認を求めるのではなく、いま表示しているカードと同じメッセージ内で確認画面へ切り替わります。処理中の表示や処理結果も、すべて同じメッセージの中で続けて表示されます。
「データを更新 (上書き)」をクリックすると、同じメッセージ内で ⚠️ バックアップ「(バックアップ名)」を現在のサーバー状態で上書きしますか? 以前のバックアップデータは失われます。 という確認に切り替わります。実行を選ぶと ⏳ 更新中... のあとに バックアップデータを更新しました。 と表示されます。更新の完了・失敗の結果画面には「戻る」ボタンが付いており、クリックすると最新の情報を取り直して、もとの詳細カードへ戻れます。
「削除」をクリックすると、同じメッセージ内で ⚠️ バックアップ「(バックアップ名)」を削除しますか? という確認に切り替わります。実行を選ぶと ⏳ 削除中... のあとに バックアップを削除しました。 と表示されます。
「/backup info」のボタン操作は、そのコマンドを実行した本人だけが使えます。ほかの人がボタンをクリックすると 操作権限がありません。 と表示され、操作は行われません。
更新・削除は、いま操作しているサーバーで作成したバックアップにのみ作用します。別のサーバーで作成したバックアップを誤って削除・上書きしてしまうことはありません(操作のたびにサーバーの境界が確認されます)。
上限とタイムアウト
バックアップ機能では、Discord 側の仕様や Bot の処理の都合で、いくつかの上限・待ち時間があります。
| 項目 | 内容 |
|---|---|
| バックアップ ID | 1 件ごとに 8 文字の固有 ID が割り当てられます。 |
| 確認ダイアログの有効時間 | 復元・更新・削除の確認ダイアログは、表示から 60 秒で期限切れになります。 |
| コマンド入力時の候補表示 | backup_id の入力時に表示される候補は最大 25 件までです。候補のラベルが長い場合は途中で省略されます。 |
| 絵文字の復元 | Discord のレート制限に配慮し、絵文字を 1 つずつ少しずつアップロードします(1 件ごとに約 0.5 秒の間隔)。 |
| ステッカーの復元 | 同様に、ステッカーは 1 件ごとに約 1 秒の間隔でアップロードします。 |
絵文字やステッカーの数が Discord の 1 サーバーあたりの上限(おおむね絵文字 250 個・ステッカー 5 個)を超える場合、上限を超えた分はアップロードされずに飛ばされます。このとき復元は途中で止まらず、最後まで処理を続けたうえで、飛ばした分を結果に知らせます。
確認ダイアログは 60 秒で期限切れになります。時間内に応答しなかった場合はボタンが反応しなくなりますので、その場合はもう一度コマンドを実行し直してください。
表示されるメッセージ
バックアップ操作で Bot が表示する主なメッセージは次のとおりです。いずれも本人だけに見える(エフェメラルな)メッセージとして表示されます。
| 状況 | メッセージ |
|---|---|
| 作成に成功 | バックアップを作成しました。 |
| 復元に成功 | 復元が完了しました。 |
| 復元は完了したが一部失敗 | 復元が完了しましたが、一部のステップで問題が発生しました。 |
| 更新(上書き)に成功 | バックアップデータを更新しました。 |
| 更新に失敗 | 更新に失敗しました (バックアップが存在しない可能性があります)。 |
| 削除に成功 | バックアップを削除しました。 |
| バックアップが見つからない | バックアップが見つかりません。 |
| 別サーバーのバックアップを復元しようとした | このバックアップは別のサーバーで作成されたため、復元できません。 |
| 確認をキャンセルした | キャンセルしました。 |
| ボタンの操作権限がない | 実行権限がありません。 または 操作権限がありません。 |
| Bot に管理者権限がない状態で復元した | Botに管理者権限がありません。復元が不完全になる可能性があります。 |
注意点・うまくいかないとき
- 復元はやり直しがききません。 復元を実行すると既存のロールとチャンネルが削除されてからバックアップの内容で作り直されます。チャンネル内のメッセージなど、削除されたものは元に戻せません。
- 別のサーバーのバックアップは復元できません。
backup_idを知っていても、現在のサーバーで作成したバックアップでなければ復元は行われず、このバックアップは別のサーバーで作成されたため、復元できません。と表示されます。 - Bot に管理者権限がないと復元が不完全になります。 Bot の権限が不足していると、ロールやチャンネルの一部が作り直せないことがあります。この場合は
Botに管理者権限がありません。復元が不完全になる可能性があります。という注意が添えられたうえで、できる範囲まで復元が進みます。復元の前に、Bot に十分な権限(できれば管理者権限)があることを確認してください。 - 絵文字・ステッカーは Discord の上限を超えると飛ばされます。 上限を超えた分はアップロードされませんが、復元自体は途中で止まらず最後まで進みます。
- ボタン操作は実行した本人だけが行えます。 「
/backup info」の「データを更新 (上書き)」「削除」ボタンは、コマンドを実行した本人以外がクリックしても反応しません。 - 確認ダイアログは 60 秒で期限切れになります。 時間が経ってからボタンを押しても反応しない場合は、コマンドを実行し直してください。
- 復元では一部のサーバー設定は元に戻りません。 サーバー名・AFK チャンネル・システムチャンネルは復元されますが、認証レベルやコンテンツフィルターの設定は復元されません(これらはバックアップに保存されますが、確認用の情報です)。
コマンド一覧
| コマンド | 動作 | 使える人 | 表示 |
|---|---|---|---|
「/backup create」 | 現在のサーバーの状態をバックアップとして保存します。 | 管理者権限を持つメンバー | 本人だけに表示 |
「/backup load」 | バックアップからサーバーを復元します(既存の構成は削除されます)。 | 管理者権限を持つメンバー | 本人だけに表示 |
「/backup info」 | バックアップの詳細を表示し、更新・削除のボタンを提供します。 | 管理者権限を持つメンバー | 本人だけに表示 |
いずれのコマンドも、標準では Discord の管理者権限を持つメンバーだけが実行できます。ダッシュボードの「コマンド権限設定」で、コマンドごとに有効・無効や独自の権限を細かく設定することもできます。
バックアップを削除する
不要になったバックアップは、ダッシュボードから削除できます。
削除したいバックアップを選ぶ
「保存済みバックアップ」一覧から、削除したいバックアップを見つけます。
削除ボタンをクリックする
そのバックアップの削除ボタンをクリックして、一覧から取り除きます。
保存して反映する
削除はその場では下書きの状態です。画面下部の保存バー(後述の「設定を保存する」参照)で「保存」すると、削除が確定して反映されます。
削除を「保存」すると、そのバックアップはダッシュボードの一覧から取り除かれます。削除する前に、本当に不要なバックアップかどうかをよく確認してください。
バックアップがまだないとき
保存済みバックアップが 1 つもない場合、「保存済みバックアップ」セクションには次のように案内が表示されます。
現在保存されているバックアップはありません。 Botのコマンドから作成してください。
このときは、Discord 上で Bot に「/backup create」コマンドを実行してバックアップを作成してください。
設定を保存する
このページで行った変更(コマンド権限設定の変更や、バックアップの削除など)は、すぐには反映されません。変更を加えると画面下部に「未保存の変更があります」というバーが表示されます。
- 「保存」をクリックすると、変更内容が確定して反映されます。
- 「破棄」をクリックすると、変更を取り消して保存前の状態に戻します。
ページを離れる前に、必要な変更は「保存」しておきましょう。保存せずに破棄すると、それまでの変更は失われます。