1.2

Updated currency api

Author: Jan Kluka

src/main/java/dev/drawethree/xprison/api/currency/model/PhysicalItemCurrency.java

@@ -0,0 +1,14 @@
+package dev.drawethree.xprison.api.currency.model;
+
+import org.bukkit.inventory.ItemStack;
+
+public interface PhysicalItemCurrency {
+
+    /**
+     * Gets the configured physical item for this currency, if any.
+     * This can be used in GUIs or displays to represent the currency visually.
+     *
+     * @return The {@link ItemStack} used as the item, or null if not set.
+     */
+    ItemStack getPhysicalItem();
+}

src/main/java/dev/drawethree/xprison/api/currency/model/XPrisonCurrency.java

@@ -1,7 +1,5 @@
 package dev.drawethree.xprison.api.currency.model;
 
-import org.bukkit.inventory.ItemStack;
-
 /**
  * Represents the metadata and formatting configuration of a currency in the XPrison API.
  * This includes display name, format rules, symbol settings, and optional icon.
@@ -17,13 +15,6 @@ public interface XPrisonCurrency {
      */
     String getName();
 
-    /**
-     * Gets the starting amount of a currency
-     *
-     * @return The amount each player will have on first join
-     */
-    double getStartingAmount();
-
     /**
      * Gets the maximum amount of a currency player can have
      *
@@ -60,14 +51,6 @@ public interface XPrisonCurrency {
      */
     String format(double amount);
 
-    /**
-     * Gets the configured physical item for this currency, if any.
-     * This can be used in GUIs or displays to represent the currency visually.
-     *
-     * @return The {@link ItemStack} used as the item, or null if not set.
-     */
-    ItemStack getPhysicalItem();
-
     /**
      * Retrieves the custom {@link XPrisonCurrencyHandler} responsible for managing balance operations
      * for this currency. If this method returns {@code null}, the currency is assumed to be managed

src/main/java/dev/drawethree/xprison/api/enchants/model/XPrisonEnchantment.java

@@ -1,5 +1,6 @@
 package dev.drawethree.xprison.api.enchants.model;
 
+import dev.drawethree.xprison.api.XPrisonAPI;
 import dev.drawethree.xprison.api.currency.model.XPrisonCurrency;
 
 /**
@@ -89,12 +90,26 @@ public interface XPrisonEnchantment {
     void unload();
 
     /**
-     * Gets the currency used to purchase or upgrade this enchantment.
+     * Gets the name of the currency used to purchase or upgrade this enchantment.
      * <p>
-     * This defines which type of currency (e.g., Tokens, Gems, Vault/Money)
-     * will be consumed when a player interacts with this enchant.
+     * This defines which type of currency (e.g., "Tokens", "Gems", "Vault") will be consumed
+     * when a player interacts with this enchant. The name should match a registered currency
+     * in the XPrison currency system.
      *
-     * @return The {@link XPrisonCurrency} implementation representing the currency type.
+     * @return The name of the currency used for this enchantment.
      */
-    XPrisonCurrency getCurrency();
+    String getCurrencyName();
+
+    /**
+     * Retrieves the {@link XPrisonCurrency} instance associated with the currency name returned by {@link #getCurrencyName()}.
+     * <p>
+     * This is a convenience method to directly access the currency object via the XPrison API,
+     * typically used to format amounts, apply caps, or access metadata like display name or symbol.
+     *
+     * @return The {@link XPrisonCurrency} instance, or {@code null} if the currency is not registered.
+     */
+    default XPrisonCurrency getCurrency() {
+        return XPrisonAPI.getInstance().getCurrencyApi().getCurrency(getCurrencyName());
+    }
+
 }

src/main/java/dev/drawethree/xprison/api/enchants/model/XPrisonEnchantmentBase.java

@@ -35,7 +35,7 @@ public abstract class XPrisonEnchantmentBase implements XPrisonEnchantment, Refu
     protected long baseCost;
     protected long increaseCost;
     protected XPrisonEnchantmentGuiProperties guiProperties;
-    protected XPrisonCurrency currency;
+    protected String currencyName;
     protected boolean refundEnabled;
     protected int refundGuiSlot;
     protected double refundPercentage;
@@ -78,7 +78,7 @@ private void loadBaseProperties(JsonObject config) {
         this.maxLevel = JsonUtils.getRequiredInt(config,"maxLevel");
         this.baseCost = JsonUtils.getRequiredLong(config, "initialCost");
         this.increaseCost = JsonUtils.getRequiredLong(config,"increaseCostBy");
-        this.currency = XPrisonAPI.getInstance().getCurrencyApi().getCurrency(JsonUtils.getOptionalString(config,"currency", "Tokens"));
+        this.currencyName = JsonUtils.getOptionalString(config,"currency", "Tokens");
 
         JsonObject refundObject = JsonUtils.getRequiredObject(config,"refund");
         this.refundEnabled = JsonUtils.getRequiredBoolean(refundObject,"enabled");