経済(通貨・銀行)

「経済」は、サーバー内だけで使える仮想通貨を導入できる機能です。メンバーは仕事で通貨を稼ぎ、ほかのメンバーに送金したり、銀行に預けて利息を受け取ったり、投資プランで運用したりできます。残高ランキングやデイリーボーナス、借入・返済、破産申請といったコマンドも用意されています。

このページでは、通貨名や通貨の絵文字、仕事(/economy work)で得られる報酬のパターン、銀行の利息、投資プランなどを設定します。

経済は本来プレミアム向けの機能ですが、現在ベータ版のあいだは全ユーザーに無料でプレミアムが付与されているため、追加の費用なくどなたでもご利用いただけます。(ベータ終了後はプレミアム限定になる予定です。)詳しくはプレミアムプランを参照してください。

この機能でできること

サーバー独自の通貨名と通貨の絵文字を決める
メンバーが /economy work(仕事)で通貨を稼げるようにし、稼げる金額やメッセージを自由に設定する
銀行に預けたお金へ利息を付ける(複利にも対応)
名前・金額・金利・期間を決めた投資プランを用意する
残高表示・送金・ランキング・デイリーボーナス・借入・返済などのコマンドを、誰が使えるか(権限)も含めて管理する

メニュー上の表記は「経済」です。サイドバー(画面の幅が狭いときは画面上部または下部に表示されるメニュー)の「娯楽」グループの中にあります。

経済の設定は、サーバーごとの個別設定ではありません。ここで設定した内容は、この Bot を導入しているすべてのサーバーに共通で適用される「デフォルト設定」です。

設定の開き方と保存の流れ

「経済」のページを開いてから、機能を有効化し、各設定を入力し、最後に保存します。

メニューから「経済」を開く

メニューで「娯楽」グループの中にある「経済」を選びます。現在ベータ版のあいだは、どなたでもそのまま経済の設定ページを開けます。(ベータ終了後にプレミアム限定となった場合は、未加入のときに項目へ「Premium」と表示され、クリックするとプレミアムの案内が開くようになります。)

「機能の有効化」をオンにする

ページ上部にある「機能の有効化」のスイッチをオンにすると、経済機能そのものが利用可能になります。

各セクションを設定する

このページには「コマンド権限設定」と「デフォルト設定」の 2 つのカードが表示されます。「デフォルト設定」の中で、通貨名・仕事・銀行・投資プランなどを設定します。詳しい操作はこのあとの各章で説明します。

保存バーで保存する

設定を変更すると、画面の下に「未保存の変更があります」というバーが表示されます。「保存」ボタンをクリックすると変更が反映されます。やり直したいときは「破棄」ボタンをクリックすると、変更前の状態に戻ります。

「保存」をクリックするまで変更内容は反映されません。ページを離れる前に必ず保存してください。

コマンド権限設定

ここでは、経済に関する各コマンドを「使えるようにするか」「誰が使えるか」を設定します。

カードの中には、次の 11 個のコマンドが並んでいます。

コマンド	説明
`/economy balance`	残高を表示します。
`/economy work`	仕事をします。
`/economy deposit`	銀行に預けます。
`/economy withdraw`	銀行から引き出します。
`/economy send`	お金を送ります。
`/economy ranking`	ランキングを表示します。
`/economy daily`	デイリーボーナスを受け取ります。
`/economy status`	経済ステータスを確認します。
`/economy borrow`	銀行からお金を借ります。
`/economy repay`	借金を返済します。
`/economy bankruptcy`	破産を申請します。

各コマンドの行をクリックすると、その下に詳細な設定が開きます。行の右側には、現在の状態を示すバッジが表示されます。

バッジ	意味
「有効」	コマンドが有効になっています
「無効」	コマンドが無効になっています
「強制上書き」	Discord 権限より個別設定を優先する設定がオンになっています

行を開くと、次の設定ができます。

