Vault

Table of contents

  1. What it enables
  2. How it works
  3. When absent
  4. Setup
  5. Related pages

Vault is an economy, permissions, and chat API for Bukkit plugins. EzLifesteal uses Vault’s economy layer to support real in-game currency for the shop and kill streak money rewards.

What it enables

  • Paid shop items — set a price on any Shop entry. Without Vault, setting a price has no effect and all items are offered for free.
  • Money kill streak rewards — award in-game currency through the money field in a Kill Streak reward entry.

How it works

On server start EzLifesteal queries the Vault service registry for an Economy provider. Any economy plugin that ships a Vault adapter is compatible, including:

  • EssentialsX
  • CMI
  • TheNewEconomy (TNE)
  • GoldAndEconomy, and others

EzLifesteal does not depend on a specific economy plugin — only on the Vault API layer.

When absent

Feature Fallback behaviour
Shop item with price set Item is offered for free
Kill streak money reward Reward entry is silently ignored

No errors are logged. The shop and kill streak features continue to work; only the economy-dependent parts are disabled.

Setup

  1. Download and install Vault on your server.
  2. Install a Vault-compatible economy plugin (e.g. EssentialsX).

  3. Add a price to one or more shop entries in shop.yml:

    slots:
  - slot: 11
    heart: standard
    price: 500.0
    amount: 1
  4. Or add a money reward in lifesteal-killstreaks.yml:
streaks:
  - threshold: 5
    rewards:
      - type: money
        amount: 250.0