Vagabond is a gameplay overhaul mod, which aims to turn Tarkov into an open world game.

You start with limited money to buy a simple loadout from Fence, with some meds if you are lucky, and your challenge is now to survive. Using only transits to move around Tarkov and specific extracts to get access to traders.

Heavily inspired by Path To Tarkov, hopefully this mod can help scratch that itch.

If you want to see the trader locations, click here.

ABPS Compatibility

0.3.4 is compatible with ABPS 2.0.14 (and older)
0.4.0 is only compatible with ABPS 2.0.15

Using SVM?

Disable the Raid Settings tab completely, it even being enabled is enough to cause conflicts, regardless of whether or not you changed anything within the tab. - Thank you _liquidrage!

Does Quests Work

They should. If its a quest which requires specific extractions, those will be available only when you have the quest(s). Using such extraction will take you back to the quest giver. Do let me know if I missed any quests / if you find any quests you cannot complete.

Main Features

• Place your hideout entrance anywhere (Press CTRL+P in raid to place your hideout entrance)
• Per-trader (and hideout if playing with friends) stash
• Use trader specific extractions to get access to their shop.
• Custom trader support (Reserve exfil to get access)
• Custom extractions and transits
• Remember last exit/transit location

Remember Raid Position

Custom Extractions, Transits and Infil locations

Dynamic Maps Compatibility

Any mod which makes changes to Extractions, Transits or player spawning (Like selectable entry mod or interaction mods), will likely conflict with this mod and prevent extracts from working.
Labyrinth has not been tested with this mod.. but.. should hopefully work.

1. Download the latest version
2. Extract and copy the SPT\user\mods\Vagabond folder to SPT\user\mods and the BepInEx\plugins\Vagabond to BepInEx\plugins.
3. If you use Headless clients, you will need to add the client plugin to the headless spt client as well.
4. Create a new profile, and it will get enrolled as a new Vagabond.

Configuration is limited for now, and might always be to some extend. Create and issue and/or make PR if need anything specific.

{
  // if you die for whatever reason (according to the game), all stashes and equipment gets wiped.
  "ResetOnDeath": false,
  // The amount of money a player starts with
  "StartingRoubles": 175000,
  // makes fence less random and useful as a starter vendor - recommend removing other traders
  "EnableFenceChanges": true,
  "DisableFlea": true,
  // disables events such as halloween etc.
  "DisableEvents": true,
  // will enable SPTs profile fixes "RemoveInvalidTradersFromProfile". Helpful if you used older versions of this mod.
  // will be removed in a future version.
  "FixProfiles": false,
  // players can only send mail with attachments to eachother if:
  // "same-exit" - they share raid + exit
  // "same-map" - they share raid
  // "anywhere" - no limits
  "MailAttachmentLimit": "same-exit",
  // if enabled, you can choose what map you want to go to and won't be locked to your current location.
  "EnablePickRaidLocation": false,
  // first time you enter a raid, whatever is left over in the stash is wiped.
  "WipeStashOnFirstRaidEntry": true,
  // adjust how long raids last by this amount of minutes, negagive values supported by be careful.
  "AdjustRaidTimeMins": 60,
  // if enabled, you can continue to place the hideout without being told you already have.
  // allowing relocation via an in-game feature will come in a later update.
  "AllowHideoutRelocation": false,
  // Where you will be placed when you die, options are: 
  // "hideout" - will send you to your hideout if you have one, otherwise fence.
  // "fence" - will send you to fence.
  // "stay" - you stay at your last known map/transit
  // "therapist" - sends you to therapist's clinic, allowing you to heal post-raid.
  "OnDeathGoTo": "hideout",
  // Which Fence/location to use as your start location (and on death location)
  // "streets" - Streets of Tarkov location
  // "lighthouse" - Lighthouse location
  "StarterFence": "streets",
  // will allow per-trader/per-extract (eg other players hideouts) virtual stashes.
  // if you disable this, your own permanent stash is used like normal.
  "EnableVirtualStashes": true,
  // if enabled, will wipe all virtual stashes when you enter a raid, making virtural
  // stashes entirely temporary. This will prevent "AllowPostRaidHealing" from working.
  "WipeVirtualStashesOnRaidEntry": false,
  // if enabled, all status effects (broken limbs, bleeds etc) will be healed when you die.
  "HealStatusEffectsOnDeath": true,
  // allow post-raid healing at Therapist (still requires money left at the Therapist)
  "AllowPostRaidHealing": true,
  // add Fence as an always available trader in hideout
  "AddFenceToHideout": false
}

View Full Size
If you want to see the trader locations, click here.

See knows issues/limitations with each released version. Below are other general issues/limitations across all versions:

• Limited configuration via this mod alone.
• SVM Extracts settings will cause conflicts, like preventing extractions etc.
• (Fika) If one of your teammates die and you use a transit after, the game will get stuck. I don’t think this is a mod issue however.
• (Fika) the spawn-in location is determined by the player who initiates the game.

Notes

• Hideout exfils persist until server restart. Other players will be able to use them as extracts until then.

Trap, for the original PTT mod, serving as strong inspiration.
Sacrificial Lamb, for testing a lot of cross compatibility between Vagabond, other mods and SVM settings on the initial release.
DanW, for the Hardcore Rules mod which I nicked some patches from.
GhostFenixx, for the SVM mod which I also nicked some patches from.
acidphantasm for the item limits begone mod, which I also nicked some code from.

If you feel utterly compelled to say thanks and you feel a comment is not enough (it is, honestly), you can become an enabler of my caffeine addiction; however only when you literally have nothing else to spend your shillings and shekels on, I am serious.

Weapon preset and build improvements for SPT

I really like the concept of weapon builds. The idea of having different sets of parts for the same weapon — each optimized for a specific role (mobility, long range, low recoil, etc.) — is genuinely cool. However, Tarkov implements presets quite rigidly. A build is treated as an exact, fixed list of attachments and nothing else (thankfully, magazines are ignored).

Personally, I don’t care which exact flashlight or laser is mounted on my SuperUltraLasergun — I often just slap on whatever I have available at the moment. Yet I still want the weapon to be recognized and displayed as the SuperUltraLasergun build.

Additionally, preset names must be globally unique, meaning you cannot have the same name for different weapon models (e.g. an AK-74N “Zenit” build and an AKS-74 “Zenit” build at the same time). And, of course, your build names must only contain Latin characters.

This mod fixes these limitations. It lets you choose which attachment types are taken into account when matching a weapon in your inventory to a saved preset, allows you to use the same name for builds of different weapons, allows you to use non-Latin characters in names, and introduces a more flexible matching system.

New: Partial Matching

You can enable partial matching for builds.

This allows you to create “base builds” that define only a minimal required set of components. A weapon will be considered a match if it contains all components from the build, but may also include additional ones.

When multiple builds match, the mod will automatically pick the most specific one (the one with more components).

This makes it possible to:

• ignore unimportant attachments (like tactical devices) without excluding entire categories
• define layered builds (e.g. base → upgraded → full kit)
• combine with excluded mod types for even more flexibility

Hide base weapon name

You can switch to display only the preset name without the base model:

Same Names

Builds for different weapons can share the same name without conflicts:

Naming Freedom

Names can use characters other than Latin, as in container tags (even emoji☻).

Flexible Matching

Excluded attachment types (in these examples: sights, mags, mounts, tactical devices, and foregrips) are ignored when comparing builds, allowing them to be recognized as the same preset:

Another example of flexible matching:

Partial Matching

Create a base preset with a minimal number of attachments. Any additional attachments you add will not change the build name, as long as all elements from the base preset are present.

Flexible Matching

You can configure which mod types will be excluded from the preset matching check. The list is generated dynamically from all classes inheriting from the base Mod class — basically, every weapon modification the game recognizes appears in the config.

This makes it easy to ignore custom modification types added by other SPT mods (I haven’t seen any yet, but the option is there).

Hierarchy

Mod types are organized in a tree structure, where each parent contains its nested subtypes.

Toggling a parent mod class (e.g., “Sights”) will toggle all its child categories (collimators, optics, etc.).

If a child category is unchecked, the parent will also be unchecked, as not all children remain selected.

If you want vanilla behavior, simply select only Magazines in the config.

• Excluded mods are still saved as part of the preset — settings only affect matching and naming.
• Settings apply only to your own builds and do not affect built-in presets (Mechanic, Prapor, etc.).
• Settings now apply instantly — no restart or profile reload required.

Note: already displayed item names will only refresh when the game updates inventory. You can force this by exiting to main menu or removing and reattaching any weapon component.

Potentially compatible with all other mods, including those that add custom weapon modification types.

⭐ RZEssentials started as a collection of separate mods, each built around the same philosophy, then merged into a single coherent package. Every system is independent, optional, and disabled by default. Install it as-is and nothing changes in your game.

⭐ This mod is built for players who want to craft their own experience and aren’t afraid to dig into config files. That said, it’s designed to be approachable : the configs are well organized and clearly commented. Most features ship with sensible default, enabling them is often enough to get a solid base without touching anything else.

⚠️ All my previous mods are deprecated and replaced by this one. Make sure to remove them before installing RZEssentials, or you’ll have conflicts.

This mod was designed around a flea-market-disabled server. Flea-related features are limited and not a development priority. Most systems have nothing to do with the flea market either way.

Some features overlap with SVM.

💠 Getting Started

Each feature lives in its own subfolder under config/. The folder structure maps directly to the tabs in this description : if you’re reading the Profiles tab, the relevant files are in config/profiles/. No hidden dependencies, no cascading side effects between systems.

Most features have a master toggle at the top of their config file. Flip it to true and the feature is live. Leave everything off and the mod does absolutely nothing.

💠 About

This mod has been extensively tested in multiplayer through a Fika headless server setup, with a small group of 3-4 people playing almost every evening. I can confidently say that 95% of the features work perfectly, at least the ones I personally use. If you run into bugs, don’t hesitate to report them.

I built this for myself first and I’m posting it hoping it’ll be useful to others.

📌 Enriches item descriptions and names with contextual information. All sections are independently toggleable. Fully compatible with modded crafts, barters, quests, and hideout requirements, whether added by this mod or any external mod.

⚡ TL;DR : To enable this feature, open RZEssentials/config/itemContext/itemContextConfig.json and set EnableItemContext to true.

Ammo name enrichment — Appends color-coded [dmg:x/pen:x] stats directly to ammo item names. Colors and thresholds are fully configurable.

Base price display — Appends a color-coded [x₽] price suffix to item names. Colors and thresholds are fully configurable.

Description cleanup — Clears vanilla descriptions for selected categories.

Crafting Components — Lists crafting recipes where this item is required as an ingredient.

Crafting Tools — Lists crafting recipes where this item is required as a tool.

Hideout — Lists hideout construction stages that require this item. Specific areas can be excluded.

Barters — Lists barter trades where this item is part of the payment. The loyalty level display is toggleable.

Quests — Lists quests that require this item.

Size — Shows container capacity and slot efficiency.

Audio — Shows headset boost and suppression stats.

Armor plates — Shows class and effective durability in the item description, and appends a [class/eff. durability] suffix to the item name.

Key — Shows a custom description for keys : what the key opens, what loot to expect, and any related quests.

⚠️ Streets of Tarkov keys are not covered. There are also very likely errors in the listed keys, I can’t be bothered to verify all of them. If you feel like doing a proper pass and want to submit a corrected version, send it my way and I’ll include it.

