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

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, and it allows you to use the same name for builds of different weapons.

Examples

Same Names

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

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:

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

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

Note: Excluding a parent mod class (e.g., “Sights”) will automatically exclude all its child categories (collimators, optics, etc.). Any changes to child options won’t have any effect while the parent is selected. For more precise control, avoid selecting the parent group and choose only the specific subcategories instead.

• Excluded mods are still saved as part of the preset. The settings only affect name matching and display in the inventory.
• Settings apply only to your own builds and do not affect built-in presets (Mechanic, Prapor etc.).
• After changing the configuration, you need to reload your player profile — or better, restart the game. Builds and inventory item names are heavily cached on startup, so changes may not take effect immediately even if it looks like they do.

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

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

SuntionCore.SPTExtensions

This module consolidates utility classes that depend on SPT-related classes. It serves as an extension to the SuntionCore module. By default, this module supports both Chinese (“ch”) and English (“en”) and utilizes the default logging path provided by SuntionCore.

To change the display language:
SuntionCoreSPTExtensionsMod.I18NSPTExtensions.Value.CurrentLang = "target_language"

To extend language support:
Fork my repository, refer to the content within the OnLoad function in the C# code under SuntionCore.SPTExtensions/Services to add your extensions, and then submit a Pull Request. Please avoid making extensive modifications to files, as this makes the review process difficult.

Features

ModMailService

• Smart Message Splitting: Automatically splits long texts by newlines (SplitStringByNewlines) to prevent client overflow.
• Async Batch Sending: Supports high-volume asynchronous dispatch (SendAllMessageAsync).
• Economy Integration: Handles multi-currency payments, payouts, and item mailing.
• Error Handling: Includes comprehensive exception catching with localized error messages.

ProfileAndAccountService

• ID Mapping Cache: Maintains a bidirectional cache between Player IDs (Pmc/Scav) and Account IDs.
• Fast Lookup: Provides GetPmcDataByPlayerId to retrieve player profiles instantly using any ID type.
• Auto-Indexing: Implements IOnLoad to automatically build account data indices on server startup.

Infrastructure

• Lazy Initialization: Static entry point (SuntionCoreSPTExtensionsMod) provides on-demand Logger and I18N instances.
• Localization: Registered translation keys for English and Chinese (e.g., KeyInvalidMoneyId, KeyProfileNotFound).

How to Reference This Library in Your Project

1. Create a libs folder within your mod project directory (optional).
2. Install both this module and the SuntionCore module into SPT (this module’s releases are packaged by default for universal mod installation). Copy "YourGameFolder\SPT\user\mods\SuntionCore\SuntionCore.dll" and "YourGameFolder\SPT\user\mods\SuntionCore.SPTExtensions\SuntionCore.SPTExtensions.dll" to the libs folder mentioned above.
3. Add the following content to your YourProjectName.csproj file:

   <ItemGroup>
       <Reference Include="SuntionCore.dll">
           <HintPath>libs\SuntionCore.dll</HintPath>
           <Private>False</Private>
       </Reference>
       <Reference Include="SuntionCore.SPTExpand.dll">
           <HintPath>libs\SuntionCore.SPTExtensions.dll</HintPath>
           <Private>False</Private>
       </Reference>
   </ItemGroup>
   

   Note: HintPath should be the relative path of the actual DLL files relative to your .csproj file.
   Private must be set to False to prevent incorrectly bundling all referenced libraries during the build output. Please refer to the documentation in my repository, as HTML tags within the .csproj file are stripped/blocked when rendered on the webpage.

4. Your compiler will now be able to correctly reference and use the contents of this library.

Create mod dependencies using the following code:

class YourModMetadata
{
    public override Dictionary<string, Range>? ModDependencies { get; init; } = new()
    {
        { "com.suntion.suntioncore", new Range(">=1.0.0") },
        { "com.suntion.suntioncore.sptextensions", new Range(">=0.1.0") }
    };
}

Credits

Inspiration sources:

• MassivesoftCore | Regarding the creation of SPT class libraries
• MassivesoftWeapons | Regarding referencing SPT class libraries
• Raid Record |
  • Fund deduction/claim processing/message sending/item sending functionalities
  • Retrieving player saves/handling conversions for sessions, profileIds, etc.
• SPT.Server | Logic for splitting items, deducting funds, adding money, etc.

SuntionCore.SPTExtensions

本模块整合了依赖 SPT 相关类的工具类，作为 SuntionCore 模块的扩展。默认情况下，本模块支持中文 (“ch”) 和英文 (“en”)，并使用 SuntionCore 提供的默认日志路径。

更改显示语言：
SuntionCoreSPTExtensionsMod.I18NSPTExtensions.Value.CurrentLang = "目标语言"

扩展语言支持：
Fork 我的仓库，参考 SuntionCore.SPTExtensions/Services 下 C# 代码中 OnLoad 函数的内容来添加您的扩展，然后提交 Pull Request。请避免对文件进行大量修改，这会增加审核难度。

功能特性

ModMailService

• 智能消息分割：自动按换行符分割长文本 (SplitStringByNewlines)，防止客户端溢出。
• 异步批量发送：支持高容量异步分发 (SendAllMessageAsync)。
• 经济系统集成：处理多货币支付、支出和物品邮寄。
• 错误处理：包含全面的异常捕获，并返回本地化的错误信息。

ProfileAndAccountService

• ID 映射缓存：维护玩家 ID（Pmc/Scav）与账户 ID 之间的双向缓存。
• 快速查找：提供 GetPmcDataByPlayerId 方法，可使用任何 ID 类型即时检索玩家档案。
• 自动索引：实现 IOnLoad 接口，在服务器启动时自动构建账户数据索引。

基础设施

• 懒加载初始化：静态入口点 (SuntionCoreSPTExtensionsMod) 按需提供 Logger 和 I18N 实例。
• 本地化：注册了英文和中文的翻译键（例如 KeyInvalidMoneyId、KeyProfileNotFound）。

如何在您的项目中引用此库

