ItemStackAPI

ItemStack Price API

This document describes the new API methods for getting sell prices of items using ItemStacks.

Overview

The new API provides methods to:

• Find ShopItems by ItemStack

• Get sell prices for ItemStacks

• Check if items can be sold

• Get prices with or without player multipliers

Quick Start

// Get the API instance
BShopAPI api = BShopAPI.getInstance();

// Get the price API for easy access
PriceAPI priceAPI = api.getPriceAPI();

// Get sell price for an ItemStack
ItemStack diamond = new ItemStack(Material.DIAMOND);
double sellPrice = priceAPI.getSellPrice(player, diamond, 64);

API Methods

PriceAPI Class

The PriceAPI class provides convenient methods for getting prices:

Getting Sell Prices

// Get sell price with player multiplier applied
double price = priceAPI.getSellPrice(player, itemStack, quantity);

// Get sell price in specific shop
double price = priceAPI.getSellPrice(player, "shop_id", itemStack, quantity);

// Get base sell price without multipliers
double basePrice = priceAPI.getBaseSellPrice(itemStack, quantity);

// Get base sell price in specific shop
double basePrice = priceAPI.getBaseSellPrice("shop_id", itemStack, quantity);

// Get all possible sell prices across all shops
List<Double> allPrices = priceAPI.getAllSellPrices(player, itemStack, quantity);

Finding Items

// Find item across all shops
Optional<ShopItem> item = priceAPI.findItemByItemStack(itemStack);

// Find item in specific shop
Optional<ShopItem> item = priceAPI.findItemByItemStack("shop_id", itemStack);

// Find all matching items across all shops
List<ShopItem> items = priceAPI.findAllItemsByItemStack(itemStack);

Utility Methods

// Check if item can be sold
boolean canSell = priceAPI.canSell(itemStack);

// Check if item can be sold in specific shop
boolean canSell = priceAPI.canSell("shop_id", itemStack);

ShopAPI Class

The ShopAPI class provides methods for finding items:

// Find item by ItemStack
Optional<ShopItem> item = api.getShopAPI().findItemByItemStack(itemStack);

// Find item in specific shop
Optional<ShopItem> item = api.getShopAPI().findItemByItemStack("shop_id", itemStack);

// Find all matching items
List<ShopItem> items = api.getShopAPI().findAllItemsByItemStack(itemStack);

TransactionAPI Class

The TransactionAPI class provides methods for getting prices:

// Get sell price with multiplier
double price = api.getTransactionAPI().getSellPrice(player, itemStack, quantity);

// Get base sell price
double basePrice = api.getTransactionAPI().getBaseSellPrice(itemStack, quantity);

Item Matching

Items are matched based on:

1. Material: The item type (e.g., DIAMOND, IRON_INGOT)

2. Custom Model Data: If the shop item has custom model data, the ItemStack must also have the same custom model data

Example Matching

// Shop item: DIAMOND with custom model data 1001
// ItemStack: DIAMOND with custom model data 1001 -> MATCH
// ItemStack: DIAMOND with custom model data 1002 -> NO MATCH
// ItemStack: DIAMOND with no custom model data -> NO MATCH

// Shop item: IRON_INGOT with no custom model data
// ItemStack: IRON_INGOT with any custom model data -> MATCH
// ItemStack: IRON_INGOT with no custom model data -> MATCH

Usage Examples

Basic Price Check

public void checkItemPrice(Player player, ItemStack item) {
    PriceAPI priceAPI = BShopAPI.getInstance().getPriceAPI();
    
    if (priceAPI.canSell(item)) {
        double price = priceAPI.getSellPrice(player, item, item.getAmount());
        player.sendMessage("You can sell this for: $" + String.format("%.2f", price));
    } else {
        player.sendMessage("This item cannot be sold.");
    }
}

Find Best Price

public void findBestPrice(Player player, ItemStack item) {
    PriceAPI priceAPI = BShopAPI.getInstance().getPriceAPI();
    
    List<Double> prices = priceAPI.getAllSellPrices(player, item, item.getAmount());
    if (!prices.isEmpty()) {
        double bestPrice = prices.stream().mapToDouble(Double::doubleValue).max().orElse(0.0);
        player.sendMessage("Best sell price: $" + String.format("%.2f", bestPrice));
    } else {
        player.sendMessage("This item cannot be sold in any shop.");
    }
}

Get Shop Information

public void getShopInfo(ItemStack item) {
    PriceAPI priceAPI = BShopAPI.getInstance().getPriceAPI();
    
    List<ShopItem> items = priceAPI.findAllItemsByItemStack(item);
    for (ShopItem shopItem : items) {
        System.out.println("Item: " + shopItem.displayName());
        System.out.println("Base Price: " + shopItem.sellPrice());
        System.out.println("Shop: " + shopItem.id());
    }
}

Error Handling

All methods return safe defaults when items are not found:

• Price methods return 0.0 when item is not found

• Find methods return Optional.empty() or empty lists when item is not found

• No exceptions are thrown for missing items

Performance Notes

• Item matching is done by iterating through all shop items

• For large shops, consider caching results if called frequently

• The API uses the existing shop caching system for performance

Example

// Quick price check
BShopAPI api = BShopAPI.getInstance();
PriceAPI priceAPI = api.getPriceAPI();

ItemStack diamond = new ItemStack(Material.DIAMOND);
double sellPrice = priceAPI.getSellPrice(player, diamond, 64);

// Check if item can be sold
if (priceAPI.canSell(diamond)) {
    // Item can be sold
}

// Find best price across all shops
List<Double> allPrices = priceAPI.getAllSellPrices(player, diamond, 64);
double bestPrice = allPrices.stream().mapToDouble(Double::doubleValue).max().orElse(0.0);