MyEconomy

Documentation · v1.2

Installation and getting started

Requirements

Paper server 1.21+ (or derivative). Vault is recommended for integration with other plugins (shops, jobs, etc.). Optional: PlaceholderAPI, DecentHolograms, MyCore.

Step-by-step installation

  1. Download MyEconomy.jar from the Downloads page.
  2. Place the file in your server's plugins/ folder.
  3. Restart the server (or run /reload if your host allows it).
  4. On first run, plugins/MyEconomy/config.yml is created automatically.

Verification

In-game, type /balance (or /bal). If the plugin is loaded, your balance will show. New players receive a starting balance defined in the config.

First steps

Essential commands: /balance or /bal to view balance, /pay <player> <amount> to send money, /ecomenu to open the GUI. Customize currency and rankings in config.yml.

Configuration example

Excerpt from config.yml for currency and starting balance:

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

Commands

Player commands

CommandDescriptionAliases
/balance [player]Show balancebal, money
/pay <player> <amount>Send moneysend
/baltop [weekly|monthly]Richest players rankingtopbalance, topbal
/ecomenuOpen economy menumoneymenu, economy, market, prices
/transactions [player] [page]Transaction historyhistory, tx

Admin commands

/eco <give|take|set|reset> <player> [amount] — Give, take, set or reset a player's balance.

Permissions

  • myeconomy.player — Player commands (balance, pay, baltop, menu, transactions)
  • myeconomy.balance.others — View others' balance
  • myeconomy.admin — /eco commands
  • myeconomy.admin.hologram — Manage holograms

Configuration (config.yml)

General

general.language — Language (en, fr, es, de, etc.). general.prefix — Message prefix. general.debug — Debug messages.

Currency

currency.name, currency.singular, currency.plural, currency.symbol, currency.decimals, currency.display-format (name or symbol), currency.short-format (1.5K, 1.2M).

Starting balance

starting-balance.amount — Amount for new players. starting-balance.welcome-message — Welcome message (placeholders: {amount}, {currency}).

Payments (/pay)

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

Rankings

rankings.top-size. Weekly: rankings.weekly.enabled, reset-day, rewards.positions. Monthly: rankings.monthly (same structure).

Security

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

Database

database.type — yaml, mysql or sqlite. Then database.mysql or database.sqlite.

Holograms (DecentHolograms)

holograms.enabled, update-interval, format.title-global, format.line-format (placeholders: {rank}, {player}, {balance}, {currency}).

Features

Complete economy

Customizable currency (name, symbol, decimals), starting balance, transaction history.

Rankings

Global, weekly and monthly rankings with automatic rewards (top 1, 2, 3). Configurable reset (day of week or day of month).

GUI menu

/ecomenu — Interface to view balance, send money (quick amounts), view rankings.

Integrations

  • Vault — Economy API for other plugins
  • PlaceholderAPI — Placeholders (balance, rank, etc.)
  • DecentHolograms — Ranking holograms
  • MyCore — Events and API
  • Auction house (taxes, transaction tracking)

Security

Max transactions per minute, cooldown, balance cap, confirmation for large amounts.