1. 在您的模组项目目录中创建一个 libs 文件夹（可选）。
2. 将此模块和 SuntionCore 模块都安装到 SPT 中（本模块的发布包默认为通用模组安装格式）。将 "您的游戏文件夹\SPT\user\mods\SuntionCore\SuntionCore.dll" 和 "您的游戏文件夹\SPT\user\mods\SuntionCore.SPTExtensions\SuntionCore.SPTExtensions.dll" 复制到上述的 libs 文件夹。
3. 在您的 YourProjectName.csproj 文件中添加以下内容：

   <ItemGroup>
       <Reference Include="SuntionCore.dll">
           <HintPath>libs\SuntionCore.dll</HintPath>
           <Private>False</Private>
       </Reference>
       <Reference Include="SuntionCore.SPTExpand.dll">
           <HintPath>libs\SuntionCore.SPTExtensions.dll</HintPath>
           <Private>False</Private>
       </Reference>
   </ItemGroup>
   

   注意：HintPath 应是相对于您的 .csproj 文件的实际 DLL 文件路径。
   Private 必须设置为 False，以防止在构建输出时错误地打包所有引用的库。 请参考我仓库中的文档，因为在网页上渲染时，.csproj 文件中的 HTML 标签会被剥离/屏蔽。

4. 您的编译器现在可以正确引用并使用此库的内容。

使用以下代码创建模组依赖：

class YourModMetadata
{
    public override Dictionary<string, Range>? ModDependencies { get; init; } = new()
    {
        { "com.suntion.suntioncore", new Range(">=1.0.0") },
        { "com.suntion.suntioncore.sptextensions", new Range(">=0.1.0") }
    };
}

致谢

灵感来源：

• MassivesoftCore | 关于 SPT 类库的创建
• MassivesoftWeapons | 关于引用 SPT 类库
• Raid Record |
  • 资金扣除/领取处理/消息发送/物品发送功能
  • 获取玩家存档/处理 session、profileId 等的转换
• SPT.Server | 物品拆分、扣除资金、添加资金等逻辑

Easygame Mod for SPTarkov

This is a feature-rich mod for the Escape from Tarkov SPTarkov server that provides comprehensive game customization through a unified configuration file. The mod offers independently toggleable features covering character attributes, raid mechanics, item systems, economy, and access cards.

Core Features

Character and Raid Adjustments

• Modify base health, energy, and hydration values for all profiles
• Adjust raid duration across all maps
• Customize item carry limits when entering raids

Weapons and Ammunition

• Adjust magazine loading, unloading, and checking times
• Modify stack sizes for all ammunition types

Items and Market

• Remove flea market selling restrictions on items
• Adjust maximum active offer counts per level
• Set all items as examined by default

Consumables

• Configure stimulator usage times, weight, and price multipliers for all injectors except morphine

Access Cards

• Customize maximum usage counts for both Labs and Labyrinth access cards

Map Display

• Optionally show the Labyrinth map in the map selection screen

All features are managed through a centralized config.json file, allowing users to flexibly enable or disable specific functions and adjust parameters to achieve a personalized gaming experience.

Configuration Guide

The config.json configuration file is located by default in SPT/user/mods/Easygame/data.

• Version v1.0.0: The server must be run at least once to wait for the configuration to be automatically generated. You can also manually create a configuration file containing all the following keys and set up the desired functions in advance according to your needs.
• After Version v1.0.0: A configuration file will be provided by default, allowing you to set the desired functions before starting the server.

{
    // Function enable/disable switches
    "EnableFunction": {
        // Whether to remove all flea market selling restrictions on items
        "IsUnlockAllItemsSellLimit": true,
        // Whether to display Labyrinth map in map selection screen
        "ShowMapToChoiceScene": true,
        // Whether to customize item carry limits into raid
        "EnterGameItemLimit": true,
        // Whether to modify health, energy and hydration values
        "EnergyHydrationModify": true,
        // Whether to modify raid duration
        "RaidTimeModify": true,
        // Whether to modify magazine loading/unloading/checking times
        "AmmoTimeModify": true,
        // Whether to modify flea market max active offer count per level
        "MaxActiveOfferCountModify": true,
        // Whether to adjust Labs access card usage count
        "AdjustLabsAccess": true,
        // Whether to adjust Labyrinth access card usage count
        "AdjustLabysAccess": true,
        // Whether to modify stimulator durability (excluding morphine)
        "AdjustSimulatorMaxHpResource": true,
        // Whether to adjust ammo stack size
        "AdjustAmmoStack": true,
        // Whether to set all items as examined by default
        "AllExaminedByDefault": false
    },
    // Stimulator configuration settings
    "StimulatorConfig": {
        // Number of uses for stimulators
        "UseTimes": 10,
        // Price multiplier for stimulators
        "PriceModify": 5,
        // Weight of stimulators in kilograms
        "Weight": 0.5
    },
    // Maximum item limit when entering raid
    "EnterGameItemLimit": 3600,
    // Health multiplier for all profiles
    "HealthModify": 1.5,
    // Energy and hydration multiplier for all profiles
    "EnergyHydrationModify": 1.5,
    // Raid duration multiplier
    "RaidTimeModify": 3,
    // Magazine loading time multiplier
    "TakeInAmmoTimeModify": 0.05,
    // Magazine unloading time multiplier
    "TakeOutAmmoTimeModify": 0.05,
    // Magazine checking time multiplier
    "CheckAmmoTimeModify": 0.45,
    // Flea market max active offers multiplier per level
    "MaxActiveOfferCountModify": 7,
    // Labs access card maximum usage count
    "LabsAccessMaximumNumberOfUsage": 10,
    // Labyrinth access card maximum usage count
    "LabysAccessMaximumNumberOfUsage": 10,
    // Ammo stack size
    "AmmoStack": 300
}

Easygame SPTarkov 模组

这是一个功能丰富的 Escape from Tarkov SPTarkov 服务端模组，通过统一的配置文件提供全面的游戏自定义功能。该模组提供独立可切换的功能，涵盖角色属性、战局机制、物品系统、经济和访问卡。

核心功能

角色与战局调整

• 修改所有档案的基础生命值、能量和水分值
• 调整所有地图的战局时长
• 自定义进入战局时的物品携带上限

武器与弹药

