CustomNPC-Plus-API/java/noppes/npcs/api/handler/IPlayerCurrencyData.java

package noppes.npcs.api.handler;

/**
 * Interface for player currency data.
 * Note: If Vault integration is enabled in config, these operations
 * will use the Vault economy instead of CNPC+ built-in currency.
 */
public interface IPlayerCurrencyData {

    /**
     * Get the current balance
     */
    long getBalance();

    /**
     * Set the balance directly
     *
     * @param balance The new balance
     */
    void setBalance(long balance);

    /**
     * Add currency to balance (deposit)
     *
     * @param amount Amount to add
     * @return true if successful, false if would exceed max balance
     */
    boolean deposit(long amount);

    /**
     * Remove currency from balance (withdraw)
     *
     * @param amount Amount to remove
     * @return true if successful, false if insufficient funds
     */
    boolean withdraw(long amount);

    /**
     * Check if player can afford an amount
     *
     * @param amount Amount to check
     * @return true if player has enough balance
     */
    boolean canAfford(long amount);

    /**
     * Get lifetime earned currency
     */
    long getLifetimeEarned();

    /**
     * Get lifetime spent currency
     */
    long getLifetimeSpent();

    /**
     * Format the balance for display
     */
    String formatBalance();

    /**
     * Check if Vault is being used for currency operations
     *
     * @return true if Vault is handling currency, false if using CNPC+ built-in
     */
    boolean isUsingVault();
}