💲Currency System

Currency Systems

bShop supports multiple currency systems for flexible economy integration.

Vault Economy (Default)

When no custom currency is specified, bShop uses the Vault API:

items:
  - id: diamond
    material: DIAMOND
    buy-price: 100.0
    sell-price: 50.0

Custom Currency Commands

For custom currency systems, use currency-command:

items:
  - id: premium_item
    material: NETHERITE_INGOT
    buy-price: 100
    currency-command: "tokens take %player% %amount%"
    currency-requirement: "%tokens_balance% >= 100"

Currency Command Placeholders

• %player% - Player's name

• %amount% - Transaction amount

• %price% - Item price

Currency Requirement Check

Use currency-requirement to check if player has sufficient funds:

currency-requirement: "%tokens_balance% >= 100"

This uses PlaceholderAPI to check the player's balance before allowing the transaction.

Priority System

1. If currency-command is specified, use custom currency

2. Otherwise, use Vault economy

3. Currency requirement is always checked if specified

Examples

Vault Economy

buy-price: 100.0
sell-price: 50.0

Custom Tokens

buy-price: 100
currency-command: "tokens take %player% %amount%"
currency-requirement: "%tokens_balance% >= 100"