> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.sparkedhost.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://scum.fandom.com/wiki/Item_IDs).

* **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!