EcoAPI 🔗

EcoAPI is a standardized interface layer for Hytale economy systems.

It does not handle money storage or transactions itself. Instead, it provides a set of abstract methods and interfaces that allow:

1. Economy Plugins (Providers) to implement their own banking logic (SQL, JSON, etc.).
2. Gameplay Plugins (Consumers) to interact with the economy (shops, jobs, etc.) without depending on a specific economy plugin.

---

❓ Why EcoAPI?

🛠 For Developers

• Decoupling: Write your plugin once. It will work with any economy plugin that implements EcoAPI.
• Standardization: Use a unified set of methods (getBalance, addBalance, removeBalance, setBalance) regardless of the underlying system.
• Flexibility: Switch the backing economy system without breaking dependent plugins.

🎮 For Users / Server Owners

• Compatibility: Allows you to use a Shop plugin from Developer A and a Banking plugin from Developer B together seamlessly.
• Freedom: You are not locked into a single specific economy plugin. You can swap implementations whenever you want.

---

📥 Installation Guide (For Users)

Note: EcoAPI does nothing on its own. You need three things for a working system:

1. EcoAPI (This plugin).
2. An Implementation Plugin (A plugin that actually stores the money and "implements" EcoAPI).
3. Any Consumer Plugins (Shops, Kits, Jobs, etc.).

Steps:

1. Download the latest release from the Releases page.
2. Place the .jar file into your server's plugins folder.
3. Ensure you also install a compatible Economy Provider plugin.

---

💻 Integration Guide (For Developers)

Since EcoAPI is not yet hosted on Maven Central, you must install it into your local Maven repository to use it as a dependency.

Step 1: Install Locally

1. Download the latest release from the Releases page.
2. Publish the artifact to your local cache with the following command (Maven)

mvn install:install-file -Dfile=Path/To/EcoAPI.jar -DgroupId=com.dunystudios.hytale.plugins -DartifactId=EcoAPI -Dversion=1.0-SNAPSHOT -Dpackaging=jar

Step 2: Add Dependency

Add EcoAPI to your project.

<dependencies>
<dependency>
<groupId>com.dunystudios.hytale.plugins</groupId>
<artifactId>EcoAPI</artifactId>
<version>1.0-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
</dependencies>

Step 3: Usage Examples

A. Using the Economy (Consumer) If you are making a Shop or Job plugin, use the API to modify balances:

// Get the economy pluginIEcoAPIeconomy = IEcoAPI.Service.getInstance();
// Get the balance of a playerfloatbalance = economy.getBalance(uuid);
// Add 10 of balance to a playereconomy.addBalance(uuid, 10);
// Remove 10 of balance from a playereconomy.removeBalance(uuid, 10);
// Set 10 of balance to a playereconomy.setBalance(uuid, 10);

B. Providing the Economy (Implementer) If you are making an Economy plugin, you must implement the interface and register it.

Main class:

publicclassMyEconomyPluginextendsJavaPlugin {
privatefinalEconomyeconomy;
publicMyEconomyPlugin() {
this.economy = newEconomy();
}
@Overrideprotectedvoidsetup() {
IEcoAPI.Service.setInstance(economy);
}
}

Economy class:

publicclassEconomyimplementsIEcoAPI {
@OverridepublicfloatgetBalance(UUIDuuid) {
// Your logicreturn0;
}
@OverridepublicvoidaddBalance(UUIDuuid, floatv) {
// Your logic
}
@OverridepublicvoidremoveBalance(UUIDuuid, floatv) {
// Your logic
}
@OverridepublicvoidsetBalance(UUIDuuid, floatv) {
// Your logic
}
}