SCUM Custom Quest Modification Guide

1. Overview

SCUM allows you to create and customize quests through JSON files located in specific folders, depending on whether you are running a multiplayer server or playing in sandbox mode. All changes to quest JSON files require a server restart (or game restart in sandbox mode) for the changes to take effect.

While understanding the JSON structure is important for advanced customization, most users can create complete quests using the SCUM Quest Editor first, then use the rest of this guide to understand, fine-tune, or manually edit the exported quest files.

Relevant Commands

#ExportQuests - Creates the Quests folder (if it doesn't already exist) and exports quest-related JSON files, providing a snapshot of all current quests.

#GetMeshInfo - Used for Interaction conditions to retrieve object information on the map (e.g., for placing interactable objects).

2. Folder and File Structure

Quests Folder

Depending on your setup, the Quests folder is located at the following location:

• Multiplayer server: <server>\SCUM\Saved\Config\WindowsServer\Quests
• Sandbox: %LocalAppData%\SCUM\Saved\Config\WindowsNoEditor\Quests

This folder is created automatically the first time you run the #ExportQuests command. Inside the Quests folder, you will find the following subfolders:

Blocked

Contains BlockedQuests.json, which lets you block (disable) certain quests by name or block all default quests.

Override

Used to add or update custom quests. When the server starts (or the game in sandbox), it parses the JSON files in this folder and applies any new or updated quests.

QuestList

Contains CustomQuestList.json (list of all custom quests exported) and DefaultQuestList.json (list of all default quests). Editing these files does not affect the server or gameplay; they are for reference only.

Blocking Default Quests

If you wish to prevent certain default quests from appearing, you can use the BlockedQuests.json file located in the Blocked folder. Simply add the names of the quests you want to disable. For example:

{
  "BlockAllDefaultQuests": false,
  "BlockQuestNames": [
    "T1_AR_Fetch_45ACPAmmobox",
    "T1_AR_Fetch_50AEAmmobox",
    "T1_AR_Fetch_9mmAmmobox"
  ]
}

Set BlockAllDefaultQuests to true if you want to disable all default quests.

3. Creating Custom Quests

All custom quests must be placed as one JSON object per file in the Override folder. Each file describes a single quest. When the server (or game) restarts, SCUM will load these quests.

Example File Structure

Quests
│
├── Blocked
│   └── BlockedQuests.json
├── Override
│   ├── MyFirstCustomQuest.json
│   └── MySecondCustomQuest.json
└── QuestList
    ├── CustomQuestList.json
    └── DefaultQuestList.json

4. Anatomy of a Quest JSON File

Each quest you create is defined by a Quest JSON object with specific properties. Some properties are mandatory, while others are optional.

Below is the structure, followed by detailed explanations:

{
  "AssociatedNPC": "Bartender",
  "Tier": 1,
  "Title": "My First Custom Quest",
  "Description": "Help the Bartender with some tasks.",
  "TimeLimitHours": 24,
  "RewardPool": [
    {
      // One or more Reward objects can go here.
    }
  ],
  "Conditions": [
    {
      // One or more Condition objects can go here.
    }
  ]
}

More on RewardPool and Conditions later.

5. Reward Objects

Each entry in the RewardPool array is a Reward object. SCUM places a maximum of five "reward slots" in each object, counted as follows:

Currency (Normal, Gold, Fame) Group:
All three of these together count as 1 reward slot—whether you include just one (e.g., CurrencyNormal only) or all three (CurrencyNormal, CurrencyGold, and Fame).

Skills:
Each Skill grant counts as 1 reward slot per skill.
Example: If you give experience in Archery and Cooking, that's 2 reward slots.

TradeDeals:
The first TradeDeal within a single Reward object counts as 2 reward slots.
Each additional TradeDeal in the same Reward object counts as 1 reward slot.
Item awarded must belong to the Trader's Inventory

Below is an example showing how reward counting works:

{
  "CurrencyNormal": 100,
  "CurrencyGold": 1,
  "Fame": 10,
  "Skills": [
    {
      "Skill": "Cooking",
      "Experience": 50
    }
  ],
  "TradeDeals": [
    {
      "Item": "Weapon_M9",
      "Price": 50,
      "Amount": 2,
      "AllowExcluded": false,
      "Fame": 10
    }
  ]
}

• CurrencyNormal (100) + CurrencyGold (1) + Fame (10) → 1 reward slot
• Cooking Skill +50 EXP → 1 reward slot
• First TradeDeal → 2 reward slots

So far, the total is 4 reward slots. You could add one more skill or one more TradeDeal (or any single-slot reward element) before hitting the limit of 5.

6. Skill Objects

Used within the Skills array inside a Reward object.

{ 
  "Skill": "Cooking",
  "Experience": 50 
}

Skill (string) Must be one of the predefined skill names: "Archery", "Aviation", "Awareness", "Boxing", "Camouflage", "Cooking", "Demolition", "Driving", "Endurance", "Engineering", "Farming", "Handgun", "Medical", "MeleeWeapons", "Motorcycle", "Rifles", "Running", "Sniping", "Stealth", "Survival", "Tactics", or "Thievery".

Experience (integer) Amount of experience points to grant for that skill.

7. TradeDeal Objects

Used within the TradeDeals array inside a Reward object.

{
  "Item": "Weapon_M9",
  "Price": 50,
  "Amount": 2,
  "AllowExcluded": false,
  "Fame": 10
}

Item (string) The in-game name of the item, same as you would use in #SpawnItem.

Price (integer, optional) The discounted (or altered) price. Omit to keep the default price.

Amount (integer ≥ 1, optional) The quantity of the discounted item available.

