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 Text | Aliases |
---|---|
/econ | /ec |
bracket | br , brackets |
bank | ba , banks |
request | req , 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.
err hello, what exactly is <bracket> ?
@samcornell
it is where you make the money. If you are not part of a bracket you will not make money. it is how you get paid!
Its possible to use BOSEconomy without all this bracket nonsense? I handle my own way of cash entering and leaving the server. Will simply denying the bracket permissions achieve that?
Brackets are completely optional. Change your default-bracket setting to be blank, and players will not be added to a bracket when they join. You can remove the default bracket as well, or set it to be disabled.
Whenever I try to use a command such as /econ set or any other admin like commands it doesn't work. It just comes up with the econ help page 1. Am I doing something wrong?
Im getting the same thing as benolian, trying to set players money and it just brings up page 1 of help
Same here as Confuzzled77 and Benolian... i can't create banks, brackets, send money.. just shows the help menu for BOSE
@Quisari
I had same problem - you have to change in main config file Use OP permissions to True . It should work then
Focus on mysql support dude. really need it for webauctionplus !
Works with 1.3
You know /econ top 5 doesnt work, infact half of these commands dont... PermissionsEx edit: problem is you have to enable op perms, and bracket default blah blah
@TanveerGT5
All of the commands work. I use PermissionsBukkit and have no problems in 1.3.1 at all.
@ThornRage
are you using PermissionsEx? if so can you paste the settings/config in to a pastebin? because for 1 month now I can't get this to properly work...
Those saying it doesn't work with PEX I have a simple solution :
"get rid of PEX" it is bad.
Groupmanager is so much better.
those of you having problems with PEX are clearly doing something wrong. we use PEX and BOSE tolerates it perfectly fine. as for top5 not working, make sure you change the "excluded" ( i think) flag in the default bracket setup.
could you help convince physicalshops to hook into your plugin or help me find a sign shop compatable with your plugin please?
@z00100100
Try Hyperconomy.
http://dev.bukkit.org/server-mods/hyperconomy/
@Equinox2507
PEX is bad? lol u mad? It's the most advanced perms plugin till date, using group manager is the easy way out for noobs.
Is there a way to make it accept /money?
Everyone comes on my server and I need to tell them to use /econ instead. Any reason it can't recognize both?
@themfmosey
Man you took word from my mouth ! If you don't want to change commands maybe you could make it changeable ! It's easy and understandable with command /money but okay it's your chose I added now spout balance plugin and now everyone can see balance no need to write but for those who aren't using spout it's hard and if I can be honest than kind a stupid why should I writhe something based on economy when I want simply see my wallet of course first thing come in mind are money but than you relies that it's wrong and for this server was different command ! Of course that's small thing but those small things make server look nice and easy to use !