「コマンドを有効化」: オンにするとそのコマンド自体が利用可能になり、オフにするとサーバーでそのコマンドは使えなくなります。
「個別権限設定を有効化」: 誰がコマンドを使えるかの判定方法を切り替えます。オフ(初期状態)では通常の Discord 権限による判定を使い、オンにすると BotShade 独自の権限設定でロールや権限を細かく指定できます。
「Discord権限より個別設定を優先」: 「個別権限設定を有効化」をオンにしたときのみ使えます。BotShade 独自の権限設定を Discord の既存権限より優先して強制適用します。操作すると確認ダイアログ「危険な権限上書きの確認」が表示されます。

/economy bankruptcy(破産を申請します)は、ユーザーの所持金・資産に影響する破壊的なコマンドです。/economy borrow(借入)や /economy send(送金)とあわせて、サーバーの運用方針に応じて有効・無効や使える対象を慎重に設定してください。

コマンドごとの権限(ホワイト/ブラックロールリストや権限条件)の詳しい設定方法はコマンド権限設定の使い方を参照してください。最初は「個別権限設定を有効化」をオフのままにして、Discord の通常の権限判定に任せても問題ありません。

デフォルト設定(すべてのサーバー共通)

「デフォルト設定」カードは、すべてのサーバー共通で適用される基本設定で、右上に「共通」というバッジが付いています。中は、次の 3 つのまとまりに分かれています。

「基本設定」(通貨名・通貨絵文字)
「仕事 (/work) 設定」(クールダウン・仕事の結果パターン)
「銀行・投資設定」(利息の設定・投資プラン)

基本設定(通貨名・通貨絵文字)

「基本設定」では、サーバーで使う通貨の見た目を決めます。

項目	内容
「通貨名」	通貨の名前を入力します。入力欄には例として「例: コイン」と表示されています。
「通貨絵文字」	通貨を表す絵文字を入力します。入力欄には例として絵文字(🪙)が表示されています。

通貨名と通貨絵文字は、残高表示やメッセージなどで通貨を表すときに使われます。

仕事 (/work) 設定

「仕事 (/work) 設定」では、メンバーが /economy work を実行したときに、どれくらいの間隔で仕事ができ、どんな結果(報酬)になるかを決めます。

クールダウン (秒)

「クールダウン (秒)」には、次に仕事ができるようになるまでの待ち時間を秒数で入力します。たとえば 300 と入力すると、一度仕事をしてから 5 分(300 秒)経たないと、もう一度仕事ができません。

仕事の結果パターン

「仕事の結果パターン」では、仕事をしたときに起こる結果を複数登録できます。1 つの結果は「どれくらいの確率で起こるか」「どんなメッセージが表示されるか」「報酬はいくらか」の組み合わせです。

結果を追加するには「結果を追加」ボタンをクリックします。追加された結果は「結果 #1」「結果 #2」のように番号付きの枠で表示され、それぞれに次の項目を設定できます。

項目	内容
「確率 (%)」	この結果が起こる確率をパーセントで入力します(0〜100)。
「メッセージ」	この結果になったときに表示されるメッセージを入力します。
「最小報酬」	報酬の下限を入力します。
「最大報酬」	報酬の上限を入力します。

報酬は「最小報酬」から「最大報酬」までの範囲でランダムに決まります。たとえば最小報酬を 100、最大報酬を 500 にすると、その結果になったときは 100〜500 の範囲で報酬が支払われます。

不要になった結果は、各枠の右上にあるごみ箱アイコンのボタンで削除できます。

「確率 (%)」はパーセントで入力しますが、内部では 0〜1 の割合に変換して扱われます(たとえば 50% は 0.5)。複数の結果を登録した場合、それぞれの「確率 (%)」をもとに結果が抽選されます。

「メッセージ」欄は変数の挿入に対応しています。入力欄の変数ボタンから、経済機能の変数(例: {Economy.balance}、{Economy.Earnings} など)を挿入して、報酬額などを文章に差し込めます。利用できる変数については変数の使い方を参照してください。

銀行・投資設定

「銀行・投資設定」では、メンバーが銀行に預けたお金に付く利息や、運用できる投資プランを設定します。

銀行の基本設定

「銀行の基本設定」という枠の中で、利息に関する設定を行います。

項目	内容
「利息を有効にする」	チェックを入れると、預金に利息が付くようになります。
「基本金利」	利息の基準となる金利を入力します。
「利息付与間隔 (秒)」	利息を付与する間隔を秒数で入力します(たとえば `3600` で 1 時間ごと)。
「複利適用」	チェックを入れると、利息を元本に組み入れて次回以降の利息を計算する「複利」になります。