📌 Colors the background of items in your inventory based on their usefulness. Most categories are left untouched : weapons, armor, and meds are already readable at a glance and don’t need it. The coloring is reserved for categories where a quick visual signal actually helps : ammo, armor plates, keys, and a handful of high-value items. The system is intentionally small : 6 tiers, and if something is glowing red, it genuinely means best-in-class.

⚡ TL;DR : To enable this feature, open RZEssentials/config/itemTiers/itemTiersConfig.json and set EnableItemTiers to true.

⚫ Default — Unassigned or not worth highlighting.

🔵 Notable — Ammo & armor plates : decent option. - OR - Other items : valued 30k–60k roubles.

🟣 Superior — Ammo & armor plates : good, reliable choice. - OR - Other items : valued 60k–90k roubles.

🟡 Excellent — Ammo & armor plates : high-end, strong performer. - OR - Other items : valued 90k–200k roubles.

🔴 Elite — Ammo & armor plates : best-in-class, hard capped at 1 or 2 per category. - OR - Other items : valued 200k+ roubles.

⚪ Situational — Ammo only : high damage but low pen aka leg meta (white/grey).

🟢 Quest — Required for a quest.

💡 Quest-only items are colored automatically. Quest keys for Customs and Reserve have been manually added on top of that. Other maps are not covered yet, if you want to add them, drop the TPLs in config/keys.json.

💡 Situational tier colors are intentionally slightly lighter than Default. These rounds are niche enough that new players don’t need to pay attention to them, so they must stay visually quiet.

💡 Includes several color themes !

itemTiersConfig.json

Defines the color for each tier name and the global price thresholds used for automatic tiering. Supports multiple color presets via the Theme field : set to dark, bright or verybright.

categoryRules.json — Pass 1

Maps item category IDs to tier names. Walks the DB parent chain, so assigning a category also covers all its sub-categories automatically. The full vanilla category hierarchy is included as comments for reference.

By default, no category is assigned a meaningful tier, every root category is mapped to Default. This means the file currently serves as a blanket reset, but you can assign any tier to any category if you want to color entire item families at once.

Quest items flagged by Tarkov’s QuestItem property are automatically assigned the Quest tier at this pass. However, this does not cover quest-required keys, which are not flagged as quest items in the DB : those are handled manually in config/keys.json.

priceRules.json — Pass 2

Lists category IDs whose tier should be assigned automatically based on handbook price, using the thresholds defined in masterConfig.json. Items below the lowest threshold fall back to Default. Uses the same DB category IDs as categoryRules.json.

Override files - Pass 3

ammo.json, armorplates.json, and any other *.json in config/ map individual item TPLs to tier names with absolute priority. Set "Enabled": false to disable a file without deleting it.

The per-TPL overrides are intentionally split across multiple files rather than lumped into one. This makes updates easier to manage : if you’ve built your own custom config, you can replace or ignore individual files without touching everything else. It also makes it easier to contribute to specific categories. If you know the ammo meta better than I do and want to submit a corrected ammo.json, you’re welcome to contribute.

Ammo boxes - Pass 4

Automatically inherits the color of the corresponding loose round. No configuration required.

📌 Lets you change almost any stat on any item in the game : damage, penetration, armor class, durability, use time, stack size, ergonomics, speed penalty, and more. No hardcoded list of supported items or properties : if the stat exists on the item template, you can change it. Changes can be applied to an entire category at once, or to individual items by TPL, with per-item values always taking priority over category values. Also supports resizing container grids : stash size, secure container dimensions, backpack capacity, cases, etc.

The mod ships with several pre-configured files as a starting point (all disabled by default) :

• containerSizes.json — Resizes pockets, stashes, secure containers, storage cases, backpacks, vests and armored rigs.
• stackSizes.json — Adjusts ammo and currency stack sizes.
• medical.json — Tweaks use counts on medkits and injectors. Defaults restore vanilla use counts.
• gearPenalties.json — Tweaks speed, mouse, and ergonomics penalties on armored equipment, vests and backpacks.
• keys.json — Tweaks use count of mechanical keys and keycards.
• itemWeights.json — Halves the weight of every item in the game.
• faceCovers.json — Ensures all skin variants of each ballistic mask share the same armor values as their base version.

All *.json files in the folder are loaded and merged automatically. Each file can be disabled independently with "Enabled": false without deleting it.

⚠️ Grid resizing, known limitation : Grid overrides work correctly for most items (containers, cases, pouches, stash). For backpacks specifically, some have a GridLayoutComponent with a layout baked into a Unity prefab. For those the inventory UI may still display the original layout. The mod BetterBackpacks solves this with a BepInEx client patch. RZEssentials does not include a client component and this will not be fixed.

⚠️ Increasing the stack size of non-stackable items is not supported. Tarkov’s inventory system is not designed for it, and the results range from balance-breaking to outright broken mechanics. Better that way I guess, it’s not Minecraft after all.

💡 The one limitation worth knowing : this system works cleanly on flat numeric and boolean properties. Nested structures like attachment filter lists require dedicated code and are not supported, except container grids, which are explicitly handled.

Each property supports three operations :

• set — Sets the value directly. This is the default, "Op" can be omitted entirely.
• add — Adds to the current value.
• multiply — Multiplies the current value.

// Mechanical keys - set to unlimited uses (0 = unlimited) (Op omitted).
"5c99f98d86f7745c314214b3": {
    "Ops": {
        "MaximumNumberOfUsage": { "Value": 0 }
    }
},

// Keycards - double the number of uses.
"5c164d2286f774194c5e69fa": {
    "Ops": {
        "MaximumNumberOfUsage": { "Op": "multiply", "Value": 2 }
    }
}

📌 Define custom profile editions that appear in the SPT launcher at character creation, each with their own starting items, trader standings and more.

💠 How it works

Registers your custom profiles into SPT’s profile template system at server startup. When a player creates a new character in the launcher, your editions appear alongside (or instead of) the vanilla SPT ones.

Each profile is defined by a separate .json file in the profiles/templates/ folder. All files are loaded automatically, just drop and go.

💠 Main Config ( profiles/profilesConfig.json )

• EnabledBaseProfiles — List of vanilla SPT profiles to keep visible in the launcher alongside your custom ones.
• ExaminedCategoryBlacklist — Excludes all items belonging to the listed categories.
• ExaminedBlacklist — Excludes specific items by TPL.

⚠️ Removing the Standard SPT profile from EnabledBaseProfiles has been known to cause issues in certain edge cases.

💠 Profile Files

Identity

• Enabled — Whether this profile is registered and visible in the launcher.
• BaseProfile — Vanilla SPT profile to clone as a base (same indices as EnabledBaseProfiles).
• Name — Profile name shown in the launcher.****
• Description — Profile description shown in the launcher.

Progression

• AllItemsExamined — Examine all handbook items on character creation. Respects ExaminedCategoryBlacklist and ExaminedBlacklist.
• MaxLevel — Start at max level.
• StartingLevel — Start at a specific level (1 to max). Ignored if MaxLevel is true. null = leave unchanged from base profile.
• StartingPrestigeLevel — Starting prestige level (1–4). null = no prestige applied.
• MaxSkills — Max out all skills.
• SkillOverrides — Override specific skills individually (values 0–51). Ignored if MaxSkills is true.

Inventory

• ClearEquipment — Wipe equipped items from the base profile.
• ClearStash — Wipe stash items from the base profile before injecting additional items.
• SecureContainer — Override the starting secure container.
• AdditionalStartingItems — Items injected into the stash on character creation. If ClearStash is false, they are added on top of whatever the base profile already contains. For items with required slots (weapons, armor…), missing children are resolved automatically from the database.

Traders

• TradersLoyalty — Per-trader standing and sales sum, keyed by trader ID.

Hideout

• HideoutStartingLevels — Starting level for each hideout area.

📌 Patches applied at the raid level.

💠 Misc raid settings ( raids/raidsConfig.json )

Raid times — Override raid duration per map. Only maps explicitly listed are affected.

No run-through — Removes the time and XP requirements for a raid to count as a survival.

Remove raid restrictions — Removes in-raid item carry restrictions (GP coin limits, etc.).

Free special extracts — Removes requirements on special extractions (car extract payment, co-op extract partner, etc.). Train and Saferoom extracts are left untouched.

Magazine Speed Multiplier — Magazine load/unload speed multipliers.

💠 Weather ( raids/weatherConfig.json )

Controls season selection and weather conditions per raid. Both systems are independent and can be enabled separately.

Season

A season is drawn randomly at the start of each raid using configurable weights. Set a season’s weight to 0 to exclude it entirely.

Weather Presets

Defines named weather presets with weighted random selection. Each preset controls rain, fog, cloud cover, and wind independently. Any field left as null is left to SPT to decide.

FixedForRaid: true — One preset is drawn per raid, conditions stay consistent from start to finish.

FixedForRaid: false — One preset is drawn per weather period (~15–30 min), producing vanilla-style variation within the raid.

📌 The largest system in the mod. Controls everything players see at traders : what’s for sale, at what price, in what quantities, what traders will buy back, and more. The three main features that control trader stock are Default Trades, Routed Trades, and Manual Trades. They are fully independent and can run in any combination.

💠 Default Trades ( traders/defaultTradesConfig.json )

Patches vanilla trader assorts without replacing them. Useful for cleaning up barter schemes, applying price multipliers, or blacklisting specific items, while keeping the rest of the vanilla stock intact. Setting ClearAllDefaultTrades to true wipes all non-Fence assorts entirely as a clean slate for the other systems.

💠 Routed Trades ( traders/routedTradesConfig.json )

Rebuilds trader assorts from scratch based on the handbook. Every item gets automatically assigned to a trader according to category routes you define in config. The routing follows the item categories hierarchy : assign a route to a root category and every sub-category inherits it automatically.

Supports routing only modded items, only vanilla items, or everything. Prices are derived from handbook values.

💠 Manual Trades ( traders/manualTradesConfig.json )

Define specific offers for specific traders with full control over every parameter : item, price, currency, barter, stack size, loyalty level, durability, and attachments. Completely independent from the other two systems. Required children (armor plates, etc.) are resolved automatically from the database.

💠 Fence ( traders/fenceConfig.json )

Fence is handled separately from other traders internally. Controls the native SPT item pool generation (counts, price multipliers) and a custom weighted pool of offers that are injected directly into Fence’s assort on every refresh.

💠 Buyback ( traders/buybackConfig.json )

Controls what each trader will accept from the player. Four modes per trader : leave vanilla behavior untouched, disable buyback entirely, restrict to specific handbook categories, or accept everything except a blacklist.

💠 Supply ( traders/supplyConfig.json )

Controls trader restock timers and stock amounts per restock cycle. Timers are clamped immediately on server start if the configured interval is shorter than the current one. Stock multipliers can be applied per trader, per handbook category, or both simultaneously.

📌 Registers a new trader (Sable). Fully configurable, sells all keys in the game by default.

To enable her, open config/traders/customTraderConfig.json and set EnableCustomTrader to true.

Stock is configured through the same systems as any other trader : Routed Trades for automatic category-based stock, and Manual Trades for specific hand-crafted offers. Both are covered in the Traders tab. In short :

• Open routedTradesConfig.json, find the Sable entry under CategoryRoutes, and enable the categories you want her to sell.
• Add specific offers in manualTradesConfig.json under her trader ID for anything that needs custom pricing, barter schemes, or durability.

📌 Controls the economy systems that aren’t directly tied to trader assorts.

💠 Handbook Prices ( economy/handbookPricesConfig.json )

