Levlix サーバーショップガイド

Levlix のショップモジュールを使うと、サーバー管理者はサーバーの仮想ポイント通貨で購入できるアイテムを提供できます。メンバーは利用可能なアイテムを閲覧し、ポイント残高で購入し、購入履歴をすべて確認できます。操作は Discord のスラッシュコマンドからでも、Web ダッシュボードから直接でも行えます。

メンバーが買い物できる場所

閲覧と購入には、同じように使える 2 つの方法があります。

1. Discord で、下記の /shop スラッシュコマンドを使います。
2. Web ダッシュボードで、経済 → ショップ を開きます。メンバーには、サーバー管理者が設定したものと同じカタログが、現在のポイント残高、在庫状況のバッジ、購入履歴とともに表示されます。

ダッシュボードでの購入は、スラッシュコマンドとまったく同じ安全チェックを通ります。販売開始日、期限、購入制限、在庫、支払いはすべてサーバー側で確認されます。ポイントの差し引きとコードの割り当ては 1 つのデータベーストランザクションで行われるため、途中で失敗した購入（たとえばその瞬間にコードのプールが尽きた場合）でポイントが減ることはありません。受け取っていないコードの代金を請求されることは決してありません。

メンバー向けコマンド

メンバー向けのコマンドは 1 つです。

/shop

2 つのタブを持つショップ画面が開きます。

tab オプションを使うと、画面を特定のタブで直接開けます。購入制限の上限まで購入済みのアイテムと、売り切れのアイテムは表示されません。

購入を確定すると、次のように処理されます。

1. Levlix が現在の残高とアイテムの在庫を確認します。
2. アイテムのコードが ダイレクトメッセージ で送られます。
3. DM を受け取れない設定の場合は、代わりにエフェメラル（自分だけに見える）メッセージでコードが表示されます。
4. ポイント残高からアイテムの価格が差し引かれます。

ボットが届けるアイテムにはコードがありません。アイテムがあなたに適用され、確認メッセージにその旨が表示されます。購入履歴 タブでは、有効な効果が最初に表示されます。

ポイントが足りない場合、Levlix は必要なポイント数と現在の所持ポイント数を伝えます。

ダッシュボードで買い物する

Levlix Web ダッシュボード で 経済 → ショップ を開きます。メンバーはそのままストア画面に移動します。サーバーの管理担当者には既定で管理画面が表示され、ショップの URL の末尾に ?view=store を付けるとメンバー向けのストアを開けます。

ストアページには次の要素があります。

購入したコードを表示する

誰かに画面をのぞき見されても購入したコードが守られるよう、購入履歴には既定で各コードの 最後の 4 文字 だけが表示されます。行の 表示 をクリックすると、必要なときに完全な値を取得できます。表示するたびに記録が残るため、何をいつ受け取ったかの証拠が常に残ります。

ボットが届けるアイテムの購入では、コードの代わりに購入したものとそのステータス（有効期限、予定、使用済み、期限切れ、取り消し済み、返金済み）が表示されます。

売り切れと販売予定のアイテム

• 売り切れ のアイテムはグレー表示になり、購入できません。過去に何が提供されたかをメンバーが確認できるよう、ページには残ります。
• 予定 のアイテムには販売開始日が表示されます。available_from に達するまで購入ボタンは無効です。
• 期限切れ のアイテムは 期限切れ バッジ付きで一覧に残り、購入できません。

管理者向け: ショップの管理

管理者は Levlix Web ダッシュボード でショップアイテムを追加、編集、削除します。各アイテムには次の設定項目があります。

アイテムのコードがすべて売れると、そのアイテムは自動的に売り切れとなり、ショップの一覧から非表示になります。

まだ誰も購入していないアイテムは削除できます。誰かが購入すると、カードには 削除 の代わりに 今すぐ終了 が表示されます。購入記録と、継続中のロール、ブースト、ニックネームはアイテムに紐づいたままなので、削除ではなく終了させます。今すぐ終了 は終了日を現在時刻に設定し、アイテムはすぐにショップから外れて、管理一覧の 期限切れ に残ります。再び販売するには、編集 で新しい終了日を設定します。

Discord 内ですばやく管理するには、/setup を開き、エンゲージメント、ショップ の順に選びます。ショップパネルにはアイテムの一覧と、アイテムの作成、ショーケースの投稿、期限切れの即時チェックの各ボタン、そして1つのアイテムをチャンネルに投稿するメニューがあります。サーバー管理 権限のないショップ管理者は、/shop にあるショップ管理ボタンから同じパネルを開けます。複数のアイテムをまとめて扱うには、引き続きダッシュボードがもっとも快適です。

ステータスでショップアイテムを絞り込む

管理ページにはステータスフィルター（すべて、有効、予定、期限切れ、売り切れ）があり、対応が必要なアイテムにすぐ移動できます。ステータスはストアがメンバーに適用するのと同じルールから決まるため、2 つの画面の表示が食い違うことはありません。

ボットが届けるアイテム

コードのほかに、ショップではボットが自ら適用するものも販売できます。種類はアイテムの作成時に選びます。種類は後から変更できませんが、その設定は変更できます。

ボットが届けるアイテムにはすべて、在庫（全体で存在する数量）、メンバーごとの 購入制限、その両方、またはどちらも設定しないことができます。コードのアイテムは引き続き、未使用のコードの数から在庫が決まります。

配送のしくみ

