Commands

This page covers how commands work in BOSEconomy, and includes a list of all commands and their permission nodes.

Server Console

The server console has permission to use every command. However, commands which are intended to be used by a player (such as "/wallet") will not work for the console. Console commands must be submitted without a forward slash ("econ ..." instead of "/econ ...").

Command Blocks

Command blocks have permission to use every command. However, if used to run purely informative commands (such as "/econ info"), or commands which are intended to be used by a player, then they will not do anything. Commands should work regardless of whether or not they are preceded by a forward slash. Command blocks are enabled by the plugin setting "allow-command-blocks". If the plugin setting "show-command-block-output" is set to "true", then all feedback directed at a command block will instead be sent to the server console. The feedback is tagged with the coordinates (and the name, if applicable) of the command block. If the setting is set to "false", then command blocks will log neither failure nor success feedback. Messages sent to other players, such as the message for receiving money from a "/pay" command, are always sent regardless of the setting.

General Aliases

The following aliases can be used for any command.

Command TextAliases
/econ/ec
bracketbr, brackets
bankba, banks
requestreq, requests

Additional Notes

  • All commands are case-insensitive.
  • Commands accessed using administrator privileges will typically display "an administrator" instead of the name of the admin when providing feedback to involved players.
  • Commands have either or both a "common" and "admin" permission node. For instance, the "/econ bank info" command has the permissions "BOSEconomy.common.bank.info" and "BOSEconomy.admin.bank.info". The common permission node allows access when the user is a bank member, and the admin permission node allows access to any bank account. Ordinary players typically only need common permission nodes, and are given them by default.
  • Most commands which accept account names can be used on bank accounts by prepending a '$' symbol to the bank account's name. Most of these commands also support account groups.

Command List

Below is a list of all of the BOSEconomy commands and their relevant permission nodes.


/econ help [page]

Node: BOSEconomy.common.help

Lists the plugin commands and briefly describes them. Help output is also displayed for any unrecognized command, though it will ignore the page argument.


/econ

Aliases: /wallet, /money

Node: BOSEconomy.common.wallet

Displays how much money you own.


/econ income [page]

Node: BOSEconomy.common.income

Lists your income brackets and rate of payment.


/econ pay <name> <amount>

Alias: /pay <name> <amount>

Node: BOSEconomy.common.pay

Pays money to another user or bank account. Only allows payments to online players when used by another player, and accepts partial name matches. Serves as an alias for the add command for the server console. Players who do not have permission to deposit into bank accounts will not be able to use this command to do so. To pay a bank account, prepend a '$' symbol to its name (ex: $Bank01).


/econ info <name> [page]

Node: BOSEconomy.admin.money.info

Lists the income brackets of a player or bank account, their total income, and how much money they own.


/econ mastery [page]

Node: BOSEconomy.common.mastery

Lists brackets that you are the master of.


/econ viewmastery <name> [page]

Node: BOSEconomy.admin.viewmastery

Lists brackets that a player or bank account is the master of.


/econ add <name> <amount>

Node: BOSEconomy.admin.money.add

Adds to a player or bank account's money. This command is equivalent to using the "sub" command with a negative number.


/econ sub <name> <amount>

Node: BOSEconomy.admin.money.sub

Subtracts from a player or bank account's money. This command is equivalent to using the "add" command with a negative number.


/econ set <name> <amount>

Node: BOSEconomy.admin.money.set

Sets a player or bank account's money.


/econ clear <name>

Node: BOSEconomy.admin.money.clear

Sets a player or bank account's money to zero. This command is equivalent to using the "set" command with a value of zero.


/econ scale <multiplier>

Node: BOSEconomy.admin.money.scale

Scales all of the money in the economy. This affects all accounts, brackets, and the initial-money setting. Can be used with negative numbers to negate all money, or zero to set all money to zero.


/econ reload [category1] ...

Node: BOSEconomy.admin.reload