Override the handbook price of any item by TPL. Handbook prices are the foundation of several SPT systems : routed trade prices, trader buyback prices, and more all derive from them. Changing a price here has broad downstream effects.

💠 Flea Market ( economy/fleaMarketConfig.json )

Controls dynamic flea market offer generation. Trader flea offers are not affected. Supports disabling all dynamic offers entirely, or selectively forcing specific items in or out of the dynamic pool.

💠 Insurance ( economy/insurance.json )

Disable insurance globally, or selectively by handbook category and individual TPL. Categories and TPL blacklists are cumulative.

💠 Hideout Areas ( hideout/hideoutAreasConfig.json )

Full control over hideout area requirements, construction times, and the bitcoin farm. Each area is configured independently. Each requirement type (items, areas, skills, trader loyalty) is controlled by its own toggle : enabling a toggle clears the vanilla requirements of that type and injects your own. Leaving a toggle off leaves vanilla requirements completely untouched.

Ships with a default config that matches vanilla exactly, enabling the feature without changing anything produces zero difference in-game.

💠 Hideout Bonuses ( hideout/hideoutBonusesConfig.json )

Overrides the bonus values granted by hideout areas at each stage.

The file ships with all vanilla values pre-filled as a ready-to-edit baseline. Enabling it without changing anything should produces zero difference in-game.

What you can safely do

• Change Value on any existing entry : this is the intended use case.
• Set a bonus Value to 0 to effectively disable it without removing the entry.
• Set IsVisible to false to hide a bonus from the UI without disabling it.

⚠️ This is exactly the kind of section where you want to go slow. Make one change at a time, launch the game, confirm it works, then make the next one.

💠 Hideout Misc ( hideout/hideoutMiscConfig.json )

Smaller settings that apply globally across the hideout.

RequireFoundInRaid — Forces or removes the Found In Raid requirement on every item requirement across all areas and all stages.

UnlockHideoutCustomizations — Unlocks hideout customization items by category. Supported categories : Wall, Floor, Ceiling, Light, MannequinPose, ShootingRangeMark.

💠 Crafting ( hideout/craftingConfig.json )

Define custom crafting recipes per hideout area, and optionally wipe all existing recipes for specific areas before injecting your own. Recipes support area level requirements, production time, fuel requirements, and flexible input lists of items, tools, and area requirements.

Ships with a default config that matches vanilla exactly.

⚠️Modifying recipes on a server where crafts are already in progress is generally a bad idea, even if the changes don’t affect those specific crafts. Finish or cancel all active crafts before making changes.

📌 Injects items directly into bot pockets after generation. Supports bosses, boss followers, PMCs, and Scavs, each with their own independent loot pool configurable separately.

Why not just edit the loot pool ?

SPT’s native loot system assigns weights to items in a pool and rolls randomly when generating a bot. The higher the weight, the more likely an item is to appear, but it’s never guaranteed. This mod sidesteps that entirely by injecting items directly into bot pockets after generation, so you get exactly what you configured every time.

⚙️ How it works

The mod runs after the bot is fully generated and injects items in two passes:

1. Free slots first — empty pocket slots are filled first.
2. Overwrite SPT items — if all slots are full, SPT-generated items are replaced.

This guarantees your configured items always end up in the pockets, regardless of what SPT put there.

⚠️ Currently covers pocket injection only. Backpack and vest support may come later, but it’s not a priority right now.

⚠️ Only 1x1 items are supported. There are no safeguards but anything larger will most likely cause issues.

🔧 Configuration

Roles

Bot roles are fully configurable directly in the config file via BossRoles and FollowerRoles. Any role listed in BossRoles gets boss loot, any role in FollowerRoles gets follower loot. The Goon followers (Big Pipe, Birdeye) are in BossRoles by default.

Boss config

Bosses support two modes controlled by UseGlobalConfig:

• true — one config applies to all bosses
• false — each boss has its own pocket loot list via PerBoss

If UseGlobalConfig is false and a boss has no PerBoss entry, it falls back to Global automatically.

Per-item config

{ "Tpl": "59faff1d86f7746c51718c9c", "Chance": 100, "MinStack": 1, "MaxStack": 1 }

• Chance — 0 to 100. 100 = guaranteed, 0 = never drops.
• MinStack / MaxStack — Stack size range. A random value between the two is picked on each injection. Defaults to 1/1 if not specified. Automatically clamped to the item’s max stack size.

Items are processed in order, top to bottom. A failed chance roll does not consume a slot, the next item in the list gets a chance to fill it. Put your highest priority items first.

Overwrite priority

When all pocket slots are full and the mod needs to overwrite SPT items, it always targets the cheapest item first based on handbook price. This preserves the most valuable SPT loot as much as possible.

Overwrite blacklist

Items protected from being overwritten when the mod needs to make room. Two ways to blacklist:

• Tpls — Exact TPL match.
• Categories — Any item whose parent chain contains the category ID is protected.

💡 Blacklisted items are never touched, regardless of their handbook price.

🔀 How the sequential logic works

Say you have 4 pocket slots and configure 3 items, with SPT already filling 3 of them:

"Pockets": [
  { "Tpl": "Bitcoin",    "Chance": 100 },
  { "Tpl": "GP Coin",    "Chance": 50  },
  { "Tpl": "Lega Medal", "Chance": 30  }
]

1. Bitcoin — rolls 100%, passes. One free slot available → injected. ✓
2. GP Coin — rolls 50%, fails. Slot is not consumed → next item gets a shot.
3. Lega Medal — rolls 30%, passes. No free slots left → overwrites an SPT item. ✓

A failed roll never wastes a slot. Only a successful roll claims one.

💡 The injection loop stops as soon as all slots are claimed, either by your configured items or by SPT items that are blacklisted. If a bot has 4 pocket slots and 4 blacklisted SPT items, none of your configured items will be injected.

📌 Patches applied to character configuration.

💠 Health ( character/healthConfig.json )

BaseEnergyRegeneration / BaseHydrationRegeneration — Base regeneration rates for energy and hydration out of raid.

Body parts — Set the maximum HP for each body part independently. Any field left as null is left unchanged from the base profile.

ApplyToExistingSaves — When enabled, HP overrides are also written to existing save files on every server start. When disabled, changes only apply to new characters created after activation.

⚠️ Disabling this option later will not restore the previous HP values in existing saves.

💠 Weight Limits ( character/weightLimitsConfig.json )

Overrides the stamina weight thresholds that control when penalties start applying.

• BaseOverweightLimits — General threshold where stamina penalties begin.
• WalkOverweightLimits — Threshold where walk speed starts being reduced.
• SprintOverweightLimits — Threshold where sprinting becomes impossible.
• WalkSpeedOverweightLimits — Threshold where walk speed is fully capped.

X is the weight where the penalty starts, Y is where it reaches its maximum.

💠 Skills ( character/skillsConfig.json )

Overrides the progression parameters of any skill in the game. Each entry targets a named skill block (e.g. Crafting, Endurance, HideoutManagement) and sets individual properties within it.

The mod ships with a full pre-configured file covering every skill. The vanilla values are preserved by default, enable it with “Enabled”: true and adjust from there.

💠 Equipment Conflicts ( character/equipmentConflictsConfig.json )

Removes the blocking relationships between equipment slots, things like headwear preventing face covers.

The default config already ships with sensible settings : most slot combinations are unlocked, but broken ones (full helmet + face mask simultaneously, etc…) are kept blocked.

If you don’t want to dig into the details, just set Enabled to true at the top of the config and you’re done. The full breakdown of what each setting does is documented inside the config file itself.

⚠️ Not every possible equipment combination has been tested. If you run into a combo that should work but doesn’t, or one that shouldn’t work but does, feel free to report it.

💠 Special Slots ( character/specialSlotsConfig.json )

Controls which items can go into the 3 special slots on all pocket templates. Each entry has a Tpl and an Enabled toggle :

• true — Adds the item to the special slot filter, and sets it as non-discardable and non-insurable.
• false — Removes the item from the special slot filter.

The config ships with a handful of pre-configured entries. Toggle them on or off as needed, or add your own TPLs.

💠 Holster Slot ( character/holsterSlotConfig.json )

Expands the holster slot to accept additional weapon types. Each category is toggled independently, and sub-categories are included automatically. Individual TPLs can also be added directly for items outside any enabled category.

Categories — One toggle per weapon type.

AllowedTpls — Individual item TPLs added on top of whatever categories are enabled.

Both lists are combined : an item is allowed if it matches either one.

💠 Locale Overrides ( ui/localesConfig.json )

Force English items — Replaces all item names, short names, and descriptions with their English equivalents for non-English clients. A great way to teach your friends English without them realizing it xD

Force English maps — Same, for map names and descriptions.

Force English hideout — Same, for hideout area names and descriptions.

Force English traders — Same, for trader locale strings.

Locale overrides — Override any locale key with a custom string, applied to all languages including English. Keys can be anything found in SPT_Data\database\locales\global\en.json.

Trader locale overrides — Override trader names, nicknames, locations, and descriptions for all languages including English. Empty fields are ignored.

💡 Locale overrides take priority over Force English options and are applied last.

💠 Avatar Overrides ( ui/avatarsConfig.json )

Remap trader portrait images. Image files are placed in the db/ folder of the mod.

💡 After changing portraits, press Clean Temp Files in the SPT launcher before restarting. Without this step portraits won’t update.

💠 Client Config ( ui/clientConfig.json )

Controls various client-side UI behaviours. All options apply to every player on the server.

Skip side selection screen — Skips the PMC/Scav selection screen before raids.

Skip insurance screen — Skips the insurance selection screen before raids.

Skip raid settings screen — Skips the raid settings screen before raids.

Skip experience screen — Skips the experience summary screen after raids.

Category sort / Item sort / Alphabetical sort — Controls trader inventory sorting behaviour. Category order and item order can be defined explicitly via their respective lists.

💡 Client config is intentionally managed server-side rather than through a BepInEx F12 menu. The mod is designed around Fika : regular players have no business touching F12 config, and keeping everything in files makes it easier to push changes without asking everyone to reinstall anything. The only tradeoff is that a game restart is required after any change, which is fine.

⚠️ Category sort was put together quickly and may not be practical for every setup, it’s worth testing before committing to it. Item sort and alphabetical sort work reliably.

💠 Misc Settings ( miscSettings/miscSettingsConfig.json )

A collection of smaller quality of life patches.

Free post-raid heal — Removes the healing cost between raids.

Unlock all outfits — Unlocks all Ragman outfits without requiring quests or purchases.

Disable PMC mail responses — Suppresses the automatic chat messages from PMCs after kills.

Disable starting gifts — Disables the starting gifts sent by traders on character creation.

💠 Repair ( miscSettings/repairConfig.json )

No repair degradation — Removes max durability loss when repairing. Items are restored to their template maximum rather than their degraded maximum, completely eliminating the durability penalty that accumulates over successive repairs.

Repair kit buffs — Controls the bonus effects applied when using repair kits. Each equipment type (armor, vest, headwear, weapon) is configured independently. Two rarity tiers (Common/Rare) each support their own bonus types, value ranges, and active durability window.

For armor, vest and headwear the available bonus type is DamageReduction. For weapons : WeaponSpread, MalfunctionProtections, and WeaponDamage.

• RarityWeight — Relative probability of rolling Common vs Rare.
• BonusTypeWeight — Relative probability of each bonus type being selected.
• ValuesMinMax — The min/max range of the bonus multiplier value.
• ActiveDurabilityPercentMinMax — The durability window (% of max) within which the bonus is active.

💡 This section hasn’t been thoroughly tested yet.

