よくある質問(FAQ)

ダッシュボードの「よくある質問」には「基本設定」「トラブルシューティング」「機能と仕様」の 3 つのカテゴリに計 18 問が掲載されています。本ドキュメントでは、これらに加えて、よく表示されるエラーメッセージ・クールダウン・各機能の上限を「困ったときの参考情報」として後半にまとめています。

ダッシュボードでは、左側メニューの「ヘルプ & サポート」を開き、「よくある質問」セクションまでスクロールすると、同じ内容をアコーディオン形式で確認できます。

ダッシュボードで FAQ を見る手順

基本設定

BotShade を利用するために必要なものはありますか?

Web ブラウザと Discord アカウントのみです。VPS やクラウドサーバーの契約は一切不要で、Bot のホスティング・データ保管・常時稼働はすべて BotShade のクラウド基盤で行います。

対応ブラウザは最新版の Chrome / Edge / Firefox / Safari です。初期登録は Discord OAuth2 の 1 クリックで完了します。コマンドライン操作や Node.js / Python などの実行環境の知識は不要です。

Bot を初めて作成する手順を教えてください。

プレミアムプランへのアップグレード方法は?

ダッシュボード左下のユーザーメニューから「プラン管理」を開くと、いつでもアップグレードできます。決済が完了すると、すぐに次の内容が有効になります。

• 保有可能 Bot 数の上限解放
• 各モジュールのプレミアム機能(カスタムコマンド無制限・ストレージ拡張・優先ホスティング 等)
• 優先サポートチャネルへのアクセス

請求は月額 / 年額から選択でき、いつでも解約できます(解約後も、支払い済み期間の末日まで機能を利用できます)。支払い方法はクレジットカード(Stripe 経由)に対応しています。

作成した Bot を削除するとどうなりますか?

Bot 本体と、それに紐づく以下のデータがすべて完全に削除されます。

• モジュール設定値
• カスタムコマンド
• イベント定義
• ストレージ内の Key-Value
• ログ履歴
• バックアップ

これらは復元できません。

一方で、Discord Developer Portal 側の Bot アプリケーション自体は削除されません。完全に不要な場合は、そちらからも別途削除してください。

作成した Bot を自分のサーバーに導入するには?

ダッシュボードの Bot 詳細ページ上部に「招待リンク」が常時表示されています。リンクをクリックして導入先サーバーを選択し、Bot が要求する権限を確認したうえで「認証」を行うと完了です。最短 10 秒程度で Bot がオンラインになります。

招待には、導入先サーバーで「サーバーの管理(MANAGE_GUILD)」権限が必要です。同じ Bot を複数のサーバーへ導入することもでき、モジュール設定やカスタムコマンドはサーバー単位で独立して管理されます。

1 つのアカウントで Bot を何個まで作成できますか?

フリープランでは最大 1 個、BotShade Pro では当面 10 個まで同時に保有できます(順次、上限を拡張する予定です)。

プランをダウングレードした場合、上限を超えた分は自動的に「停止」状態になり、データは保持されたまま残ります。再びアップグレードすれば、追加の作業なしで復帰できます。

チーム / 法人向けに 20 個以上の枠が必要な場合は、Discord サポートサーバーで個別にご相談ください。

トラブルシューティング

導入した Bot が「オフライン」のまま動きません。

多くの場合、原因は Intents 設定か、トークンの貼り付けミスです。以下を順に確認してください。

スラッシュコマンド(/)を入力しても候補に出てきません。

Discord 側のコマンドキャッシュが原因で、登録した直後は反映まで数分から最大 1 時間ほどのタイムラグがあります。以下をお試しください。

ダッシュボードが正常に表示されません / 画面が真っ白になります。

多くの場合、ブラウザキャッシュや古い Service Worker が原因です。以下をお試しください。

設定を変更したのに Bot に反映されません。

通常は保存と同時に即座に反映されますが、次のケースでは追加のアクションが必要です。

加えて、保存ボタンをクリックした後に「保存しました」というトーストが表示されているか(ネットワーク不調で失敗していないか)も確認してください。

Bot が突然反応しなくなりました。

一時的な接続障害か、API レート制限の可能性があります。以下を確認してください。

