Economies

A crate's cost, a requirement, a reward's money and the reroll price all name a currency the same way.

Names

vault, vault-unlocked and playerpoints hold one balance each, so a currency after them is refused rather than guessed at.

Where they are written

A crate that names a currency this server does not run is not loaded, and the console names the file and the key.

Treasury

economy.treasury-wait-ms (250) is how long one Treasury call may take before the plugin gives up and takes nothing. It runs on the player's thread, so a large number stalls a tick. Raise it only for an economy on a slow database.

Placeholder currencies

Many economy plugins have no API but publish a balance placeholder and a take command. That pair is one currency:

economy {
  placeholder {
    tokens {
      balance   = "%tokens_balance%"
      take      = "tokens take {player} {amount}"
      thousands = ","
    }
  }
}

A crate writes [take-money] placeholder:tokens 40. A command cannot report a failure, so the balance is read first and a take the player cannot afford is refused. Needs PlaceholderAPI.

Bridges

An economy none of the names reach is described in economy.bridges, not compiled against. The key is the name a crate writes. None of that plugin's code is touched unless it is installed.

economy {
  bridges {
    mybank {
      plugin         = "MyBank"
      class          = "com.example.mybank.api.BankAPI"
      access         = "static"
      accessor       = "getInstance.getApi"
      balance-method = "getBalance"
      take-method    = "withdraw"
      argument       = "player-id"
      answer         = "boolean"
      currencies     = "one"
    }
  }
}

Related: economy.conf, Crates