💠 Log Config ( miscSettings/logConfig.json )

Controls which log channels are active. All channels are enabled by default. Once your config is dialed in, you can disable channels here to reduce console spam.

💠 The extras/ folder

The extras/ folder contains two reference files dumped from the SPT database :

• itemList.json — All item templates.
• categoryList.json — The full category hierarchy.

These are useful any time you need to look up a specific item TPL or category ID for use in config files. In many cases this is faster than using ItemFinder, since you can just Ctrl+F directly in the file and copy paste the tpl and the handbook price.

The dumps also include the full contents of WTT - Content Backport, so modded items and categories from that pack are covered as well.

⚠️ Use Notepad++ or VSCode to edit config files. The default Windows Notepad won’t warn you about syntax errors.

💡 My personal config is available on the repository if you want more concrete examples of what the mod can do.

Adds information on quests that will help you power through them quicker without ever alt-tabbing.

• Shows if a quest is required for Collector
• Shows if a quest is required for Lightkeeper
• Shows what keys are required for the quest
• Shows next quests in chain after the current quest
• Shows gun smithing parts required for gun smithing quests

Buy me coffee here!

Extract to the root of your SPT install as shown below

LiveBitcoinPricesREDUX

This mod dynamically updates the in-game price of Physical Bitcoin in SPT to match live Tarkov pricing.

• Supports SPT 4.0
• Rebuilt in C# for SPT 4.0
• Supports both PVE and PVP pricing modes through config
• Uses cached fallback data if the live API is unavailable
• Optional periodic updates can be enabled in config

Bitcoin price data is fetched live from Tarkov Dev.

Stay synced with live Tarkov Bitcoin pricing in your SPT setup.

1. Download and extract the mod archive.
2. Copy the included SPT folder into your main SPT directory.

Final structure should look like this:

SPT\user\mods\LiveBitcoinPricesREDUX\

That’s it. The mod will update Bitcoin pricing automatically on server start.

The mod includes:

• config/config.json — main settings
• config/price.json — cached price data used as fallback

Main options

• GameMode
  • "pve" = uses Tarkov PVE pricing
  • "pvp" = uses Tarkov PVP pricing
• EnablePeriodicUpdates
  • false = update on server boot only
  • true = keep updating on the configured interval
• UpdateInterval
  • update frequency in seconds when periodic updates are enabled
• EnableLogging
  • enables console logging
• Advanced.EnablePriceCaching
  • enables cached fallback pricing
• Advanced.CacheExpirationHours
  • max cache age before it is ignored
• Advanced.ApiTimeout
  • API timeout in milliseconds
• Advanced.UserAgent
  • custom user agent for requests

• Original mod by Shardbyte; this is an updated continuation.
• Original mod available here.
• This version has been converted from JavaScript to C# for SPT 4.0 compatibility.

Note: This mod focuses only on updating Physical Bitcoin pricing. It does not rebalance the wider economy.

One video speaks louder than thousand words: (also READ FAQ)

1. Download Addon “Essential Texture Pack”
2. But why are textures in the separate addon?
   • this way updating code won’t force you to redownload 100+ MB of textures
   • this allows everyone to make their own texture packs and share them on forge
3. How can I make my own texture pack?
   • Essential Texture Pack page describes it in detail
4. I don’t see camo editor
   • You clicked EDIT BUILD, try MODDING
5. Fika compatibilty?
   • You wont see camos of other players, but there won’t be any other issues
   • Maybe someone will make proper compatibility patch (not me)
6. Camo for armor/backpack/rig/helmet?
   • Nope, equipment is entirely different beast
7. Keep some weapon parts untouched by camo?
   • Maybe in the future
8. Keep paint attached to moving weapon parts (magazine, pistol slide, etc)?
   • Maybe in the future
9. Apply paint on part-by-part basis?
   • Maybe in the future
10. gif support?
    • Maybe in the future
11. Any keybinds to speed up edit process?
    • Check F12/7Bpencil.WeaponCamoAndStickers
12. Undo system?
    • 😭
13. I changed something and camo is now looking weird and its sliding across weapon surface
    • You made decal box too big. Try to scale it down (especially in green axis)
14. Camo editor UI is too small / too big
    • Check UI Scale setting in F12/7Bpencil.WeaponCamoAndStickers menu
15. Do guns returned by insurance retain their camo?
    • Nope, they are technically copies with different ids. Haven’t worked on synchronizing it
16. What mods have you used in the video?
    • Brighter Interiors
    • CloudSix - Volumetric Clouds
    • Smajlec’s Lights

Mod Overview

The base game only saves limited statistics (Overview page), while this mod accurately records complete combat logs for every match, including:

Kills View in match details page

• Specific weapon used
• Hit location (head, chest, limbs, etc.)
• Type of target killed (PMC, Scav, Boss, Scav Boss, Boss guard, etc.)
• Time the target was killed

Loot View in match details page

• List of items brought into the match and items taken out
• Items newly found in the match, items lost, and changed items (increased bullet count, decreased durability of medical supplies and weapons, etc.)

Match Earnings View in match details page / View in record list page

• Match map information, match playtime

• At the start of the match:

  • Combat Readiness Value (similar to Delta Action, calculates the combined value of weapons, rigs, backpacks, armor, etc.)
  • Secure Container value (total value of all items in the Secure Container, often accounting for a large portion)
  • Total value brought in (equals Combat Readiness Value + Secure Container value + value of items in backpack, rig, pockets, and special slots)

• When leaving the match:

  • Total value extracted (gross profit)
  • Losses (consumed items, discarded items, durability loss, etc.)
  • Net profit (gross profit - losses)

• Match result:

  // Theoretically includes these:
  public enum ExitStatus
  {
    SURVIVED,
    KILLED,
    LEFT, // Left the match (via the in-game Esc menu option)
    RUNNER,
    MISSINGINACTION,
    TRANSIT,
  }
  

• If survived/transited/rushed extraction: Extraction point information, playstyle information

• Otherwise: Information about which faction and which enemy (name not important except for bosses) eliminated you using what weapon and which limb was hit.

Prices View in the Prices page

This feature leans towards debugging, primarily used to verify if the mod’s calculated prices are correct. It can also be used for fuzzy searching of item names and IDs related to keywords, and for purchasing FIR items for quests.

Quick Loadout View in match details page / View in record list page

Quickly purchase the equipment used when entering a specific match. You can filter for specific required equipment categories.

Exception Handling

• The mod records data on the server side. If the server crashes for reasons unrelated to this mod before the match ends, as long as it doesn’t crash immediately after the client finishes the match, restarting the server still has a high probability (>90%) of correctly recording the match data.
• If you Alt+F4 after a match starts or the client crashes, launching the next game will cause the cached result of that match to be recorded as an unknown outcome.

Record List Page

WebUI Homepage

Accessing the WebUI

· Method 1 (Quick Jump): In the console, find the line [RaidRecord] WeiUI run at https://127.0.0.1:6969/RaidRecord, hold down the Ctrl key and left-click the link. The browser will automatically open the corresponding page. · Method 2 (Manual Entry): Open any browser, manually enter the address displayed in the console (e.g., https://127.0.0.1:6969/RaidRecord) into the address bar, and press Enter to access it.

Installation Method

The installation is simple. Just extract the .7z file to your SPT game root directory. After installation, your file structure should look like this:

Your SPT Game Root Directory\SPT\user\mods\RaidRecord\(any mod files)

Credits

• Thanks to the SPT team for providing the framework and documentation.
• Thanks to DrakiaXYZ, HiddenCirno, jbs4bmx, GhostFenix̵̮̀x̴̹̃©, Dsnyder | WTT, and all other developers in the community for sharing their experience, code, and patiently answering questions.
• Thank you for downloading and trying out this mod.

Settings

1. Recommended method: Change directly in the WebUI.

   

2. Go to …/SPT/user/mods/RaidRecord/db and open “config.json”.

3. Set local to the two-letter name of a translation file that exists in the db/locals folder, e.g., “cn”.

   If changing the language has no effect, clear the local cache in the Launcher and restart the client.

4. Set logPath to change the output directory for some logs within the mod (to prevent mod error messages from cluttering the SPT server logs).

5. Set autoUnloadOtherLanguages to enable the optimization feature for multi-language support starting from 0.6.4.

6. Set priceCacheUpdateMinTime to change the update interval for the mod’s price cache. This setting does not affect the price command, which will always get the price calculated by the mod immediately.

7. Set modGiveIsFIR to modify whether items given by the mod (when purchasing items via the mod, quick loadout) are FIR (Found in Raid) status.

Database Description

…/SPT/user/mods/RaidRecord/db folder

~0.6.1 The locals folder contains translation files. The records folder (created after running the mod) contains record files for different accounts. config.json saves the mod configuration.

For installation and database compatibility, refer to the details in the Version section of this mod.

Command System

All commands and parameters are case-insensitive, but it is recommended to use lowercase letters. Command usage: commandkey parameter1 parameter1value parameter2 parameter2value suffixparameter String-type parameter values can be enclosed in half-width English double quotes to include spaces.

After entering a match, find a friend named Raid Record Manager and send help to get command help information.

The current version supports the following commands:

• help: Get help information for all commands.
• cls: Clear the chat history in the dialog (recommended to use frequently).
• info: Get earnings, kills, and other information for a specified match.
• items: Get the loot changes or brought-in/taken-out list for a specified match. Can be limited to output items whose price change falls within the [ge, le] range.
• list: List all existing match records. Later pages contain newer matches. You can adjust the number of items per page using the limit parameter.
• price: Get the value of a specified item, or perform a fuzzy search for multiple item values by name.
• buy: Quickly purchase the equipment used when entering a specified match (in-game, entering buy can quickly purchase the equipment from the last match).

Localization Method

AI-Assisted Translation

1. Make a copy of ch.json or en.json, rename it to the two-letter name of the target language, e.g., “cz.json” (best to correspond with the name of Game Folder\SPT\SPT_Data\database\locales\global**.json).
2. Send the translation file to the AI and ask it to translate while preserving the format.
   • If the AI modifies any translation keys, interrupt it and instruct the AI to only translate the JSON values.
   • If the AI modifies anything inside {{}}, interrupt it and instruct the AI not to translate {{}} or the values inside them.
3. Verify that the translation results are correct. The above steps should translate over 70% of the content.
4. Check whether the column variables in the tables under the "translations" key correspond with their names to prevent the AI from altering word order (changing column and table names together is acceptable).
5. Check for missing \n.

Manual Translation

1. Find translations in Game Folder\SPT\SPT_Data\database\locales\global\**.json.
   • “roleNames”: Search for BotRole and ScavRole.
   • “armorZone”: Search for DeathInfo, Collider Type (recommended), Armor Zone, HeadSegment.
2. If you urgently need to use commands, prioritize translating values under “translations”.
3. If you urgently need to view logs output by the server, prioritize translating values under “serverMessage”.

模组概述

原版游戏仅保存有限统计数据(总览页面), 而本模组精准记录每一场对局的完整战斗日志, 包括:

击杀

对局详情页面查看

• 使用的具体武器
• 命中部位(头部、胸部、四肢等)
• 击杀目标类型(PMC、Scav、Boss、Scav Boss、Boss 带的守卫等)
• 击杀目标的时间

物资

对局详情页面查看

• 带入对局的物品与带出对局的物品清单
• 这场对局中新搜到的物资, 损失的物资, 变化的物资(子弹数量增加, 药品与武器耐久减少等)

对局收益

对局详情页面查看 / 战绩列表页面查看

• 对局地图信息, 对局游玩时间

• 对局入场时的

  • 战备价值(类似三角洲行动, 计算武器, 弹挂, 背包, 护甲等装备的价值和)
  • 安全箱内价值(安全箱内所有物资总价值, 有不少情况下, 这里的价值占非常大的比率)(Scav模式为0)
  • 总的带入价值(该值等于战备价值+安全箱内价值+背包弹挂口袋特殊插槽内的物品价值)

• 离开对局时

  • 带出总价值(算是毛利润)
  • 战损(使用物品消耗, 丢弃物品, 耐久损耗等)
  • 净利润(毛利润-战损)

• 对局结果

  // 理论上有这些:
  public enum ExitStatus
  {
    SURVIVED, // 幸存
    KILLED, // 被击杀
    LEFT, // 离开对局(指客户端Esc后那个选项)
    RUNNER, // 匆匆撤离
    MISSINGINACTION, // 迷失
    TRANSIT, // 转移
  }
  

• 如果幸存/转移/匆匆撤离 : 撤离点信息, 游戏风格信息

• 其他情况: 被哪个阵营的哪个敌人(除了boss, 名称不重要)使用什么武器命中你哪个肢体淘汰你的信息

价格

在价格页面查看

该功能偏向调试, 主要用于验证模组计算的价格是否正确, 也可以用于模糊搜索与关键词相关的物品名称与ID, 以及购买FIR物品过任务

快捷起装

对局详情页面查看 / 战绩列表页面查看

可以快速购买指定对局进入对局时的装备 可以筛选指定需要的装备类别

意外情况处理

• 模组会在服务端记录数据, 如果对局结束前服务端在非本模组原因下崩溃, 只要不是客户端刚对局结束时服务端就崩溃, 重启服务端仍然有概率(>90%)正确记录对局数据
• 对局启动后Alt+F4或者客户端崩溃, 下一次启动战局后会导致记录的该战局的缓存对局结果被记录为未知结局

对局列表页面

WebUI主页

访问 WebUI

· 方法一（快捷跳转）： 在控制台找到 [RaidRecord] WeiUI run at https://127.0.0.1:6969/RaidRecord 这一行，按住 Ctrl 键并用鼠标左键点击该链接，浏览器会自动打开对应页面。 · 方法二（手动输入）： 打开任意浏览器，在地址栏手动输入控制台中显示的地址（如 https://127.0.0.1:6969/RaidRecord），然后按回车键访问。

安装方式

安装方法很简单, 只需将 .7z 文件解压到您的SPT游戏根目录即可 安装完成后，您的文件结构应如下所示：

你的SPT游戏根目录\SPT\user\mods\RaidRecord\(模组的任何文件)

致谢

• 感谢SPT团队提供的框架与文档。
• 感谢DrakiaXYZ, HiddenCirno, jbs4bmx, GhostFenix̵̮̀x̴̹̃©, Dsnyder | WTT以及其他所有在社区中分享经验、代码与耐心解答问题的开发者们。
• 感谢您下载并尝试本模组。

设置

1. 推荐方案, 直接在WebUI更改

   

2. 前往…/SPT/user/mods/RaidRecord/db 并打开“config.json”

3. 设置local为db/locals文件夹下存在的翻译文件的二位名称, 例如“cn“

   更改任何语言后如果无效, 应该在Launcher清理本地缓存后再启动客户端

4. 设置logPath以更改模组内一些日志的输出目录(这是为了避免模组报错信息导致SPT服务端日志过于繁琐的问题)

5. 设置autoUnloadOtherLanguages, 以启用0.6.4开始的对多语言化的优化功能

6. 设置priceCacheUpdateMinTime, 以更改模组价格缓存的更新间隔, 该设置不会影响price命令, price只会立刻获取当前模组计算的价格

7. 设置modGiveIsFIR, 以修改模组给的物资(在模组购买物品, 快速起装)是否是FIR(对局中发现(带勾))状态

数据库说明

…/SPT/user/mods/RaidRecord/db 文件夹

~0.6.1 locals文件夹下为翻译文件 records文件夹(运行过模组后才会创建)为不同账户的记录文件 config.json保存模组配置

安装与数据库的兼容性参考本模组的Version中的详细信息

命令系统

所有命令和参数对大小写不敏感, 但推荐全部使用小写字母 指令使用方式为命令键 参数1 参数1的值 参数2 参数2的值 尾缀参数 字符串类型参数的值可以用半角英文双引号包起来以输入空格

进入对局后, 找到一个名为对局战绩管理的好友, 对他发送help以获取指令的帮助信息

当前版本支持以下指令:

• help: 获取所有命令帮助信息
• cls: 清理对话框聊天记录(推荐多用用)
• info: 获取指定对局收益, 击杀等信息
• items: 获取指定对局物资变化或带入带出清单, 可以限定只输出价格变化量处于[ge, le]之间的物品清单
• list: 列出当前已有的所有对局记录, 页数越靠后, 对局越新; 可以通过limit参数调整每页显示数量
• price: 获取指定物品价值, 或者通过名称模糊搜索多个物品价值
• buy: 快速购买指定对局进入对局时的装备(局内可以输入一个buy快速购买上局装备)

本地化方式

AI辅助翻译

1. 复制一份ch.json或en.json, 重命名为对应语言的二位名称, 例如“cz.json“(最好与Game Folder\SPT\SPT_Data\database\locales\global**.json)的名称对应
2. 将翻译文件发送给AI, 要求它保留格式的翻译;
   • 如果AI进行了任何翻译键的操作, 打断他, 并在提示词中要求AI只翻译json的值
   • 如果AI修改了任何{{}}中的内容, 打断他, 并在提示词中要求AI禁止翻译{{}}与其中的值
3. 验证翻译结果是否正确, 上述操作基本能进行70%以上的翻译
4. 检查翻译文件"translations"键下的各个表的列的变量是否与名称对应, 以防止AI改变语序(列名和表名顺序一起改变是可以的)
5. 检查是否漏了\n

手动翻译

1. 可以在Game Folder\SPT\SPT_Data\database\locales\global\**.json通过找到的翻译
   • “roleNames”: 搜索BotRole和ScavRole
   • “armorZone”: 搜索DeathInfo, Collider Type(推荐), Armor Zone, HeadSegment
2. 急需使用命令, 优先翻译“translations“下的值
3. 急需查看服务端输出的日志, 优先翻译“serverMessage“下的值

IF UPDATING FROM v4.2.2 - READ VERSION INFO BEFORE UPDATING!

A full rework of the original CNN-Containers mod, ported and updated for SPT 4.0.X. Adds 9 specialized containers for organizing your stash and taking essential supplies into raids — tiered across trader loyalty levels so new players get affordable starter storage while larger containers are gated behind higher loyalty.

All containers are configurable via a config file. You can enable/disable individual containers, adjust trader prices and loyalty levels, resize container grids, set custom flea market prices, add extra allowed/excluded item filters, and rename/translate containers.

1. Download and extract the mod zip into your SPT directory.

2. Launch the game.

1. Download and extract the mod zip into your SPT directory, overwriting when prompted.

2. Open the SPT launcher’s settings and click “Clean Temp Files” before launching.

Note: v4.3.0 will have breaking changes for some who already have the mod installed - READ THE RELEASE NOTES BEFORE UPDATING!

Edit config/config.jsonc to customize the mod. You can:

• Enable or disable individual containers
• Change trader prices and loyalty levels
• Resize container grids (except the Mapbook, which uses fixed slots)
• Resize each of the Onyx’s 3 grids independently
• Set custom flea market prices (separate from trader prices)
• Add extra allowed item filters per container (for mod compatibility, e.g. Pack ‘n’ Strap)
• Add excluded item filters (e.g. block specific cases from going inside the Wooden Box)
• Rename or translate container names, short names, and descriptions

Optional settings are commented out below each container in the config - just uncomment and edit.

WARNING: Disabling a container or changing its grid size after you’ve already used it in your profile (items stored inside) can cause profile corruption or item loss. Only change these settings on a fresh profile or after emptying the affected containers.

Tier 1 — Starter storage:

• Recycled Ammo Bag (2x2)

  • Holds ammunition, fits inside Secure Containers.
  • Trader: Prapor LL1 - 75,000₽

• Recycled FAK (3x3)

  • Holds medical items, fits inside Secure Containers.
  • Trader: Therapist LL1 - 85,000₽

• Small Portable Fridge (2x3)

  • Holds food items, fits inside Secure Containers.
  • Trader: Jaeger LL1 - 38,000₽

• Small Toolbox (4x6)

  • Holds tools/barter items.
  • Trader: Skier LL1 - €500

Tier 2 — Mid-level storage:

• Mod Case (6x5)

  • Holds weapon mod items.
  • Trader: Peacekeeper LL2 - $1,200

• Secure Mapbook (slot-based)

  • Slot-based container for maps, fits in Secure Containers and Special Slots.
  • Trader: Therapist LL2 - 65,000₽

• Ruined Wooden Box (8x6)

  • General-purpose storage crate that accepts any item.
  • Trader: Jaeger LL2 - 1,000,000₽

Tier 3:

• Gear Box (10x8)

  • Holds clothing (vests, rigs, backpacks, etc).
  • Trader: Ragman LL3 - 850,000₽

Tier 4:

• Secure Container Onyx (2x3 + 3x4 + 1x2)

  • Premium secure container with 3 grids. Follows default excluded items.
  • Trader: Peacekeeper LL4 - Barter: Kappa + $85,259

The Onyx is listed twice with Peacekeeper - one with the Kappa as a barter, the other with the Desecrated Kappa variant.

The Mod Case and Ruined Wooden Box models display with pink/purple textures (missing shaders). The bundles were built for an older Unity version and need to be recompiled for SPT v4.0’s Unity version. Functionally they work fine.

This mod is provided as-is, with no official support.

This mod is licensed under the MIT License. Please refer to the LICENSE file included in the archive for full details.

Original mod by Cannuccia.

Updated for SPT 3.11.X by AMightyTank.

Secure Mapbook by MrVibesRSA.

Container Onyx (Re-Upload) by Dsnyder.

Testing and feedback by TheSunGod.

Ported and reworked with additions for SPT 4.0.X by Dildz.

Tarkov has hundreds of quests. Even without mods, the quest list quickly becomes overwhelming — you don’t know what to prioritize, which weapon to bring, or which map to play.

MissionControl picks 3 random quests from the ones you’ve unlocked and hides the rest. Complete one, a new one appears from your unlocked pool. Stuck? Buy a reroll at Prapor to get fresh picks.

By default, only vanilla quests are filtered. Modded quests are always visible and don’t consume slots. You can change this in the config.

Key features:

• Only 3 quests visible at a time, randomly picked from your unlocked quests
• Complete a quest → a new random one appears instantly
• Reroll at Prapor — buy the Mission Reroll item to get 3 fresh picks. Stuck quests stay visible but stop consuming slots
• Trader whitelist — some traders’ quests are always visible (configurable by name)
• Per-profile persistence across server restarts
• Safe for existing profiles — remove the mod and all quests come back

Extract the zip in your SPT root folder:

The client plugin handles quest list refresh after completing a quest and after purchasing a reroll.

Edit SPT/user/mods/MissionControl/config/config.jsonc:

If a trader name in the whitelist is not found, the server log will list all available trader names.

Buy the “Mission Reroll” item at Prapor (Loyalty Level 1, 50,000₽ by default).

What happens:

1. Your current in-progress quests become exempt — they stay visible but stop counting toward the slot limit
2. 3 fresh random quests are picked from your unlocked pool
3. The game reloads your profile automatically

Why? If you’re stuck on 3 difficult quests and can’t progress, the reroll lets you get new ones without abandoning the old ones. You temporarily have more than 3 active quests until you finish the old ones.

Install → play. That’s it.

From all the quests you’ve unlocked (met the level/prerequisite requirements), MissionControl randomly picks a few and hides the rest. The selection is persistent — you see the same quests until you complete them or buy a reroll.

Quest slots:

• You have 3 slots (configurable). In-progress and available quests both count
• 0 quests accepted → 3 random available quests shown
• 1 quest accepted → 2 random available quests shown
• 3 quests accepted → no new quests shown until you complete some
• Complete a quest → a new random one fills the slot immediately
• Failed quests stay in their slot (restart from the UI)

After a reroll:

• Old in-progress quests stop counting toward slots (they’re “exempt”)
• 3 new quests fill your slots
• Finishing an exempt quest → it disappears, no new slot opens
• Finishing a new quest → a fresh random one takes its place

Modded quests (default behavior):

• Modded quests are always visible and never consume slots
• Only vanilla quests are subject to the slot limit
• Change this with filter_modded_quests: true

Nothing is permanent. Remove the mod and all quests return to normal. Safe for existing profiles.

• SPT 4.0.x
• Works with any quest mod — modded quests are detected automatically
• Works with custom traders — whitelist by name
• Safe for existing profiles — if you have more quests accepted than max_slots, no new quests are shown until you drop below the limit

Report them on GitHub.

If you enjoy MissionControl and want to support my work, feel free to buy me a coffee!

All my mods are free and open source. Your support keeps me motivated to create more!

Malfunction Overhaul

• Skip Inspection Before Clearing

  • Allows players to clear a weapon malfunction immediately using the clear keybind, bypassing the requirement to visually inspect the weapon first.

• Remove Boss Forced Malfunctions

  • Prevents bosses (such as Kollontay) from triggering scripted, forced weapon malfunctions on the player’s active firearm. This ensures that jams are only caused by weapon condition or ammunition stats.

These can be adjusted in the BepInEx config (F12)

• The Saiga12K now has a Full Auto mode. (be careful with the recoil ಠ_ಠ) Full auto version exists in the game now.

• The ETMI-019 and Kiba Arms SPRM rail mounts are now compatible with more optics and mounts.

• The semi-automatic mode of the Benelli M3 has been slightly adjusted, similar to other semi-automatic shotguns in the game, such as the MP-155 and MP-153.

• AA-12 -> Increased the cyclic rate of fire to 450 RPM.

• Now you can put the Kiba Arms SPRM rail mount and the AK GP-25 accessory kit recoil pad in the KS-23M.

• Now the saiga-12k can use most of the AKs handguards.

• The ETMI-019 and Kiba Arms SPRM rail mounts can now be equipped on the MTs-255

KS-23M 6-shell magazine:

MP-153 competition 13-shell magazine:

SOK-12 12/76 Alliance Armament 30-round magazine:

Benelli M3 M-LOK Keymod Handguard:

MP-12 Single Shot Shotgun:

MP-700 .700 Nitro Express Double Rifle:

1. Download the makeshotgunsgreatagain.zip.
2. Drag and drop the files directly into the root folder of your SPT installation.
3. The folders should merge automatically. If you get a prompt to overwrite files, say yes.

Benelli M3 Handguard by zzzs570

SOK-12 12/76 Alliance Armament 30-round magazine by HyHylie - “The Fiery Demise”

12/70 Winchester Super-X 00 Buckshot by Guy in a Poncho (@ponchoguy) - Sketchfab

12/70 Flechette, AP and Magnum express by deadcomrade - Sketchfab

Gcr357 for helping me with some models

Issues? Open one HERE

WTT-ContentBackport brings 1.0 content to SPT 4

This mod adds virtually EVERY new item, clothing, hideout customization, voice line, and character head from the 1.0 release. If you’ve been curious what the live version added, it’s all here.

Content Added:

• All new weapons, attachments, and gear
• Character customization (heads, clothing, voices)
• Hideout upgrades and decorations
• Barter items, food, and medical supplies
• New ending environments + Miami environment
• Custom WTT Achievements for unlocking some of the exclusive items

We couldn’t backport everything—here’s what’s missing:

• Live Achievements + Quest content. No main story (yet?)
• New prestige levels UPDATE NOW THERE’S A MOD FOR THAT :0 https://forge.sp-tarkov.com/mod/2540/content-backport-prestiges#versions
• Terminal, and any reworked maps (labs, interchange, ect)

What we did rebuild:

All automatic weapons were reconstructed from scratch to work properly in SPT. BIG shoutout to Eco and Eukyre for undertaking this project.

Option 1: Achievements - We’ve added achievable unlock conditions for Twitch drops, preorder content, and other exclusive items. Earn them naturally as you play. You can see these achievements in your achievements tab, as well as the unlock conditions for each.

Option 2: Cheat Codes - Use Commando commands to unlock everything instantly. Open a chat with “Commando” in your friends list, type help to Commando to see all available commands. If there is no Commando in your friends list, you more than likely have Fika installed disabling Commando from being used. These achievements are HIDDEN, the ONLY way to see what they do is to use them. FAFO

Example command:

spt nikitasvoice

Unlocks Nikita’s voice for your faction (BEAR/USEC).

Note: Some unlocks require a game restart. Menu refresh is needed before achievements display on your character if they’re earned via cheats. We’re actively working on a solution to both issues.

This wouldn’t exist without our team:

• EpicRangeTime - Project setup, item balancing, backend compatibility work
• Eco - Rebuilt all weapons from scratch with soundbank changes
• Eukyre - Custom sound design for backported weapons, json coder extraordinaire
• Pigeon - His one single broken commit (kidding, i just love poking fun at him)
• Crackbone - Adding items to static loot because nobody else wanted to

Demonstration Video (Yes, it’s Live Flea Prices, but the same concept applies to all of my mods, I’m not making mod-specific extraction example videos):

What is Welcome To Tarkov?

Welcome To Tarkov (WTT) is a mod for SPT AKI that has been in development for over a year. What started as a small passion project has grown in size to incorporate 15+ core members as well as contributions from other well-known mod authors and friends of WTT alike.

How does Welcome To Tarkov change the game?

As a mod, WTT overhauls SPT AKI, touching on almost every vanilla game system, as well as adding completely new systems to the game and its core mechanics. Inspired by open-world hardcore survival projects like STALKER: Anomaly and STALKER: GAMMA, WTT takes SPT’s artificial multiplayer MMO difficulty adders and replaces them with a challenging world economy, loot scarcity rebalancing, a lore friendly quest overhaul, and a map-traveling system built from rewritten portions of the Traveler mod allowing seamless travel between maps. Aside from its changes to the game’s core properties, WTT also adds to the world’s variety of traders, NPC’s, characters, items, and quests:

• Over 1,000 custom bundles adding new weapons, attachments, wearables, containers, food, medical, and barter items.
• New bosses with their own custom gear that will be properly incorporated into WTT’s quest lines.
• New, meaningful traders with their own lore-friendly quests and narrative elements to help the player progress through the story-line of WTT.
• New playable characters and outfits that will add to the player’s customization abilities.
• New quest types incorporating brand new map extraction points, putting the player’s knowledge and familiarization of SPT’s maps to the test.

Welcome To Tarkov stands as one of the largest mods created for SPT AKI thus far.

When does Welcome To Tarkov release?

Thursday.

Which Thursday?

TBD

Want to follow our progress?

You can follow the project through it’s development in our discord here:

https://discord.gg/WelcomeToTarkov

DISCLAIMER: YOU CANNOT INCLUDE THIS MOD IN YOUR RELEASES - ONLY LIST IT AS A DEPENDENCY

WTT-CommonLib is a comprehensive modding library for SPT (Single Player Tarkov) that streamlines the creation and integration of custom content in Escape from Tarkov. It automatically handles both server-side database changes and client-side resource loading, allowing mod authors to add new items, quests, loot, character assets, crafting recipes, and more with simple service calls and straightforward JSON configuration.

Key Features:

• Custom items with helpers to integrate into traders, loot containers, hideout areas, and more
• Custom quests and quest zones
• Character customization (heads, voices, clothing)
• Lootspawn system for random loot items and forced quest items
• Hideout crafting recipes
• Multi-language localization
• Custom buff effects, inventory profiles, weapon presets, rig layouts, and more!

For detailed implementation guides and full API documentation, see the README on GitHub.

What is Welcome To Tarkov?

Welcome To Tarkov (WTT) is a mod for SPT AKI that has been in development for over a year. What started as a small passion project has grown in size to incorporate 15+ core members as well as contributions from other well-known mod authors and friends of WTT alike.

How does Welcome To Tarkov change the game?

As a mod, WTT overhauls SPT AKI, touching on almost every vanilla game system, as well as adding completely new systems to the game and its core mechanics. Inspired by open-world hardcore survival projects like STALKER: Anomaly and STALKER: GAMMA, WTT takes SPT’s artificial multiplayer MMO difficulty adders and replaces them with a challenging world economy, loot scarcity rebalancing, a lore friendly quest overhaul, and a map-traveling system built from rewritten portions of the Traveler mod allowing seamless travel between maps. Aside from its changes to the game’s core properties, WTT also adds to the world’s variety of traders, NPC’s, characters, items, and quests:

• Over 1,000 custom bundles adding new weapons, attachments, wearables, containers, food, medical, and barter items.
• New bosses with their own custom gear that will be properly incorporated into WTT’s quest lines.
• New, meaningful traders with their own lore-friendly quests and narrative elements to help the player progress through the story-line of WTT.
• New playable characters and outfits that will add to the player’s customization abilities.
• New quest types incorporating brand new map extraction points, putting the player’s knowledge and familiarization of SPT’s maps to the test.

Welcome To Tarkov stands as one of the largest mods created for SPT AKI thus far.

When does Welcome To Tarkov release?

Thursday.

Which Thursday?

TBD

Want to follow our progress?

You can follow the project through it’s development in our discord here:

https://discord.gg/WelcomeToTarkov

Requires WTT-CommonLib

Make Meds Great Again! is a mod that lets your PMC move while performing surgeries, so you’re not a sitting duck every time you patch up. It also allows you to sprint while healing. Customize HP values for medkits, as well as the number of uses for painkillers, bandages, and other medical items.

Walking in surgery

Running while healing

1. Download the MakeMedsGreatAgain-xxx.zip.
2. Drag and drop the files directly into the root folder of your SPT installation.
3. The folders should merge automatically. If you get a prompt to overwrite files, say yes.

Debug Mode

• debug (true or false): Enable this to see detailed logs in the server console about which items are being modified and if the configuration is loading correctly.

General Consumables (Usage Counts)

You can define how many times each item can be used before it is consumed. Set these to a whole number:

• Usage Settings:
  • calocUsage (Caloc-B)
  • armyBandageUsage (Army Bandage)
  • analginPainkillersUsage (Analgin Painkillers)
  • augmentinUsage (Augmentin)
  • ibuprofenUsage (Ibuprofen)
  • vaselinUsage (Vaseline)
  • goldenStarUsage (Golden Star Balm)
  • aluminiumSplintUsage (Alu Splint)
  • normalSplintUsage (Splint)
  • esmarchUsage (Esmarch)
  • catTurniquetUsage (CAT)
  • survivalKitUsage (Surv12)
  • cmsUsage (CMS)

Advanced Medkit Customization

Each major medical kit (Grizzly, Salewa, IFAK, AFAK, Car Kit, AI-2) can be individually configured.

NOTE If the [medkit]Changes property (e.g., grizzlyChanges) is set to false, the mod will ignore that specific kit and it will keep its default vanilla values.

Common Properties for All Medkits:

Replace [medkit] with the kit name (e.g., grizzly, salewa, ifak, etc.):

• [medkit]Changes (true/false): toggles the mod’s changes for this kit.
• [medkit]HP (Number): The total resource points of the kit.
• [medkit]CanDoSurgery (true/false): If true, this kit can restore “blacked out” (destroyed) limbs like a CMS or Surv12.
• [medkit]SurgeryCost (Number): How many resource points are consumed to perform a surgery.
• [medkit]CanHealHeavyBleeding (true/false): Ability to stop heavy bleeds.
• [medkit]HeavyBleedingHealCost (Number): Resource cost to heal a heavy bleed.
• [medkit]CanHealLightBleeding (true/false): Ability to stop light bleeds.
• [medkit]LightBleedingHealCost (Number): Resource cost to heal a light bleed.
• [medkit]CanHealFractures (true/false): Ability to fix broken bones.
• [medkit]FractureHealCost (Number): Resource cost to fix a fracture.

Example config.json Snippet

  "salewaChanges": true,
  "salewaHP": 450,
  "salewaCanHealFractures": true,
  "salewaFractureHealCost": 100,
  "salewaCanHealHeavyBleeding": true,
  "salewaHeavyBleedingHealCost": 175,
  "salewaCanHealLightBleeding": true,
  "salewaLightBleedingHealCost": 40,
  "salewaCanDoSurgery": true,
  "salewaSurgeryCost": 400

In-Game Configuration

Two settings can be adjusted in-game using the BepInEx Configurator (press F12) :

• Can walk in surgery: Enables or disables walking while performing surgery.
• Can sprint using meds: Enables or disables sprinting while using medical items.

• If you enable Surgery in a medkit (e.g., Grizzly) and disable the “Can walk during surgery” option in the BepInEx configurator (F12), your player will stop walking (similar to CMS and Surv12).

• Not So Realistic - SPT Mods Workshop - My other mod (This mod includes all the features of this mod)
• Medical Attention - SPT Mods Workshop

• Continuous Healing by Lacyway
• Healing Autocancel by IhanaMies

• Jehree -> Big thanks to Jehree for the incredibly helpful Client Modding Quick Start Guide, which made this mod possible!
• NoNeedName-> Thanks for the Slightly Boosted Meds mod, which served as a great example and inspiration!
• Cj and Lacyway -> Also huge thanks to these legends for helping me find the classes to patch and answering countless questions.

Configurable Categories:

Stash and items

Hideout

Traders

Trader Services

Loot

Skills and Experience

Raid options

Flea market

Repeatable quests

Case Space Manager

SCAV:

Bots

PMC

Advanced Features

Install .Net 9 by using this link: Click Me
Install 7ZIP [https://www.7-zip.org]

Installation: Download the .7z archive from github releases, unpack it in folder where your game executable located. Run Greed.exe to configure your settings, manual is included inside the app.

Uninstall: Delete Greed.exe, delete [SVM] ServerValueModifier folder in SPT/user/mods If you utilised CSM plugin - delete HideSpecialIcon.dll from BepInEx/Plugins

Server terminal says I am missing a loader. What should I do?

Really, you didn’t manage to read all of the messages it told you to do in server terminal?

SVM doesn’t have a default configuration file. If you haven’t applied any kind of settings, then the mod disables itself.

Create a preset and then apply it. Be sure loader.json have been created in Loader folder, so is preset in Preset Folder.

My pockets have disappeared!

Data related to your pockets’ structure is stored inside SVM.

Removing SVM from the modlist removes your pockets.

If you want to remove SVM from your modlist – Run SVM once with Case Space Manager disabled,

Then run the game, load into a profile and only afterward close the game and delete SVM.

How does level scale reward works?

Each level margin has own set of possible rewards and their chances, for example:

When your PMC level is 25, daily quest completion will reward you with:

~32k roubles, 6GP coins and 5 items.

If you were over level 30, you’d have bigger rewards, vice versa if you were level 19.

You can adjust both levels, and rewards fields.

You have to keep the amount of level ranges and reward sets within same amount.

How does Skill Leveling efficiency works?

Taken from the Escape from Tarkov Wiki:

Each skill has a leveling speed modifier depending on how many full skill points have been earned recently in the raid:

1. 129%: Before the first skill point, the leveling speed is at 129% (denoted by a blue arrow ).

2. 100%: After the first skill point, the leveling speed is normal or 100% (denoted by the lack of an arrow).

3. < 100%: After the first 2 skill points, the leveling speed is calculated using the formula

0.6 ^ (Earned Points - 1) * 100, where earned points are rounded down to the nearest digit

(e.g. 0.6 ^ (2 - 1) * 100 = 60%; denoted by a red arrow ).

After not earning any skill points for 200 seconds, the modifier is reset for that skill.

Keep in mind that unlike at the start of the raid, the earned points counter

is set to 1 in this case, which means you don’t start with the 129% modifier

but with the 100% modifier.

List of SVM’s custom IDs to be used:

a8edfb0bce53d103d3f62b9b Custom PMC Pockets

a8edfb0bce53d103d3f62b0b to a8edfb0bce53d103d3f62b3b are Grids IDs (increment on 2nd digit from the end)

a8edfb0bce53d103d3f62b4b to a8edfb0bce53d103d3f62b8b is Slots (increment on 2nd digit from the end)

a8edfb0bce53d103d3f6219b Custom SCAV Pockets

a8edfb0bce53d103d3f6229b to a8edfb0bce53d103d3f6259b (increment on 3rd digit from the end)

Advanced Features:

What is Individual Item Changer?

This feature will allow you to change mostly anything related to items.json.

It will take an effect after all the other settings in ‘Items and Stash’.

For easy item browsing I recommend using the Item Finder, the link for which is in “Discord and Website Links” above. Be advised, first _props/Properties shouldn’t be declared,

but it will require internal grids and slots structures.

The order of applying changes go this way – Parent IIC, Default IIC

Price changer is independent and is not affected by the rest.

You can insert values and arrays of values using this structures:

For Default IIC and Parent IIC

ID:Property:Value

ID:Property:[Array,Of,Values]

ID:Structure:Property:Value

ID:ExternalStructure:Array:InternalStructure:Property:Value

Most structures can support expressions: add, subtract, division, multiplication and equals (+,-,/,*,=)

ID:Property:Expression:Value

String based structures can support expressions: add, substract(+,-)

ID:Property:Expression:[Array,Of,Values]

Here are some examples you can try by copy-pasting:

Default IIC:

1. Morphine with 2 uses:

544fb3f34bdc2d03748b456a:MaxHpResource:2

2. P90 magazine with the size of 100 rounds:

5cc70093e4a949033c734312:Cartridges:0:MaxCount:100

3. Emergency Exit Keys with 100 uses:

5448ba0b4bdc2d02308b456c:MaximumNumberOfUsage:100

4. 120 Igolnik stack in a single cell:

5c0d5e4486f77478390952fe:StackMaxSize:120

5. MBSS backpack vertical and horizontal size to 8 cells:

544a5cde4bdc2d39388b456b:Grids:0:Properties:CellsH:8

544a5cde4bdc2d39388b456b:Grids:0:Properties:CellsV:8

6. Grach pistol that can switch to full auto:

576a581d2459771e7b1bc4f1:weapFireType:[single,fullauto]

7. AFAK Resource is multiplied by 1.5

60098ad7c2240c0fe85c570a: MaxHpResource:*:1.5

8. Wallet does not accept keycards

5783c43d2459774bbe137486:Grids:0:Properties:Filters:0:Filter:-:[5c164d2286f774194c5e69fa]

Here are the examples on Parent IIC:

1. All stimulators with 2 uses:

5448f3a64bdc2d60728b456a:MaxHpResource:2

2. All magazines have +10 ergonomics:

5448bc234bdc2d3c308b4569:Ergonomics:+:10

Caution, some fields have different names in SPT structure than it is in JSON/DB, In most cases fields should start with first letter being Uppercase and often every single word too, and no extra symbols, some are being handled by Greed, for example ‘_max_count’ being changed to ‘MaxCount’, keep that in mind. Currently handled ones: “effects_damage”, “effects_health”, “_mergewithchildren” and example above.

Price Changer

Price Changer is the most simple one, made of 3 fields:

ID:Expression:Value

It support equals, add, subtract, division and multiplication (=,+,-,/,*)

Example:

1. 60 Round AK magazine price multiplied by 2.5

55d482194bdc2d1d4e8b456b:*:2.5

2. All stimulators cost 1337 more

5448f3a64bdc2d60728b456a:+:1337

Fleamarket > Add Multiplier to the item’s price:

SPT’s field, allows multiplying the price explicitly for flea market AI offers, good for balancing keycards/keys/cases

Very simple form, ID:Value, nothing else is accepted.

Example:

1)Marked key costs 1.8 more

5780cf7f2459777de4559322:1.8 – PS: Exist in DB by default

Create a new trader offer:

This box allows you to add an offer to any trader with your own price and type of currency on any desired loyalty level.

It accepts short names for currency (USD,RUB,EUR,GP) but you can also set any desired item ID

It also accepts most of vanilla trader names (Therapist,Mechanic,Ref,Prapor,Skier,Ragman,Peacekeeper,Jaeger) but same with currency – can accept any ID

Hard exceptions: Do not use Fence, Lightkeeper and any other trader that doesn’t have items structure/trade functionality

Since 2.1.0 you can now completely clear trader assort by typing Name:CLEAR

Example:

1. Therapist sells Item Case for 15000 USD at loyalty level 2

Therapist:USD:15000:59fb042886f7746c5005a7b2:2

2. Remove all Ref offers

Ref:CLEAR

This application uses Media and/or Materials from the Video Game “Escape from Tarkov” and links that leads to Game official wiki that can be accessed via [https://escapefromtarkov.fandom.com/](https://escapefromtarkov.fandom.com/%60)

Escape from Tarkov content and materials are the intellectual property of their respective owners “Battlestate Games Limited”.

Developer of this application is not affiliated to “Battlestate Games Limited” nor their Wikis, in any way

In AI PMC Section, PMC Names consist of usernames of multiple SPT communities.

If you find yourself uncomfortable to be in this list or you find certain name offensive - report to a mod developer.

I don’t support old/outdated versions of my mods meaning you will not receive any help from me if you are using an old version.

As of moment of writing[09.03.2023 UPD 2024] I am not planning to make any kind of Compatibility with mods, however the SVM itself is quite modular, if you think conflicts can happen - you can always disable incompatible section via Greed.

Credits:
Related to SVM:

Ereshkigal - Main inspirator, a lot of initial code was used from Ereshkigal’s mods, such as Bots loadouts, Aki Configurator and AKI-AIO.
Senko, Chomp, Spaceman - Assisted or is part of the development in one way or another, whether it be being the owner of code snippets used in this mod, to actively developing the mod or providing help.

TheSpartacus - Transition to AKI 3.0.0 and general help between releases

Related to UI (GFVE/GREED):

SerWolfik - for GFVE icon.

Lacyway - Major help with UI transition, giving me a head start with WPF

SSH_ - Archive with Icons
BattleStateGames - for creating those icons.

Misc:

KMC - Reuploading the mod onto the SPT-Aki website.

Volcano - Oddba representative of SVM

Nexus4880 - Creator of ‘Hide Special Icon’ Plugin for Case Space Manager

Fire Hawk, Z3R0, Tabi, Assassin, Morgan, RakTheGoose - Testers, feedback

G10rgos, DaveyB0y, Fortis, olli991, Kain187, GamesB4Gains, Kiriko, MalecSP, BiddinWar, RepublicanJesus, Bushtail - Donations

Localizations:
Ukrainian - celebrutu

Korean - 루퍼, 고라니

Spanish - og_ruby

Chinese - Volcano

Everyone else who provided any kind of support to the project, whether bug reports, feedback related to UI or helped other to with issues.

This mod adds a complete full-goods trader system to the game, featuring four types of traders: Weapon Trader, Equipment Trader, Consumable Trader, and Barter Trader. It supports bilingual (Chinese and English) names, descriptions, and avatar path configurations. All traders have the ability to purchase items, while the Equipment Trader also offers repair and insurance services. The Equipment Trader can sell helmets, vests, armor, backpacks, and other equipment, and the Barter Trader allows the purchase of any secure container.

In terms of item handling, the mod enhances special items: rocket launchers are automatically paired with rockets and calculate total price, ammunition boxes automatically traverse slots to fill ammunition and set stack counts, and items with mandatory slots will be randomly filled with compatible items by default. The system includes built-in statistics tracking to monitor success counts for secure containers, special items, items with slots, and ordinary items, and outputs debug logs for critical operations such as rocket launcher handling, recording overall item addition success rates and categorical statistics.

The pricing system supports three modes: using only handbook prices, using average flea market prices, or automatically selecting the lower of the two (default). A global price adjustment multiplier (default 1.2) is also configurable. All settings are automatically loaded from config.json with fallback to default values. All static resources of the mod are centralized in the /data/ directory for easy deployment and management.

该模组为游戏添加了完整的全货物商人系统，包含武器商、装备商、消耗品商和杂物商四类商人，支持中英双语名称、描述及头像路径配置。所有商人具备购买功能、装备商人具备维修和投保功能，其中装备商可出售头盔、胸挂、护甲、背包等装备，杂货商人可购买任意安全箱。

在物品处理方面，模组针对特殊物品进行了增强：火箭筒可自动配套火箭弹并计算总价，弹药盒能自动遍历插槽填充弹药并设置堆叠数量，带有必备插槽的物品会默认随机填充匹配物品。系统内置统计机制，可追踪安全箱、特殊物品、有槽位物品和普通物品的成功计数，并为火箭发射器等关键操作输出调试日志，记录整体物品添加成功率及分类统计。

价格体系支持三种模式：仅使用手册价格、使用跳蚤市场平均价格、自动取两者最小值（默认），并可配置全局价格调整系数（默认1.2）。所有配置通过 config.json 自动加载，支持默认值回退。模组的所有静态资源集中于 /data/ 目录下，便于部署与管理。

Every raid you run racks up stats — kills, distance walked, blood lost, armor shredded. But those numbers just sit there doing nothing.

StatRewards turns your profile stats into repeatable milestones that send you random loot via mail. Kill 25 PMCs? Prapor sends you a weapon. Walk 25km? Jaeger mails you food and drinks. Lose 50 liters of blood? Therapist questions your biology and sends meds.

Key features:

• 48 milestones out of the box — kills, headshots, damage, healing, looting, exploration, economy, and every weapon type
• Random rewards by category — meds, ammo, gear, keys, barter items, money, food, drinks
• Repeatable — milestones trigger every N stats, forever
• Global threshold multiplier — one slider to make rewards more or less frequent
• Fully configurable — add, remove, or tweak milestones and reward pools via JSONC config
• Safe for existing profiles — first install seeds milestones to current stats, no retroactive reward flood

Extract the zip in your SPT root folder.

No client plugin needed — this is a server-only mod.

All 48 default milestones with their thresholds:

Combat

Weapon Types

Factions

Damage & Health

Survival & Raids

Movement & Consumables

Loot

Economy

Exploration

A StatRewards bot appears in your friends list. Send it any message to see your top 10 closest milestones:

=== StatRewards Progress ===

93% — Headhunter (HeadShots) — 14/15
79% — Armor Breaker (CauseArmorDamage) — 3952/5000
76% — Rifleman (KilledWithAssaultRifle) — 19/25
75% — Accuracy King (HitCount) — 187/250
73% — PMC Slayer (KilledPmc) — 11/15
70% — Survivor (ExitStatus) — 7/10
68% — Scavenger (BodiesLooted) — 17/25
64% — Weapons Hoarder (Weapons) — 16/25
60% — Key Collector (Keys) — 6/10
58% — Lead Spitter (AmmoUsed) — 580/1000

+38 more

Edit SPT/user/mods/StatRewards/config/mod_config.jsonc:

Global settings:

Per-milestone settings:

Trader IDs (for sender field):

Reward categories:

You can also use specific item template IDs:

{ "template_id": "5449016a4bdc2d6f028b456f", "min_stack": 50000, "max_stack": 100000, "weight": 2 }

Install → play. That’s it.

After each raid, when you return to the main menu, the mod checks your profile’s overall stats against all configured milestones. When a threshold is crossed, random rewards are generated from the milestone’s reward pool and sent via in-game mail from the configured trader.

First install: All milestones are seeded to your current stats. You won’t receive a flood of retroactive rewards — only new progress counts.

Progress tracking: A small JSON file per profile is saved in user/mods/StatRewards/progress/. Delete it to re-seed.

Nothing is permanent. Remove the mod and nothing changes in your profile. The mod only reads stats and sends mail.

You can create addons for StatRewards — no code needed. An addon is simply a modified mod_config.jsonc that adds or tweaks milestones.

What you can do:

• Add new milestones with custom stat triggers, thresholds, messages, and reward pools
• Change existing milestone thresholds, rewards, or trader senders
• Create themed packs (e.g. “Hardcore Mode” with higher thresholds, “Casual Mode” with lower ones)

How to create an addon:

1. Copy the default mod_config.jsonc
2. Add, remove, or modify milestones
3. Share your file — users just replace theirs with yours

Available stats for milestones: see the full list in DESIGN.md — 100+ trackable profile stats including kills by weapon type, kills by faction, damage types, looting, economy, exploration, and more.

Example — adding a custom milestone:

{
  "id": "my_custom_milestone",
  "stat_key": "KilledWithTemplate",
  "stat_subkey": "5cadfbf7ae92152ac412eeef",  // specific weapon template ID
  "every": 10,
  "sender": "5a7c2eca46aef81a7ca2145d",
  "message": "You really love that gun.",
  "reward_count": 2,
  "reward_pool": [
    { "category": "ammo", "weight": 5 },
    { "category": "weapon_preset", "weight": 3 }
  ]
}

See “Configuration” tab

• SPT 4.0.x
• Server-only — no client plugin required
• Works with any mod
• Safe for existing profiles — install or remove at any time

Report them on GitHub.

If you enjoy StatRewards and want to support my work, feel free to buy me a coffee!

All my mods are free and open source. Your support keeps me motivated to create more!

The mod aims to simplify the process of adding new items in SPT by encapsulating item creation interfaces, and provides comprehensive documentation that systematically organizes data resources and explains the function of various properties and fields. The accompanying Wiki offers complete API references and item creation guides, helping developers and players use the mod more efficiently and rapidly expand SPT’s item database.

Tag Explanation:
The mod uses semantic versioning (x.x.x). The Wiki (available as a separate download from the mod plugin) is also released with semantic versions but is uniquely identified by Wiki Tags. A Wiki tag follows the format Wiki_Year_Month_Day_Hour_Minute and is used consistently for labeling and linking within the local Wiki documentation.

Download Instructions:
Starting from version v0.1.0, to reduce package size, the default download link only provides the mod itself. The Wiki is no longer bundled with the mod.

• If you need only the mod, download it directly from this page.
• If you want to download or update the Wiki, get it separately from the mod plugin page.

After extracting the mod, you will find one folder:

• SPT/user/mods/SptItemCreator: The main mod

New Cache System (v0.1.0+):

• Output directory: [Game Root]\SPT\user\mods\SptItemCreator\StatsCache
• Contents: Based on the entire SPT database, the mod generates a categorized list for each type, including all property names and all values that have appeared.
• Purpose: Serves as a reference when creating new items, and provides a foundation for creating scripts to calculate frequencies, value distributions, averages, etc.

How to Use the Wiki:

1. (Optional) Move the Wiki folder to any location you prefer — except inside any SPT 4.0 mod folder.
2. Navigate into the Wiki folder.
3. Double-click index.html.
4. Starting from Wiki_26_02_02_18_20, the Wiki supports both Chinese and English bilingual content. You can switch between languages directly within the Wiki interface.

Note:
Since the mod and Wiki are now distributed separately (starting from v0.1.0), the server warning about “No Assemblies found” mentioned in previous versions no longer occurs. You can safely place the Wiki folder anywhere outside the SPT mods directory.

本模组旨在通过封装物品创建接口，简化在SPT中新增物品的流程，并提供详尽的文档说明，系统整理各项数据资源与属性字段的作用。配套Wiki提供了完整的模组接口文档与物品创建指南，帮助开发者和玩家更高效地使用本模组，快速扩展SPT中的物品内容。

标签说明：
模组以语义化版本（x.x.x）计算版本。Wiki（可在模组插件页面单独下载）虽也使用语义化版本发布，但实际使用Wiki标签来标记唯一的版本。Wiki标签由“Wiki_年_月_日_时_分”组成，并在本地Wiki文档中完全以此格式进行标记与链接。

下载说明：
从 v0.1.0 版本开始，为降低文件尺寸，默认下载链接仅提供模组本体，不再打包 Wiki。

• 若仅需模组本体，直接在本页面下载即可。
• 若需下载或更新 Wiki，可在本模组的插件页面单独获取。

解压模组后，仅包含以下文件夹：

• SPT/user/mods/SptItemCreator：模组本体

新缓存系统（v0.1.0+）：

• 输出目录： 游戏根目录\SPT\user\mods\SptItemCreator\StatsCache
• 内容： 模组根据当前 SPT 的所有数据库，整理的一份按照类型分类好的、每个类型有的属性名称与所有出现过的值的列表
• 用处： 创建新物品时的参考；制作脚本统计频数、数值分布、均值等的基础

Wiki 使用方式：

1. （可选）将 Wiki 文件夹移动到任意你喜欢的位置（切勿放入任何 SPT 4.0 模组文件夹内）
2. 进入 Wiki 文件夹
3. 双击打开 index.html
4. 从 Wiki_26_02_02_18_20 版本开始，Wiki 已支持中英文双语内容，可在 Wiki 界面内直接切换语言阅读。

说明：
由于新版本（v0.1.0 起）模组与 Wiki 已分开分发，此前版本中提到的“服务端提示 No Assemblies found 警告”的问题已不复存在。您只需将 Wiki 文件夹放置在 SPT 模组目录外的任意位置即可正常使用。

1. Download and Install CommonLib FIRST THIS IS REQUIRED
2. Download Scorpion
3. Open the downloaded 7z file in 7-zip
4. Select the user folder in the 7z file in 7-zip
5. Drag the user folder from 7-zip into your SPT folder

Demonstration Video (yoink):

Quest Guide (May not be current)

https://acidphantasm.github.io/scorpion-guide/quests/1-15.html

Quest Map

Kaeno-TraderScrolling