• 调整弹匣装填、卸弹和检查时间
• 修改所有弹药类型的堆叠数量

物品与市场

• 解除跳蚤市场物品售卖限制
• 调整每等级最大活跃报价数量
• 默认设置所有物品为已检查状态

消耗品

• 配置 stimulator 使用次数、重量和价格倍率（除吗啡外所有注射器）

访问卡

• 自定义实验室（Labs）和迷宫（Labyrinth）访问卡的最大使用次数

地图显示

• 可选在地图选择界面显示迷宫地图

所有功能通过集中的 config.json 文件管理，允许用户灵活启用或禁用特定功能并调整参数，以实现个性化的游戏体验。

配置指南

config.json 配置文件默认位于 SPT/user/mods/Easygame/data。

• v1.0.0 版本：必须至少运行一次服务端以等待配置自动生成。您也可以手动创建包含以下所有键的配置文件，并根据需要预先设置所需功能。
• v1.0.0 之后版本：默认会提供配置文件，允许您在启动服务端前设置所需功能。

{
    // 功能启用/禁用开关
    "EnableFunction": {
        // 是否解除所有物品的跳蚤市场售卖限制
        "IsUnlockAllItemsSellLimit": true,
        // 是否在地图选择界面显示迷宫地图
        "ShowMapToChoiceScene": true,
        // 是否自定义带入战局的物品上限
        "EnterGameItemLimit": true,
        // 是否修改生命值、能量和水分值
        "EnergyHydrationModify": true,
        // 是否修改战局时长
        "RaidTimeModify": true,
        // 是否修改弹匣装填/卸弹/检查时间
        "AmmoTimeModify": true,
        // 是否修改跳蚤市场每等级最大活跃报价数量
        "MaxActiveOfferCountModify": true,
        // 是否调整实验室访问卡使用次数
        "AdjustLabsAccess": true,
        // 是否调整迷宫访问卡使用次数
        "AdjustLabysAccess": true,
        // 是否修改 stimulator 耐久度（不含吗啡）
        "AdjustSimulatorMaxHpResource": true,
        // 是否调整弹药堆叠数量
        "AdjustAmmoStack": true,
        // 是否默认所有物品为已检查状态
        "AllExaminedByDefault": false
    },
    // 刺激物配置设置
    "StimulatorConfig": {
        // 刺激物使用次数
        "UseTimes": 10,
        // 刺激物价格倍率
        "PriceModify": 5,
        // 刺激物重量（千克）
        "Weight": 0.5
    },
    // 进入战局时最大物品上限
    "EnterGameItemLimit": 3600,
    // 所有档案的生命值倍率
    "HealthModify": 1.5,
    // 所有档案的能量和水分倍率
    "EnergyHydrationModify": 1.5,
    // 战局时长倍率
    "RaidTimeModify": 3,
    // 弹匣装填时间倍率
    "TakeInAmmoTimeModify": 0.05,
    // 弹匣卸弹时间倍率
    "TakeOutAmmoTimeModify": 0.05,
    // 弹匣检查时间倍率
    "CheckAmmoTimeModify": 0.45,
    // 跳蚤市场每等级最大活跃报价倍率
    "MaxActiveOfferCountModify": 7,
    // 实验室访问卡最大使用次数
    "LabsAccessMaximumNumberOfUsage": 10,
    // 迷宫访问卡最大使用次数
    "LabysAccessMaximumNumberOfUsage": 10,
    // 弹药堆叠数量
    "AmmoStack": 300
}

Introduction

Tarkov’s vanilla system feels weightless, this full recoil replacement mod attempts to improve it. Recoil is now mostly based on your weapon’s caliber, which makes weapons of the same caliber/platform perform similarly across the board. As an added benefit it also makes things easier to balance, which wasn’t really possible before with the Legacy version of Recoil Rework. The mod also overhauls visual recoil and makes things more wibbly-wobbly and stuff.

The mod is still in it’s early stages so any feedback is welcome.

Why not update the original Recoil Rework?

I wanted to keep the original Recoil Rework readily available for those that prefer it or need it for some other reason. The two mods also have a very different approach to handling recoil so I think a new release is warranted. Do not install both versions (Legacy & Rewrite), only pick one!

Preview

Installation

Drag and drop. Like any other mod.

Known Issues

• Sprinting while in left stance messes up your weapon position for the rest of the raid (fixed in 1.0.1)
• Inspection screen recoil values lie to you
• Only certain attachments (grips and muzzle devices) currently contribute towards recoil reduction. This is due to bullpups being incapable of having stocks, upper receivers and such.
• Some weapons cause busy hands in the hideout and you’ll have to restart your game if this happens. Probably an invisible nullref somewhere, I wouldnt know.
• Probably something else, let me know!

Compatibility

The mod is compatible with WTT-Content Backport and WTT-Armory out of the box. However, if you’d like to add your own custom calibers then you can do so within the server mod in SPT/user/mods/RecoilReworkServer/Config/CaliberData/. You can also modify weapon data in SPT/user/mods/RecoilReworkServer/Config/WeaponData/. There are plenty of examples, so go wild!

Example caliber data:

// example_caliber.jsonc
{
    "CaliberOne": {
        "BaseVerticalKick": 40,
        "BaseHorizontalKick": 30,
        "BaseRollKick": 250,
        "BaseBackwardsRecoil": 4
    },
    "CaliberTwo": {
        "BaseVerticalKick": 20,
        "BaseHorizontalKick": 15,
        "BaseRollKick": 120,
        "BaseBackwardsRecoil": 4
    }
}

Example weapon data:

// example_weapon.jsonc
[
    {
        // use either weaponId or weaponIds. DO NOT USE BOTH!
        "weaponId": "5fb64bc92b1b027b1f50bcf2"
        "weaponIds": [
            "5fb64bc92b1b027b1f50bcf2",
            "5fc3f2d5900b1d5091531e57"
        ],
        // caliber multipliers for the specified weapons, in case a weapon has a special recoil mitigation system
        "weaponRecoilModifiers": {
            "VerticalKickMultiplier": 0.3,
            "HorizontalKickMultiplier": 0.25
        },
        // you can override any vanilla weapon properties here
        "overrideProperties": {
            // really nice recoil pivot value
            "RecoilCenter": {
                "x": 0.05,
                "y": -0.3,
                "z": 0
            }
        }
    }
]