AllowExcluded (boolean, optional) Allows buying items normally not sold by the trader if set to true.

Fame (integer ≥ 0, optional) Fame requirement to buy the item. Omit to use the default fame requirement.

8. Condition Objects

The Conditions array in a Quest JSON object consists of one or more Condition objects. Each condition can be one of three types: Elimination, Fetch, or Interaction.

{
  "Type": "Elimination",
  "CanBeAutoCompleted": false,
  "TrackingCaption": "Eliminate 3 puppets",
  "SequenceIndex": 0,
  "LocationsShownOnMap": [
    {
      "Location": { "X": 0.0, "Y": 0.0, "Z": 0.0 },
      "SizeFactor": 1.0
    }
  ]
}

{"Location": { "X": 1000.0, "Y": 2000.0, "Z": 30.0 },
"SizeFactor": 1.0}

{ "Location": "{X=-157607.328 Y=-687586.562 Z=667.976|P=353.113800 Y=101.191971 R=0.000000}",
"SizeFactor": 1.0}

{ 
  "Type": "Elimination",
  "TargetCharacters": [
    "Puppet",
    "Prisoner" 
  ],
  "Amount": 5,
  "AllowedWeapons": [
    "BP_Weapon_M1911_C",
    "BP_Weapon_M9_C"
  ]
}

{
  "Type": "Fetch",
  "DisablePurchaseOfRequiredItems": false,
  "PlayerKeepsItems": false,
  "RequiredItems": [
    {
      "AcceptedItems": [ "Apple" ],
      "RequiredNum": 3,
      "RandomAdditionalRequiredNum": 2,
      "MinAcceptedItemUses": 1,
      "MinAcceptedCookLevel": "Raw",
      "MaxAcceptedCookLevel": "Cooked",
      "MinAcceptedCookQuality": "Poor",
      "MinAcceptedItemMass": 100.0,
      "MinAcceptedItemHealth": 50.0,
      "MinAcceptedItemResourceRatio": 20.0,
      "MinAcceptedItemResourceAmount": 50.0
    }
  ]
}

{ 
  "Type": "Interaction",
  "Locations": [{
    "AnchorMesh": "/Game/World/SomeMap/BP_Switch.BP_Switch_C",
    "Instance": 4,
    "FallbackTransform": "X=123.456 Y=234.567 Z=10.0 Pitch=0 Yaw=0,Roll=0",
    "VisibleMesh": "/Game/World/SomeMap/BP_SwitchModel.BP_SwitchModel_C" 
  },
  {
    "AnchorMesh": "/Game/World/SomeMap/BP_Door.BP_Door_C"
  }],
  "MinNeeded": 1,
  "MaxNeeded": 2,
  "SpawnOnlyNeeded": true,
  "WorldMarkerShowDistance": 50
}

9. Putting It All Together: Example Quest

Below is a simple, fully-detailed example of a custom quest JSON file. Save this file as MyFirstQuest.json (or any name) inside the Override folder.

{
  "AssociatedNpc": "GeneralGoods",
  "Tier": 1,
  "Title": "General Goods trader's Special",
  "Description": "Collect apples for the General Goods trader and get a small reward.",
  "TimeLimitHours": 24.0,
  "RewardPool": [{
    "CurrencyNormal": 100,
    "Fame": 5,
    "Skills": [{
      "Skill": "Cooking",
      "Experience": 20
    }],
    "TradeDeals": [
      {
        "Item": "Pineapple",
        "Price": 50,
        "Amount": 1,
        "Fame": 0 
      } 
    ] 
  }],
  "Conditions": [{
    "TrackingCaption": "Gather apples",
    "SequenceIndex": 0,
    "CanBeAutoCompleted": false,
    "Type": "Fetch",
    "DisablePurchaseOfRequiredItems": false,
    "PlayerKeepsItems": true,
    "RequiredItems": [{
      "AcceptedItems": [
        "Apple_2"
      ],
      "RequiredNum": 3,
      "MinAcceptedItemHealth": 50.0
    }],
    "LocationsShownOnMap": [{
      "Location": {
        "X": 1000.0,
        "Y": 2000.0,
        "Z": 50.0
      },
      "SizeFactor": 1.0
    }]
  }]
}

Explanation

• AssociatedNPC - The General Goods trader will offer the quest, and rewards from the TradeDeals array apply to the General Goods trader's shop.
• Tier - Tier 1 indicates a simple or low-level quest.
• RewardPool - The player receives 100 normal currency, 5 fame, 20 Cooking experience, and can buy a Pineapple at a discounted price once they complete the quest.
• Conditions
  • Type is Fetch. The player must bring 3 apples (AcceptedItems: Apple_2) with at least 50% health.
  • They must return to the General Goods trader (CanBeAutoCompleted: false) to finalize the quest.
  • PlayerKeepsItems is true, so they won't lose the apples upon completion.

After creating or modifying this file, restart your server or game for the quest to become active.

10. Tips and Best Practices

• Keep backups of your JSON files in case you need to revert changes.
• Validate your JSON using online or local JSON validators to prevent formatting errors.
• Use #GetMeshInfo for accurate placement data for Interaction type conditions.
• Test your quest in sandbox mode first if possible, before adding it to a live server environment.
• Remember that you cannot edit default quests. You can only block them or create entirely new ones.

Conclusion

By following this guide, you should be able to create, customize, and manage your own quests in SCUM. Whether you want to block default quests, add new ones with unique conditions, or reward players with currency, fame, discounts, or skill experience, the JSON structure provided above covers all the essentials.

Important: Always restart your server or game after making changes to the JSON files so that your custom quests load properly.

Enjoy crafting unique SCUM experiences with your custom quests!