Skip to main content

Installation

Requirements​

RequirementMinimum Version
Sigma Orders & Auctions (core plugin)Latest
Java21
Paper / Spigot / Folia1.21

The Auction module must be enabled in Sigma Orders & Auctions' config.yml (modules.auction: true). The addon will not function if the auction module is disabled.

Installation Steps​

1. Install Sigma Orders & Auctions​

Ensure the core plugin is installed, running, and the Auction module is enabled before adding this addon.

2. Drop the Addon Jar​

Place RandomAuctionAddon.jar into your server's plugins/ folder.

plugins/
├── SigmaOrders-Auction.jar      ← core plugin (required)
└── RandomAuctionAddon.jar       ← this addon

3. Start the Server​

On first start, the addon generates its configuration file:

plugins/
└── RandomAuctionAddon/
    └── config.yml

4. Configure the Addon​

Open plugins/RandomAuctionAddon/config.yml and configure:

  • Pool weights and items — What items the bot will list
  • Pricing settings — Shop integration or fallback prices
  • Generation settings — Intervals, player thresholds, caps
  • Bot identity — Name mode and bot player name(s)

See Configuration for a full reference.

5. Reload or Restart​

Apply your configuration changes with:

/randomauction reload

or restart the server.

Verifying the Installation​

Run /randomauction status in-game to confirm:

  • The addon is enabled
  • The core plugin API is connected
  • Generation scheduling is active

You can force a test generation with:

/randomauction generate

Check the auction house (/auction) to confirm a bot listing appeared.

Optional Integrations​

IntegrationPurposeHow to Enable
EconomyShopGUIShop-based pricingInstall EconomyShopGUI; set pricing.shop-provider: economyshopgui in config
ExcellentShopShop-based pricingInstall ExcellentShop; set pricing.shop-provider: excellentshop in config
ItemsAdderCustom items in poolsInstall ItemsAdder; set use-custom-items: true in config
Oraxen / Nexo / MMOItemsCustom items in poolsInstall respective plugin; enable custom items in config

File Layout​

plugins/
└── RandomAuctionAddon/
    └── config.yml          ← all configuration (pools, pricing, generation, engagement)

The addon does not create its own database — all auction listings are managed by the Sigma Orders & Auctions core plugin.

Updating​

  1. Stop the server
  2. Replace RandomAuctionAddon.jar with the new version
  3. Start the server — configuration is preserved automatically
  4. Review the changelog for any new config keys

See Also​