A small list of mods I would recommend using alongside Recoil Rework:

• Fontaine’s FOV Fix
• Better Rear Sights
• HollywoodFX
• Eye Relief Tweak

… and a few others, but I’m gatekeeping them.

Full control over SPT’s economy through config files. Every feature is independently toggleable and fully configurable : pick what you need, ignore the rest. Whether you want to tweak a few trader stocks or rebuild the economy from scratch, it’s all just config.

Getting Started

⚠️ By default, every feature in this mod is disabled. Install it as-is and nothing changes in your game - it’s a clean slate.

Each feature has a dedicated on/off switch in masterConfig.json. Flip it to true and the feature is live. That’s it. Every switch maps directly to one of the tabs in this description, which contains the full documentation and config reference for that feature.

• 🏷️ EnableDefaultTrades — 🟢 On by default → see the Default Trades tab
• 🔀 EnableRoutedTrades — 🔴 Off by default → see the Routed Trades tab
• 🛒 EnableManualTrades — 🔴 Off by default → see the Manual Trades tab
• 👤 EnableFenceConfig — 🔴 Off by default → see the Fence tab
• 🏪 EnableBuybackConfig — 🔴 Off by default → see the Buyback tab
• 📦 EnableSupplyConfig — 🔴 Off by default → see the Supply tab
• 📝 EnableHandbookPricesConfig — 🔴 Off by default → see the Handbook Prices tab
• 📈 EnableFleaMarketConfig — 🔴 Off by default → see the Flea Market tab
• 🛡️ EnableInsuranceConfig — 🔴 Off by default → see the Insurance tab
• 🏠 EnableHideoutConfig — 🔴 Off by default → see the Hideout tab
• ⚗️ EnableCraftingConfig — 🔴 Off by default → see the Crafting tab

Pick what you need, leave the rest off. Features are fully independent - run any combination you want.

The three main features that control what players see at traders are Default Trades, Routed Trades and Manual Trades. It’s worth understanding the difference before diving in.

🏷️ EnableDefaultTrades keeps vanilla trader assorts intact and applies patches on top of them, for instance replacing barter requirements with a straight cash price. Setting it to false wipes all vanilla assorts entirely and ignores defaultTradesConfig.json.

🔀 EnableRoutedTrades takes a completely different approach : it rebuilds trader offers from scratch based on the handbook. Every item gets automatically assigned to a trader according to category rules you define. If set to false, routedTradesConfig.json will be entirely ignored.

🛒 EnableManualTrades lets you define specific offers for specific traders with full control over every parameter : item, price, currency, barter, durability, attachments. Completely independent from the other two. If set to false, manualTradesConfig.json will be entirely ignored.

⚠️ Use Notepad++ or VSCode to edit your config files, the default Windows Notepad will mess up your formatting and won’t warn you about syntax errors. —–> Download Notepad++ - Download VSCode

💡 The mod ships with an extras folder containing category_dump.json and item_dump.json : direct dumps of the database. If you’re just looking for a specific item or category ID, these are significantly more conveninent to copy&paste from than ItemFinder : open the file, Ctrl+F, done. item_dump.json includes all items added by WTT - Content Backport.

Patches vanilla trader assorts without replacing them entirely. Useful when you want to keep the default stock but clean up how trades work.

⚙️ Configuration : defaultTradesConfig.json

Blacklist — List of TPLs to remove from all trader assorts unconditionally. Applied before any other patch.

PriceMultipliers — Per-trader cash price multiplier. Only affects cash-only offers (rub/usd/eur) — barter schemes are ignored. Keyed by trader ID.

NoBarterTraders — Replaces barter schemes with a straight cash payment at handbook price, per trader. Each trader entry supports:

• Enabled — whether this trader’s barters are converted
• Currency — currency to use for the converted price : "rub" | "eur" | "usd". EUR and USD amounts are calculated from the handbook rouble price using the in-game exchange rate.
• ExcludedBarterTpls — list of item TPLs to exclude. If every item in a barter scheme belongs to this list, the scheme is left untouched. Useful to preserve GP coin or lega medal trades selectively.

Reads every item in the handbook at runtime and automatically assigns it to a trader based on a category map you define in config. The routing system follows the handbook’s category hierarchy : define a route for “Weapons” and every sub-category inherits it automatically. Ships with a full pre-built map covering all vanilla item categories.

For modded content — RouteModdedItemsOnly detects items not present in the vanilla handbook and routes only those to traders. Every item added by every mod you have installed shows up at a trader immediately, at handbook price. The vanilla_items.json file in the mod’s root folder is used as the reference to determine what’s vanilla and what isn’t.

For visibility — ForceRouteAll bypasses all filters and routes every item in the handbook. Combined with AllItemsExamined, nothing is hidden.

For economy overhauls — instead of hand-editing dozens of assort json files, you maintain a single config that describes the intent and the mod handles the rest.

⚙️ Configuration : routedTradesConfig.json

• ForceRouteAll — Route every handbook item regardless of category routes and blacklists.
• RouteModdedItemsOnly — Only route items not present in vanilla_items.json (modded items). Mutually exclusive with RouteVanillaItemsOnly.
• RouteVanillaItemsOnly — Only route items present in vanilla_items.json (vanilla items). Mutually exclusive with RouteModdedItemsOnly.
• FallbackTrader — When ForceRouteAll is true, items with no matching category route go here. Always priced in roubles.
• TraderCurrencies — Currency used for routed offers, per trader.
• Blacklist — Items that are never routed to any trader, regardless of category routes.

Completely independent from auto-routing. Define specific trades for specific traders with full control over every parameter.

⚙️ Configuration : manualTradesConfig.json

Each offer supports:

• Rouble price or barter payment (or both combined)
• Stack count (-1 for unlimited)
• Loyalty level requirement
• Durability for weapons and armor
• Manual children (explicit attachments)
• Auto-resolved required children — for items with required slots (armor plates etc.), the mod automatically injects the correct child items by reading the template from the DB, recursively.

