Commands

All core commands are registered in plugin.yml. Tab-completion suggests subcommands and arguments you have permission for.

Player commands

/balancebal, money

Permission:openeco.command.balance

Check your balance. With `openeco.command.balance.others`, specify another player. Add an optional currency id as the last argument.

/baltopbalancetop, moneytop

Permission:openeco.command.baltop

View the richest players. Supports pagination and an optional currency id. Results are cached for `baltop.cache-ttl-seconds`.

/pay

Permission:openeco.command.pay

Send money to another player. Respects pay cooldown, tax, and minimum amount from config. Optional currency argument.

/historytxhistory, ecohistory

Permission:openeco.command.history

View transaction history. Defaults to your own account. With `openeco.command.history.others`, specify another player. Supports pagination and optional currency filter.

Admin commands — /eco

All /eco subcommands require their individual permission node (or openeco.admin).

/eco give

Permission:openeco.command.eco.give

Give money to a player. Optional currency argument. Fires balance change events and records history.

/eco take

Permission:openeco.command.eco.take

Take money from a player. Fails if the player has insufficient funds. Optional currency argument.

/eco set

Permission:openeco.command.eco.set

Set a player's balance to an exact amount. Optional currency argument.

/eco reset

Permission:openeco.command.eco.reset

Reset a player's balance to the configured starting balance. Optional currency argument.

/eco delete

Permission:openeco.command.eco.delete

Delete a player's account and that account's transaction history. This cannot be undone.

/eco freeze

Permission:openeco.command.eco.freeze

Freeze an account. Frozen accounts cannot deposit, withdraw, pay, or receive payments.

/eco unfreeze

Permission:openeco.command.eco.unfreeze

Unfreeze a previously frozen account.

/eco rename

Permission:openeco.command.eco.rename

Rename an account's display name. Names must be unique (case-insensitive) and 16 characters or fewer.

/eco reload

Permission:openeco.command.eco.reload

Reload `config.yml` and message templates. Restarts autosave and history prune schedulers.

Does not replace a restart after changing storage backends, cross-server.enabled, or accounts.load-strategy.

Alias

/economy is an alias for /eco.

Migration command

/openecomigrate

Permission:openeco.migrator.admin

Import economy data from another plugin or migrate between storage backends.

Usage: /openecomigrate <source> [--scan] [--dry-run] [--overwrite]

Economy plugin import requires the OpenEcoMigrator addon. Storage migration is built into the core JAR.

Addon commands

OpenEcoEnhancements

/exchange

Permission:openeco.enhancements.exchange

Exchange one currency for another at a configured rate. Usage: `/exchange <amount> <from> <to>`

OpenEco Proxy (Velocity)

/ecosync

Permission:openeco.admin.sync

Manually force a flush-then-refresh cycle for an online player on the proxy network. Usage: `/ecosync <player>`

Useful after direct database edits or when debugging a suspected stale balance.

What /eco reload does

reloadSettings() runs on the main thread and:

1. Reloads config.yml from disk (including legacy currency.* → currencies.* migration).
2. Refreshes message templates.
3. Restarts autosave and history prune schedulers.

Storage type, cross-server mode, and account load strategy still require a full server restart.