💵 Crate Open Cost

In ExcellentCrates, in addition to keys, or instead of them, you can make certain crates paid to open.

Players can't open paid crates if they can't afford them, even if they do have key(s) for it.

A crate can require multiple currencies at the same time. See below for a list of available currencies.

Available Currencies

The following currencies are available to use:

  • XP Points (built-in, regular player's xp points)

  • XP Levels (built-in, regular player's xp levels)

  • Money (built-in, requires Vault and vault-compatible economy plugins)

  • CoinsEngine (⭐ Recommended, Vault compatble!)

How to Set Open Cost

Follow the steps to make a crate paid:

  1. Go to /crate editor -> Crates -> Select your crate

  2. Find the Open Cost button.

  3. Click to add cost.

  4. You will see a list of all available currencies in chat.

  5. Click the one you'd like to use, press space, and enter amount. Example: money 50

  6. Done. You've added a cost for your crate!

Currency Settings

For some currencies, there are a few customization settings available in config.yml under Currency section. Make sure to check it out!

Currency:
  xp:
    Enabled: true
    Name: XP
    Format: '%amount% %name%'
  levels:
    Enabled: true
    Name: XP Levels
    Format: '%amount% %name%'
  money:
    Enabled: true
    Name: Money
    Format: $%amount%

If, for some reason, you need to know currency identifiers, you can see them in plugin startup logs:

[ExcellentCrates] Registered currency: xp
[ExcellentCrates] Registered currency: levels
[ExcellentCrates] Registered currency: money
[ExcellentCrates] Registered currency: coinsengine_gems
[ExcellentCrates] Registered currency: coinsengine_coins

Last updated