投資プラン

「投資プラン」では、メンバーが選んで運用できるプランを複数登録できます。プランを追加するには「プランを追加」ボタンをクリックします。追加されたプランは「プラン #1」「プラン #2」のように番号付きの枠で表示され、それぞれに次の項目を設定できます。

項目	内容
「プラン名」	プランの名前を入力します。
「最小金額」	このプランに投資できる金額の下限を入力します。
「最大金額」	このプランに投資できる金額の上限を入力します。
「金利 (%)」	このプランの金利をパーセントで入力します。
「期間 (時間)」	運用期間を時間で入力します。
「複利運用を有効にする」	チェックを入れると、このプランの利息計算が複利になります。

不要になったプランは、各枠の右上にあるごみ箱アイコンのボタンで削除できます。

「最小金額」「最大金額」は数値のほか、金額を表す変数を挿入することもできます。入力欄の変数ボタンから、経済機能の数値・金額の変数を選んで設定できます。

「プランを追加」をクリックすると、初期値として「New Plan」というプラン名、金利 5.0%、期間 24 時間などが入った枠が追加されます。内容は必要に応じて書き換えてください。

実際の動作と既定値

ここからは、メンバーが実際にコマンドを実行したときの Bot の挙動と、設定を変更していないときに適用される既定値をまとめます。設定画面で値を変更すれば、ここで紹介する既定値は上書きされます。

通貨残高は Bot ごと・メンバーごとに記録されます

通貨は、この Bot を導入しているすべてのサーバーをまたいで、メンバー 1 人につき 1 つの残高として記録されます。メンバーがはじめて経済機能に触れたとき(コマンドを実行したとき)に残高が自動で作成され、初期の手持ちは 1,000 コイン、銀行残高は 0 から始まります。新規メンバーには初期の信用スコアとして 100 ポイントが与えられます。

残高表示(`/economy balance`)

/economy balance を実行すると、手持ち・銀行・合計資産(手持ち + 銀行)が表示されます。表示の前に、たまっている銀行利息が自動で反映されてから金額が計算されます。応答は公開メッセージとして送信されます。

仕事(`/economy work`)

/economy work を実行すると、ランダムな報酬を受け取れます。「仕事の結果パターン」を設定している場合はその設定にもとづいて抽選され、未設定の場合は次の既定の確率帯が使われます。

おおよその確率	報酬の範囲(コイン)
約 97%	2,500 〜 6,500
約 2%	6,500 〜 16,500
約 0.3%	16,500 〜 26,500
約 0.1%	26,500 〜 46,500
約 0.1%	46,500 〜 66,500
約 0.05%	66,500 〜 86,500
ごくまれ	86,500 〜 150,000

報酬を受け取ると、メッセージとともに「Work Again」ボタンが表示され、ボタンからもう一度仕事を実行できます。このボタンは、メッセージが削除されるか Bot が再起動するまで使えます。

「仕事の結果パターン」を設定している場合は、それぞれの結果に登録したメッセージが表示されます。メッセージ内に挿入した報酬額などの変数は実際の値に置き換えられます。なお、変数の置き換えに失敗した場合は既定のメッセージが表示されます。

デイリーボーナス(`/economy daily`)

/economy daily を実行すると、1 日に 1 回(既定の間隔は 24 時間)ボーナスを受け取れます。既定のボーナス額は 1,000 コインで、手持ちに加算されます。すでに受け取り済みのときは、次に受け取れるまでの残り時間が表示されます。このコマンドの応答は、本人にだけ見える非公開メッセージ(エフェメラル)で送信されます。

銀行への預け入れと引き出し(`/economy deposit` / `/economy withdraw`)

/economy deposit は手持ちから銀行へ、/economy withdraw は銀行から手持ちへコインを移します。金額は正の整数のほか all を指定でき、all は手持ちまたは銀行の全額を対象にします。