Controls Fence’s item generation and offer injection. Fence is handled differently from other traders internally : this feature is independent from EnableDefaultTrades, EnableRoutedTrades, and EnableManualTrades.

⚙️ Configuration : fenceConfig.json

The config is split into three sub-sections.

⚫ Default Item Pool

SPT’s native Fence generation system. On each refresh, SPT randomly picks items from a built-in pool and generates offers from them.

• EnableDefaultItemPool — Master switch for default item pool. If false, zeroes all native generation counts entirely and also disables Default Item Pool Additions, regardless of EnableDefaultItemPoolAdditions.
• AssortSize — Number of regular items (ammo, meds…) per refresh.
• WeaponPresetMinMax — Number of preconfigured weapons with mods per refresh.
• EquipmentPresetMinMax — Number of preconfigured armor rigs per refresh.
• ItemPriceMult — Price multiplier applied to all regular items.
• PresetPriceMult — Price multiplier applied to all weapon and equipment presets.

All of the above also have a Discount* variant that applies to the secondary discount tab, unlocked at Fence rep level 6.

⚫ Default Item Pool Additions

🚨 EXPERIMENTAL, not battle-tested. This feature was added mostly out of curiosity and hasn’t received much attention since. I don’t personally use it and have no plans to in the near future, so I haven’t invested time in making it robust. It will likely misbehave with weapons or armors. If you just want to throw a couple of simple items into the vanilla pool it might do the job, but if you actually care about controlling what Fence stocks, just set EnableDefaultItemPool: false and use the Custom Item Pool : it’s more reliable and more flexible.

Extends the built-in pool with extra items of your choice. Only active if EnableDefaultItemPool is also true.

• EnableDefaultItemPoolAdditions — switch for this sub-section only.
• DefaultItemPoolAdditions — list of items to inject into the native pool. Each entry supports:
  • Tpl — item template ID
  • RoublePrice — price in roubles
  • LoyaltyLevel — Fence rep level required (1 = always visible)

⚫ Custom Item Pool

Completely independent from the default pool. Defines a weighted pool of offers that are injected directly into Fence’s assort on every refresh, on top of whatever the default pool generates.

• CustomItemCount — How many offers to draw from the pool per refresh.
• CustomItemPriceMultiplier — Global price multiplier applied to all custom offers. Useful to scale the entire pool up or down without editing each entry individually.
• CustomItemPool — the pool to draw from. Each entry supports:
  • Tpl — item template ID
  • Weight — relative draw chance. Higher values mean the item is more likely to be picked. Items with Weight: 0 are ignored.
  • StackSize**** — quantity per offer slot
  • CurrencyTpl — currency TPL (roubles, dollars, euros, GP coin, Lega medal, or any other item)
  • Price — price in the chosen currency, before CustomItemPriceMultiplier is applied
  • LoyaltyLevel — Fence rep level required (1 = always visible)

💡 The weighted draw means you can mix rare and common items in the same pool — a weapon with Weight: 2 is twice as likely to appear as one with Weight: 1. Set extreme values (e.g. Weight: 100 vs Weight: 1) to simulate truly rare drops.

💡 Example config included. The default fenceConfig.json ships with a ready-to-use custom pool listing every weapon in the game — including all weapons added by WTT - Content Backport — all priced in GP coins. Feel free to use it as a starting point or strip it down to whatever you actually need.

Controls what each trader will accept from the player. Each trader can be configured independently — or left untouched if you want to keep vanilla behavior for specific ones.

⚙️ Configuration : buybackConfig.json

Each trader can be set to one of four modes:

• Default — leaves the vanilla buy policy untouched
• Disabled — trader refuses to buy anything from the player
• Categories — trader only accepts items from the specified handbook category IDs
• AllWithBlacklist — trader accepts all handbook items except those explicitly blacklisted

Controls trader restock timers and stock amounts per restock cycle.

⚙️ Configuration : supplyConfig.json

RestockTimes — Restock interval in seconds for each trader. If the configured interval is shorter than the trader’s current timer, the timer is clamped immediately on server start — no need to wait out the old one.

StockMultipliers — Multiplies the purchasable quantity (BuyRestrictionMax) of trader items per restock cycle. Items with no buy restriction (truly unlimited) are not affected.

• EnableByTrader — Apply a flat multiplier per trader.
• EnableByCategory — Apply a multiplier per handbook category. Sub-categories inherit the parent multiplier automatically.

💡 Both modes can be active simultaneously — multipliers are combined.

⚠️ Stock multipliers are not compatible with routed trades. Routed offers are automatically injected as unlimited stock, which means they have no BuyRestrictionMax to multiply, the supply patcher skips them entirely. This is a known limitation with no planned fix for now, as unlimited stock is the intended behavior for routed trades. If you need stock restrictions on specific items, use manual trades instead.

Overrides the handbook price of any item by TPL.

⚙️ Configuration : handbookPricesConfig.json

A flat dict of TPL → price in roubles. Any item in the game can be overridden here.

"62330c18744e5e31df12f516": 186, // .357 Magnum JHP
"59faff1d86f7746c51718c9c": 35000 // Physical bitcoin

Handbook prices are the foundation of several SPT systems, this feature has broad effects beyond just what’s visible at traders :

• Routed trades — routed offer prices are derived from handbook price, so overriding a price here directly changes what it costs at the trader.
• Trader sell prices — what traders pay when buying items from the player is also handbook-based.

Controls dynamic flea market offer generation. Trader flea offers are not affected by any of these settings.

⚙️ Configuration : fleaMarketConfig.json

• Disable — Disables all dynamic flea market offer generation entirely. Both blocks new offer generation and purges any offers already present at server start. Trader offers are not affected.

• DynamicForceDisable — List of TPLs to remove from dynamic flea offers. Sets CanSellOnRagfair = false on matching item templates. Nothing outside the listed TPLs is touched.

• DynamicForceEnable — List of TPLs to force into dynamic flea offers. Sets CanSellOnRagfair = true on matching item templates. Nothing outside the listed TPLs is touched.

Both lists are applied independently and can coexist. If the same TPL appears in both, ForceEnable wins as it runs last.

