Skip to main content

Pricing System

Complete guide to the dynamic pricing system.

Overview​

The pricing system calculates order prices using shop integration, multipliers, and fallback prices to ensure fair and dynamic pricing.

Price Calculation Flow​

  1. Shop Check: Check if shop provider is available
  2. Price Lookup: Get price from shop (if available)
  3. Apply Multipliers: Apply base, rarity, and time multipliers
  4. Profit Margin: Apply profit margin (if configured)
  5. Arbitrage Check: Verify price is valid (if enabled)
  6. Fallback: Use fallback price if shop unavailable

Shop Integration​

ExcellentShop​

pricing:
  shop-provider: "excellentshop"

Uses ExcellentShop sell prices as base.

EconomyShopGUI​

pricing:
  shop-provider: "economyshopgui"

Uses EconomyShopGUI sell prices as base.

No Shop​

pricing:
  shop-provider: "none"

Uses fallback prices only.

Base Multipliers​

pricing:
  base-multiplier: 2.5
  min-multiplier: 1.5
  max-multiplier: 4.0

Base multiplier applied to all prices, capped by min/max.

Rarity Multipliers​

Different multipliers for different rarities:

pricing:
  rarity-multipliers:
    common: 1.2
    rare: 2.5
    ores: 1.8
    blocks: 1.0

Time-Based Bonuses​

Higher prices during special times:

pricing:
  time-bonuses:
    peak-hour: 1.5
    night: 1.3
    weekend: 1.4

Profit Margin​

Add profit margin to shop prices:

pricing:
  profit-margin:
    min: 1.1  # 10% above shop price
    max: 1.5  # 50% above shop price

Random value between min and max is selected.

Arbitrage Prevention​

Prevent buying from shop and immediately fulfilling orders:

pricing:
  prevent-arbitrage: true

If enabled, orders won't be created if order price > shop buy price.

Fallback Prices​

Used when shop unavailable or item not found:

pricing:
  fallback-prices:
    diamond: 500.0
    iron_ingot: 80.0
    default: 25.0

Price Caching​

Prices are cached for performance:

performance:
  price-cache-ttl: 300  # 5 minutes

Examples​

Basic Setup​

pricing:
  base-multiplier: 2.0
  shop-provider: "excellentshop"
  fallback-prices:
    default: 25.0

Premium Pricing​

pricing:
  base-multiplier: 3.0
  rarity-multipliers:
    common: 1.5
    rare: 3.0
  profit-margin:
    min: 1.2
    max: 1.8

Next Steps​