サーバー通貨（マルチ通貨）

説明

ユーザーガイド

サーバー独自の通貨を1つ以上作成できます。メンバーはチャットやボイスで通貨を獲得し、ショップ、カジノ、ミニゲームで使用します。相互に交換できる複数の通貨を使って、独自の経済圏を作りたい管理者向けの機能です。

機能

• 好きな数だけ通貨を作成でき、それぞれに名前と絵文字を設定できます。
• アクティビティに応じて報酬を配布します：メッセージごと、ボイスの滞在時間ごと、またはその両方。
• 特定のチャンネルやカテゴリに獲得を限定したり、獲得の上限を設けたりできます。
• Discord内に対話式のパネルを投稿します：残高、ショップ、インベントリ、カジノ、両替。
• 通貨ごとのショップを開設できます（価格、在庫、有効期限）。
• 通貨ごとにシンプルなカジノを用意できます（固定または自由な賭け金、調整可能な当選確率、クールダウン）。
• 交換レートを設定して通貨同士を連携できます（派生通貨 → 主要通貨）。
• 富豪ランキングを表示します。

クイックスタート（管理者）

1. 通貨を作成します：/monnaie creer id:gold nom:ゴールド emoji:💰（IDは小文字の英数字のみです）。
2. 獲得設定を行います：/monnaie config_gain — 方式（メッセージ、ボイス、両方）、獲得量、間隔、文字数のしきい値を選びます。
3. 任意：/monnaie restriction で獲得を特定のチャンネルに限定します。
4. ショップに商品を登録します：/monnaie boutique_objet、またはダッシュボードのショップタブ。
5. 任意：/monnaie casino でカジノを設定し、/monnaie staff_role で管理用のロールを指定します。
6. チャンネルにパネルを投稿します：メンバー向けには /monnaie panneau type:👤 Panneau Utilisateur、チーム専用のチャンネルには type:🛠 Panneau Staff を指定します。

コマンド

メンバー向け

コマンド	説明
/monnaie liste	サーバーに設定されているすべての通貨を表示。
/monnaie classement	ある通貨における富豪ランキング。
/monnaie conversions	連携している通貨と交換レートを表示。
/monnaie convertir	派生通貨を主要通貨に交換。

残高、ショップ、インベントリ、カジノはコマンドではなく、ユーザーパネルのボタンから利用します。

管理者向け

コマンド	説明
/monnaie creer	通貨を作成（ID、名前、絵文字）。
/monnaie config_gain	獲得設定：方式、金額、間隔、文字数のしきい値、上限。
/monnaie restriction	獲得をチャンネルまたはカテゴリに限定。
/monnaie boutique_objet	通貨のショップに商品を追加。
/monnaie casino	通貨のカジノを設定（モード、賭け金、配当、当選確率、クールダウン）。
/monnaie staff_role	スタッフパネルを使用できるロールを指定。
/monnaie lier	派生通貨をレート付きで主要通貨に連携。
/monnaie panneau	対話式パネル（ユーザー用またはスタッフ用）をチャンネルに投稿。

ダッシュボードでの設定

「マルチ通貨」モジュールには4つのタブがあります。

• 通貨 — 通貨の作成と全項目の編集：名前、絵文字、獲得方式、メッセージごとの獲得量と間隔、文字数のしきい値、1日の上限、ボイスでの獲得量と間隔、許可するチャンネルとカテゴリ、カジノの設定（モード、クールダウン、賭け金、配当、分子／分母の形式で指定する当選確率）、主要通貨への交換の連携。
• ショップ — 指定した通貨の商品：名前、説明、絵文字、価格、在庫（空欄は無制限）、有効期限。
• 残高 — ある通貨の上位100件の残高。メンバーごとに残高を調整できます（値の置き換え、または加算・減算）。
• 設定 — スタッフパネルのボタンを使用できるスタッフロール。

Discordへのパネルの投稿は、Discord上で /monnaie panneau を使って行う操作のままです。ダッシュボードがあなたの代わりにメッセージを投稿することはありません。

ショップとの関係

混同しやすい2つの別のシステムがあるため注意してください。

• このモジュールのショップは組み込み型です。通貨ごとに独自の商品リストを持ち、購入はユーザーパネルの「🛒 ショップ」ボタンから行い、価格は即座に引き落とされ、商品はメンバーのインベントリに入ります。チケットも承認もありません。
• 「ShopDiscord」モジュールは別のシステムで、「ポイント」と呼ばれる独自の通貨、ボーナスロール、ブースト、そして購入ごとのチケットによる承認を備えています。そちらの動作をお探しの場合は、このドキュメントの**ShopDiscord（ショップとポイント）**のページをご覧ください。

両方を同じサーバーで併用することもできますが、それぞれの残高は連動しません。メインの経済圏としてはどちらか一方を選んでください。そうしなければ、メンバーはどの通貨が何に使えるのか分からなくなります。

このモジュールの通貨は、Activityのミニゲームとチャレンジとカードモジュールでも使用されます。

知っておきたいこと

• ダッシュボードには「不安定なモジュール — 開発中」という警告が表示されます。 メンバーが頼りにする経済圏を立ち上げる前に、設定を十分にテストしてください。
• 文字数のしきい値を設定しないと、メッセージによる獲得は一切発生しません。 計算ではこのしきい値が除数として使われます。しきい値と同じ長さのメッセージで満額の獲得となり、それより長ければ比例して多く、短ければ比例して少なくなります。しきい値が0の場合、獲得量は常に0です。現実的な値（例えば20文字）を設定してください。
• 「1日の上限」は、その日の獲得量ではなく現在の残高と比較されます。 この値を超えると、そのメンバーはこの通貨を獲得できなくなります。つまり残高の上限として機能します。上限を設けたくない場合は0のままにしてください。
• 間隔はスパム対策です。 メンバーは通貨ごとに、1つの間隔（分単位）につき最大1回しか獲得できません。このカウンターはメモリ上に保持され、Botが再起動するとリセットされます。
• ボイスでの獲得は1分ごとに確認されます。 ボイスでの獲得は、金額とボイスの間隔の両方が設定されている場合にのみ発生します。
• 通貨のIDは作成後に変更できません（名前と絵文字は変更できます）。他のすべてのモジュールの選択欄に表示されるため、短く分かりやすいものを選んでください。
• 通貨を削除すると、それに付随するすべてが削除されます。 メンバーの残高、ショップの商品、カジノの履歴が対象です。この操作は取り消せません。
• カジノは通貨ごとに設定する必要があります。 設定していない場合、メンバーには管理者に連絡するよう促すメッセージが表示されます。「固定」モードでは賭け金が決められており変更できません。「自由」モードではプレイヤーが金額を選びます。
• 交換は一方向のみです。 派生通貨から主要通貨への交換のみが可能です。通貨を自分自身に連携させることはできません。
• スタッフパネルからは通貨の付与と回収ができます。 非公開のチャンネルに投稿し、スタッフロールは信頼できる人にのみ付与してください。管理者はいずれの場合も利用できます。
• 有効期限を過ぎたショップの商品は自動的に削除されます（10分ごとに確認）。