Reloads BOSEconomy data. Valid categories are settings, accounts, brackets, and all. If no categories are provided, all of them are reloaded.


/econ save [category1] ...

Node: BOSEconomy.admin.save

Immediately saves BOSEconomy data. Valid categories are settings, accounts, brackets, and all. If no categories are provided, all of them are saved.


/econ stats

Node: BOSEconomy.common.stats

Displays the total player count, total money, average money, and average income. Bank accounts are not included in the statistics.


/econ top5

Node: BOSEconomy.common.top5

Displays the top 5 wealthiest players.


/econ bracket create <bracket> <value> [master]

Node: BOSEconomy.admin.bracket.create

Creates a new bracket.


/econ bracket remove <bracket>

Node: BOSEconomy.admin.bracket.remove

Removes a bracket.


/econ bracket rename <bracket> <name>

Nodes: BOSEconomy.common.bracket.rename BOSEconomy.admin.bracket.rename

Renames a bracket. The common permission node allows a bracket's master to change their bracket's name if the "can-rename" setting is set to "true".


/econ bracket list [page]

Node: BOSEconomy.admin.bracket.list

Lists all of the brackets.


/econ bracket info <bracket>

Nodes: BOSEconomy.common.bracket.info BOSEconomy.admin.bracket.info

Displays information about a bracket, including all of its settings. The common permission node allows a bracket's master to view information about their bracket.


/econ bracket set <bracket> <field> [value]

Nodes: BOSEconomy.common.bracket.set BOSEconomy.admin.bracket.set

Changes a bracket setting. Displays a list of possible settings if an invalid setting is provided. The common permission node allows a bracket's master to change their bracket's "value" setting within the boundaries specified by the "minimum-value" and "maximum-value" settings if the "can-change-value" setting is set to "true".


/econ bracket setmaster <bracket> [master]

Nodes: BOSEconomy.common.bracket.set BOSEconomy.admin.bracket.set

Sets or removes a bracket's master. This command is an alias for "/econ bracket set <bracket> master [master]".


/econ bracket removemaster <bracket>

Nodes: BOSEconomy.common.bracket.set BOSEconomy.admin.bracket.set

Removes a bracket's master. This command is an alias for "/econ bracket set <bracket> master".


/econ bracket listmembers <bracket> [page]

Nodes: BOSEconomy.common.bracket.listmembers BOSEconomy.admin.bracket.listmembers

Lists the members of a bracket. The common permission node allows a bracket's master to view their bracket's member list.


/econ bracket addmember <bracket> <member>

Nodes: BOSEconomy.common.bracket.addmember BOSEconomy.admin.bracket.addmember

Adds a member to a bracket. The common permission node serves multiple purposes. It allows a bracket's master to add members to their bracket if the bracket's "add-member" setting is not set to "deny". It allows players to add themselves to a bracket if the bracket's "player-join" setting is not set to "deny". It allows players to add an owned back account to a bracket if the bracket's "bank-join" setting is not set to "deny".


/econ bracket removemember <bracket> <member>

Nodes: BOSEconomy.common.bracket.removemember BOSEconomy.admin.bracket.removemember

Removes a member from a bracket. The common permission node serves multiple purposes. It allows a bracket's master to remove members from their bracket if the bracket's "add-member" setting is not set to "deny". It allows players to remove themselves from a bracket if the bracket's "player-leave" setting is not set to "deny". It allows players to remove an owned back account from a bracket if the bracket's "bank-leave" setting is not set to "deny".


/econ bracket join <bracket>

Nodes: BOSEconomy.common.bracket.addmember BOSEconomy.admin.bracket.addmember

Adds you to a bracket if the bracket's "player-join" setting is not set to "deny". This command is an alias for "/econ bracket addmember <bracket> @me".


/econ bracket leave <bracket>

Nodes: BOSEconomy.common.bracket.removemember BOSEconomy.admin.bracket.removemember

Removes you from a bracket if the bracket's "player-leave" setting is not set to "deny". This command is an alias for "/econ bracket removemember <bracket> @me".