手持ち(または銀行)にある以上の金額を指定した場合はエラーにはならず、利用できる範囲の上限まで自動で調整されて処理されます。引き出しの際は、たまっている銀行利息が先に反映されてから処理されます。「預け入れ時のメッセージ」「引き出し時のメッセージ」を設定している場合は、その文面で応答します。

送金(`/economy send`)

/economy send は、自分の手持ちから相手の手持ちへコインを送ります。銀行残高は関与しません。金額は正の整数または all で指定します。自分自身や Bot には送金できません。手持ちが足りない場合は送金されず、エラーメッセージが表示されます(預け入れ・引き出しのような自動調整は行われません)。「送金時のメッセージ」を設定している場合は、その文面で応答します。

銀行の利息

利息を有効にしている場合(既定では有効)、残高表示・預け入れ・引き出し・ランキングのいずれかが行われたタイミングで、経過時間に応じた利息が計算され、銀行残高に反映されます。既定の金利は **1 時間ごとに 1%(複利)**です。利息は表示の前に静かに反映され、利息が付いたことを知らせる個別の通知は出ません。銀行残高が 0 のときは利息は付きません。

借入・返済・破産(`/economy finance` コマンド)

借入・返済・破産・経済ステータスの確認は、Discord 上では /economy finance で始まるコマンド(/economy finance status、/economy finance borrow、/economy finance repay、/economy finance bankruptcy)として実行します。管理画面の「コマンド権限設定」では、これらは /economy status・/economy borrow・/economy repay・/economy bankruptcy という名前で有効・無効や権限を管理します。

/economy finance status: 現在の借金残高(最新の利息を反映)、信用スコアと評価、借入限度額、1 時間あたりの金利、返済期限を表示します。信用度の評価は次の 5 段階で表示されます。

評価内容
Very Bad 非常に低い
Bad 低い
Average 普通
Good 良い
Excellent 非常に良い
/economy finance borrow: お金を借ります。投資プランを設定している場合はプランの選択が必要です(プランが 1 つだけのときは自動で選択されます)。プランを設定していない場合は、既定の金利 1 時間あたり 5% と、指定した期間(既定 24 時間)が使われます。借入は信用審査の対象で、必要なスコアは借入額・期間・金利などから動的に決まります。審査に通ると借りた額が手持ちと借金残高の両方に加算され、信用スコアが少し下がります。すでに借金があるときは、返済期限は現在の期限と新しい期限のうち早いほうに設定されます。応答は本人にだけ見える非公開メッセージで送信されます。
/economy finance repay: 手持ちから借金を返済します。金額は正の整数または all で指定し、借金残高を超える分は自動で借金残高までに調整されます。手持ちが足りない場合は返済できません。返済すると信用スコアが更新され、返済額に応じて加点され、返済期限を過ぎている場合は経過に応じて減点されます。借金を完済すると、ボーナスとして信用スコアが加点されます。なお、ごく短期間での早期返済では加点されない場合があります。応答は非公開メッセージで送信されます。
/economy finance bankruptcy: 借金を帳消しにする緊急手段です。借金残高が 0 になり、信用スコアが 0 にリセットされます。実行すると 3 日間、仕事の報酬が 60% 減額されるペナルティが発生します。借金があるときだけ実行できます。応答は公開メッセージで送信されます。

評価	内容
`Very Bad`	非常に低い
`Bad`	低い
`Average`	普通
`Good`	良い
`Excellent`	非常に良い

借金が遅延しているとき・破産直後の仕事

借金の返済期限を過ぎている状態で /economy work を実行すると、仕事の報酬の一部(既定で 50%)が借金の返済に強制的に充てられ、残りが手持ちに加算されます。このとき、仕事の結果メッセージに徴収の通知が追記されます。

破産を申請してから 3 日以内に仕事をすると、報酬が 60% 減額されます。このとき、仕事の結果メッセージに自己破産ペナルティの通知が追記されます。借金の遅延徴収と破産ペナルティが同時に当てはまる場合は、先に破産ペナルティで減額され、その後に残った報酬から借金が徴収されます。

通貨の表示

すべての金額は「絵文字金額通貨名」の形式で表示されます。既定の絵文字は 🪙、既定の通貨名は コイン です。「基本設定」で通貨名や通貨絵文字を変更すると、残高や取引のメッセージすべてに反映されます。通貨名を空にすると、絵文字と数値だけで表示されます。

