Configuration

EzEconomy uses a main config.yml plus a storage-specific configuration file. Only enable the storage provider you plan to use.

config.yml

storage: yml
multi-currency:
  enabled: false
  default: "dollar"
  currencies:
    dollar:
      display: "Dollar"
      symbol: "$"
      decimals: 2
    euro:
      display: "Euro"
      symbol: "€"
      decimals: 2
    gem:
      display: "Gem"
      symbol: "♦"
      decimals: 0
  conversion:
    dollar:
      euro: 0.95
      gem: 0.01
    euro:
      dollar: 1.05
      gem: 0.012
    gem:
      dollar: 100
      euro: 80

Banking toggle

Enable or disable the built-in bank subsystem (commands, GUIs, Vault bank methods, and bank placeholders).

banking:
  enabled: true

Set banking.enabled to false if you prefer using a different bank plugin or want to disable shared bank accounts.

Caching strategy

Configure how EzEconomy caches frequently-read values (placeholders, top lists, GUI data).

# Available options: LOCAL, REDIS, BUNGEECORD, DATABASE
caching-strategy: LOCAL

• LOCAL: in-process memory cache only (default)
• REDIS: use the Redis extension for a central cache shared across servers
• BUNGEECORD: proxy-backed cache using plugin messaging to a proxy-side store
• DATABASE: use the configured database as a cache backend (uses ezeconomy_cache table)

If caching-strategy is not present, the plugin will fallback to the older locking-strategy value for backward compatibility.

Notes

• storage must match one of the supported providers: yml, mysql, sqlite, mongodb, or custom.
• When multi-currency.enabled is false, EzEconomy uses only the default currency.
• Conversion rates are directional. Define both directions if you need round trips.

YML Storage

config-yml.yml

yml:
  file: balances.yml
  per-player-file-naming: uuid
  data-folder: data

Recommended for: small servers, quick setup, and testing.

MySQL Storage

config-mysql.yml

mysql:
  host: localhost
  port: 3306
  database: ezeconomy
  username: root
  password: password
  table: balances

Recommended for: shared hosting, large servers, and cross-server networks.

SQLite Storage

config-sqlite.yml

sqlite:
  file: ezeconomy.db
  table: balances
  banksTable: banks

Recommended for: single-server environments that want a lightweight database.

MongoDB Storage

config-mongodb.yml

mongodb:
  uri: mongodb://localhost:27017
  database: ezeconomy
  collection: balances
  banksCollection: banks

Recommended for: teams already using MongoDB in their infrastructure.

Custom Storage

Set storage: custom and register a provider from another plugin.

EzEconomy.registerStorageProvider(new YourProvider(...));

See the Developer API page for details.