/econ bracket setmultiplier <bracket> <member> <multiplier>

Nodes: BOSEconomy.common.bracket.setmultiplier BOSEconomy.admin.bracket.setmultiplier

Sets a member's multiplier in a bracket. The common permission node allows a bracket's master to change a member's multiplier within the boundaries specified by the "minimum-multiplier" and "maximum-multiplier" settings if the "change-multiplier" setting is not set to "deny".


/econ bracket clear <account> [filter1] ...

Node: BOSEconomy.admin.bracket.clear

Removes an account from its brackets. Valid filters are 'member' and 'master', to remove the account from brackets that it is a member or the master of. If none are provided, both filters are used.


/econ bank create <bank> [owners] [members]

Node: BOSEconomy.admin.bank.create

Creates a new bank account with the specified owners and members. If you only wish to add members, use the "@none" account group token.
(Ex: "/econ bank create Bank01 @none Member,AnotherMember")


/econ bank remove <bank>

Node: BOSEconomy.admin.bank.remove

Removes a bank account.


/econ bank rename <bank> <name>

Nodes: BOSEconomy.common.bank.rename BOSEconomy.admin.bank.rename

Renames a bank account. The common permission node allows an owner to rename their bank account.


/econ bank list [page]

Node: BOSEconomy.common.bank.list

Lists all bank accounts.


/econ bank info <bank> [page]

Nodes: BOSEconomy.common.bank.info BOSEconomy.admin.bank.info

Lists the income brackets of a bank account, its total income, and how much money it has. The common permission node allows an owner or member to view their bank account's information.


/econ bank mastery <bank> [page]

Nodes: BOSEconomy.common.bank.mastery BOSEconomy.admin.bank.mastery

Lists brackets that a bank account is the master of. The common permission node allows an owner to view their bank account's mastery.


/econ bank listmembers <bank> [page]

Nodes: BOSEconomy.common.bank.listmembers BOSEconomy.admin.bank.listmembers

Lists the members and owners of a bank account. The common permission node allows an owner to view their bank account's member list.


/econ bank withdraw <bank> <amount>

Nodes: BOSEconomy.common.bank.withdraw BOSEconomy.admin.bank.withdraw

Withdraws money from a bank account. The common permission node allows an owner or member to withdraw from their bank account.


/econ bank deposit <bank> <amount>

Node: BOSEconomy.common.bank.deposit

Deposits money into a bank account. This is available to any player, not just the bank account's members and owners.


/econ bank addowner <bank> <player>

Nodes: BOSEconomy.common.bank.addowner BOSEconomy.admin.bank.addowner

Adds an owner to a bank account. If the player is already a member, they are changed to an owner. The common permission node allows an owner to add additional owners to their bank account.


/econ bank addmember <bank> <player>

Nodes: BOSEconomy.common.bank.addmember BOSEconomy.admin.bank.addmember

Adds a member to a bank account. If the player is already an owner, they are changed to a member. The common permission node allows an owner to add members to their bank account.


/econ bank removemember <bank> <player>

Nodes: BOSEconomy.common.bank.removemember BOSEconomy.admin.bank.removemember

Removes a member or owner from a bank account. The common permission node allows an owner to remove owners or members from their bank account.


/econ request list [page]

Node: BOSEconomy.common.request.list

Lists your sent and received requests.


/econ request do <request> <action>

Node: BOSEconomy.common.request.do

Performs an action on a request. Valid actions are 'cancel' for sent requests, and 'accept' or 'reject' for received requests.


/econ payday reset

Node: BOSEconomy.admin.payday.reset

Resets the payday timer. This initializes the payday interval at whatever time the command is sent. From this point in time, the interval continues normally. This does not prompt an immediate payday to occur; it sets it to occur one payday interval after the command is used.


/econ about

Node: BOSEconomy.common.about

Displays the version number of the plugin.


Comments

Posts Quoted:
Reply
Clear All Quotes