MyEconomy

ドキュメント · v1.2

インストールと始め方

必要環境

Paper サーバー 1.21+（または派生）。他プラグイン（ショップ、ジョブ等）連携に Vault 推奨。オプション: PlaceholderAPI、DecentHolograms、MyCore。

インストール手順

  1. ダウンロードページから MyEconomy.jar を取得。
  2. サーバーの plugins/ に配置。
  3. サーバーを再起動（または /reload を実行）。
  4. 初回起動で plugins/MyEconomy/config.yml が自動作成。

確認

ゲーム内で /balance（または /bal）を実行。プラグインが読み込まれていれば残高が表示されます。新規プレイヤーは config で定義した初期残高を受け取ります。

最初のステップ

基本コマンド: /balance または /bal で残高確認、/pay <プレイヤー> <金額> で送金、/ecomenu でメニューを開く。通貨やランキングは config.yml でカスタマイズ。

設定例

config.yml の通貨・初期残高の抜粋:

currency:
  name: "coins"
  symbol: ""
  decimals: 2
starting-balance:
  amount: 100.0
  welcome-message: "&aYou received &e{amount} {currency} &a!"

コマンド

プレイヤーコマンド

コマンド説明エイリアス
/balance [プレイヤー]残高表示bal, money
/pay <プレイヤー> <金額>送金send
/baltop [weekly|monthly]富豪ランキングtopbalance, topbal
/ecomenu経済メニューを開くmoneymenu, economy, market, prices
/transactions [プレイヤー] [ページ]取引履歴history, tx

管理者コマンド

/eco <give|take|set|reset> <プレイヤー> [金額] — プレイヤーの残高を付与・扣除・設定・リセット。

権限

  • myeconomy.player — プレイヤーコマンド（balance, pay, baltop, menu, transactions）
  • myeconomy.balance.others — 他プレイヤーの残高を表示
  • myeconomy.admin — /eco コマンド
  • myeconomy.admin.hologram — ホログラム管理

設定 (config.yml)

一般

general.language — 言語（en, fr, es, de 等）。general.prefix — メッセージ接頭辞。general.debug — デバッグメッセージ。

通貨

currency.name、currency.singular、currency.plural、currency.symbol、currency.decimals、currency.display-format（name または symbol）、currency.short-format（1.5K、1.2M）。

初期残高

starting-balance.amount — 新規プレイヤーの金額。starting-balance.welcome-message — ウェルカムメッセージ（プレースホルダ: {amount}, {currency}）。

支払い (/pay)

pay.enabled、pay.min-amount、pay.max-amount、pay.tax-percentage、pay.require-confirmation-above、pay.allow-self-pay、pay.quick-amounts。

ランキング

rankings.top-size。週間: rankings.weekly.enabled、reset-day、rewards.positions。月間: rankings.monthly（同構造）。

セキュリティ

security.max-transactions-per-minute、transaction-cooldown、max-balance、min-balance、allow-negative-balance。

データベース

database.type — yaml、mysql または sqlite。続いて database.mysql または database.sqlite。

ホログラム (DecentHolograms)

holograms.enabled、update-interval、format.title-global、format.line-format（プレースホルダ: {rank}, {player}, {balance}, {currency}）。

機能

完全な経済

カスタマイズ可能な通貨（名前・記号・小数）、初期残高、取引履歴。

ランキング

全体・週間・月間ランキング、自動報酬（トップ1・2・3）。リセット日（曜日または日付）を設定可能。

GUIメニュー

/ecomenu — 残高表示、送金（クイック金額）、ランキング表示のインターフェース。

連携

  • Vault — 他プラグイン向け経済API
  • PlaceholderAPI — プレースホルダ（残高、ランク等）
  • DecentHolograms — ランキングホログラム
  • MyCore — イベントとAPI
  • オークション（税金、取引追跡）

セキュリティ

分あたり取引上限、クールダウン、残高上限、高額時の確認。