Skip to main content

Configuration

Complete configuration reference for Random Orders Addon.

Configuration File​

The main configuration file is located at:

plugins/RandomOrdersAddon/config.yml

Configuration Structure​

# Enable/disable the addon
enabled: true

# System player name for random orders
system-player-name: "Server"

# Order generation settings
generation:
  # Configuration here

# Item selection settings
items:
  # Configuration here

# Pricing settings
pricing:
  # Configuration here

# Player engagement features
engagement:
  # Configuration here

# Performance settings
performance:
  # Configuration here

Quick Configuration Guide​

Basic Setup​

  1. Enable the addon:

    enabled: true

  2. Set generation interval:

    generation:
      min-interval-minutes: 5
      max-interval-minutes: 15

  3. Configure material pools:

    items:
      material-pools:
        common:
          - DIAMOND
          - IRON_INGOT

  4. Set pricing:

    pricing:
      base-multiplier: 2.5

Configuration Sections​

Generation Settings​

Controls when and how orders are generated.

Key Settings:

  • min-players-online - Minimum players required (0 = disabled)
  • min-interval-minutes - Minimum time between generations
  • max-interval-minutes - Maximum time between generations
  • max-orders-per-interval - Maximum orders per generation cycle
  • player-count-scaling - Scale generation by player count
  • peak-hour-multiplier - Multiplier during peak hours
  • peak-hours - Peak hour time ranges

Example:

generation:
  min-players-online: 1
  min-interval-minutes: 5
  max-interval-minutes: 15
  max-orders-per-interval: 3
  player-count-scaling: true
  peak-hour-multiplier: 1.5
  peak-hours:
    - start: 18
      end: 22

Item Selection Settings​

Controls which items can be generated in orders.

Key Settings:

  • material-pools - Organized item pools (common, rare, ores, blocks)
  • pool-weights - Probability weights for each pool
  • quantity-ranges - Quantity ranges per pool
  • use-itemsadder - Enable ItemsAdder custom items
  • allow-enchantments - Allow random enchantments
  • enchantment-chance - Chance for enchantments (0.0-1.0)
  • max-enchantments - Maximum enchantments per item
  • allow-nether-items - Allow Nether dimension items (default: true)
  • nether-items - List of Nether dimension items/patterns
  • allow-end-items - Allow End dimension items (default: true)
  • end-items - List of End dimension items/patterns

Example:

items:
  material-pools:
    common:
      - DIAMOND
      - IRON_INGOT
    rare:
      - NETHERITE_INGOT
      - BEACON
  pool-weights:
    common: 50
    rare: 10
  quantity-ranges:
    common:
      min: 16
      max: 64
    rare:
      min: 1
      max: 16
  use-itemsadder: false
  allow-enchantments: true
  enchantment-chance: 0.3
  max-enchantments: 3
  # Dimension-based filtering
  allow-nether-items: true
  nether-items:
    - "*NETHER*"
    - NETHERRACK
    - SOUL_SAND
    - "*WARPED*"
    - "*CRIMSON*"
  allow-end-items: true
  end-items:
    - "END*"
    - "*CHORUS*"
    - "*PURPUR*"
    - "*SHULKER*"

Pricing Settings​

Controls how order prices are calculated.

Key Settings:

  • base-multiplier - Base price multiplier
  • min-multiplier - Minimum multiplier
  • max-multiplier - Maximum multiplier
  • rarity-multipliers - Multipliers per rarity
  • time-bonuses - Time-based bonuses
  • shop-provider - Shop plugin integration
  • profit-margin - Profit margin range
  • prevent-arbitrage - Prevent price manipulation
  • fallback-prices - Fallback prices when shop unavailable

Example:

pricing:
  base-multiplier: 2.5
  min-multiplier: 1.5
  max-multiplier: 4.0
  rarity-multipliers:
    common: 1.2
    rare: 2.5
  shop-provider: "excellentshop"
  profit-margin:
    min: 1.1
    max: 1.5
  prevent-arbitrage: false

Engagement Settings​

Controls player engagement features.

Key Settings:

  • completion-bonus - Enable completion bonuses
  • bonus-multiplier - Bonus multiplier
  • special-events - Enable special events
  • event-schedule - Scheduled events
  • announce-special - Announce special orders
  • default-priority - Default order priority
  • urgent-chance - Chance for urgent orders

Example:

engagement:
  completion-bonus: true
  bonus-multiplier: 1.1
  special-events: true
  announce-special: true
  default-priority: 0
  urgent-chance: 0.1

Performance Settings​

Controls performance optimizations.

Key Settings:

  • cache-materials - Cache material pools
  • price-cache-ttl - Price cache TTL (seconds)
  • rate-limit-ms - Rate limit for API calls

Example:

performance:
  cache-materials: true
  price-cache-ttl: 300
  rate-limit-ms: 100

Configuration Examples​

Basic Economy Server​

enabled: true
generation:
  min-interval-minutes: 10
  max-interval-minutes: 20
  max-orders-per-interval: 2
items:
  material-pools:
    common:
      - DIAMOND
      - IRON_INGOT
      - GOLD_INGOT
pricing:
  base-multiplier: 2.0
  shop-provider: "excellentshop"

High-Activity Server​

enabled: true
generation:
  min-interval-minutes: 3
  max-interval-minutes: 8
  max-orders-per-interval: 5
  player-count-scaling: true
  peak-hour-multiplier: 2.0
items:
  material-pools:
    common:
      - DIAMOND
      - IRON_INGOT
    rare:
      - NETHERITE_INGOT
pricing:
  base-multiplier: 3.0
  rarity-multipliers:
    common: 1.5
    rare: 3.0

Reloading Configuration​

After editing config.yml, reload:

/randomorders reload

Configuration Validation​

The addon validates configuration on load:

  • Interval ranges
  • Multiplier ranges
  • Material pool existence
  • Enchantment chances
  • Pool weight distribution

Invalid values are adjusted automatically with warnings.

Next Steps​