Levlix モジュール連携ガイド
モジュール連携は、サーバーの Levlix モジュールをつなぎます。レベルアップでポイントを、カウントのマイルストーンで XP やゴールドを、クイズの正解でゴールドを支払えるほか、メンバーは /exchange でサーバーのポイントと RPG のゴールドを両替できます。
すべて、オンにするまではオフです。報酬と両替の方向はそれぞれ別のスイッチで、量と 1 日の上限も個別に設定します。
オンにする
- Levlix ダッシュボード を開き、サーバーを選んで、モジュール ページ(サイドバーの サーバー セクション)で モジュール連携 を有効にします。
- サイドバーの経済グループにある モジュール連携 を開き、報酬と両替を設定します。
- 両替は Discord でも設定できます。
/setupを実行し、エンゲージメント → モジュール連携 を開きます。
モジュールを再びオフにすると、報酬と両替は止まり、/exchange はサーバーから消えます。マトリックスと両替の設定は、次に使うときのために保持されます。
報酬マトリックス
報酬マトリックス カードでは、モジュールが知らせるタイミングが行に、3 つの通貨が列に並びます。セルをオンにして数値を設定し、マトリックスを保存 をクリックします。
| 設定 | 説明 |
|---|---|
| 量 | 1 回のタイミングでメンバーに支払う量です。最大で 1,000 XP、10,000 ポイント、100,000 ゴールドです |
| 1日あたり | 1 人のメンバーがこの報酬を UTC の 1 日に受け取れる回数で、最大 100 です(0 = 上限なし。ただしカウントのマイルストーンを除く) |
| N 個の数字ごと | カウントのマイルストーン専用です。どの数字で支払うかを 10 から 100,000 の間で決めます(既定は 100) |
使えるタイミングは次のとおりです。
| タイミング | 元のモジュール | 支払える通貨 |
|---|---|---|
| レベルアップ | XP | ポイント、ゴールド |
| カウントのマイルストーン | カウントゲーム、N 個の数字ごと(N は 10 以上で設定) | XP、ポイント、ゴールド |
| クイズ: 正解 | クイズ | XP、ゴールド |
| RPG のボス撃破 | RPG | XP、ポイント |
タイミングが、元のモジュール自身の通貨を支払うことはありません。レベルアップで XP は支払えず、ボス戦でゴールドは支払えません。こうして報酬の連鎖を短く保ち、1 つの報酬が次々と報酬を呼ぶ無限ループを起こさないようにしています。
クイズの報酬はクイズごとに設定します。マトリックスの値は新しいクイズの初期値で、クイズごとに変更したり、報酬なしで実施したりできます。
メンバーが連携の報酬を受け取ると、そのタイミングのカード(たとえばレベルアップやクイズの結果)に、🔗 で始まる行で表示されます。何かを支払うカウントのマイルストーンには、到達した数字への返信として、カウントチャンネルに専用の短いカードが投稿されます。
ページ下部の 最近の付与 カードには、直近 50 件の支払いと両替が、日時、メンバー、タイミング、通貨、量とともに表示されます。
両替
メンバーは /exchange でサーバーのポイントと RPG のゴールドを交換します。2 つの方向は別々に設定し、両替設定を保存 で保存します。
| 設定 | 説明 |
|---|---|
| 有効 | メンバーがこの方向に両替できるかどうか |
| 1ポイントあたりのゴールド | 両替レートで、1 から 1,000 までです |
| 手数料(パーセント) | ゴールドからポイントへの両替専用です。ゴールドのうち差し引く割合で、1 から 50 パーセントまでです |
| 1日の上限(ポイント) | メンバーが UTC の 1 日に両替できるポイントです。支払ったポイント(ポイントからゴールド)または受け取ったポイント(ゴールドからポイント)で数え、最大 100,000 です。0 = 上限なし |
| 最低額 | メンバーが 1 回で両替できる最小の量で、1 から 100,000 までです |
ゴールドからポイントへの両替では、まず手数料を差し引き、残りをレートで割って端数を切り捨てます。1 ポイントあたり 10 ゴールド、手数料 10 パーセントの場合、1,000 ゴールドは 90 ポイントになります。
/setup でも保存できません。新しいサーバーでは、両方向がオフ、レートは 1 ポイントあたり 10 ゴールド、手数料は 10 パーセント、1 日の上限は 500 ポイント、最低額は 1 で始まります。
コマンド
| コマンド | 機能 | 必要な権限 |
|---|---|---|
/exchange |
サーバーのレート、自分のポイントとゴールドを表示する、自分だけの両替カードを開きます。方向ごとのボタンを押すと量を入力できます | 全員 |
/exchange direction amount |
すぐに両替します。例: /exchange direction: ポイントをゴールドに amount: 100。量は、支払う通貨で 1 から 100,000 までです |
全員 |
/setup → モジュール連携 |
両替の 2 つの方向を設定します。報酬マトリックスはダッシュボードにあり、報酬ルール で開けます | サーバー管理 |
仕組み
- 両替するには、どちらの方向でもメンバーに RPG のキャラクターが必要です。キャラクターがない場合、カードは
/rpg startを案内します。 - 両替では、まずメンバーから元の通貨を差し引き、その後で両替先の通貨を支払います。支払いが確認できない場合、Levlix はそれでも届いたかどうかを調べ、支払いが確実に失敗したときだけ元の通貨を返金します。そのため、メンバーに 2 回支払われることはありません。
- 同じメンバーの両替が同時に 2 つ実行されることはないので、2 回クリックしても 1 日の上限を超えることはありません。
/privacyで アクティビティ記録 をオフにしたメンバーや、Levlix にデータを削除してもらったメンバーは、連携の報酬を受け取りません。- 報酬と両替は、メンバー、タイミング、通貨、量とともに台帳に記録されます。90 日より古い記録は削除されますが、確認を待っている両替は残ります。
- ダッシュボードでの変更は 1 秒以内にボットに反映されます。
よくある質問
メンバーが報酬を受け取れませんでした。
セルがオンになっていること、対象のモジュール(XP または RPG)が有効なこと、ゴールドの場合はメンバーに RPG のキャラクターがあること、メンバーがそのセルの 1 日の上限に達していないこと、メンバーが /privacy で アクティビティ記録 をオフにしていないことを確認してください。
メンバーが XP を両替できないのはなぜですか? XP は獲得するだけのものです。差し引かれることも両替されることもないので、レベルは常に実際の活動を表します。
誰が何を両替したか確認できますか? 両替は、メンバーのポイント履歴と 最近の付与 カードに表示されます。ダッシュボードで行ったマトリックスや両替の変更は、すべてダッシュボードの監査ログに記録されます。