Introduction - EconomyOverride.jsonThe file
/SCUM/Saved/Config/WindowsServer/EconomyOverride.json
controls your entire economy system (trader economy) on your SCUM server.
You can use it to set how traders work, how prices change, when stock refills,
and whether fame points or dynamic prices are active.
If an entry isn't in this file or is set to -1,
the server automatically uses the default value of the game.
The file loads when you start the server - so if you change it, you need to restart,
so all traders and price cycles get updated.
Tip: Keep economy-logging = 1 turned on while you're testing.
That way you can track exactly how prices, funds, and rotations react in the server log.
economy-reset-time-hours
Description: Time (in hours) after which the whole economy (prices, money, storage) gets reset.
Values: -1.0 (no reset), 0.0–168.0+
Default: -1.0
Recommendation: -1.0 or 72.0 (every 3 days for a clean economy)
prices-randomization-time-hours
Description: How often trader prices get randomly recalculated.
Values: -1.0 (no changes), 0.0–168.0+
Default: -1.0
Recommendation: 48.0–96.0 for light price rotation
tradeable-rotation-time-ingame-hours-min
Description: Minimum ingame hours before a trader refreshes their stock.
Values: 0.0–9999.0
Default: 48.0
Recommendation: 48.0 (2 ingame days)
tradeable-rotation-time-ingame-hours-max
Description: Maximum ingame hours until rotation.
Values: >= min value, 0.0–9999.0
Default: 96.0
Recommendation: 96.0 (4 ingame days)
tradeable-rotation-time-of-day-min
Description: Earliest time of day (in-game hours, 0–24) for item rotation.
Values: 0.0–24.0
Default: 8.0
Recommendation: 8.0 (morning)
tradeable-rotation-time-of-day-max
Description: Latest time of day (in-game hours, 0–24) for item rotation.
Values: 0.0–24.0
Default: 16.0
Recommendation: 16.0 (afternoon)
fully-restock-tradeable-hours
Description: Time (in hours) until an item's stock is fully restocked.
Values: 0.1–9999.0
Default: 2.0
Recommendation: 1.0–3.0 (depends on server speed)
trader-funds-change-rate-per-hour-multiplier
Description: Speed at which traders regenerate their funds.
Values: 0.0–10.0
Default: 1.0
Recommendation: 1.0 (realistic), >2.0 (fast refill)
prices-subject-to-player-count
Description: Prices vary based on active player count.
Values: 0 (off), 1 (on)
Default: 0
Recommendation: 0 for stability
gold-price-subject-to-global-multiplier
Description: Gold prices follow the global economy multiplier.
Values: 0 or 1
Default: 1
Recommendation: 1 (default behavior)
gold-base-price
Description: Base value of one gold unit.
Values: -1 (default), 1–1,000,000
Default: -1
Recommendation: Only change if using custom economy.
gold-sale-price-modifier
Description: Multiplier for the gold sale price.
Values: -1.0 (default), 0.0–10.0
Default: -1.0
Recommendation: 1.0 (standard rate)
gold-price-change-percentage-step
Description: Percentage price change per adjustment step.
Values: -1.0 (default), 0.0–100.0
Default: -1.0
Recommendation: 5.0–10.0 (moderate fluctuation)
gold-price-change-per-step
Description: Absolute price change per step.
Values: -1.0 (default), 0.0–10,000.0
Default: -1.0
Recommendation: Only use this if no percent change is active.
economy-logging
Description: Turns on logging for all trade actions.
Values: 0 (off), 1 (on)
Default: 0
Recommendation: 1 (debugging & balancing)
traders-unlimited-funds
Description: Traders have unlimited money.
Values: 0 (normal), 1 (unlimited)
Default: 0
Recommendation: 0 (realistic), 1 (test server)
traders-unlimited-stock
Description: Traders have unlimited stock.
Values: 0 (normal), 1 (unlimited)
Default: 0
Recommendation: 0 (recommended), 1 (test server)
tradeable-rotation-enabled
Description: Enables or disables item rotation for traders.
Values: 0 (off), 1 (on)
Default: 1
Recommendation: 1 (more variety)
enable-fame-point-requirement
Description: Enables Fame Points requirement for certain purchases.
Values: 0 (off), 1 (on)
Default: 0
Recommendation: 1 (more progression)
tradeable-code
Description: Internal item name (Blueprint ID, e.g. "Weapon_AK47").
Values: String (correct item ID)
Recommendation: Exact internal name, otherwise item is invalid.
base-purchase-price
Description: Trader sale price (to player).
Values: -1 (default), ≥1
Recommendation: -1 (keep default values)
base-sell-price
Description: Vendor buy price (what players get).
Values: -1 (default), ≥0
Recommendation: -1 (default)
delta-price
Description: Price variation (supply/demand).
Values: -1.0 (default), 0.0–1.0 (0–100%)
Recommendation: 0.2 for ±20% variation
can-be-purchased
Description: Whether item can be sold by vendor.
Values: "default", "true", "false"
Recommendation: default (server decides)
required-famepoints
Description: Minimum fame points required to buy.
Values: -1 (ignore), 0–10000+
Suggestion: 0–2000 for high-tier items
All numeric values can be given as strings ("1.0") or plain numbers (1.0).
Negative values (-1, -1.0) = use default game values.
For anything over 9999.0, the game might ignore or reset values.
0/1 are read as Booleans, not as "true"/"false" strings.
Unknown keys are just skipped but won’t cause crashes.
Too short rotation times (< 12h) or restock times (< 0.5h) can make the economy unstable.
Enable log (economy-logging = 1), when values are being tested or changed.
Have your .json file validated, for example use https://jsonlint.com/