Skip to content

Economy System

Armory Bot economy includes currency balances, a shop, missions, and admin controls.

Command Groups

  • /shop - Member economy actions
  • /mission - Daily/weekly mission wagers and mission configuration views
  • /economy - Admin economy and shop management

Member Commands (/shop)

Command Description
/shop balance [user] View balance
/shop give <user> <amount> Transfer currency to another user
/shop deposit <amount> Move coins from wallet to bank
/shop withdraw <amount> Move coins from bank to wallet
/shop browse [page] Browse shop inventory
/shop buy <item_id> Buy item by shop ID
/shop info <item_id> View detailed item info
/shop inventory View owned items
/shop sell <item_id> [quantity] Sell owned items
/shop turnin <item_name> [quantity] Turn in mission/collection items
/shop wealthboard [page] Balance leaderboard
/shop transactions [limit] Recent transaction history
/shop guard-duty Guard duty activity reward flow

Mission Commands (/mission)

Command Description
/mission daily Run a daily mission wager (optional difficulty, wager, and item sacrifice)
/mission weekly Run a weekly mission wager (optional difficulty, wager, and item sacrifice)
/mission info View the Missions vs Deployments vs Bounties system breakdown
/mission config View current mission wager configuration (admin)

Admin Commands (/economy)

Command Description
/economy setbalance <user> <amount> Set exact balance
/economy addcoins <user> <amount> Add coins
/economy removecoins <user> <amount> Remove coins
/economy additem <name> <description> <price> [role] [stock] Add shop item
/economy edititem <item_id> ... Update shop item fields
/economy restock <item_id> <amount> Increase item stock
/economy removeitem <item_id> Remove shop item
/economy config ... Update currency and mission reward settings
/economy toggle <enabled> Enable/disable economy
/economy auditlog [limit] View admin audit entries

Quick Setup

1) Configure currency and mission rewards

/economy config daily_amount:100 weekly_amount:500 currency_name:"Coins" currency_symbol:"🪙"

2) Create first shop items

/economy additem name:"VIP Access" description:"VIP role" price:10000 role:@VIP stock:25
/economy additem name:"Name Change" description:"One nickname update" price:2500 stock:-1

3) Test member flow

/shop balance
/shop browse
/shop buy item_id:1
/shop inventory

Shop and Stock Notes

  • Item IDs are required for /shop buy and related item actions.
  • stock:-1 means unlimited stock.
  • Shop administration uses /economy ...; member purchasing uses /shop ....

Transfer and Bank Notes

  • Use /shop give for player-to-player transfers.
  • Use /shop deposit and /shop withdraw for wallet/bank movement.
  • Use /shop transactions for recent activity checks.

Missions and Progression

Missions provide repeatable reward cadence:

/mission daily
/mission weekly
/mission info

Adjust mission-related economy values through /economy config and mission configuration tools.

Permissions

Admin economy commands require:

  • Manage Server permission, or
  • Explicit permission override (for example economy or shop) via /permissions grant.

Troubleshooting

Purchase fails

  1. Confirm the item ID exists (/shop browse).
  2. Confirm user has enough balance.
  3. Confirm stock is available.

Economy commands denied

  1. Confirm role has required override for economy/shop.
  2. Confirm user has Manage Server if no override exists.
  3. Check /permissions list for conflicting overrides.

Missions not claimable

  1. Check cooldown/reset state with /mission info.
  2. Confirm economy is enabled (/economy toggle enabled:true).