The flea market is, in my opinion, a leftover from the live game that has no place in a balanced solo/coop experience. It adds a lot of clicking for not much actual fun, and there are better ways to introduce randomness into the economy. That said, I’ll add the occasional feature for it if needed.

Disable insurance globally or selectively by category and item TPL.

⚙️ Configuration : insuranceConfig.json

• DisableAll — Disables insurance on every item in the game. If true, the blacklists below are ignored.
• CategoryBlacklist — Disables insurance on all items belonging to the specified handbook categories. Sub-categories are included automatically. Ships with the full vanilla category list pre-filled, all disabled by default.
• TplBlacklist — Disables insurance on specific items by TPL.

💡 CategoryBlacklist and TplBlacklist are cumulative, an item is blacklisted if it matches either one.

📝 All other insurance-related settings are already covered by ServerValueModifier. No point duplicating them here.

Full control over hideout area requirements, construction times, and the bitcoin farm through config files.

💡 The default hideoutConfig.json ships with every area pre-configured to match vanilla exactly. Enabling the feature without changing anything produces zero difference in-game, it’s just a clean starting point. Edit only what you want to change, leave the rest as-is.

⚙️ Configuration : hideoutConfig.json

Area fields

• RemoveFromDb — removes the area from the database entirely.
• Enabled — whether the area is available to the player.
• DisplayLevel — whether the current level is displayed in the UI.

Construction time

• UseCustomConstructionTime — master toggle. If false, vanilla construction times are left untouched.
• ConstructionTime — dict of stage level → time in seconds. Stages not listed default to 0. Use an empty dict {} to set everything to instant.

Requirements

Each requirement type (Item, Area, Skill, TraderLoyalty) is controlled independently via a UseCustom* toggle and a matching dict.

• When true : vanilla requirements of that type are cleared on every stage first, then the dict is injected per stage.
• When false : vanilla requirements of that type are left completely untouched.
• To only clear without injecting anything, set the toggle to true and leave the dict empty {}.

Dict keys are stage level strings ("1", "2", "3"…). Stages not listed are left as-is after the clear.

Each requirement type expects the following fields per entry :

• ItemRequirements — ItemTpl, ItemCount
• AreaRequirements — AreaName (matches HideoutAreas enum, case-insensitive), AreaLevel
• SkillRequirements — SkillName, SkillLevel
• TraderRequirements — TraderName (trader nickname, case-insensitive), TraderLoyalty

Found in Raid

• RequireFoundInRaid — forces IsSpawnedInSession on every item requirement across all areas and all stages, after all custom patches have been applied. true = FIR required everywhere, false = FIR removed everywhere, null = untouched.

Bitcoin farm

• ProductionSpeedMultiplier — divides the base production time. e.g. 2.0 = twice as fast. (default: 1.0 → 145000s per bitcoin)
• MaxCapacity — maximum number of bitcoins that can accumulate. (default: 3)
• GpuBoostRate — GPU boost rate per card. (default: 0.041225)

Define custom crafting recipes per hideout area, and optionally clear all existing recipes for specific areas before injecting your own.

💡 The default craftingConfig.json ships with all vanilla recipes pre-configured. Enabling the feature without changing anything produces zero difference in-game; it’s just a clean starting point. Add your own recipes, remove ones you don’t want, or wipe entire areas and rebuild them from scratch.

⚙️ Configuration : craftingConfig.json

• ClearAreas — list of hideout areas whose vanilla recipes will be wiped before injection
• Recipes — recipes grouped by hideout area. Each recipe supports area level requirement, end product, count, production time, fuel requirement, and a list of input requirements (items or area levels)

Most features work out of the box with modded content. Auto-routing, manual offers, buyback rules, AllItemsExamined, and handbook price overrides all operate on TPLs — as long as you know the correct TPL for a modded item, you can reference it anywhere in the config exactly like a vanilla one. I haven’t done extensive compatibility testing though, and this is something I’ll look to improve in future updates.

Tested compatible mods:

• More Energy Drinks by Hood
• WTT - Content Backport by GrooveypenguinX

⚠️ Any mod that touches the same systems as RZCustomEconomy will conflict. This includes mods that modify trader assorts, flea market offers, hideout requirements or production times, crafting recipes, or trader buyback policies.

This mod is not to be taken seriously

22 Crackshot is the wretched mind child of me seeing a drug bust gun that was made from a flare pistol and thinking “that’d be funny in tarkov” and now we have this..

The gun and ammunition can be purchased from Skier.

Huge shoutout to EpicRangeTime, GrooveyPengiunX, and Bushtail. This mod would have taken ALOT longer without their generous assistance.

Another thank you to Bobinstein for their .22 models that i used for refs.

I do not remember what video the 22spear is from. image was sent by a friend.

A utility library extracted and optimized from various mods, specifically designed for SPT (Single Player Tarkov) server modding.

The current stable version (v1.0.0) includes core functionalities for File Size Calculation & Formatting, Internationalization (I18N), and a Modular Logging System.

Tip: For detailed code examples and implementation patterns, please refer to the SuntionCore.Tests project included in the source repository.

Key Features

1. Magnitude Formatter

A robust tool for formatting numerical values with dynamic units (e.g., KB, MB, GB).

• Provides sealed configuration types (MagnitudeConfig) and common presets (MagnitudePreset).
• Automatically formats numbers into readable strings based on step thresholds (e.g., 12.12 KB, 36.24 MB).

2. File Size Utilities (FileSizeUtil)

Efficient tools for handling file metrics.

• Calculate raw file sizes in bytes via static methods or string extensions.
• Convert file paths directly into human-readable size strings with customizable decimal precision.
• Includes built-in exception handling for invalid paths or inaccessible files.

3. Internationalization (I18N)

A comprehensive multi-language management system.

• Instance Management: Supports multiple independent translation contexts identified by name.
• Dynamic Loading: Batch loads language files (xx.json) from directories.
• Advanced Syntax:
  • Chain keys using :: for concatenated translations.
  • Parameter replacement using {{VariableName}} syntax.
• Database Integration: Optional integration with DatabaseServer to track and utilize SPT’s native localization dictionaries (SptLocals).

