授权转载 - Allay - EconomyAPI - 经济前置 | MineBBS 我的世界中文论坛

版权类型: 授权转载

版权链接: https://github.com/AllayMC/EconomyAPI/

语言支持: 多语言

前置组件: Allay

适配版本（基岩）

全版本

EconomyAPI

EconomyAPI 是一个旨在统一所有经济插件 API 的插件。该 API 既可以由提供经济功能的插件实现，也可以被其他需要经济支持的插件（如商店插件）调用。这使得所有需要经济系统的插件都能与任何安装了 EconomyAPI 实现的经济插件协同工作。

注意：
EconomyAPI 不能单独使用！它仅提供统一调用的抽象 API，需要另一个具体的经济插件来提供实现。同时，该插件需要 PlaceholderAPI 才能正常运行。

开发使用

Gradle 依赖配置：

代码：

repositories {
    mavenCentral()
}

dependencies {
    // 引入 EconomyAPI
    compileOnly(group = "org.allaymc", name = "economy-api", version = "0.2.0")
}

调用 API 示例：

Java：

import org.allaymc.economyapi.EconomyAPI;
import org.allaymc.economyapi.Account;
import org.allaymc.economyapi.Currency;
import java.math.BigDecimal;
import java.util.UUID;

public class Example {
    public void example() {
        // 获取 API 实例
        EconomyAPI api = EconomyAPI.get();
        // 获取或创建账户
        UUID uuid = UUID.randomUUID();
        Account account = api.getOrCreateAccount(uuid);
        // 获取默认货币的余额
        Currency currency = api.getDefaultCurrency();
        BigDecimal balance = account.getBalance(currency);
        // 将余额格式化为字符串
        String formattedBalance = currency.format(balance);
    }
}

实现 API 示例：

Java：

import org.allaymc.api.plugin.Plugin;
import org.allaymc.economyapi.EconomyAPI;

public class MyEconomyAPI extends Plugin implements EconomyAPI {
    @Override
    public void onLoad() {
        // 设置 API 实例。注意：EconomyAPI#API 只能被设置一次。
        EconomyAPI.API.set(this);
    }
}