Skip to main content

​
Currency Overview

JPlots supports three different currency systems, giving you flexibility to choose what works best for your server. Players use currency to rent plots and extend their rental duration.

​
Currency Types

JPlots offers three currency options:

Custom Items

Players hold physical items in their inventory. Fully customizable with any item type, name, and lore.

EssentialsX

Uses EssentialsX’s built-in economy system.

Vault

Works with any economy plugin that supports Vault (like EssentialsX, CMI, etc.).

​
Configuring Currency Type

The currency type is set in your config.yml file: 
currency:
  # Options: "items" (default), "essentialsx", "vault"
  type: "items"

​
Switching Currency Types

  1. Open your config.yml file
  2. Change the currency.type value to your desired type
  3. Reload the plugin: /plot reload
Important: When switching from items to economy-based currency (EssentialsX/Vault), make sure the required plugin is installed and configured. If the plugin isn’t found, JPlots will automatically fall back to items currency.

​
Custom Item Currency (Default)

Custom item currency is the default and most flexible option. You can use any Minecraft item as currency, with full control over its appearance.

​
Setting Up Custom Item Currency

​
Method 1: Using Commands (Easiest)

  1. Hold the item you want to use as currency in your hand
  2. Run the command:
/plot currency set
This automatically saves all the item’s properties (material, name, lore, enchantments, etc.) as the currency.

​
Method 2: Manual Configuration

You can also edit the currency.yml file directly: 
currency:
  material: "DIAMOND"  # The item type
  display-name: "&bPlot Currency"  # Display name with color codes
  amount: 1  # Default amount
  lore:
    - "&7Official plot currency"
    - "&7Use this to rent plots"
  custom-model-data: 0  # For custom textures
  unbreakable: false
  glowing: false  # Makes the item glow
  enchantments: []  # List of enchantments
  item-flags: []  # Item flags to hide

​
Customizing Currency Items

Once you’ve set a currency item, you can customize it further by editing currency.yml:
  • Material: Any valid Minecraft item (e.g., DIAMOND, EMERALD, GOLD_INGOT)
  • Display Name: Use & for color codes (e.g., &b for aqua, &e for yellow)
  • Lore: Add multiple lines of descriptive text
  • Glowing: Set to true to make the item glow (like enchanted items)
  • Custom Model Data: Use custom resource pack textures

​
Getting Currency Items

Admins can give currency items to players for testing or rewards: 
/plot currency get [amount]
Examples: 
/plot currency get        # Gives 1 currency item
/plot currency get 10     # Gives 10 currency items

​
Checking Currency Type

To see what currency system is currently active: 
/plot currency info
This shows you the current currency type and whether currency commands are available.
Currency commands (/plot currency set and /plot currency get) are only available when using items currency. When using EssentialsX or Vault, these commands are disabled since economy plugins handle currency management.

​
EssentialsX Economy

EssentialsX has its own built-in economy system. If you’re already using EssentialsX on your server, this is a great option.

​
Setup

  1. Install EssentialsX - Make sure EssentialsX is installed and running
  2. Configure in JPlots - Set currency.type: "essentialsx" in config.yml
  3. Reload - Run /plot reload
EssentialsX economy works through Vault if Vault is installed, or directly through EssentialsX’s API if Vault isn’t available.

​
How It Works

  • Players use their EssentialsX money balance
  • Renting a plot costs money from their balance
  • Extending plots also uses EssentialsX money
  • All EssentialsX economy commands work normally (/pay, /balance, etc.)

​
Vault Economy

Vault is a compatibility layer that works with many economy plugins. This gives you the most flexibility.

​
Supported Economy Plugins

Vault works with popular economy plugins like:
  • EssentialsX
  • CMI
  • And many more!

​
Setup

  1. Install Vault - Download and install the Vault plugin
  2. Install Economy Plugin - Install your preferred economy plugin (EssentialsX, CMI, etc.)
  3. Configure in JPlots - Set currency.type: "vault" in config.yml
  4. Reload - Run /plot reload
Make sure both Vault and your economy plugin are installed and working before switching to Vault currency. JPlots will check for Vault on startup and fall back to items if it’s not found.

​
How It Works

  • Players use their economy plugin balance
  • All transactions go through your economy plugin
  • Works seamlessly with shop plugins and other economy-dependent plugins
  • Economy plugin commands work normally

​
How Currency is Used

​
Renting Plots

When a player rents a plot, they pay the rental price you’ve set: 
/plot rent <plot-name> <amount>
Example: 
/plot rent shop-1 50
This sets the plot to cost 50 currency. When a player right-clicks the plot’s sign or hologram, they’ll pay 50 currency to rent it.

​
Extending Plots

Players can extend their plot rental by paying an extension cost: 
/plot extend cost <plot-name> <amount>
Example: 
/plot extend cost shop-1 20
This sets the extension cost to 20 currency. Players can extend their plot through the GUI menu (/plot menu) or by right-clicking the plot sign/hologram.

​
Currency Requirements

  • Players must have enough currency in their balance/inventory
  • For items currency: Players need the physical items in their inventory
  • For economy currency: Players need sufficient money in their economy account
  • If a player doesn’t have enough, they’ll see an error message

​
Currency Tips

​
For Item Currency

  • Consider stackability - Items that stack to 64 are easier to manage than non-stackable items
  • Use resource packs - Custom model data lets you create unique-looking currency items

​
Troubleshooting Currency Issues

​
Items Currency Not Working

Problem: Currency items aren’t being recognized or removed. Solutions:
  • Make sure you’ve set the currency with /plot currency set
  • Check that the item in the player’s inventory matches exactly (name, lore, etc.)
  • Verify the currency is saved in currency.yml

​
Economy Currency Not Working

Problem: Economy transactions fail or currency type doesn’t switch. Solutions:
  • Verify the required plugin (EssentialsX/Vault) is installed and enabled
  • Check server logs for error messages
  • Make sure the economy plugin is properly configured
  • Try reloading: /plot reload

​
Players Can’t Rent Plots

Problem: Players get “not enough currency” errors even when they have money/items. Solutions:
  • Check the currency type matches what you’re using
  • For items: Verify players have the correct currency items (not just any item, but the specific currency item)
  • For economy: Check the player’s balance with economy commands
  • Verify the plot’s rent price is set correctly

​
Next Steps

Quick Start

Learn how to create plots and set rental prices

Commands Reference

See all currency-related commands