SCUM Trader Config Explained

The SCUM trader config file is your toolkit for customizing the in-game economy, allowing server owners to set prices, control stock, and balance gameplay to fit their community. Whether you're creating a hardcore barter system or a thriving PvE market, understanding how this config works gives you full control over what players can buy and sell.

Overriding Economy Settings

Below is a list of every economy setting you can change in SCUM:

• economy-reset-time-hours – How often traders reset stock and money; -1 means never resets.

• prices-randomization-time-hours – How often item prices randomly change; -1 means never randomizes.

• tradeable-rotation-enabled – Enables periodic item rotation for traders; 0 disables, 1 enables.

• tradeable-rotation-time-ingame-hours-min / max – In-game hours between item rotation swaps.

• tradeable-rotation-time-of-day-min / max – In-game time of day when rotation occurs; range 0–24.

• fully-restock-tradeable-hours – Real-time hours required for sold-out items to fully restock.

• trader-funds-change-rate-per-hour-multiplier – Rate at which traders regain funds to buy from players.

• prices-subject-to-player-count – Adjusts prices based on player count; 0 means no adjustment.

• economy-logging – Logs buy/sell transactions in the server logs.

• traders-unlimited-funds / stock – 1 gives traders unlimited funds or stock for transactions.

• enable-fame-point-requirement – 1 requires fame points to purchase certain items.

Overriding Trader Settings

You can use the traders section in "EconomyOverride.json" to customize exactly what each trader sells, at what price, and under what conditions. Here's how it works:

Template for Each Trader

Inside traders, each trader (e.g. "A_0_Armory") gets an array of item entries:

{
  "tradeable-code"       : "itemspawnname",
  "base-purchase-price"  : "NUMBER",
  "base-sell-price"      : "NUMBER",
  "delta-price"          : "NUMBER",
  "can-be-purchased"     : "default/true/false",
  "required-famepoints"  : "NUMBER"
}

Item Entry Fields

• tradeable-code: The in-game asset ID. For example, the same code used with the "#SpawnItem" command. You can find a list of Item IDs in the Official SCUM Wiki.

• base-purchase-price / base-sell-price: Sets the price for buying from and selling to the trader. Use "-1" to retain the game’s default price.

• delta-price: Price variation applied on top of the base prices. You can set it to either:

• \-1 = random variation each refresh

• 0 or any positive number = fixed variation each variation

• can-be-purchased: Determines the availability of the item. You can set it to either:

• default = uses SCUM’s normal logic

• true = item is always available

• false = never available from trader

• required-famepoints: Determines the minimum fame needed to purchase the item. You can either set it to:

• \-1 = default fame requirement

• 0 or any positive number = specific fame threshold

How to Override a Trader

1. Choose your trader (e.g. "A_0_Armory", "B_4_Trader", "C_2_Mechanic").

2. List your items under the trader inside the square brackets. For example, if you want a trader in the A0 Bunker to sell Frag Grenades for the price of 50 and everything else at the default values, you would add a new item entry with the template earlier, just like below:

   {
     "A_0_Armory": [
       {
         "tradeable-code": "Frag_Grenade",
         "base-purchase-price": "-1",
         "base-sell-price": "50",
         "delta-price": "-1.0",
         "can-be-purchased": "default",
         "required-famepoints": "-1"
       }
     ]
   }

To reset the trader overrides, remove the contents of the square brackets, so resetting the overridden trades we made earlier will result in the following:

   {
     "A_0_Armory": []
   }

Still have some questions about SCUM trader configuration?

Don't hesitate to reach out to our support team! We're available 24/7 to assist!

Updated on: 01/07/2025