4. Modular Logging (ModLogger)

A dedicated logging system designed to separate mod-specific logs from the main server output.

• Isolation: Each mod writes to its own log file(s), preventing main log pollution.
• Strategies: Supports single-file rotation and multi-file separation by log level (Info, Warn, Error, Debug).
• Auto-Cleanup: Configurable file size limits to automatically purge old logs upon server startup.
• Thread-Safe: Ensures safe concurrent access across multiple threads.

Since all the above functions of this module manage instances through static properties, you can use them anywhere

ModLogger is particularly suitable for recording debugging information that needs to be output, without having to search through the SPT logs for your own logs among other module logs.

How to Reference This Library

To use SuntionCore in your own mod project:

1. Copy DLL: Install this mod to your SPT instance, then copy SuntionCore.dll from user/mods/SuntionCore/ into a libs folder within your mod project.
2. Update Project File: Add the following reference to your .csproj file:

   <ItemGroup>
       <Reference Include="SuntionCore.dll">
           <HintPath>libs\SuntionCore.dll</HintPath>
           <Private>False</Private>
       </Reference>
   </ItemGroup>
   

   Note: Ensure <Private> is set to False to prevent bundling the DLL with your mod output.

Create mod dependencies using the following code:

class YourModMetadata
{
    public override Dictionary<string, Range>? ModDependencies { get; init; } = new()
    {
        { "com.suntion.suntioncore", new Range(">=1.0.0") }
    };
}

Quick Usage Overview

String Extensions

Extend standard strings with powerful utility methods:

• .ToFileSize(): Returns a formatted file size string (e.g., "61.23 KB").
• .CalFileSize(): Returns the raw file size in bytes (long).
• .Translate(): Retrieves localized text with support for key chaining and argument injection.

Workflow Examples

Formatting Numbers: Use MagnitudeFormatter to convert raw values into unit-based strings instantly.

Handling Files: Call FileSizeUtil.GetFileSize(path) to get a readable size string, or use the extension method on any path string.

Localization:

1. Initialize with I18N.Initialize(databaseServer). (This initialization is required only if you need the I18N system to track SPT’s native translation dictionary based on the current language. Once initialized, you can access this dictionary via the SptLocals property.)
2. Get an instance via I18N.GetOrCreateI18N("MyMod").
3. Load JSON language packs and switch languages dynamically.
4. Translate keys with automatic parameter substitution.

Logging:

1. Create a logger: ModLogger.GetOrCreateLogger("MyMod").
2. Log messages using .Info(), .Warn(), .Error(), or .Debug().
3. Logs are automatically written to user/mods/SuntionCore/ModLogs.

Documentation & API

For complete API definitions, method signatures, and advanced configuration options, please consult the dedicated API manuals:

• English: API_EN.md
• Chinese: API_ZH.md

Credits

Inspired by and built upon the concepts of:

• MassivesoftCore & MassivesoftWeapons: For SPT library architecture and referencing standards.
• SPT Item Creator: For local mod logging concepts.
• Raid Record: For file size calculation and internationalization logic.
• SuntionCore (Original Mod): For magnitude-based value formatting.

一个从多个模组中提取并优化的工具库，专为 SPT (单机塔科夫) 服务端模组开发设计。

当前稳定版本 (v1.0.0) 包含了 文件大小计算与格式化、国际化 (I18N) 以及 模块化日志系统 等核心功能。

提示： 如需详细的代码示例和实现模式，请参考源代码仓库中包含的 SuntionCore.Tests 项目。

主要特性

1. 量级格式化器 (Magnitude Formatter)

一个强大的工具，用于格式化带有动态单位（如 KB、MB、GB）的数值。

• 提供密封的配置类型 (MagnitudeConfig) 和常用预设 (MagnitudePreset)。
• 根据步进阈值自动将数字格式化为可读字符串（例如 12.12 KB, 36.24 MB）。

2. 文件大小工具 (FileSizeUtil)

处理文件指标的高效工具。

• 通过静态方法或字符串扩展计算原始文件大小（字节）。
• 直接将文件路径转换为人类可读的大小字符串，支持自定义小数精度。
• 包含对无效路径或无法访问文件的内置异常处理。

3. 国际化 (I18N)

一个全面的多语言管理系统。

• 实例管理： 支持多个由名称标识的独立翻译上下文。
• 动态加载： 从目录批量加载语言文件 (xx.json)。
• 高级语法：
  • 使用 :: 连接键以实现串联翻译。
  • 使用 {{VariableName}} 语法进行参数替换。
• 数据库集成： 可选择与 DatabaseServer 集成，以跟踪和利用 SPT 的原生本地化词典 (SptLocals)。

4. 模块化日志 (ModLogger)

一个专用的日志系统，旨在将特定模组的日志与主服务器输出分离。

• 隔离性： 每个模组写入自己的日志文件，防止主日志被污染。
• 策略： 支持单文件轮转和按日志级别（Info, Warn, Error, Debug）分离到多文件。
• 自动清理： 可配置文件大小限制，在服务器启动时自动清理旧日志。
• 线程安全： 确保跨多个线程的并发访问安全。

由于本模块以上所有功能均通过静态属性管理实例，因此您可以在任何地方使用它们

ModLogger 特别适合记录需要输出的调试信息，而无需在 SPT 日志中从其他模块的日志里费力查找您自己的日志。

如何引用此库

要在您自己的模组项目中使用 SuntionCore：

1. 复制 DLL： 将此模组安装到您的 SPT 实例中，然后将 user/mods/SuntionCore/ 目录下的 SuntionCore.dll 复制到您的模组项目中的 libs 文件夹内。
2. 更新项目文件： 在您的 .csproj 文件中添加以下引用：

   <ItemGroup>
       <Reference Include="SuntionCore.dll">
           <HintPath>libs\SuntionCore.dll</HintPath>
           <Private>False</Private>
       </Reference>
   </ItemGroup>
   

   注意：确保将 <Private> 设置为 False，以防止将 DLL 打包到您的模组输出中。

使用以下代码创建模组依赖：

