Keep Sealed Cases (KSC)

Tarkov is a harsh place, but some things just shouldn’t vanish without a trace. Ever wonder where that sturdy weapons case goes after you pry it open for the loot inside? Wonder no more! Keep Sealed Cases (KSC) rectifies this Tarkov anomaly.

This mod ensures that upon opening any sealed weapons case, you will promptly receive a brand new, fully functional weapons case delivered directly to your in-game mail. Enjoy the loot without the immersion-breaking disappearance of a valuable case.

Features

• Intelligent Detection: The mod uses a “Data Signature” check to smartly determine when a case has been unpacked. It only triggers when a target case is deleted AND multiple new items are added to your inventory, preventing it from incorrectly activating when you sell, delete, or trade a case.
• Highly Configurable RNG System (Optional): Don’t want a guaranteed reward? You have full control! The entire system can be enabled or disabled in the config.json file. When enabled, you can choose between two modes:
  • Simple Mode: A flat percentage chance to receive a case.
  • Skill-Based Mode: A dynamic chance calculated from your character’s Intellect, Attention, and Crafting skills. All parameters (base chance, bonus per skill level, max chance, and even which skills are used) are fully tunable in the config!
• Immersive Notifications: The mod provides clear feedback for every outcome.
  • Success: Receive your new case with one of several randomized, lore-friendly success messages.
  • Failure: If the RNG roll doesn’t succeed, you’ll get a message explaining that the case was “broken” in the process, so you’re never left wondering.

Installation

1. Unzip the downloaded file.
2. Drag and drop the user folder into your root directory.

Future Plans

• Expanded Container Support: I am exploring the possibility of adding functionality for different items, such as the Sealed Box or the Locked Case from previous events.
• ~~Optional “Hardcore” RNG System:~~ (Completed)
  • ~~For players who want a more balanced or “lore-friendly” experience, I am considering an optional RNG system. When enabled in the config file, this would introduce a configurable chance that the case “breaks” upon unpacking.~~

Compatibility

This mod was developed and fully tested on SPT-AKI 3.11.3. It may work on other 3.X.X versions but is not guaranteed and may require modification of the package.json.

Configuring the RNG System

The Keep Sealed Cases (KSC) mod includes a highly configurable chance-based system to determine if you receive a replacement case after unpacking. All customization is done by editing the config.json file located in your user/mods/[KSC] KeepSealedCases/ folder.

1. How to Enable or Disable the RNG System

By default, the RNG system is disabled, meaning you are guaranteed to receive a replacement case every time.

To turn the system on, open config.json and change "enabled" from false to true.

To Enable RNG:

"rngSystem": { "enabled": true, "type": "skill", ... }

To Disable RNG (Guaranteed Reward):

"rngSystem": { "enabled": false, "type": "skill", ... }

2. How to Choose Your RNG Type

When the RNG system is enabled, you can choose between two different modes using the "type" setting.

• "simple": A flat percentage chance. Quick and easy.
• "skill": A dynamic chance based on your character’s skill levels. More immersive and rewarding.

Example: To use the "simple" chance mode:

"rngSystem": { "enabled": false, "type": "simple", ... }

3. Configuring “Simple” Mode

If you set the "type" to "simple", the mod will use the "simpleChance" value. This is a number from 1 to 100 representing your percentage chance of success.

Example: Setting a 60% chance to receive a case:

"rngSystem": { ... "simpleChance": 60, ... }

4. Configuring “Skill-Based” Mode

This is the most advanced mode. Your chance to receive a case is calculated dynamically based on your character’s skills.

"skillBased": {
  "baseChance": 15,
  "skillBonuses": {
    "Intellect": 1.0,
    "Attention": 0.75,
    "Crafting": 0.5
  },
  "maxChance": 90
}

• "baseChance": This is your starting success chance, even with level 0 skills. It acts as a safety net for new characters.
• "maxChance": This is the absolute maximum success chance you can achieve, no matter how high your skills are. This ensures there is always an element of risk.
• "skillBonuses": This is where you define which skills matter and how much they contribute.
  • The "key" (e.g., "Intellect") is the exact, case-sensitive name of the skill.
  • The "value" (e.g., 1.0) is the percentage point bonus you get for each level of that skill.

Customizing Skills: You can easily add, remove, or change the skills and their bonus values. For example, if you wanted to add WeaponMaintenance to the calculation, you would simply add it to the list:

"skillBonuses": {
  "Intellect": 1.0,
  "Attention": 0.75,
  "Crafting": 0.5,
  "WeaponMaintenance": 0.25
},

Now, your Weapon Maintenance skill will also contribute to your success chance!

Troubleshooting & Debug Logs

If you are experiencing issues with the mod (e.g., not receiving a case), you can enable detailed logging to help diagnose the problem.

1. Navigate to your mod’s folder at user/mods/[KSC]KeepSealedCases/.

2. Open the config.json file with a text editor (like Notepad).

3. Change the enableLogging value from false to true.

   Before:

   { "enableLogging": false, "logFileName": "ksc.log" }
   

   After:

   { "enableLogging": true, "logFileName": "ksc.log" }
   

4. Save the config.json file and restart your SPT server.

5. Perform the action in-game that is causing the issue (e.g., open a sealed case).

6. A new log file will be generated inside your mod folder at user/mods/[KSC]KeepSealedCases/logs/ksc.log.

7. Please share the contents of this ksc.log file when you report an issue. This information is essential for troubleshooting!

8. Remember to set enableLogging back to false when you are done.

Credit

I decided to make this mod after my brother brought it up while we were playing.