Skip to main content

Random Orders Addon - Overview

The Random Orders Addon is a powerful extension for Sigma Orders that automatically generates random orders for players to fulfill. It creates a dynamic marketplace where the server generates orders based on configurable item pools, pricing strategies, and engagement features.

What is Random Orders Addon?​

Random Orders Addon is a separate plugin that integrates with Sigma Orders to automatically create orders on a schedule. Instead of players only creating orders, the server itself generates orders that players can fulfill for rewards.

Key Features​

Automatic Order Generation​

  • Scheduled Generation: Orders are created automatically at configurable intervals
  • Smart Scheduling: Adjusts generation frequency based on player count
  • Peak Hour Support: Increased generation during peak hours
  • Player Count Scaling: More players online = more orders generated

Intelligent Item Selection​

  • Material Pools: Organize items into pools (common, rare, ores, blocks)
  • Weighted Selection: Control probability of items from each pool
  • ItemsAdder Support: Use custom ItemsAdder items in orders
  • Dimension Filtering: Filter items by dimension (Overworld, Nether, End) with configurable item lists and wildcard pattern matching
  • Enchantment Support: Random enchantments on generated items

Dynamic Pricing​

  • Shop Integration: Integrates with ExcellentShop and EconomyShopGUI
  • Smart Pricing: Uses shop prices as base with configurable multipliers
  • Rarity-Based Pricing: Different multipliers for common vs rare items
  • Time-Based Bonuses: Higher prices during peak hours, nights, weekends
  • Arbitrage Prevention: Optional protection against price manipulation

Player Engagement​

  • Completion Bonuses: Extra rewards for fulfilling random orders
  • Special Events: Scheduled events with bonus multipliers
  • Urgent Orders: Random urgent/priority orders for higher rewards
  • Event Announcements: Notify players of special random orders

Performance Optimized​

  • Price Caching: Caches calculated prices for performance
  • Async Operations: All order generation runs asynchronously
  • Rate Limiting: Configurable rate limits for API calls
  • Material Pool Caching: Efficient material selection
  • Auto-Collection: System orders automatically collected when delivered to prevent database accumulation
  • Database Reconnection: Improved reliability with single retry mechanism for database connection issues

How It Works​

  1. Scheduler: Runs on a configurable interval (e.g., every 5-15 minutes)
  2. Player Check: Verifies minimum players online (if configured)
  3. Item Selection: Randomly selects item from configured pools
  4. Price Calculation: Calculates price using shop integration or fallback prices
  5. Order Creation: Creates order via Sigma Orders API
  6. Player Notification: Players can view and fulfill orders

Integration with Sigma Orders​

The addon integrates seamlessly with Sigma Orders:

  • Uses Sigma Orders API to create orders
  • Orders appear in the main Orders GUI
  • Uses the same fulfillment system
  • Admin GUI shows random orders count
  • Orders are marked with system UUID for identification

Use Cases​

Economy Servers​

  • Create constant demand for items
  • Stimulate player economy
  • Provide consistent earning opportunities
  • Balance item prices through demand

Survival Servers​

  • Encourage resource gathering
  • Create goals for players
  • Add variety to gameplay
  • Reward active players

Custom Item Servers​

  • Showcase ItemsAdder custom items
  • Create demand for custom items
  • Integrate custom items into economy

Requirements​

  • Sigma Orders: Required (main plugin)
  • Java 21+: Required
  • Paper/Spigot 1.21+: Required
  • Vault: Soft dependency (for economy)
  • ItemsAdder: Optional (for custom items)
  • ExcellentShop: Optional (for shop pricing)
  • EconomyShopGUI: Optional (for shop pricing)

Quick Start​

  1. Install Sigma Orders first
  2. Install Random Orders Addon
  3. Configure config.yml
  4. Enable the addon
  5. Orders will start generating automatically

Next Steps​