class YourModMetadata
{
    public override Dictionary<string, Range>? ModDependencies { get; init; } = new()
    {
        { "com.suntion.suntioncore", new Range(">=1.0.0") }
    };
}

快速使用概览

字符串扩展

为标准字符串扩展强大的实用方法：

• .ToFileSize(): 返回格式化的文件大小字符串（例如 "61.23 KB"）。
• .CalFileSize(): 返回原始文件大小（字节，long 类型）。
• .Translate(): 获取本地化文本，支持键链接和参数注入。

工作流示例

格式化数字： 使用 MagnitudeFormatter 立即将原始值转换为基于单位的字符串。

处理文件： 调用 FileSizeUtil.GetFileSize(path) 获取可读的大小字符串，或在任何路径字符串上使用扩展方法。

本地化：

1. 使用 I18N.Initialize(databaseServer) 初始化。（仅当您需要 I18N 系统根据当前语言跟踪 SPT 的原生翻译词典时，才需要此初始化。初始化后，您可以通过 SptLocals 属性访问此词典。）
2. 通过 I18N.GetOrCreateI18N("MyMod") 获取一个实例。
3. 加载 JSON 语言包并动态切换语言。
4. 使用自动参数替换翻译键。

日志记录：

1. 创建日志记录器：ModLogger.GetOrCreateLogger("MyMod")。
2. 使用 .Info(), .Warn(), .Error() 或 .Debug() 记录消息。
3. 日志将自动写入 user/mods/SuntionCore/ModLogs 目录。

文档与 API

有关完整的 API 定义、方法签名和高级配置选项，请查阅专门的 API 手册：

• 英文： API_EN.md
• 中文： API_ZH.md

致谢

灵感源自并构建于以下项目的概念：

• MassivesoftCore & MassivesoftWeapons：关于 SPT 库架构和引用标准。
• SPT Item Creator：关于本地模组日志记录的概念。
• Raid Record：关于文件大小计算和国际化逻辑。
• SuntionCore (原始模组)：关于基于量级的数值格式化。

Just some changes I made for my own playthrough and decided to share as a mod.

Kriss Vector 9x19mm

• Increased fire rate (1100 RPM)

Revolvers

• Removed double action accuracy penalty:
  • RSH-12
  • Chiappa Rhino 9mm
  • Chiappa Rhino .357
  • MTs-255

Attachments & Compatibility

• AA-12 Barrels: Added compatibility with more muzzle devices.
• RPD Barrels: Added compatibility with more muzzle devices.
• PKM Barrel: Added compatibility with more muzzle devices.
• KEDR Threaded Adapter: Added compatibility with more muzzle devices.
• Alpha Dog Suppressor: Added compatibility with various sights.

1. Download the Make-Tarkov-Great-Again.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.

Have an idea?

If you have suggestions for:

• New weapon rebalances.
• Attachment compatibility tweaks.
• QoL improvements.

Feel free to leave a comment or reach out.

• Make Meds Great Again by viniHNS
• Make Shotguns Great Again by viniHNS
• Make VPO-101 Great Again by viniHNS
• Make PL-15 Great Again! by viniHNS
• Make STM9 Great Again! by viniHNS

• The AA-12 silenced sound is weird.

Collection of most of saintdeer’s mod posted.

Included Weapons:

• 🔹 QBZ-191 5.8x42 Assualt Rifle
• 🔹 MCX Virtus 5.56x45/.300blk Assualt Rifles
• 🔹 Mk47 Dissent 7.62x39 Assualt Rifle

All sound bundles have been rebuilt to fix the issue where gunfire sounds did not change according to the environment (indoor/outdoor)

Decompress and put the folder SPT under [Your EFT Directory]/

• If you installed MassivesoftTrader, things this mod added will show up in the new Trader’s page.

• To disable a certain component, remove the coresponding folder under SaintDeerWeapons/subs/

• Theoretically compatible with Fika and WTT-armory. Not fully tested. No guarantee.

Collection of most of my weapon mod posted and and saintdeer’s GRAU.

Included Weapons:

• 🔹 BAL-27 5.7x28 Assualt Rifle
• 🔹 DG-56 5.56x45 Assualt Rifle
• 🔹 GRAU 5.56x45/7.62x39 Rifles
• 🔹 ISO .45ACP/9x19 Submachinguns
• 🔹 ISO Hemlock 5.56x45/7.62x51/.300blk Assualt Rifles
• 🔹 JAK-12 12ga Automatic Shotgun
• 🔹 (New) KATT AMR .50 BMG Bolt-action Rifle
• 🔹 Longbow 7.62x39 Bolt-action Rifle
• 🔹 M14 7.62x51 Rifle
• 🔹 MCW 5.56x45 Assualt Rifles
• 🔹 (New) MCX 5.56x45 Barrel
• 🔹 (New) MHG Hand Grenades
• 🔹 New COD Mags from MW
• 🔹 QBZ-03 5.56x45 Assualt Rifle
• 🔹 QBZ-97 5.56x45 Assualt Rifle
• 🔹 Superi46 4.6x30 Submachinegun
• 🔹 TR75/76/77 Assualt Rifles
• 🔹 Type 64 7.62x25 Slienced Submachinegun
• 🔹 Vector .308 Assualt Rifle
• 🔹 Various New Ammo

All sound bundles have been rebuilt to fix the issue where gunfire sounds did not change according to the environment (indoor/outdoor)

Decompress and put the folder SPT under [Your EFT Directory]/

• Not completely compatible with profile created with AmightyTank’s Massivesoft Gun due to the inconsistent ID used by GRAU. Remove anything related with GRAU might work.

• Tavor X95 & X95-R is not included since WTT have a better one.

• To disable a certain component, remove the coresponding folder under MassivesoftWeapons/subs/

• Theoretically compatible with Fika and WTT-armory. Not fully tested. No guarantee.

MassivesoftCore is a library required for my mods to fuction. Basically it functions as an item loader and compatibility solver.

You can use it as a dependency to build your own mod but no support or documentation will be provided.

Decompress and put the folder MassivesoftCore under [Your EFT Directory]/SPT/user/mods

For versions later than 1.0.2: Decompress and put the folder SPT under [Your EFT Directory]/