• Discord で購入すると、アイテムはすぐに適用されます。ダッシュボードで購入すると処理はボットに渡され、購入時にボットがオフラインだった場合でも、長くても数分以内に適用されます。
• 期間のあるアイテムを再度購入すると、期間が 延長 されます。新しい期間は現在の期間が終わったときに始まります。
• 個人用 XP ブーストはサーバー全体のブーストとは重複しません。大きいほうの倍率が適用されます。
• 連続記録シールドは自動的に使われます。メンバーが日を逃すと、逃した 1 日につきシールドが 1 枚消費され、連続記録が続きます。シールドが足りない場合は連続記録がリセットされ、シールドは残ります。
• ニックネームのアイテムでは、メンバーがテキストを入力し、ボットがそれをあなたのテンプレートに当てはめます（例: VIP {text}）。モデレーションモジュールが有効な場合、テキストはサーバーのモデレーション用ワードフィルターを通ります。
• アイテムが終了すると、ボットはロールを外すか、以前のニックネームに戻します。購入前からメンバーが持っていたロールが外されることはなく、メンバーがその間に変更したニックネームもそのままにします。

返金

ボットがアイテムを適用できない場合（ロールが削除された、ボットに権限がない、メンバーが退出した、サーバーオーナーがニックネームを購入した）、購入は自動的に返金されます。ポイントは残高に戻り、在庫 1 個分が解放され、購入者には理由を記したダイレクトメッセージが届きます。購入は履歴で 返金済み と表示されます。

付与の取り消し

管理担当者は、アイテムカードの 付与 で、ボットが届けるアイテムを現在誰が保有しているかを確認でき、そこで付与を取り消せます。ボットは数分以内にそれを元に戻します。取り消しでは返金されません。

購入の告知

購入を告知 をオンにしてチャンネルを選ぶと、誰かがアイテムを購入するたびにボットが短いメッセージを投稿します。そのメッセージではメンバーがメンションされます。

管理ページ上部の ショップ設定 には、すべてのアイテムが引き継ぐ既定値があります。デフォルトの告知チャンネルと、新しいアイテムで告知を最初からオンにするかどうかです。独自のチャンネルを持たないアイテムはデフォルトのチャンネルに投稿し、くじの抽選結果も同じ扱いになります。デフォルトのチャンネルがない場合は、告知するアイテムごとにチャンネルを選ぶ必要があります。ショップ管理レベル は引き続き サーバー設定 にあります。

くじ

くじのアイテムは回ごとに実施されます。購入されたチケットはそれぞれ、価格からハウス取り分を引いた額をその回の賞金プールに入れます。ハウス取り分はそのまま流通から取り除かれます。抽選時刻になると、ボットはチケットを 1 枚ランダムに選び（各チケットは 1 回ずつ数えられるため、チケットが多いほどチャンスも増えます）、賞金プール全額をそのメンバーにポイントとして支払い、結果を結果チャンネルに投稿して、次の回を開始します。チケットのない回は何も告知せずに終了します。

管理担当者は 今すぐ抽選（1 分以内に抽選が実行されます）と この回を中止（すべてのチケットが返金されて次の回が始まり、ボットが短いお知らせを投稿します）を使えます。開催中の回にチケットがある間は、くじのアイテムを削除できません。先に抽選するか中止してください。アイテムを期限切れにするとチケットの販売は止まりますが、開催中の回の抽選は行われます。

ストアのカードには、現在の賞金プール、入っているチケットの数、自分のチケット、次の抽選時刻が表示されます。Discord の /shop 画面にも同じ行が表示されます。

ショップ管理ロール

既定では、ショップを管理できるのはサーバー管理者だけです。別のロール（たとえば Community Manager や専任の Shop Team）にアイテムの作成と編集を任せたい場合は、サーバー設定 の ショップ管理レベル を モデレーター以上 または 管理者とオーナー に設定します。ロールの階層（user → moderator → admin → owner）によって、誰に管理画面が表示され、誰にストアが表示されるかが決まります。

設定されたロールより下のメンバーは、管理画面の URL を直接開いた場合でも、常にストア画面に移動します。ストアをプレビューしている管理担当者には 管理画面に戻る リンクが残るので、迷うことはありません。

ユーザーの残高を管理する

サーバー管理者は、Levlix Web ダッシュボードからメンバーのポイント残高を手動で追加、削除、調整できます。すべての変更は監査履歴に記録され、透明性が保たれます。

特殊なケースと安全に関する注意

• ダッシュボードでの購入ごとにメンバーシップを確認。 ストアの URL は Levlix アカウントを持つ誰にでも公開されていますが、実際に購入できるのはサーバーのメンバーだけです。購入処理はコードのプールに触れる前にメンバーシップを再確認します。
• 購入者 1 人につきコードは必ず 1 つ。 購入の処理中は購入者の行に短時間のデータベースロックがかかるため、購入ボタンをダブルクリックしても（あるいは同じ人が 2 つのタブを開いても）、1 回の支払いで 2 つのコードを受け取ることはありません。
• ボットが停止中でも購入は可能。 ダッシュボードでの購入は Redis 経由で通知され、ボットが購入者に DM を送れるようにしますが、いずれにしてもコードはダッシュボード内ですぐに届けられます。ボットがオフラインでも購入は成功し、ページを更新すると購入履歴にコードが表示されます。
• 売り切れへの切り替えは即時。 アイテムの最後のコードがダッシュボードで受け取られると、同じリクエスト内でアイテムが売り切れになります。次の訪問者に古い「残り 1」が表示されることはありません。