EconomyOverride.json - SCUM

📂 Introduction - EconomyOverride.json

The 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.

=== Global Economy Settings ===

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)

=== Trader Item Overrides ===

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

Technical note ⚠

• 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/