「Missing Permissions」「Missing Access」エラーが頻発します。

Bot の Discord ロールに必要な権限が不足しているか、対象チャンネルで Bot が明示的に拒否されています。以下を確認してください。

権限が不足している状態でスラッシュコマンドを実行すると、Bot は自分だけに見える(エフェメラルな)メッセージで、不足している権限名を伝えます。あなた自身の権限が足りないときは このコマンドを実行するには、あなたに以下の権限が必要です: に続けて権限名が表示され、Bot 側の権限が足りないときは Botがこのコマンドを実行するには、以下の権限が必要です: と表示されます。表示された権限を、上記の手順でロールやチャンネルに付与してください。

コマンドを実行すると「連続して使用できません」と表示されます。

一部のコマンドには、連続実行を防ぐためのクールダウン(待機時間)が設定されています。クールダウン中に同じコマンドを実行すると、このコマンドは連続して使用できません。 に続けて、あと何秒待てばよいかが表示されます。表示された秒数だけ待ってから、もう一度お試しください。これはエラーではなく、想定どおりの動作です。

カスタムコマンドの実行が途中で止まる / 最後まで動きません。

カスタムコマンドには、サーバー全体の動作を守るために実行時間とステップ数の上限があります。1 回の実行は最長 30 秒で打ち切られ、処理の段数(ステップ)は 5000 までに制限されています。これを超えると、実行した本人だけに見えるエフェメラルなメッセージが表示され、残りの処理はスキップされます。

途中で止まってしまう場合は、繰り返し(ループ)の回数を減らす、条件分岐を整理する、1 つのコマンドに詰め込みすぎず複数のコマンドに分ける、といった見直しが有効です。なお、ループの回数は 1 ブロックあたり最大 100 回までに自動で抑えられ、それを超える値を指定しても上限内に収められます(このとき特にメッセージは表示されません)。

機能と仕様

メッセージの「埋め込み(Embed)」を自由にカスタマイズできますか?

ダッシュボードのツール内「Embed Builder」で、タイトル / 説明 / 色 / 画像 / サムネイル / 著者行 / フッター / タイムスタンプ / フィールド(最大 25 個)までを視覚的に編集できます。右側のプレビューには、Discord と同じレンダリングでリアルタイムに反映されます。

1 つのメッセージに最大 10 個の Embed を束ねることもできます。完成したものは Discord Webhook 互換の JSON としてコピーできるため、他の Bot / CI / GitHub Actions などにそのまま流用できます。

サーバーのメンバー数や入退室ログを自動で表示できますか?

はい。以下の 3 つの仕組みを組み合わせて自動化できます。

• 「ウェルカムメッセージ」モジュールで、新規参加者へのウェルカムメッセージを自動で送信できます。{user.mention} や {guild.memberCount} などの変数を埋め込んで、動的にメッセージを生成できます。
• 「カスタム変数」とチャンネル名同期を組み合わせれば、ボイスチャンネル名を「👥 メンバー: 1,234」のように自動更新できます。
• 参加 / 退出 / Ban / Kick / ロール変更 / メッセージ削除などの監査系イベントは、「ログ」モジュールで指定チャンネルへ自動送信できます。イベントごとに ON / OFF・送信先を個別に設定できます。

データのセキュリティ・プライバシーは大丈夫ですか?

通信は TLS 1.3、保存データは AES-256 で暗号化しています。

Bot トークンは KMS(鍵管理サービス)に格納し、運営側でも平文での閲覧・エクスポートはできない設計です。保持する個人情報は Discord ユーザー ID とメールアドレスのみで、同意なく第三者へ提供することはありません。

GDPR / 改正個人情報保護法(APPI)に準拠しており、アカウント削除時には紐づくデータもすべて完全に消去されます。詳細は利用規約・プライバシーポリシーをご参照ください。

1 つの Bot を複数のサーバーで使い回せますか?

はい。1 つの Bot を複数のサーバー(ギルド)に導入でき、以下はサーバーごとに完全に独立して管理されます。

• 各モジュールの ON / OFF
• ウェルカム文面
• カスタムコマンドの対象
• ロールパネル
• ログ出力チャンネル
• ストレージ値

