SigmaSellAxe Wiki

API Documentation

Complete developer documentation for integrating with SigmaSellAxe. This API allows other plugins to interact with SigmaSellAxe programmatically.

Getting the Plugin Instance

All API interactions start by obtaining the plugin instance:

SigmaSellAxe plugin = (SigmaSellAxe) Bukkit.getPluginManager().getPlugin("SigmaSellAxe");
if (plugin == null || !plugin.isEnabled()) {
    // Plugin not loaded
    return;
}

Core API Classes

SigmaSellAxe

Main plugin class providing access to all managers and hooks.

ConfigManager

Manages all plugin configuration files and settings.

EconomyHook

Handles economy operations and shop plugin integration.

ShopPluginManager

Manages shop plugin integrations and provides unified access to shop prices.

ShopPluginInterface

Interface for shop plugin integrations. Implement this to add support for new shop plugins.

DupeDetector

Utility class for detecting potential money duplication exploits.

DupeInfo

Information about a potential duplication exploit.

Code Examples

Getting Sell Price

SigmaSellAxe plugin = (SigmaSellAxe) Bukkit.getPluginManager().getPlugin("SigmaSellAxe");
if (plugin == null || !plugin.isEnabled()) {
    return;
}

EconomyHook economyHook = plugin.getEconomyHook();
double price = economyHook.getShopPrice(player, Material.DIAMOND_ORE);

if (price > 0) {
    player.sendMessage("Diamond Ore sells for: $" + price);
} else {
    player.sendMessage("Diamond Ore cannot be sold");
}

Getting Item Boost

ConfigManager configManager = plugin.getConfigManager();
double boost = configManager.getItemBoost("farming", "PUMPKIN");

if (boost > 0) {
    player.sendMessage("Pumpkin has a " + (boost * 100) + "% boost in farming shop");
}

Checking Shop Plugin

ShopPluginManager shopManager = economyHook.getShopPluginManager();
ShopPluginInterface activePlugin = shopManager.getActiveShopPlugin();

if (activePlugin != null) {
    String pluginName = activePlugin.getPluginName();
    int shopCount = activePlugin.getDetectedShopsCount();
    player.sendMessage("Active shop plugin: " + pluginName + " (" + shopCount + " shops)");
} else {
    player.sendMessage("No shop plugin active - using fallback prices");
}

Detecting Duplication Exploits

DupeDetector dupeDetector = new DupeDetector(plugin);
Map<Material, DupeDetector.DupeInfo> dupeItems = dupeDetector.detectDupeItems(player);

if (!dupeItems.isEmpty()) {
    player.sendMessage("Warning: " + dupeItems.size() + " items have dupe potential!");
    for (Map.Entry<Material, DupeDetector.DupeInfo> entry : dupeItems.entrySet()) {
        DupeDetector.DupeInfo info = entry.getValue();
        player.sendMessage("- " + entry.getKey() + ": Buy $" + info.buyPrice + 
            ", Sell $" + info.boostedSellPrice);
    }
}

Checking Protection Plugin Integration

// Check if Lands is available
LandsHook landsHook = plugin.getLandsHook();
if (landsHook.isLandsAvailable()) {
    boolean canSell = landsHook.canPlayerSellInArea(player, location);
    if (!canSell) {
        player.sendMessage("You don't have permission to sell here!");
    }
}

// Check GriefPrevention
GriefPreventionHook gpHook = plugin.getGriefPreventionHook();
if (gpHook.isGriefPreventionAvailable()) {
    boolean canSell = gpHook.canPlayerSellInClaim(player, location);
    if (!canSell) {
        player.sendMessage("You don't have permission to sell in this claim!");
    }
}

Thread Safety

All API methods are thread-safe and can be called from any thread. The plugin uses synchronized blocks and volatile variables to ensure thread safety, making it safe for use on Folia and other multi-threaded servers.

Version Compatibility

API methods may change between major versions. Check the plugin documentation for breaking changes when updating the plugin.

Dependencies

To use the API in your plugin, add SigmaSellAxe as a dependency:

<dependency>
    <groupId>me.jayesh</groupId>
    <artifactId>SigmaSellAxe</artifactId>
    <version>2.0.7</version>
    <scope>provided</scope>
</dependency>

Support

For API questions or feature requests:

• Check the Troubleshooting guide
• Join our Discord Server