Features
Overview of all features included in the Random Auction Addon.
Feature Indexโ
| Feature | Summary |
|---|---|
| Listing Generation | Scheduling, player-count scaling, caps, and per-item cooldowns |
| Material Pools | Weighted pools, pool contents, custom items, dimension items |
| Pricing System | Shop integration, fallbacks, rarity multipliers, time bonuses, anti-abuse protections |
| Enchantment System | Enchanted listings, per-enchantment price impact, chance and cap configuration |
| Engagement Features | Flash sales, featured listings, rare announcements, named market events |
Listing Generationโ
The addon's core: a background scheduler that fires at random intervals and posts bot listings to the auction house.
- Randomized intervals keep the marketplace feeling organic
- Player-count scaling adjusts listing volume to match server activity
- Peak hour multiplier floods the market during busy periods
- Global bot listing cap prevents the auction house from being overwhelmed
- Per-item cooldown stops the same material from appearing too frequently
Material Poolsโ
Items are organized into named pools with independent weights, quantity ranges, and listing durations. On each generation run, a pool is selected by weight, then an item is randomly chosen from within it.
| Pool | Typical Contents |
|---|---|
| Common | Food, basic crafting materials, everyday supplies |
| Rare | Harder-to-obtain drops and materials |
| Ores | All ore variants (iron, gold, diamond, netherite, etc.) |
| Blocks | Building, decorative, and structural blocks |
| Enchanted | Items designed to receive random enchantments |
| Potions | Normal, splash, and lingering potions |
Custom items from ItemsAdder, Oraxen, Nexo, and MMOItems can be added to any pool. Dimension-specific items (Nether and End) have their own configurable lists.
Pricing Systemโ
Prices are calculated dynamically using a layered approach:
- Shop-based price (EconomyShopGUI or ExcellentShop) ร profit margin
- Per-item fallback price if no shop data exists
- Category fallback (blocks, tools, armor) or universal default
- Rarity multiplier applied based on which pool the item came from
- Time-based bonus for peak hours, nights, and weekends
- Anti-arbitrage and anti-undercut checks to prevent exploits
- Enchantment price additions layered on top for enchanted items
Enchantment Systemโ
Bot listings can include randomly enchanted items with pricing that reflects the enchantments applied:
- Each enchantment type has a configurable level range and price-per-level range
- A Sharpness V sword will cost significantly more than Sharpness I
- Multiple enchantments stack their price additions
- A global enchantment chance controls how often listings are enchanted
max-countcaps how many enchantments can appear on one item
Engagement Featuresโ
Tools to make bot activity feel dynamic and exciting:
- Flash sales โ Randomly triggered discount events with server-wide broadcast
- Featured listings โ A configurable chance for a listing to appear as "featured" in the auction GUI
- Rare announcements โ Server broadcast when a rare pool item is listed
- Named market events โ Scheduled time-window events with bonus multipliers, extra listings, and custom names (e.g. "Iron Rush", "Diamond Frenzy")
See Alsoโ
- Overview โ Plugin overview
- Commands โ Command reference
- Configuration โ Full configuration reference