一方で、Bot のアイコン / 名前 / 自己紹介は Discord Developer Portal 側のアプリケーション単位で管理されるため、全サーバーで共通です。

サーバー横断の集計(全サーバーの合計メンバー数 等)は、Servers ページから閲覧できます。

カスタムコマンドは何個まで作成でき、どこまでの処理ができますか?

作成できる個数はプランによって異なります。

処理内容は、以下までサポートしています。

• テキスト応答
• Embed 送信
• ロール付与 / 剥奪
• チャンネル転送
• 変数置換(ユーザー名・サーバー名・現在時刻 等)
• 条件分岐(GUI ブロックで組み立て)
• ストレージ Key-Value の読み書き

スラッシュコマンドとプレフィックスコマンドの両方で動作し、コマンドごとに個別の有効 / 無効・対象チャンネル制限を設定できます。

BotShade ストレージには何を保存できますか?

ストレージモジュールでは、任意の JSON 互換データを Key-Value で保存できます(経済系のコイン残高・ユーザー別ポイント・サーバーごとの設定値 等)。

容量の上限はプランによって異なります。

読み書きは、カスタムコマンド・イベントビルダー・外部 API(Bot Webhook)から可能で、キーの一括インポート / エクスポートにも対応しています。

上限とクールダウンの早見表

「思ったように作成できない」「反応しない」と感じたときは、まず各機能の上限やクールダウンに当たっていないかを確認すると、原因の切り分けが早くなります。

投票・抽選・ロールパネルでは、名前(投票名・パネル名)はサーバー内で重複できません。同じ名前を指定すると、投票名 「(指定した名前)」 は既に使用されています。別の名前を指定してください。 のように、別名を求めるエフェメラルなメッセージが表示されます。

上限に達したときに表示される、主なエフェメラルメッセージは次のとおりです(ベータ期間中はプレミアム相当の緩い上限で利用できるため、通常はこれらの上限には達しにくくなっています)。

自動応答・レベリングが「無反応」なのは正常な場合があります

次の機能は、条件によっては「あえて何も表示しない」動作になります。無反応に見えても不具合とは限りません。

• 自動応答(オートレスポンダー): クールダウンを設定している場合、待機時間内に再度トリガーが一致しても、応答は送られません(静かにスキップされます)。また、対象チャンネルやロールのホワイトリスト / ブラックリストの条件で除外されている場合も応答しません。
• レベリングの XP 付与: 同じ人が短時間に連続で発言した場合、クールダウン(初期値は約 10 秒、サーバーごとに変更可能)の間は XP が加算されません。この間も特にメッセージは表示されません。

サーバー保護(荒らし対策)による自動アクション

サーバー保護(レイド・大量メンション・サーバー破壊への対策)を有効にしていると、しきい値を超えた操作に対して Bot が自動でアクションを実行します。代表的な初期値は次のとおりです(いずれもサーバーごとに変更可能で、ホワイトリスト対象は除外されます)。

• 大量メンションの検出: 1 メッセージに 5 件を超えるメンションを検出すると、そのメッセージを削除し、大量メンションを検出しました。メッセージを削除しました。 という警告をチャンネルに送信します(この警告は約 5 秒後に自動削除されます)。
• サーバー破壊対策(Anti-Nuke): 短時間に集中した破壊的操作(BAN・キック・チャンネル削除・ロール削除など)を 1 分間の枠で監視し、しきい値(初期値は 1 分あたり 5 件)を超えた実行者にアクションを行います。
• レイド対策(Anti-Raid): 短時間に大量のメンバー参加(初期値は 10 秒以内に 10 人)を検出すると、設定したアクションを実行します。必要に応じてチャンネルのロックや、通知ロールへのメンションも行われます。

これらの自動アクションが意図せず作動する場合は、対象のしきい値を見直すか、信頼できるロール・メンバーをホワイトリストに追加してください。

次のステップ / 関連ページ

• ストレージ — Key-Value データの保存と容量の詳細
• レベリング — モジュールごとの設定方法
• 解決しない場合は、ダッシュボードの「ヘルプ & サポート」画面から、Discord サーバー・ドキュメント・メールサポートのいずれかにお問い合わせください。