Economy

HeadDB can optionally charge players when they obtain heads.

Requirements

• Vault
• A Vault-compatible economy provider
• enabled: true in economy.yml

When economy support is disabled, heads are free.

Configuration

enabled: false
provider: vault

prices:
  any-head: 0.0
  player-heads: 0.0
  categories: {}
  custom-categories: {}
  heads: {}

Price scopes

Setting	Purpose
prices.any-head	Global fallback price.
prices.player-heads	Price for player heads.
prices.categories	Prices keyed by remote or applicable category ID.
prices.custom-categories	Prices keyed by Custom Category ID.
prices.heads	Per-head prices using typed or visible IDs.

Example:

prices:
  any-head: 5.0
  player-heads: 25.0

  categories:
    blocks: 2.5
    helmets: 15.0

  custom-categories:
    donor-shop: 50.0

  heads:
    "123": 100.0
    "custom:server-logo": 250.0

Resolution priority

HeadDB uses the most specific applicable configured price. An individual head price takes precedence over category and fallback pricing. Custom-category, player-head, and remote-category rules apply according to the selected head and acquisition context.

A value of 0 makes that scope free.

Failure behavior

When economy is enabled but Vault or a compatible provider is unavailable, HeadDB logs a warning and does not silently withdraw money. Check /hdb debug, /hdb report, and the server console.

Transactions fail cleanly when the player has insufficient funds or the economy provider rejects the withdrawal.