Configuration
Complete reference for plugins/RandomOrdersAddon/config.yml.
Top-Level Settings
| Key | Type | Description |
|---|---|---|
enabled | boolean | Master on/off switch for the addon |
system-player-name | string | Name shown as the order creator for bot-generated orders |
Generation Settings (generation)
| Key | Type | Description |
|---|---|---|
min-players-online | int | Minimum online players before generation runs (0 = disabled) |
min-interval-minutes | int | Minimum time between generation runs |
max-interval-minutes | int | Maximum time between generation runs |
max-orders-per-interval | int | Maximum orders created per run |
player-count-scaling | boolean | Scale orders generated by current player count |
peak-hour-multiplier | double | Extra order multiplier during peak hours |
peak-hours | list | Time ranges (start/end, 24h) treated as peak hours |
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 (items)
| Key | Type | Description |
|---|---|---|
material-pools | map | Named item pools (common, rare, ores, blocks, etc.), each a material list |
pool-weights | map | Selection weight per pool |
quantity-ranges | map | Per-pool min/max stack size |
use-itemsadder | boolean | Allow ItemsAdder custom items in pools |
allow-enchantments | boolean | Allow randomly enchanted generated items |
enchantment-chance | double | Probability (0.0–1.0) an eligible item is enchanted |
max-enchantments | int | Maximum enchantments per item |
allow-nether-items | boolean | Allow Nether-dimension items (default true) |
nether-items | list | Material name/wildcard patterns treated as Nether items |
allow-end-items | boolean | Allow End-dimension items (default true) |
end-items | list | Material name/wildcard patterns treated as End items |
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
allow-nether-items: true
nether-items: ["*NETHER*", NETHERRACK, SOUL_SAND, "*WARPED*", "*CRIMSON*"]
allow-end-items: true
end-items: ["END*", "*CHORUS*", "*PURPUR*", "*SHULKER*"]
Pricing Settings (pricing)
| Key | Type | Description |
|---|---|---|
base-multiplier | double | Base price multiplier applied to fallback/shop prices |
min-multiplier / max-multiplier | double | Random multiplier range applied per order |
rarity-multipliers | map | Multiplier per pool rarity |
time-bonuses | map | Time-based price adjustments |
shop-provider | string | excellentshop, economyshopgui, or none |
profit-margin | map | min/max multiplier above shop sell price |
prevent-arbitrage | boolean | Block prices exploitable via shop buy-back |
fallback-prices | map | Per-material price used when no shop price is available |
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 (engagement)
| Key | Type | Description |
|---|---|---|
completion-bonus | boolean | Award a bonus when an order is fully delivered |
bonus-multiplier | double | Completion bonus size |
special-events | boolean | Enable scheduled special-order events |
event-schedule | map | Special-event time windows |
announce-special | boolean | Broadcast special orders server-wide |
default-priority | int | Default priority assigned to generated orders |
urgent-chance | double | Probability a generated order is marked urgent |
engagement:
completion-bonus: true
bonus-multiplier: 1.1
special-events: true
announce-special: true
default-priority: 0
urgent-chance: 0.1
Performance Settings (performance)
| Key | Type | Description |
|---|---|---|
cache-materials | boolean | Cache material pool lookups |
price-cache-ttl | int | Shop price cache duration (seconds) |
rate-limit-ms | int | Minimum milliseconds between shop plugin API calls |
performance:
cache-materials: true
price-cache-ttl: 300
rate-limit-ms: 100
Validation
Invalid values (bad interval ranges, multiplier ranges, missing pools, out-of-range enchantment chances, etc.) are corrected automatically on load, with a warning logged.
Apply config changes with:
/randomorders reload