目次
Levlix プレゼント企画モジュールガイド
Levlix のプレゼント企画モジュールを使うと、管理者はサーバーポイントを賞品とする期間限定のプレゼント企画を投稿できます。メンバーはワンクリックで参加し、当選者は自動的に抽選されます。
関連ページ: プレゼント企画の自動化。
プレゼント企画のしくみ
- 管理者がタイトル、ポイントの賞品、当選者数、期間を設定します。Levlix は選ばれたチャンネルに プレゼント企画に参加 ボタン付きでプレゼント企画を投稿します。
- メンバーはボタンをクリックして参加します。各メンバーは 1 回だけ参加でき、投稿の参加数カウンターは参加のたびに更新されます。
- 時間切れになると、Levlix は当選者をランダムに選び、各当選者の残高に賞品を加算して、同じチャンネルに当選発表を投稿します。元の投稿には結果が表示され、ボタンがなくなります。
- プレゼント企画の投稿と当選発表は、サーバーの言語のカードです。自分の言語で表示 ボタンを押すと、同じカードを自分の言語で、自分だけに表示できます。
- 実行中のプレゼント企画はボットの再起動後も続きます。ボタンは再び取り付けられ、終了タイマーも再設定されます。ボットのオフライン中に終了時刻を過ぎたプレゼント企画は、ボットが復帰するとすぐに抽選されます。
プレゼント企画を作成する
/giveaway create channel: #giveaways
チャンネルは任意です。指定しない場合、Levlix は設定のデフォルトチャンネル、または現在のチャンネルを使います。コマンドを実行するとフォームが開きます。
| 項目 | 説明 |
|---|---|
| プレゼント企画のタイトル | 投稿の見出し。最大 255 文字 |
| 説明 | 任意のテキスト。最大 1,000 文字。既定は「参加者の皆さんの幸運を祈ります！」 |
| ポイント賞品 | 各当選者に加算されるポイント。正の数である必要があります |
| 当選者数 | 1 から 20（既定は 1） |
| 期間 | 60m、1h、1d、2d12h などの形式。数字だけの場合は分として扱われます。既定は 60m |
/giveaway create-advanced は同じフォームを開き、さらに require_game_id オプションでこのプレゼント企画だけサーバーの既定値を上書きできます。登録済みの ゲームID を持つメンバーだけが参加できるようになります。
Web ダッシュボードから
プレゼント企画 ページで 新しいプレゼント企画 をクリックし、タイトル、説明、賞品ポイント、当選者、チャンネル、期間（時間） を入力します。ゲームIDを必須にする を使うと、参加を登録済みのゲームIDを持つメンバーに限定できます。プレゼント企画を作成 を押すとプレゼント企画がボットに渡され、ボットは /giveaway create とまったく同じようにチャンネルに投稿します。投稿も プレゼント企画に参加 ボタンも、自動の抽選と支払いも同じです。
上限はコマンドと同じで、当選者は最大 20 人、期間は 1 から 720 時間です。そのチャンネルでメッセージを送信する権限が、あなたとボットの両方に必要です。
プレゼント企画を管理する
プレゼント企画の投稿にはそれぞれフッターに ID が表示され、管理者向けコマンドはこの ID を使います。
| コマンド | 説明 |
|---|---|
/giveaway end giveaway_id: <id> |
プレゼント企画を今すぐ終了し、当選者を抽選して賞品を支払います。ダッシュボードの 早期終了 も同じ動作です |
/giveaway cancel giveaway_id: <id> |
当選者なしでプレゼント企画を締め切ります。投稿は キャンセル済み と表示され、チャンネルにお知らせが送られます |
/giveaway stats giveaway_id: <id> |
ステータス、賞品、参加数、当選者、作成日時、残り時間、ジャンプリンク。ID は最近のプレゼント企画から自動補完されます。giveaway_id を指定しない場合は、サーバーのプレゼント企画の概要が表示されます |
作成、終了、キャンセル、統計の表示には、サーバー管理（または 管理者）の権限、あるいは設定の管理ロールが必要です。/giveaway settings には サーバー管理 の権限が必要です。
設定
/giveaway settings default_channel: #giveaways admin_role: @Giveaway Team enabled: True require_game_id: False
指定したオプションだけが変更されます。オプションを指定しない場合、コマンドは現在の設定を表示します。同じ設定は /setup の エンゲージメント、プレゼント企画 にもあります。
| オプション | 説明 |
|---|---|
default_channel |
チャンネルを指定せずに /giveaway create を実行したときに使われるチャンネル |
admin_role |
管理者とサーバー管理の権限に加えて、プレゼント企画の作成と管理を許可するロール |
enabled |
プレゼント企画の作成をオンまたはオフにします。オフの場合、作成コマンドは「このサーバーではプレゼント企画が現在無効になっています。」と応答します |
require_game_id |
サーバー全体の既定値: 登録済みのゲームIDを持つメンバーだけが参加できます |
メンバー向け
/giveaway prizes
3つのタブを持つ、自分だけに見えるハブが開きます。
| タブ | 説明 |
|---|---|
| 開催中 | 開催中のすべてのプレゼント企画と、その賞品、終了時刻、参加数。参加する でハブから直接参加できます |
| 自分の参加 | 自分が参加している開催中のプレゼント企画 |
| 自分の当選 | これまでに当選したプレゼント企画の数と獲得ポイント、最近の当選 |
ハブはあなただけに表示されます。
Web ダッシュボード
ダッシュボードでサーバーを開き、サイドバーで プレゼント企画 を選びます（モデレーターロール以上）。ページには、実施中のプレゼント企画、参加数の合計、賞品の合計、完了したプレゼント企画のカウンター、実施中のプレゼント企画ごとの 早期終了 ボタン付きカード、そして賞品、当選者、参加数、終了日を含む過去 50 件のプレゼント企画が表示されます。
新しいプレゼント企画 でプレゼント企画を開始します（Web ダッシュボードから を参照）。早期終了 は確認を求めたあと、ボットが当選者を抽選し、賞品を支払い、/giveaway end と同じようにプレゼント企画のチャンネルで当選者を発表します。
よくある質問
参加者が当選者数より少ない場合は？ Levlix は参加者の数だけ当選者を抽選します。参加者がいない場合は、参加者が足りなかったことを発表します。
メンバーは 2 回参加できますか？ いいえ。2 回目にクリックすると「このプレゼント企画にはすでに参加しています！」と表示されます。終了時刻を過ぎた後の参加も拒否されます。
プレゼント企画を DM で実行できますか？ いいえ。プレゼント企画はサーバーでのみ機能します。