mirror of
https://github.com/KAMKEEL/CustomNPC-Plus-API.git
synced 2026-11-17 20:25:15 +00:00
Add Player Currency, Stock Options, Trader Syncing API
This commit is contained in:
1 parent
866be1fef5
commit
339e0f164e
4 files changed
+281
No files matched your search
@@ -0,0 +1,62 @@
|
||||
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();
|
||||
}
|
||||
Reference in new issue
Block a user