Levlix 招待トラッキングガイド
Levlix の招待モジュールは、どのメンバーが誰を招待したかを記録します。このデータは、アクティビティ記録、マイルストーン、ランキングの各システムに反映されます。
記録される招待を作成する
/invites create max_uses: <0-unlimited> duration: <hours> temporary: <true/false>
動作を細かく指定して、独自の招待リンクを作成できます。
| パラメーター | 説明 | デフォルト |
|---|---|---|
max_uses |
リンクを使える最大回数（0 = 無制限） | 0 |
duration |
リンクが有効な時間数（0 = 無期限） | 24 |
temporary |
true の場合、このリンクで参加したメンバーは、接続を切るとロールを失います | false |
Levlix は非公開で応答するため、リンクはあなただけに表示されます。各招待を誰が作成し、何回使われたかは自動的に記録されます。
個人用招待リンク
デフォルトでは、/invites create はコマンドを実行したチャンネルへの招待を作成します。そうではなく、すべてのメンバーに、あなたが選んだチャンネル（たとえば非表示の認証チャンネル）への固定リンクを 1 つずつ共有してほしい場合は、サーバーを個人用招待リンクに切り替えます。
/setupを実行して エンゲージメント、招待 を開くか、ダッシュボードでサーバーを開き、招待 に移動します。- 個人用招待リンク で 招待チャンネル（ダッシュボードでは 招待先チャンネル）を選びます。設定はすぐに保存されます。
招待先チャンネルが設定されている間は、次のようになります。
/invites createは常に、そのチャンネルへの無期限かつ無制限の招待を作成します。max_uses、duration、temporaryオプションは無視されます。- 各メンバーが受け取るリンクはちょうど 1 つです。コマンドをもう一度実行すると、同じリンクが返されます。
- メンバーには招待の権限が一切不要で、招待先チャンネルが見える必要もありません。誰がコマンドを実行できるかは、Discord のコマンド権限（サーバー設定、連携サービス、Levlix、
/invites）で決めます。たとえば認証済みロールだけに許可できます。 - すべてのロールから 招待を作成 を外せば、Levlix のリンクだけがサーバーへの入口になります。
- Levlix には、招待先チャンネルで チャンネルを見る と 招待を作成 が必要です。
チャンネルごとの招待に戻すには、/setup またはダッシュボードでチャンネルの選択を解除します。既存の個人用リンクは、Discord で削除するまで引き続き使えます。
メモ
Discord では、1 つのサーバーで有効な招待は最大 1,000 件までです。非常に大きなサーバーでは、メンバーごとに 1 つの無期限リンクがこの上限に達することがあります。
管理者の設定
管理者は /setup の エンゲージメント、招待 で招待のツールを使えます。個人用リンクの 招待チャンネル のほかに、画面には 招待の統計 を開く 統計 ボタンがあります。
- 追跡中の招待、招待した人の数、招待による参加、1つの招待の最多使用回数。
- 招待者トップ: 最も多くの人を連れてきたメンバー。
- 作成者が不明な招待がある場合はその注記。
同じ画面の 招待データを更新 は、既存のすべての招待をスキャンし、欠けている作成者を補います。ボットの移行後や、問題からの復旧時に使います。実行できるのは5分に1回です。サーバーの招待を読み取るには、Levlix に サーバー管理 の権限が必要です。
トラッキングの仕組み
Levlix は Discord の招待イベントをリアルタイムで監視しています。
- メンバーが参加すると、Levlix はどの招待コードが使われたかを確認し、その招待の作成者に加算します。
- 招待データはデータベースに保存され、ユーザーのアクティビティプロフィールに反映されます。
- 招待数は
/activity、/leaderboard、マイルストーンシステムに表示されます。
