イベントモジュール: 管理者向けセットアップガイド

このガイドでは、管理者向けに、イベントモジュールの有効化、シーズンイベントの開始、報酬の設定、そして Discord、/setup ハブ、Web ダッシュボードからのイベント運営を順に説明します。メンバー側からイベントがどう見えるか（ドロップ、テーマ付きメッセージ、探索、スコア）については、コミュニティイベントの機能ページ を参照してください。

モジュールのオンとオフ

イベントモジュールは既定でオンなので、メンバー向けの /event と/setup にある管理者向けのイベント管理カードはすぐに使えます。オフにする（または再びオンにする）には、次の手順に従います。

1. Levlix ダッシュボード を開き、サーバーを選択します。
2. モジュール に移動し、イベント モジュールを切り替えます。/setup の コミュニティ、イベント からも切り替えられます。
3. 変更は 1 分以内に Discord に反映されます。

同時に開催できるイベントは 1 つ

サーバーで同時に実行できるイベントは最大 1 つです。イベントは次の 2 つの方法のどちらかで始まります。

• 手動: 管理者が 9 つのテーマから好きなものを選び、最終日を指定します。イベントはその日の 23:59:59 UTC に終了します。
• 自動シーズン: オンにすると、Levlix は毎日 00:05 UTC とボットの起動時にカレンダーを確認します。シーズン中のテーマがあり、実行中のイベントがなければ、そのテーマを開始し、テーマの期間の終わりに終了します。

自動シーズンはあなたの判断を尊重します。現在の期間内ですでに開始されたテーマは再び開始されないため、早めに終了したイベントは終了したままです。手動で開始したイベントは、終了するまで自動シーズンをブロックします。

開始するには、Levlix が閲覧、メッセージの送信、リアクションの追加、メッセージ履歴の読み取りを行えて、除外されていないテキストチャンネルが少なくとも 1 つ必要です。そうでない場合、開始は拒否され、その旨を伝えるメッセージが表示されます。イベント中にチャンネルへの投稿に失敗した場合、Levlix はその回の残りの期間、そのチャンネルをスキップします。

Discord の管理カード

サーバー管理 権限を持つ管理者は、/setup でイベント管理カードを開きます。コミュニティ、イベント、イベント管理を開く の順に選んでください。

カードには 4 つのタブがあり、下部のメニューから選びます。

• ステータス: イベントが実行中かどうか、いつ終了するか、これまでのメンバー数、ドロップ数、発見数。延長 は終了日を移動し、イベント終了 は確認後にイベントを終了して、すぐに勝者発表を行います。実行中のイベントがない場合は、開始するテーマ でテーマを選び、終了日（YYYY-MM-DD、UTC）を入力します。
• 報酬: 支払い率、1 位から 3 位のボーナス、勝者ロール。数値を編集 を押すと、支払い率（0 から 200 %）、3 つのボーナス、勝者ロールを受け取る上位メンバーの人数（1 から 10）を入力するフォームが開きます。ロールは 勝者ロール（任意） で選び、勝者ロールを削除 で解除します。
• お知らせ: お知らせチャンネル、メンションするロール、自動シーズンのスイッチ（自動シーズンをオンにする または 自動シーズンをオフにする）。
• ランキング: 現在の回の上位 10 人と、過去 5 回分の結果とその勝者。

除外チャンネル、アクティビティレベル、クールダウンは Web ダッシュボードで設定します。カードにはそこへのリンクがあります。

報酬

• 支払い: スコアが増えるたびに、score × payout / 100 のサーバーポイント（切り捨て）が支払われます。既定は 100 %、範囲は 0 から 200 % です。0 % の場合、イベントはランキングとボーナスのためだけに行われます。
• ボーナスポイント: 既定では 1 位、2 位、3 位にそれぞれ 500、300、150 サーバーポイント（それぞれ 0 から 100,000）が支払われます。ボーナスは支払い率に関係なく、常に全額支払われます。
• 勝者ロール: 任意です。各イベントの終了時に、Levlix は上位メンバー（既定では上位 3 人）にこのロールを付与します。メンバーは次のイベントが始まるまでロールを保持し、その時点で Levlix がロールを外します。
• 同点: スコアが同じ場合は、最後にスコアを獲得した行動が早かったメンバーが上位になります。

お知らせ

Levlix はイベントごとに 3 つのメッセージを投稿します。開始時（用意された報酬を含む）、終了の 24 時間前の予告、そして上位 10 人を発表する勝者発表です。投稿先はお知らせチャンネルで、設定されていない場合はサーバーのシステムチャンネルになります。どちらもない場合は投稿されません。メンションするロールは、開始時と勝者発表の投稿でのみメンションされます。

セットアップハブ

/setup では、コミュニティ の下の イベント ページでモジュールをオンまたはオフにでき、基本設定として カレンダーに合わせてイベントを開始（自動シーズン）、お知らせチャンネル、メンションするロール があります。イベント管理を開く は上で説明した管理カードを開き、ダッシュボードを開く は Web の管理ページに移動します。

Web ダッシュボード

• サーバーのイベントページ（/server/{id}/events、すべてのメンバーが閲覧可能）: 実行中のイベントの参加者、ドロップ、獲得数、自分のスコア、ランキング、最近の勝者、今後 12 か月のカレンダー。
• イベント管理ページ（/server/{id}/events/admin、管理担当者向け）: テーマと最終日を指定したイベントの開始、終了日の変更や即時終了、報酬と勝者ロール、お知らせチャンネル、通知ロール、シーズンに合わせて開始（自動シーズン）、ランキング、終了したイベントとその勝者のアーカイブ。

次の 3 つの設定は Web の管理ページにしかありません。

• アクティビティレベル: 低（ドロップ半分）、標準、高（1.5 倍）。標準では、活発なチャットで 1 時間あたり約 6 回の絵文字ドロップ、2 回のテーマ付きメッセージ、1 回の探索が発生します。
• クールダウン: 1 人のメンバーがスコアを獲得できるドロップやメッセージの間隔（秒）。0 から 600（既定は 60）。探索にはクールダウンがありません。
• 除外チャンネル: 何も出現せず、メッセージがチャットのアクティビティに数えられないチャンネルやカテゴリ全体。

メンバー向けコマンド一覧

モジュールが有効な場合、次のコマンドは誰でも使えます。

参加をやめる設定は、Levlix を使うすべてのサーバーのすべてのイベントに適用されます。参加をやめたメンバーのリアクションと探索の回答はカウントされず、そのメッセージもチャットのアクティビティに数えられません。

セットアップチェックリスト

• お知らせチャンネル を選びます。選ばない場合、投稿はシステムチャンネルに送られるか、スキップされます。
• 自動シーズン をオンにするか、テーマを手動で開始するかを決めます。
• 報酬 を確認します: 支払い率、3 つのボーナス、必要であれば勝者ロール。
• ドロップが邪魔になるチャンネル（ルール、お知らせ、サポート）を Web ダッシュボードで除外します。
• チャットチャンネルで Levlix がメッセージの送信、リアクションの追加、メッセージ履歴の読み取りを行えることを確認します。