Commands

All core commands are declared in plugin.yml; the commands section of config.yml can disable any of them or change its name and aliases (restart required, see Configuration). The names below are the defaults. Tab-completion suggests subcommands and arguments you have permission for.

Player commands

/balance [player] [currency]bal, money

Permission:openeco.command.balance

Check your or another player's balance. Without `openeco.command.balance.others`, standard players can still check their own balance in another currency using /balance [currency].

/baltop [page] [currency]balancetop, moneytop

Permission:openeco.command.baltop

View the richest players. Supports pagination and an optional currency filter. Results refresh in the background every `baltop.refresh-interval-seconds` while changes are pending.

/pay <player> <amount> [currency]

Permission:openeco.command.pay

Send money to another player. Respects pay cooldown, transfer tax, and minimum transaction limits from the config.

/history [self|player] [page] [currency]txhistory, 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. Note: page number and currency can be provided in any order.

Admin commands — /eco

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

/eco give <player> <amount> [currency]

Permission:openeco.command.eco.give

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

/eco take <player> <amount> [currency]

Permission:openeco.command.eco.take

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

/eco set <player> <amount> [currency]

Permission:openeco.command.eco.set

Set a player's balance to an exact amount.

/eco reset <player> [currency]

Permission:openeco.command.eco.reset

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

/eco delete <player>

Permission:openeco.command.eco.delete

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

/eco freeze <player>

Permission:openeco.command.eco.freeze

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

/eco unfreeze <player>

Permission:openeco.command.eco.unfreeze

Unfreeze a previously frozen account.

/eco rename <player> <newname>

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, leaderboard refresh, and history prune schedulers.

Does not replace a restart after changing storage backends or cross-server.enabled.

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.