Skip to content

Commands and Permissions

Jump to bottom
snazzyatoms edited this page Apr 9, 2026 · 1 revision

This page covers the commands and permission nodes for both the modern Coffers line and the Coffers Legacy line.

Command Overview

Coffers provides:

  • a modern command root: /coffers
  • a legacy command root: /cofferslegacy

Both lines support the same major command actions:

  • balance
  • pay
  • set
  • history
  • currencies
  • migratevault

Modern Commands

The modern line uses:

  • /coffers

/coffers balance [player] [currency]

Shows a balance.

Usage examples:

  • /coffers balance
  • /coffers balance gems
  • /coffers balance Kai
  • /coffers balance Kai coins

Notes:

  • players can check their own balance
  • checking another player's balance requires the coffers.command.balance.others permission

/coffers pay <player> <amount> [currency]

Transfers funds from the sender to another player.

Usage examples:

  • /coffers pay Kai 50
  • /coffers pay Kai 25 gems

Notes:

  • this command is for players only
  • players cannot pay themselves
  • negative amounts are rejected

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

Sets a player's balance directly.

Usage examples:

  • /coffers set Kai 100
  • /coffers set Kai 500 coins

Notes:

  • intended for administration and management use
  • requires the coffers.command.set permission

/coffers history [player] [limit]

Shows recent transaction history for an account.

Usage examples:

  • /coffers history
  • /coffers history Kai
  • /coffers history Kai 10

Notes:

  • when used without a player argument, players can view their own recent history
  • console must specify a player

/coffers currencies

Shows the currently available currencies.

Usage example:

  • /coffers currencies

/coffers migratevault [provider]

Migrates balances from another Vault-backed economy provider already available on the server.

Usage examples:

  • /coffers migratevault
  • /coffers migratevault Essentials

Notes:

  • requires the coffers.command.migratevault permission
  • intended for migration and setup workflows

Legacy Commands

The legacy line uses:

  • /cofferslegacy

/cofferslegacy balance [player] [currency]

Shows a balance on the legacy line.

Usage examples:

  • /cofferslegacy balance
  • /cofferslegacy balance gems
  • /cofferslegacy balance Kai
  • /cofferslegacy balance Kai coins

/cofferslegacy pay <player> <amount> [currency]

Transfers funds on the legacy line.

Usage examples:

  • /cofferslegacy pay Kai 50
  • /cofferslegacy pay Kai 25 gems

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

Sets a player's balance on the legacy line.

Usage examples:

  • /cofferslegacy set Kai 100
  • /cofferslegacy set Kai 500 coins

/cofferslegacy history [player] [limit]

Shows recent transaction history on the legacy line.

Usage examples:

  • /cofferslegacy history
  • /cofferslegacy history Kai
  • /cofferslegacy history Kai 10

/cofferslegacy currencies

Shows the currently available currencies on the legacy line.

Usage example:

  • /cofferslegacy currencies

/cofferslegacy migratevault [provider]

Migrates balances from another Vault-backed economy provider into the legacy Coffers line.

Usage examples:

  • /cofferslegacy migratevault
  • /cofferslegacy migratevault Essentials

Permission Overview

The modern and legacy lines use separate permission namespaces.

Modern permissions:

  • coffers.command.use
  • coffers.command.balance.others
  • coffers.command.set
  • coffers.command.migratevault

Legacy permissions:

  • cofferslegacy.command.use
  • cofferslegacy.command.balance.others
  • cofferslegacy.command.set
  • cofferslegacy.command.migratevault

Modern Permission Nodes

coffers.command.use

Default: true

Allows use of the main /coffers command root.

coffers.command.balance.others

Default: op

Allows a user to check another player's balance.

coffers.command.set

Default: op

Allows direct balance setting through /coffers set.

coffers.command.migratevault

Default: op

Allows Vault migration commands through /coffers migratevault.

Legacy Permission Nodes

cofferslegacy.command.use

Default: true

Allows use of the main /cofferslegacy command root.

cofferslegacy.command.balance.others

Default: op

Allows a user to check another player's balance on the legacy line.

cofferslegacy.command.set

Default: op

Allows direct balance setting through /cofferslegacy set.

cofferslegacy.command.migratevault

Default: op

Allows Vault migration commands through /cofferslegacy migratevault.

Recommended Permission Setup

For most servers:

  • leave coffers.command.use enabled for normal players
  • leave cofferslegacy.command.use enabled for normal players if you are running the legacy line
  • reserve balance.others, set, and migratevault for staff or administrators

Typical admin-level nodes:

  • coffers.command.balance.others
  • coffers.command.set
  • coffers.command.migratevault

Typical legacy admin-level nodes:

  • cofferslegacy.command.balance.others
  • cofferslegacy.command.set
  • cofferslegacy.command.migratevault

Notes

Keep in mind:

  • the modern line and legacy line use different command roots
  • the modern line and legacy line use different permission node prefixes
  • migration commands are powerful and should generally be restricted to administrators
  • balance-setting permissions should not be granted to normal players

Clone this wiki locally