イベントビルダー(近日公開)
「イベントビルダー」は、Discord サーバー上で起きた出来事(メンバーの参加・退出、メッセージの受信など)をきっかけに、Bot を自動で動かすための機能です。
イベントビルダーは現在「開発中」です。画面を開いても設定やイベントの追加はできません(2026-05 時点)。後日のアップデートで実装予定です。
イベントビルダーとは
BotShade には、Bot を動かすきっかけ(トリガー)を作る機能が 2 種類あります。
| 機能 | 動くきっかけ | 例 |
|---|---|---|
| コマンドビルダー | ユーザーがスラッシュコマンドを入力したとき | /help と打つと使い方を返信する |
| イベントビルダー(近日公開) | サーバーで何かの出来事が起きたとき | 新しいメンバーが参加したら歓迎メッセージを送る |
イベントビルダーの画面は Bot ごとに用意されており、Bot ダッシュボードのメニュー、または Bot 一覧の各 Bot カードのメニューから開けます。対応するイベントや設定項目は、正式公開時に確定します。
公開までの代替手段
イベントビルダーが正式公開されるまでの間も、似たことを実現する方法があります。用途に合わせて次の機能をご利用ください。
スラッシュコマンドで手動のきっかけを作る
「特定の操作に反応して Bot を動かしたい」という場合は、コマンドビルダーでスラッシュコマンドを作成できます。出来事に自動で反応するのではなく、ユーザーが自分でコマンドを打つ形になりますが、メッセージの送信やロールの付与といった処理を組み立てられます。
ログ画面で出来事の発生を確認する
「サーバーでどんな出来事が起きているか」を確認したい場合は、Bot ダッシュボードのログ画面で、発生した出来事やエラーの履歴を確認できます。
参考: Bot がすでに自動で反応する出来事
BotShade の Bot は、サーバー上の出来事に対してすでにいくつかの自動応答を行っています。これらはレベリングや保護などの各機能の設定として動作するもので、イベントビルダーの画面からは設定できません。
メンバーの参加・退出・BAN
メンバーがサーバーに参加・退出・追放(キック)・BAN されたとき、通知用に設定したチャンネルへメッセージを送信できます(各通知が有効で、有効なチャンネルが指定されている場合)。通知の文面はテンプレートでカスタマイズでき、参加時の既定文面は {USER_MENTION} joined!、退出時の既定文面は {USER_NAME} left.、BAN 時の既定文面は {USER_MENTION} was banned. です。
文面の中では、ユーザーのメンションや名前などを差し込むためのプレースホルダ(例: {USER_MENTION} ・ {USER_NAME})を使えます。キックや BAN を行ったモデレーターや理由が判明している場合は、{MODERATOR_MENTION} や {REASON} も差し込めます。
レベリング(XP とレベルアップ)
メッセージの送信に応じて XP を付与するレベリングは既定で有効です。ロールやチャンネルごとのボーナス倍率、XP を稼げるチャンネルの許可リスト・除外リスト(両方を設定した場合は許可リストが優先)を設定できます。レベルアップ時には設定したチャンネルへお祝いの埋め込みを送信でき、到達レベルに対応する「報酬ロール」を自動で付与できます(Bot 側に「ロールの管理」権限が必要)。
自動応答(オートレスポンダー)
特定のキーワードを含むメッセージにテキストや埋め込みを返信する自動応答も既定で有効です。判定方法は完全一致・前方一致・後方一致・「含まない」なども選べ、クールダウンの適用範囲(サーバー全体・チャンネル単位・ユーザー単位など)や、チャンネル・ロールごとの許可リスト・除外リストも設定できます。
保護(モデレーション)機能
荒らしや不正リンクへの対策として、アンチレイド(短時間の大量参加)、アンチニューク(BAN・チャンネル削除などの破壊的操作の連発)、スキャム対策(詐欺リンクの削除。既定のアクションはタイムアウト)、大量メンション対策、ゴーストピング検出があります。詳しい設定項目は保護をご覧ください。
Bot とサーバーのオーナー、許可リスト登録者や管理ロールを持つユーザーは対象外です。発動時はログチャンネルへ記録が残ります(例: Anti-Raid Triggered ・ Anti-Nuke Triggered)。「段階的な処罰(エスカレーション)」を有効にすると、同じユーザーの違反回数に応じて処罰が重くなります(おおむね 1〜2 回目は基本のアクション、3〜4 回目はキック、5 回目以降は BAN)。
リマインダーの自動送信
設定したリマインダーは、送信時刻になったものが順次送信されます。毎日・毎週・毎月の繰り返しにも対応します。送信先のチャンネルが見つからない・Bot に送信権限がないといった場合、そのリマインダーは送信に失敗します。
上限と既定値の早見表
| 項目 | 既定値・上限 |
|---|---|
| レベリング | 既定で有効 |
| 付与 XP / メッセージ | 5〜15 XP(ランダム) |
| XP 付与のクールダウン | 10 秒 |
| 最大レベル | 50 |
| アンチレイド発動条件 | 10 秒以内に 10 人超の参加(既定) |
| アンチニューク発動条件 | 1 分間に 5 回超の操作(既定) |
| 大量メンションの上限 | 1 メッセージ 5 メンション(既定。0 で無効) |
| ゴーストピング検出 | 削除が投稿から 5 分以内のときのみ |
| 自動応答の判定方法 | 部分一致(含む・大文字小文字を区別しない、既定) |
| リマインダーの送信チェック間隔 | 約 15 秒(1 回最大 100 件) |
| リマインダーのロケーション | 最大 200 文字 |
| リマインダーの添付 URL | 最大 3 件(各 500 文字まで) |
| 保護機能(アンチニューク/レイド/スキャム/ゴーストピング等) | 既定で無効 |
上限の一部はプランによって変わる設計ですが、ベータ期間中はすべての機能を無料でご利用いただけます(詳しくはプレミアム)。なお、BotShader AI のみプレビューアクセス権限が必要です。
注意点・うまくいかないとき
- 通知が送られない: 各通知が有効になっているか、指定したチャンネルが削除されていないか・正しい種類のチャンネルかをご確認ください。通知先が無効な場合は、エラーを出さずに送信されないことがあります。
- 退出とキックの区別がつかない: Bot に「監査ログの表示」権限がないと、キックでも「退出」として通知されることがあります。
- 保護機能のアクションが効かない: Bot の権限が不足していると、各アクションは静かに失敗します。キック・BAN には「メンバーをBAN/キック」権限、タイムアウトには「メンバーをタイムアウト」権限、レイド時のチャンネルロックには「チャンネルの管理」権限、メッセージ削除には「メッセージの管理」権限が必要です。
- ロール(報酬ロール)が付与されない: Bot に「ロールの管理」権限が必要です。また、付与したいロールが Bot 自身のロールより上位にあると付与できません。
- ゴーストピングが検出されない: 削除されたメッセージが Bot 側で保持されていないと検出できません。投稿から 5 分を超えた削除や、保持されていないメッセージは検出対象外です。
- 違反回数が思ったより少ない: 段階的処罰の違反回数は一時的なもので、Bot の再起動でリセットされます。
次のステップ / 関連ページ
- コマンドビルダーの概要 — スラッシュコマンドを作って Bot を動かす方法
- 全コマンド管理 — 作成したコマンドの一覧と管理
- ログ — 出来事やエラーの発生履歴を確認する
最終更新: