BotShadeBot 機能（モジュール）
抽選(プレゼント企画 / Giveaway)
サーバーのメンバーが参加できるプレゼント抽選(Giveaway)を開催する機能です。抽選の作成・終了・再抽選は Discord 上のコマンドで行い、ダッシュボードではコマンドの権限と当選メッセージを設定します。すべてのプランで利用できます。
コマンド・コンテキストメニュー(抽選メッセージの右クリックメニュー)の有効化と権限は コマンド権限設定 で行います。
コマンド一覧
「誰が使えるか」は、個別権限設定をしていない初期状態の挙動です。
| コマンド / メニュー | できること | 誰が使えるか |
|---|---|---|
/giveaway create | 抽選を作成し、参加ボタン付きメッセージを投稿します。賞品・当選者数・期間のいずれかを省略すると、項目を順に入力する作成ウィザードが開きます。 | 「Manage Server(サーバー管理)」権限を持つメンバー |
/giveaway end | 進行中の抽選を手動で終了し、当選者を選んで結果を投稿します。 | 「Manage Server(サーバー管理)」権限を持つメンバー |
/giveaway reroll | 終了済みの抽選から当選者を選び直します。 | 「Manage Server(サーバー管理)」権限を持つメンバー |
/giveaway edit | 管理ハブを開き、抽選の作成・一覧・詳細表示・編集・削除を行います。一覧に表示されるのは最新 10 件までです。 | 「Manage Server(サーバー管理)」権限を持つメンバー |
| 「抽選を終了する」(右クリックメニュー) | /giveaway end と同じです。 | 管理者(Administrator)権限を持つメンバー |
| 「抽選をリロールする」(右クリックメニュー) | /giveaway reroll と同じです。 | 管理者(Administrator)権限を持つメンバー |
右クリックメニューをほかのメンバーにも使わせるには、コマンド権限設定 でホワイトリストに追加してください。ただし、使えるのは「Manage Server(サーバー管理)」権限を持つメンバーか、抽選の作成者本人に限られます。
抽選の動作
- 参加ボタンは押すたびに参加・取り消しが切り替わります。
- 期間が来ると Bot が自動で終了します。 当選者を選び、抽選メッセージへの返信として当選メッセージを投稿します。終了は時刻ちょうどではなく、数十秒ほど遅れることがあります。
- 当選者は参加者からランダムに選ばれます。 ボーナスエントリーを設定している場合は、対象ロールを持つ参加者が当選しやすくなります。
- 参加者が当選者数より少ないときは、いる人数だけが当選します。 参加者がいないまま終了した場合は
当選者なし！と表示されます。 - 参加条件は最初に参加するときだけ確認されます。 参加を取り消して入り直すときは再確認されないため、条件を満たさなくなった人が参加状態を保てる場合があります。
- 抽選メッセージを Discord 上で削除すると、終了・再抽選の結果を投稿できなくなります。
/giveaway editの「削除」は抽選そのものを取り消す操作で、当選者の選出も結果の投稿も行いません。当選者を決めたい場合は/giveaway endを使ってください。/giveaway editで変更できるのは賞品名・当選者数・期間の延長です。期間を短くすることはできません。
参加条件とボーナスエントリー
| 設定 | 内容 | プラン |
|---|---|---|
| 必須ロール | 指定したロールを持つメンバーだけが参加できます | すべて |
| アカウント作成からの経過日数 | 7 / 14 / 30 / 90 日以上経過したアカウントだけが参加できます | Plus 以上 |
| サーバー参加からの経過日数 | サーバーに参加してから 1 / 7 / 14 / 30 日以上たったメンバーだけが参加できます | Plus 以上 |
| ボーナスエントリー | 指定したロールを持つ参加者の抽選口数を +1〜+5 増やします。複数の対象ロールを持つ場合は合算されます | Plus 以上 |
上限
| 項目 | Free | Plus | Pro | Max |
|---|---|---|---|---|
| 同時に開催できる抽選 | 2 件 | 5 件 | 20 件 | 無制限 |
| 当選者数 | 5 人 | 15 人 | 50 人 | 無制限 |
| 実施期間 | 7 日 | 30 日 | 90 日 | 無制限 |
プランに関係なく、賞品名は最大 100 文字、抽選メッセージのタイトルは最大 256 文字、説明は最大 1000 文字です。色の書き方は 色の指定 をご覧ください。抽選コマンドにクールダウンはありません。
当選メッセージ
抽選が終了して当選者が決まったときに Bot が送るメッセージを、ダッシュボードの「当選メッセージ設定」で作ります。本文(最大 2000 文字)と埋め込みを設定でき、埋め込みの編集画面は他の機能と共通です(埋め込みメッセージ)。
本文と埋め込みの各欄では、次の抽選変数を使えます。
| 変数 | 内容 |
|---|---|
{Giveaway.prize} | 賞品の名前 |
{Giveaway.winners} | 当選者のメンション一覧 |
{Giveaway.winnerNum} | 当選者の総数 |
{Giveaway.participators} | 参加者のメンション一覧 |
{Giveaway.participatorNum} | 参加者の総数 |
{Giveaway.winUser} | 代表当選者(最初の当選者)。{Giveaway.winUser.name} {Giveaway.winUser.mention} {Giveaway.winUser.id} で名前・メンション・ID を取り出せます |
{Giveaway.endTime} | 抽選の終了日時(Discord の動的タイムスタンプ) |
{Giveaway.creatorMention} | 抽選作成者のメンション |
{Giveaway.messageUrl} | 抽選メッセージへのリンク URL |
表示されるメッセージ
X や <...> の部分には、上限値や操作名などが入ります。
| 表示されるメッセージ | 状況と対処 |
|---|---|
参加条件を満たしていません: | 続けて表示される条件(必須ロール・アカウント経過日数・サーバー参加日数)を満たしていません。条件を満たしてから参加してください。 |
この抽選は既に終了しています。 | 終了済みの抽選に参加しようとした、またはもう一度終了しようとしました。 |
このプランでは当選者数をX人までしか設定できません。 | 当選者数がプランの上限を超えています。上限内で指定するか、プランを変更してください。 |
このプランでは実施期間をX日までしか設定できません。 | 実施期間がプランの上限を超えています(編集時は 残り実施期間 として表示されます)。 |
このプランで同時開催できる抽選はX件までです。進行中の抽選が終了してから作成してください。 | 同時開催数の上限に達しています。進行中の抽選が終了すると作成できます。 |
アカウント経過日数・サーバー参加日数の条件は有料プラン限定です。 / ボーナスエントリーは有料プラン限定です。 | Free プランでは使えない条件を指定しました。 |
この抽選を作成した本人、またはサーバー管理者のみが<操作>できます。 | 作成者でも管理者でもないメンバーが、終了・再抽選・編集・削除をしようとしました。 |
終了済みの抽選は編集できません。 | 編集できるのは進行中の抽選だけです。 |
変更する項目を1つ以上指定してください。 | 編集で何も指定していません。 |
結果の表示に失敗しました。元のメッセージが見つからないか、権限がありません。 | 抽選メッセージが削除されたか、Bot にそのチャンネルの権限がありません。 |
エラー: このチャンネルにメッセージを送信する権限がありません。 | Bot に投稿先チャンネルへの送信権限を付けてください。 |
これは抽選メッセージではありません。 | 抽選以外のメッセージに右クリックメニューを使いました。 |
次のステップ / 関連ページ
最終更新: