This mod makes it infinitely easier to share your weapon builds on Discord as well as when you’re playing with a group of friends using Fika.

This mod features:

• CTRL-C & CTRL-V weapon build import & export bindings to make it very easy to copy and paste a weapon build from Discord into the game
• A websocket & utilities to keep all weapon builds on the SPT server central, meaning that all profiles will have access to them (And will see them be edited live if someone is looking at a build!)
• A quick and easy way to grab saved builds out of the ‘WeaponBuilds’ folder, for storage or taking it to another playthrough.

Demonstration Video (Yes, it has a different mod name. The installation is the same)

• Lacyway and the Fika team, this mod uses some copied classes to do with websockets that is largely based on their code.

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. What formats are supported?
   • png, mp4 (H.264, H.265), webm (VP8), for more details check Unity docs
5. gif support?
   • Convert your gifs to videos. If you dont need transparent background, use mp4. Otherwise - webm, just dont forget to set codec to VP8 (VP9 is not supported by Unity). Also compare quality after conversion, some converter websites absolutely destroy gifs on their default settings, so set bitrate high, it will still come out smaller than original gif.
6. Videos don’t play audio?
   • Check Play Audio setting in F12/7Bpencil.WeaponCamoAndStickers menu, but it won’t work as you expect because of technical challenges
7. I don’t see camo editor
   • You clicked EDIT BUILD, try MODDING
8. I managed to paint left and right side, but how do I paint top?
   • There are multiple tools to do it:
     1. Try MaxAngle slider, get a feeling how it works, setting MaxAngle to 0 will cover everything at the expense of stretching (but it may look fine in your case)
     2. Select Move tool, look at green arrow, decal is projected in direction opposite to it. This means you can rotate decal to face any surface you want to paint. Left/Right is just handy shortcuts to set decal position/rotation/scale certain way
     3. Use Mask, it will break up pattern and make cutoff line less noticable
9. Fika compatibilty?
   • Check Fika Support addon
10. Camo for armor/backpack/rig/helmet?
    • Nope, equipment is entirely different beast
11. Keep some weapon parts untouched by camo?
    • Maybe in the future
12. Keep paint attached to moving weapon parts (magazine, pistol slide, etc)?
    • Maybe in the future
13. Apply paint on part-by-part basis?
    • Maybe in the future
14. Any keybinds to speed up edit process?
    • Check F12/7Bpencil.WeaponCamoAndStickers
15. Undo system?
    • 😭
16. 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)
17. Camo editor UI is too small / too big
    • Check UI Scale setting in F12/7Bpencil.WeaponCamoAndStickers menu
18. Do guns returned by insurance retain their camo?
    • Nope, they are technically copies with different ids. Haven’t worked on synchronizing it
19. What mods have you used in the video?
    • Brighter Interiors
    • CloudSix - Volumetric Clouds
    • Smajlec’s Lights

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!

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!

Installing quest mods (custom traders, quest overhauls, etc.) adds thousands of extra XP that breaks the vanilla progression curve. You level up too fast, outpacing your trader reputation — you have the level for LL3 gear but haven’t unlocked it yet.

FairProgression fixes this automatically. It runs after all mods have loaded, analyzes every quest in the database, and scales XP rewards so the progression curve matches vanilla — no matter how many quest mods you have installed.

Key features:

• Detects vanilla vs modded quests automatically
• Scales XP per bracket aligned with trader loyalty unlocks (LL2/LL3/LL4 phases)
• Buffs under-rewarded quests where difficulty far exceeds the XP reward
• Analyzes quest objectives (boss kills, map difficulty, restrictions, skills, etc.)
• Detailed dashboard in server logs
• Safe for existing profiles — only modifies rewards in memory
• Works with any quest mod — no configuration needed

Extract the zip in your SPT root folder. Start the server. That’s it.

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

• mode — "scale_all" (default) reduces all quests proportionally. "scale_modded_only" only reduces modded quests.
• level_brackets — "trader" (default) auto-computes from vanilla trader loyalty levels. Or use a JSON array like [5, 10, 20, 30, 40].
• min_coefficient — 0.25 (default). Quest XP never drops below 25% of original.
• buff_under_rewarded — true (default). Increase XP for quests where difficulty far exceeds the reward (capped at x2).
• buff_gap_threshold — 5 (default). Minimum level gap between difficulty and XP to trigger a buff.
• enable_dashboard — true (default). Print the rebalancing dashboard in server logs.
• dry_run — false (default). Calculate and log everything but don’t modify any rewards.
• verbose — false (default). Log every modded quest with difficulty scores, per-trader breakdown, and under-rewarded details.

Every server start, FairProgression logs a dashboard showing exactly what changed:

[FairProgression] ================================================================
[FairProgression]  XP Rebalancing Dashboard
[FairProgression]  Mode: scale_all
[FairProgression] ================================================================
[FairProgression]  Quests: 1492 total (558 vanilla, 934 modded)
[FairProgression]  Vanilla quest XP: 11.0M -> 7.9M (-27.6%)
[FairProgression]  Modded  quest XP: 24.6M -> 21.4M (-13.1%)

[FairProgression]  Bracket  Van.Q   Van.XP  Mod.Q   Mod.XP    Total  Coeff     After
[FairProgression]  1-12       167     2.0M    117    256.1k     2.2M  0.885      2.0M
[FairProgression]  13-20      145     1.8M    116    578.2k     2.4M  0.754      1.8M
[FairProgression]  21-32      151     3.2M    193      2.1M     5.3M  0.603      3.2M
[FairProgression]  33-42       55     1.7M    137      3.3M     5.0M  0.334      1.7M
[FairProgression]  43+         40     2.4M    371     18.4M    20.8M    ---     20.8M

[FairProgression]  Buffed 185 under-rewarded quests (+369.0k XP)

[FairProgression]  Total quest XP: 35.6M -> 29.3M (-17.5%)
[FairProgression] ================================================================

Enable verbose for a full per-trader and per-quest breakdown with difficulty scores.

Install quest mods → FairProgression handles the rest.

When you add quest mods, the extra XP makes you level up too fast. You reach level 30 but your traders are still LL2 because you haven’t done enough vanilla quests to unlock them.

FairProgression solves this by:

1. Detecting which quests come from mods and which are vanilla
2. Estimating when you’ll realistically complete each quest based on its objectives, prerequisites, and reward
3. Reducing XP from quests that would over-level you
4. Boosting XP from quests that are harder than their reward suggests

The XP budget is split into phases matching vanilla trader unlock levels — so your level always stays in sync with what you can actually buy.

Example: You have 934 modded quests adding 24.6M extra XP. FairProgression scales this down to keep you on the vanilla curve, while buffing 185 quests that were under-rewarded for their difficulty.

Nothing changes on disk. All adjustments are in memory. Remove the mod and everything goes back to normal. Safe for existing profiles.

• SPT 4.0
• Compatible with any mod that adds quests
• Compatible with QuestsExtended (detects placeholder conditions)
• Safe for existing profiles — only modifies quest rewards in memory, not on disk
• Adding/removing quest mods: just restart the server

Report them on GitHub.

If you enjoy FairProgression 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!

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/ 目录下，便于部署与管理。

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.

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.5.0 was tested with ABPS 2.0.16, and a graceful failover is added. If your version is not compatible, it will say so in the bepinex logs, but Vagabond with continue to work.

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,
  // 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 any limitation.
  // if disabled, to be able to relocate you will need to complete the "Fresh Foundations" quest from Skier (repeatable).
  "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 starter 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,
  // if enabled, you can use another player's hideout exit to access your own hideout
  "ShareHideoutExits": false,
  // how much it should cost to relocate the hideout
  "HideoutRelocationFee": 350000,
  // What loyalty level is required to accept the quest to get the trader to join your hideout?
  "JoinHideoutTherapistLoyaltyLevel": 2,
  "JoinHideoutJaegerLoyaltyLevel": 2,
  "JoinHideoutMechanicLoyaltyLevel": 2,
  "JoinHideoutPeacekeeperLoyaltyLevel": 2,
  "JoinHideoutPraporLoyaltyLevel": 2,
  "JoinHideoutRagmanLoyaltyLevel": 2,
  "JoinHideoutSkierLoyaltyLevel": 2
}

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

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

A terminal wizard (TUI) that scaffolds a ready-to-build SPT 4.x mod project in seconds — no manual setup required.

Supports both server mods (C# / .NET 9 / NuGet) and client mods (BepInEx / netstandard2.1).

Just run the binary, answer a few prompts, and get a fully configured project with correct namespaces, references, packaging target, and README.

• Interactive step-by-step TUI — no flags, no config files to edit
• Live SPT version picker — fetches available versions from NuGet so you always pin the right one
• Server mod — generates a .csproj pre-wired with SPTarkov.Common, SPTarkov.DI, and SPTarkov.Server.Core
• Client mod — generates a .csproj targeting netstandard2.1 with local DLL references auto-resolved from your SPT install path
• Correct C# namespace and metadata filled with your name, version, and GUID
• Build + packaging target baked into .csproj — dotnet build produces a ready-to-distribute .zip
• Multiple starter templates per mod type
• License picker with 17 SPDX options
• Also generates a .sln, README.md, and .gitignore
• Input validation on every field (mod name, semver, URL, SPT install path, etc.)

Server mod templates:

• Empty — minimal ModMetadata + IOnLoad entry point
• Edit Database — DatabaseService injection example
• Read JSON Config — reads a custom config.json via ModHelper

Client mod templates:

• Empty — minimal BaseUnityPlugin with Awake()
• BepInEx Config — comprehensive Config.Bind examples (bool, int/float sliders, string, enum, keybinds, color picker)
• Harmony Patch — ModulePatch with Prefix/Postfix in a Patches/ subfolder

Server mod:

MyMod/
├── MyMod.sln
├── MyMod.csproj   ← NuGet refs + auto-zip packaging target
├── Mod.cs         ← ModMetadata + IOnLoad entry point
├── README.md
└── .gitignore

Client mod:

MyMod/
├── MyMod.sln
├── MyMod.csproj   ← Local DLL refs + auto-zip + PostBuild copy to BepInEx/plugins/
├── Plugin.cs      ← BaseUnityPlugin + [BepInPlugin]
├── README.md
└── .gitignore

1. Download the latest binary from the Files tab
2. Place spt-scaffold.exe inside the folder where you want your mod created
3. Run it — the wizard will ask for:
   • Mod Type — server or client
   • Template — starter template for your mod type
   • SPT Install Path (client mods only) — used to resolve local DLL references
   • Mod Name (used as C# namespace and GUID)
   • Author
   • Version (semver, defaults to 1.0.0)
   • SPT Compatibility (pick from live NuGet versions)
   • Description (optional)
   • Repository URL (optional)
   • License
4. Done — open the generated folder in your IDE and start coding

Want a template added to the wizard? Open a Pull Request on GitHub.

A template is just a folder with two things:

1. template.json — displayed in the picker UI:

{
  "Label": "My Template",
  "Desc": "Short description shown in the wizard"
}

2. One or more .tmpl files — the filename (minus .tmpl) becomes the generated file. Templates use Go’s text/template syntax. Available fields:

Folder location:

• Server template → internal/templates/server/myTemplateName/
• Client template → internal/templates/client/myTemplateName/

Look at the existing templates in those folders as a reference before writing your own.

• Windows x64
• .NET 9 SDK — to build generated server mods
• An existing SPT installation — required for client mods (DLL references are resolved from it)

Issues? Open one HERE

A simple mod that lets you add custom hideout production recipes by placing JSON files in the recipes folder — no coding required.

Use the TarkovCraft website to generate your recipes easily!

• Automatically loads all .json files from the recipes folder
• Supports multiple files — organize your recipes however you like
• Logs loaded recipes and errors in the server console
• Seamlessly integrates with the existing hideout crafting system

Place your recipe .json files inside user/mods/TarkovCraft-Loader/recipes/.

You can have as many .json files as you want — any name works!

Need help creating recipe JSON files? Use the TarkovCraft website.

1. Download the latest release .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

• Malformed JSON or invalid item IDs will be skipped and logged as errors in the server console
• Adding many recipes to one hideout area may cause a brief freeze when first opening that station — this is a client-side limitation

Issues? Open one HERE