上限とクールダウン

項目	既定値 / 上限
初期の手持ち	1,000 コイン
仕事のクールダウン	300 秒(5 分)
デイリーボーナス	1,000 コイン / 24 時間ごと
銀行の金利	1 時間ごとに 1%(複利)
借入の既定金利(プラン未設定時)	1 時間あたり 5%
新規メンバーの信用スコア	100 ポイント
信用スコアの範囲	0 〜 1,000 ポイント
借入に必要な最低スコア	10 ポイント
借金残高の上限	9,999,999,999 コイン
ランキングの表示人数	上位 10 人
破産ペナルティ	3 日間・仕事の報酬を 60% 減額
借金遅延時の徴収	仕事の報酬の 50%

仕事のクールダウンは、設定画面の「クールダウン (秒)」で変更できます。利息の金利・付与間隔・複利の有無、デイリーボーナス額、通貨名・絵文字なども設定で変更できます。ここに挙げた数値は、いずれも設定を変更していないときの既定値です。

無料プランとプレミアムで上限差がある挙動も一部にありますが、現在ベータ版のあいだは全ユーザーに無料でプレミアムが付与されているため、これらの上限は緩和された状態でどなたでもご利用いただけます。

表示されるメッセージ

メンバーがコマンドを実行したときに Bot が表示する主なメッセージは次のとおりです。** で囲まれた部分は太字、金額や残り時間などは実際の値に置き換わります。

成功時

状況	メッセージ
仕事に成功(結果パターン未設定)	`働いて（金額）もらいました！`
デイリーボーナス受け取り	`📅 デイリーボーナス！今日も来てくれてありがとう！（金額）を受け取りました。`
銀行に預け入れ	`銀行に（金額）を預けました。`
銀行から引き出し	`銀行から（金額）を引き出しました。`
送金	`（相手のメンション）に（金額）を送金しました。`

預け入れ・引き出し・送金のメッセージは、それぞれ「預け入れ時のメッセージ」「引き出し時のメッセージ」「送金時のメッセージ」を設定すると差し替えられます。

仕事の報酬に追記される通知

借金の遅延や破産ペナルティが当てはまるときは、仕事の結果メッセージの末尾に次の通知が追記されます。


💸 自己破産のペナルティ
給料が （金額） 減額されました。


⚠️ 借金遅延徴収
借金の返済が遅れているため （金額） が強制徴収されました。

エラー・案内メッセージ

状況	メッセージ
仕事のクールダウン中	`少し休憩しましょう！あと（秒数）秒お待ちください。`
デイリーボーナス受け取り済み	`今日は既に受け取っています！` に続けて `あと（時間）お待ちください。`
金額の指定が不正	`金額は正の数または 'all' で指定してください。`
預け入れ・引き出しの金額がない	`預ける/引き出す金額がありません。`
自分自身への送金	`自分自身には送金できません。`
Bot への送金	`Botには送金できません。`
送金時の残高不足	`手持ちのお金が足りません。`
返済する借金がない	`現在借金はありません！`
借入額が不正	`借入額は1以上である必要があります。`
返済額が不正	`返済額は1以上である必要があります。`
借金がないのに破産申請	`現在、借金はありません。自己破産の必要はありません。`
プラン未選択(複数プラン設定時)	`利用するプランを選択してください。`
経済機能が利用できない	`経済機能が利用できません。`

借入の審査に落ちたときや借入限度額を超えたときは、必要なスコアと現在のスコア、または借入限度額と申請総額を示すメッセージが表示されます。たとえば審査落ちのときは 🚫 **審査落ち (Loan Denied)** で始まり、・必要スコア: **（数値）** と ・あなたのスコア: **（数値）** が示され、借入額を減らすか返済期間を短くするよう案内されます。プランの借入可能額の範囲を外れているときは、このプランの借入可能額は（最小）〜（最大）です。 のように表示されます。

注意点・うまくいかないとき

預け入れ・引き出しは自動調整、送金はエラーになります。 預け入れや引き出しは、持っている以上の金額を指定しても上限まで自動で調整されて処理されます。一方、送金は手持ちが足りないと送金されずエラーになります。仕様の違いに注意してください。
借金は複利で増えます。 借金の利息は時間の経過に応じて複利で計算され、/economy finance status や /economy finance repay を実行したタイミングで最新の残高に反映されます。返済が遅れるほど残高が膨らむため、早めの返済をおすすめします。借金残高は最大 9,999,999,999 コインで頭打ちになります。
複数回借りても返済期限は延びません。 すでに借金があるときに追加で借りると、返済期限は現在の期限と新しい期限のうち早いほうに設定されます。借りても期限が先延ばしになるわけではありません。
破産はリセットではありません。 破産すると借金は帳消しになりますが、信用スコアが 0 になり、3 日間は仕事の報酬が 60% 減額されます。安易な利用は避け、計画的な返済を優先してください。
仕事をしても報酬がもらえないとき。 「仕事の結果パターン」を設定している場合は、結果が 1 つ以上登録されていて、各結果の「確率 (%)」「最小報酬」「最大報酬」が適切に入力されているか確認してください。結果パターンを未設定のままにすると、既定の確率帯で報酬が支払われます。
コマンドが使えないとき。 ページ上部の「機能の有効化」と、「コマンド権限設定」内の各コマンドの「コマンドを有効化」の両方がオンになっているか、変更後に「保存」をクリックしたかを確認してください。

コマンド一覧

メンバーが Discord 上で使える経済関連のコマンドは次のとおりです。応答が「非公開」のものは、実行した本人にだけ見える形で表示されます。

コマンド	できること	応答
`/economy balance`	手持ち・銀行・合計資産を表示します。	公開
`/economy work`	仕事をしてランダムな報酬を得ます(「Work Again」ボタン付き)。	公開
`/economy deposit <amount>`	手持ちから銀行へ預け入れます(`all` で全額)。	公開
`/economy withdraw <amount>`	銀行から手持ちへ引き出します(`all` で全額)。	公開
`/economy send <user> <amount>`	相手の手持ちへ送金します(`all` で全額)。	公開
`/economy daily`	デイリーボーナスを受け取ります。	非公開
`/economy ranking`	合計資産の上位 10 人を表示します。	公開
`/economy finance status`	借金残高・信用スコア・借入限度額・返済期限を表示します。	公開
`/economy finance borrow <amount> [plan] [hours]`	お金を借ります(審査あり)。	非公開
`/economy finance repay <amount>`	借金を返済します(`all` で全額)。	非公開
`/economy finance bankruptcy`	借金を帳消しにします(ペナルティあり)。	公開

これらのコマンドは、いずれも「コマンド権限設定」で個別に有効・無効や権限を設定できます。借入・返済・破産・ステータス確認は、管理画面では /economy borrow・/economy repay・/economy bankruptcy・/economy status という名前で管理し、Discord 上では /economy finance で始まるコマンドとして実行します。

よくある質問

サーバーごとに別々の通貨や報酬を設定できますか?

できません。経済の設定は「デフォルト設定」として、この Bot を導入しているすべてのサーバーに共通で適用されます。

有効化したのにコマンドが使えません。

ページ上部の「機能の有効化」と、「コマンド権限設定」内の各コマンドの「コマンドを有効化」の両方がオンになっているか確認してください。また、変更後に画面下部の保存バーで「保存」をクリックしたかどうかも確認してください。

仕事をしても報酬がもらえません。

「仕事 (/work) 設定」で「結果を追加」を使って結果パターンを 1 つ以上登録しているか確認してください。また、各結果の「確率 (%)」「最小報酬」「最大報酬」が適切に入力されているかも確認してください。

次のステップ / 関連ページ

ミニゲーム — 経済の通貨を使って遊べるゲーム機能(プレミアム限定)
レベリング — メンバーの活動に応じてレベルを付与する機能
コマンド権限設定の使い方 — ホワイト/ブラックロールや権限条件の詳しい設定方法
変数の使い方 — メッセージや金額欄に差し込める変数の一覧と使い方
プレミアムプラン — 経済機能を含むプレミアム限定機能について
モジュールの基本と共通操作 — 機能の有効化や保存など、すべてのモジュールに共通する操作