誕生日と記念日ガイド
誕生日モジュールは、メンバーの 4 種類の「誕生日」を記録し、それぞれを設定可能な報酬で自動的に祝います。実際の誕生日はメンバー自身が登録し、残りの 3 つは Discord のメタデータから検出されます。
4 種類のイベント
| イベント | きっかけ |
|---|---|
| 実際の誕生日 | メンバーが /birthday set で誕生日を登録したとき |
| Discord 記念日 | メンバーの Discord アカウント作成日の毎年の記念日 |
| 参加記念日 | メンバーがこのサーバーに参加した日の毎年の記念日 |
| サーバー誕生日 | サーバー自体の毎年の記念日。サーバー全体で祝います |
イベントの種類はそれぞれ個別に有効または無効にできます。実際の誕生日だけ、記念日だけ、あるいはコミュニティに合った任意の組み合わせで運用できます。
メンバー向けコマンド
ユーザー向けのコマンドはすべて /birthday グループにあります。
| コマンド | 説明 |
|---|---|
/birthday show |
自分だけに見える誕生日のハブを開きます |
/birthday set <date> |
ショートカット: 誕生日を登録します（実際の誕生日のイベントに必要） |
/birthday remove |
ショートカット: 保存されている誕生日を削除します |
ハブには 2 つのタブがあります。
| タブ | 説明 |
|---|---|
| 自分の誕生日 | 保存されている誕生日と、次の誕生日までの日数。誕生日を設定（または 誕生日を変更）でフォームが開き、削除 で誕生日を削除します |
| 近日中 | このサーバーでメンバーが共有している、近づいている誕生日 |
日付は DD-MM（例: 24-08）または YYYY-MM-DD（例: 2001-08-24）の形式で入力します。年は任意です。年を入力すると、お知らせに新しい年齢が表示されます。ほかのメンバーには日と月だけが表示されます。
各メンバーが保存できる誕生日は、サーバーごとに 1 つだけです。登録はまったくの任意です。登録しないメンバーには、実際の誕生日のイベントが発生しないだけです。誕生日を変更すると、次に変更できるまでロック期間があります。削除してから設定し直しても、このロックは解除されません。
2 月 29 日 の誕生日は、2 月 29 日がない年には 2 月 28 日に祝われます。
Discord で誕生日を管理する
管理者は /setup の コミュニティ、誕生日 でモジュールを設定します。各イベント（メンバーの誕生日、Discord 記念日、参加記念日、サーバー誕生日）にはそれぞれ専用のスイッチとチャンネルがあり、さらに当日だけ付与する誕生日ロールと、メンションするロールを設定できます。
同じページにあるメンバーの誕生日ボタンを押すと、他のメンバーを管理する画面が開きます。
| ボタン | 説明 |
|---|---|
| 誕生日を設定 | 他のメンバーの代わりに誕生日を設定します |
| 誕生日を削除 | 他のメンバーの保存されている誕生日を削除します |
| ページ送り付きの一覧 | サーバーに登録されている誕生日を確認します |
報酬
イベントの種類ごとに、次の項目を設定できます。
- ポイント: 当日にメンバーに加算されるポイント（サーバー誕生日では メンバーごとのポイント）。
- XP: レベリングシステムを通じて付与される XP（サーバー誕生日では メンバーごとの XP）。
- 誕生日ロール（24時間）: 実際の誕生日のみ。約 24 時間付与され、その後自動的に外されるロールです。途中でボットが再起動しても外されます。サーバー誕生日には代わりに 通知ロール があります。
- メッセージ: 独自のお知らせのテキストです。空のままにすると、サーバーの言語に翻訳された既定のテキストが使われます。プレースホルダー: メンバーのメンションには
{user}、年数には{years}、サーバー名には{server}を使えます（サーバー誕生日では{awarded}も使います）。
実際の誕生日、Discord 記念日、サーバー記念日は、指定したお知らせチャンネルで祝われます。チャンネルがない場合、そのイベントはお知らせされません。メッセージを空にしても、お知らせがオフになることはありません。サーバー誕生日のイベントはサーバー全体で祝われ、全員に関わるため、通常はより大きな報酬を設定します。
お知らせはサーバーの言語のカードです。自分の言語で表示 ボタンを押すと、同じカードを自分の言語で、自分だけに表示できます。
スケジュール
お知らせ時刻（UTC） の 1 つの時刻で、Levlix がその日のお祝いを投稿するタイミングが決まります。スケジューラーは 1 日 1 回、その時刻にすべてのサーバーを確認するので、お知らせをコミュニティが最も活発な時間帯に合わせられます。サーバーごとに別の cron ジョブを用意する必要はありません。
監査ログ
ダッシュボードには 監査 タブがあり、最近の変更（メンバーまたは管理者による直近 50 件の誕生日の編集）と 最近の報酬（ポイントと XP を含む直近 20 件の支払い）が表示されます。誰が日付を変更したかの確認や、報酬の支払いの検証に役立ちます。
セットアップの概要
- Levlix ダッシュボード を開き、サーバーの 誕生日 ページに移動します。
- モジュールのメインスイッチをオンにし、お知らせの時刻を選びます。
- 祝いたいイベントの種類を有効にし、それぞれの報酬とメッセージを設定します。
- 必要に応じて、実際の誕生日用の 誕生日ロール（24時間） と、サーバー誕生日用の 通知ロール を選びます。
- メンバーに
/birthday setを実行して実際の誕生日を登録するよう呼びかけます。