Skip to main content

Installation

Complete installation guide for Random Orders Addon.

Prerequisites​

Before installing Random Orders Addon, ensure you have:

  1. Sigma Orders installed and working
  2. Java 21+ installed
  3. Paper/Spigot 1.21+ server
  4. Vault (optional, for economy features)

Installation Steps​

Step 1: Install Sigma Orders​

Random Orders Addon requires Sigma Orders to be installed first:

  1. Download Sigma Orders from your source
  2. Place SigmaOrders.jar in your plugins/ folder
  3. Start your server to generate configuration
  4. Verify Sigma Orders is working: /orders help

Step 2: Install Random Orders Addon​

  1. Download RandomOrdersAddon.jar
  2. Place it in your plugins/ folder
  3. Start or reload your server

Step 3: Verify Installation​

Check server console for:

[Random Orders Addon] ✓ RANDOM ORDERS ADDON successfully enabled!
[Random Orders Addon] ✓ Connected to SigmaOrders v<version>

Step 4: Configure​

  1. Edit plugins/RandomOrdersAddon/config.yml
  2. Configure material pools, pricing, and generation settings
  3. Reload: /randomorders reload

Optional Dependencies​

ItemsAdder​

For custom item support:

  1. Install ItemsAdder
  2. Set items.use-itemsadder: true in config
  3. Add ItemsAdder IDs to material pools

Shop Plugins​

For dynamic pricing:

  • ExcellentShop: Set pricing.shop-provider: "excellentshop"
  • EconomyShopGUI: Set pricing.shop-provider: "economyshopgui"

Post-Installation​

Enable the Addon​

The addon is enabled by default. To disable:

enabled: false

Or use command:

/randomorders toggle

Check Status​

Verify everything is working:

/randomorders status

Expected output:

=== Random Orders Status ===
Enabled: Yes
Scheduler: Running
API: Connected
Online Players: 5
Min Players Required: 1
Player Requirement: Met

Troubleshooting​

Addon Not Starting​

Error: SigmaOrders API not found!

Solution:

  • Ensure Sigma Orders is installed and enabled
  • Check that Sigma Orders loaded before Random Orders Addon
  • Restart server if needed

No Orders Generating​

Check:

  1. Is addon enabled? (/randomorders status)
  2. Are minimum players online? (check config)
  3. Are material pools configured? (check config)
  4. Check server logs for errors

Configuration Errors​

Error: Configuration validation failed!

Solution:

  • Check config.yml syntax
  • Verify all required sections exist
  • Check material pool names match pool-weights
  • Review server logs for specific errors

Next Steps​