SigmaSellAxe Wiki

Complete documentation for SigmaSellAxe

Integrations

SigmaSellAxe integrates with various plugins to provide a complete solution. All integrations are optional except Vault (required for economy).

Shop Plugins

ExcellentShop

Status: Fully Supported (Optional)

Download: SpigotMC

Features:

  • Automatic shop detection
  • Real-time price fetching
  • Reflection-based integration (no compile dependency)
  • Multi-shop support
  • Permission-based pricing
  • Shop access validation

Configuration:

economy:
  shop-plugin: excellentshop  # or 'auto'

Detection:

The plugin automatically detects ExcellentShop on startup and generates shop configurations. Shops are detected from ExcellentShop's Virtual Shop module.

Without ExcellentShop:

If ExcellentShop is not installed, the plugin will use fallback prices from config.yml or switch to EconomyShopGUI if available.

EconomyShopGUI

Status: Fully Supported (Optional)

Download: SpigotMC

Features:

  • Full API integration
  • Multi-economy type support
  • Shop section detection
  • Dynamic pricing with limits
  • Permission checks
  • Buy and sell price support

Configuration:

economy:
  shop-plugin: economyshopgui  # or 'auto'

Detection:

The plugin automatically detects EconomyShopGUI on startup and generates shop configurations. All shop sections are detected and configured.

Without EconomyShopGUI:

If EconomyShopGUI is not installed, the plugin will use fallback prices from config.yml or switch to ExcellentShop if available.

Shop Plugin Selection

The plugin supports automatic shop plugin detection:

economy:
  shop-plugin: auto  # Automatically detects available shop plugin

Priority (when auto-detecting):

  1. ExcellentShop (if available)
  2. EconomyShopGUI (if available)
  3. Fallback prices (if no shop plugin)

Protection Plugins

Lands

Status: Fully Supported (Optional)

Download: SpigotMC

Features:

  • Area trust checking
  • Permission-based selling restrictions
  • Seamless integration
  • Respects Lands trust levels

Configuration:

integrations:
  lands-integration: true

How it works:

  • Checks if player has trust in the area
  • Prevents selling if player doesn't have permission
  • Respects Lands trust levels (owner, member, trusted, etc.)
  • Works with Lands area boundaries

Without Lands:

If Lands is not installed, container sales are allowed based on permissions only (no area protection checks).

GriefPrevention

Status: Fully Supported (Optional)

Download: SpigotMC

Features:

  • Claim boundary detection
  • Permission-based selling restrictions
  • Full claim protection
  • Respects claim permissions

Configuration:

integrations:
  griefprevention-integration: true

How it works:

  • Checks if player is in a claim
  • Verifies player has permission to sell in the claim
  • Prevents selling in protected claims without permission
  • Respects GriefPrevention claim flags

Without GriefPrevention:

If GriefPrevention is not installed, container sales are allowed based on permissions only (no claim protection checks).

WorldGuard

Status: Fully Supported (Optional)

Download: Bukkit

Features:

  • Region flag support
  • Multi-region detection
  • Integration with other protection plugins
  • Respects WorldGuard region flags

Configuration:

integrations:
  worldguard-integration: true

How it works:

  • Checks WorldGuard regions at the location
  • Respects region flags
  • Works alongside Lands and GriefPrevention
  • Prevents selling in protected regions

Without WorldGuard:

If WorldGuard is not installed, container sales are allowed based on permissions only (no region protection checks).

Economy Plugins

Vault

Status: Optional (Recommended)

Download: GitHub Releases

Features:

  • Economy integration
  • Multi-economy support (EssentialsX, CMI, etc.)
  • Standard economy API
  • Automatic economy provider detection

Functionality:

Vault provides the economy API used by SigmaSellAxe to deposit money to players. Without Vault, economy transactions will not work.

Supported Economy Plugins:

  • EssentialsX
  • CMI
  • BOSEconomy
  • Any economy plugin that supports Vault

Dependency Summary

All dependencies are optional (soft dependencies). The plugin will work without them, but with limited functionality.

Required:

  • Minecraft 1.21+ (Paper, Spigot, or Folia server)

Optional (Recommended):

  • Vault - Provides economy integration API. Required for money transactions.
  • ExcellentShop or EconomyShopGUI - Enables automatic shop detection
  • Lands, GriefPrevention, or WorldGuard - Area protection integration

Dependency Functionality

With All Dependencies:

  • ✅ Full ExcellentShop integration with dynamic pricing
  • ✅ Automatic shop detection and configuration
  • ✅ Boost multipliers support
  • ✅ Lands area trust checking
  • ✅ GriefPrevention area trust checking
  • ✅ WorldGuard area trust checking
  • ✅ Economy transactions via Vault

Without Dependencies:

  • ⚠️ Uses fallback prices from config.yml
  • ⚠️ No automatic shop detection
  • ⚠️ No area protection checks (permissions only)
  • ⚠️ Economy still works if you have Vault (any economy plugin)

Integration Priority

When multiple protection plugins are installed, they are checked in this order:

  1. Lands - Checked first
  2. GriefPrevention - Checked if Lands doesn't apply
  3. WorldGuard - Checked if neither Lands nor GriefPrevention apply

Important: All checks must pass for selling to be allowed. If any protection plugin denies access, selling is blocked.

Troubleshooting Integrations

Shop Plugin Not Detected

  1. Verify the shop plugin is installed and enabled
  2. Check server console for detection messages
  3. Run /sigmasellaxe verifyConfig to check detection
  4. Try /sigmasellaxe regenerate to re-detect shops
  5. Check that the shop plugin is working correctly

Protection Plugin Not Working

  1. Verify the protection plugin is installed and enabled
  2. Check integration is enabled in config: 
    integrations:
  lands-integration: true
  3. Check server console for integration messages
  4. Verify player has proper permissions in the protection plugin
  5. Test the protection plugin independently

Price Issues

  1. Verify shop plugin is working correctly
  2. Check shop configuration files
  3. Run /sigmasellaxe verifyConfig to check for issues
  4. Check debug logs for price fetching errors
  5. Verify items exist in the shop plugin

Integration Status

You can check integration status in the server console on startup. The plugin displays which integrations are available and which are active.

Example startup output:

- Integrations
  ✓ ExcellentShop (active)
  ✓ EconomyShopGUI integration enabled
  ✓ Lands integration enabled
  ✓ GriefPrevention integration enabled
  ✓ WorldGuard integration enabled
  ✓ Vault integration enabled