Skip to main content

Random Auction Addon — Overview

The Random Auction Addon is a separate plugin that automatically populates the Sigma Orders & Auctions auction house with bot-generated listings on a configurable schedule. It keeps the marketplace alive and active even during low-traffic periods, creating a persistent and dynamic economy without requiring player participation.

What It Does​

The addon runs a background task that periodically posts auction listings under a configured bot account. Items are drawn from weighted material pools, priced using live shop data or fallback rules, and optionally enchanted — giving each listing a realistic feel. Players see and interact with these listings exactly like any other auction listing.

Key Features​

Automatic Listing Generation​

  • Randomized scheduling — Listings are created at random intervals within a configurable min/max range, avoiding predictable patterns
  • Player-count scaling — Fewer listings when the server is quiet, more during busy periods
  • Peak hour multiplier — Generates extra listings during configured peak play hours
  • Minimum online players — Can be configured to skip generation when too few players are online

Weighted Material Pools​

  • Six built-in pools — Common, Rare, Ores, Blocks, Enchanted, Potions
  • Per-pool weights — Control how often each pool is selected
  • Per-pool quantity and duration — Each pool has its own configurable stack size and listing duration
  • Custom items — Supports ItemsAdder, Oraxen, Nexo, and MMOItems custom items
  • Dimension-specific items — Separate configurable lists for Nether and End items

Smart Pricing​

  • Shop integration — Derives prices from EconomyShopGUI or ExcellentShop with a configurable profit margin
  • Fallback pricing — Per-item and category-level fallback prices when no shop data is available
  • Rarity multipliers — Rarer pool items automatically carry higher price tags
  • Time-based bonuses — Peak hours, night, and weekend pricing adjustments
  • Anti-arbitrage protection — Prevents bot listings that could be exploited via shop buy-back
  • Anti-undercut protection — Prevents the bot from listing far below active player listings

Enchantment System​

  • Bot listings can include randomly enchanted items
  • Each enchantment type has configurable min/max level and min/max price-per-level impact
  • Configurable overall enchantment chance and max enchantments per item

Engagement Features​

  • Flash sales — Randomly triggered discount events with server-wide announcement
  • Featured listings — A configurable chance for a listing to be marked as "featured"
  • Rare item announcements — Broadcasts when a rare pool item is listed
  • Named market events — Scheduled time-window events with bonus multipliers and extra listings

Bot Identity​

  • Static mode — All bot listings appear under a single configured player name
  • Random mode — A name is randomly chosen from a list per generation run

How It Works​

  1. A background task fires at a random interval (within the configured min/max range)
  2. The task checks online player count against the minimum threshold
  3. A material pool is selected by weighted probability
  4. An item is picked from the pool; quantity, duration, and price are calculated
  5. Optional enchantments are rolled and applied with corresponding price adjustments
  6. The listing is posted to the Auction House under the bot account
  7. Players browse and purchase bot listings exactly like any player listing

Requirements​

RequirementDetails
Sigma Orders & AuctionsRequired — must have the Auction module enabled
Java21+
Paper / Spigot / Folia1.21+
VaultSoft dependency (via core plugin)
EconomyShopGUIOptional — for shop-based pricing
ExcellentShopOptional — for shop-based pricing
ItemsAdder / Oraxen / Nexo / MMOItemsOptional — for custom item pool entries

Quick Start​

  1. Install Sigma Orders & Auctions and ensure the Auction module is enabled in config.yml
  2. Drop the RandomAuctionAddon.jar into your plugins/ folder
  3. Start the server to generate the default config.yml
  4. Configure pools, pricing, and generation settings
  5. Listings will start appearing in the auction house automatically

Next Steps​