CakeAuction API

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    compileOnly 'com.github.CakesStudio:CakeAuctionAPI:VERSION'
}

<dependencies>
    <dependency>
        <groupId>com.github.CakesStudio</groupId>
        <artifactId>CakeAuctionAPI</artifactId>
        <version>VERSION</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

name: MyAwesomeAddon
main: com.example.myaddon.MyAddon
version: 1.0.0
api-version: '1.6.0'
folia-supported: true
authors: [ "Developer" ]

public class MyAddon extends AbstractAddon {
    @Override
    protected void onEnable() {
        saveDefaultConfig();
        registerListener(new MyListener());
        registerCommand(new MyCommand());
    }
}

// Асинхронная задача
runTaskAsync(() -> { /* логика */ });

// Задача с задержкой (регионально-безопасно)
runTaskLaterAsync(() -> { ... }, 20L);

IEconomyManager economy = api.getEconomyManager();

// Проверка поддержки мультивалютности
if (economy.supportsMultiCurrency()) {
    // Получение баланса игрока в конкретной валюте
    double points = economy.getBalance(player, "playerpoints");
    
    // Списание и зачисление средств
    if (economy.has(player, "playerpoints", 150.0)) {
        economy.withdraw(player, "playerpoints", 150.0);
        economy.deposit(receiver, "playerpoints", 150.0);
    }
    
    // Форматирование суммы под правила валюты
    String formatted = economy.format("playerpoints", 150.0); // напр. "150 ⛁"
}

// Регистрация собственного кастомного провайдера валюты
economy.registerProvider(new IEconomyProvider() {
    @Override public String getName() { return "gems"; }
    @Override public double getBalance(OfflinePlayer p) { ... }
    @Override public boolean has(OfflinePlayer p, double amount) { ... }
    @Override public void deposit(OfflinePlayer p, double amount) { ... }
    @Override public boolean withdraw(OfflinePlayer p, double amount) { ... }
    @Override public String format(double amount) { return amount + " 💎"; }
});

IAuctionManager auction = api.getAuctionManager();

// Поиск: запрос, категория, валюта, тип сортировки
Collection<IAuctionItem> results = auction.search("Diamond", "Resources", "vault", "price_asc");

// Создание лота с указанием валюты (например "vault" или "playerpoints")
api.createAuction(player, itemStack, 500.0, "vault", 3600L, false);

// Динамическая регистрация категории с предикатом-фильтром
ItemStack icon = new ItemStack(Material.GOLDEN_APPLE);
auction.registerCategory(
    "mythic_gear",
    "<gradient:#ffd700:#ff4500>Mythic Gear</gradient>",
    icon,
    itemStack -> {
        if (itemStack == null || !itemStack.hasItemMeta()) return false;
        return itemStack.getItemMeta().getDisplayName().contains("Mythic");
    }
);

// Динамическая регистрация кастомной сортировки
auction.registerSortingType(
    "seller_name_length",
    "<aqua>Seller Name Length</aqua>",
    Comparator.comparingInt(item -> item.getSellerName().length())
);

ITaxManager taxManager = api.getTaxManager();

// Получение ставки налога для конкретной валюты
double rate = taxManager.getTaxRate(player, "vault"); // напр. 5.0 (5%)

// Проверка ставок для продавца и покупателя
double sellerRate = taxManager.getSellerTaxRate(player, "vault");
double buyerRate = taxManager.getBuyerTaxRate(player, "vault");

IUserManager userManager = api.getUserManager();

// Проверка лимитов слотов с учетом валюты
if (userManager.isLimitReached(player, "playerpoints")) {
    player.sendMessage("Вы исчерпали лимит лотов за PlayerPoints!");
}

int totalMaxSlots = userManager.getMaxSlots(player);
int pointsMaxSlots = userManager.getMaxSlots(player, "playerpoints");
long duration = userManager.getSellDuration(player, "playerpoints");

IUUIDManager uuid = api.getUUIDManager();
UUID random = uuid.random();
String shortId = uuid.toShortId(random); // напр. "7x2K9mPq1z"

IItemManager itemManager = api.getItemManager();
String base64 = itemManager.serialize(itemStack);
String signature = itemManager.getSignature(itemStack);

IHookManager hooks = api.getHookManager();

hooks.registerProvider(new IItemHookProvider() {
    @Override
    public @Nullable ItemStack getItem(@NonNull String id) {
        if (id.equalsIgnoreCase("ruby_gem")) {
            return new ItemStack(Material.EMERALD);
        }
        return null;
    }

    @Override
    public @Nullable String getItemId(@NonNull ItemStack item) {
        if (item.getType() == Material.EMERALD) {
            return "ruby_gem";
        }
        return null;
    }

    @Override
    public @NonNull String getPrefix() {
        return "myprovider"; // Обрабатывает "myprovider:ruby_gem"
    }
});

// Регистрация тега [GIVE_REWARD]
api.getActionManager().registerAction("GIVE_REWARD", (player, loc, text) -> {
    player.sendMessage("Награда: " + text);
});