SigmaSellAxe Wiki

Complete documentation for SigmaSellAxe

Features

Complete overview of all SigmaSellAxe features and capabilities.

Container Selling

The core feature of SigmaSellAxe - instant selling of items from containers using a special Sell Axe tool.

How It Works

  1. Admin gives players a special Diamond Axe (the Sell Axe)
  2. Players right-click containers (chests, barrels, shulkers) while holding the Sell Axe
  3. Plugin checks permissions, area trust, and validates items
  4. Items are sold using shop plugin prices (or fallback prices)
  5. Money is deposited to player's account via Vault
  6. Transaction is logged for record-keeping

Supported Containers

  • Chests - Single and double chests
  • Barrels - All barrel types
  • Shulker Boxes - All shulker box variants
  • Hoppers - Hopper inventories
  • Other Containers - Any container that implements InventoryHolder

Transaction Limits

  • Max Items: 5,000 items per transaction
  • Performance: Optimized for large transactions
  • Thread Safety: Fully thread-safe operations
  • Async Processing: Non-blocking operations for better TPS

GUI Features

Sellable Items GUI

Accessible via /sigmasellaxe items or left-clicking with the Sell Axe (if enabled).

Features:

  • Shows all sellable items from all shops
  • Displays prices from shop plugins
  • Shows boost multipliers
  • Color-coded item display
  • Pagination support (45 items per page)
  • Real-time price updates

Sorting System

The GUI includes a powerful sorting system with 4 sort types:

  1. Alphabetically A-Z - Sort items alphabetically (A to Z)
  2. Alphabetically Z-A - Sort items alphabetically (Z to A)
  3. Price High→Low - Sort by price (highest first)
  4. Price Low→High - Sort by price (lowest first)

Sorting Features:

  • Single hopper icon cycles through all sort types
  • Active sort type highlighted in lore
  • Player-specific preferences (persists across sessions)
  • Smooth transitions between sort types
  • Sort preference saved per player UUID

Dupe Items GUI

Shows potential money duplication exploits. Accessible via /sigmasellaxe verifyDupe.

Features:

  • Lists items where boosted sell price > buy price
  • Shows buy price, sell price, and boosted sell price
  • Color-coded warnings
  • Pagination support
  • Detailed information for each potential dupe

Durability System

Configurable durability loss system for the Sell Axe tool.

Configuration

sell-axe:
  durability:
    enabled: true      # Enable/disable durability loss
    lose-per-sell: 1   # Durability lost per sell operation

Behavior

  • Durability is lost only when items are successfully sold
  • If selling fails (no items, no permission, etc.), no durability is lost
  • When durability reaches 0, the Sell Axe breaks normally
  • Players can repair the Sell Axe using an anvil
  • Diamond Axe has 1561 durability points (with lose-per-sell: 1, can sell ~1561 times)

Boost System

Flexible boost multiplier system for increasing sell prices.

Global Boost

Set a global boost for all items in a shop:

shop:
  id: 'farming'
global-boost: 0.5  # 50% boost for all items

Item-Specific Boost

Set boost for specific items:

items:
  PUMPKIN:
    boost: 1.0      # 100% boost
    enabled: true
  MELON:
    boost: 0.5      # 50% boost
    enabled: true

Boost Calculation

The final sell price is calculated as:

finalPrice = basePrice × (1 + globalBoost + itemBoost)

Example:

  • Base price: $100
  • Global boost: 0.5 (50%)
  • Item boost: 1.0 (100%)
  • Final price: $100 × (1 + 0.5 + 1.0) = $250

Transaction Logging

Comprehensive logging system for all sell transactions.

Console Logging

All transactions are logged to console in one-liner format:

[SigmaSellAxe] SELL: PlayerName sold 64 DIAMOND_ORE for $9,600.00 at world (CHEST) - Items: DIAMOND_ORE:64

File Logging

Enable file logging in config:

logging:
  enabled: true
  file-logging: true
  log-rotation: true

Features:

  • Logs to plugins/SigmaSellAxe/logs/transactions.log
  • Automatic log rotation
  • Timestamp tracking: [YYYY-MM-DD HH:MM:SS]
  • Detailed transaction information
  • One transaction per line for easy parsing

Debug System

Configurable debug logging system for troubleshooting.

Debug Levels

debug:
  enabled: false
  level: BASIC  # BASIC, DETAILED, or VERBOSE

Levels:

  • BASIC - Essential debug information (recommended for troubleshooting)
  • DETAILED - More detailed information including permission checks and price lookups
  • VERBOSE - Maximum verbosity including all API calls and internal operations

What Gets Logged

  • Shop plugin detection
  • Price fetching operations
  • Configuration loading
  • Error details
  • Performance metrics
  • Dupe detection calculations
  • Protection plugin checks

Protection Plugin Integration

See Integrations for details on protection plugin support.

Performance Features

  • Thread Safety - Fully thread-safe operations for Folia support
  • Efficient Caching - Optimized price lookups
  • Resource Limits - Prevents server overload with item count limits
  • Folia Support - Multi-threaded server support
  • Async Operations - Non-blocking economy operations
  • Optimized Algorithms - Fast sorting and searching

Smart Configuration

  • Auto-Detection - Automatically detects shop plugins and generates configs
  • Config Migration - Automatic migration between versions
  • Hot Reloading - Reload configs without server restart
  • Preservation - User customizations are preserved during updates