[KSC] Keep Sealed Cases 1.0.4

Ever thought it was weird the weapons case just disappears after unpacking? Yeah me too, now it doesn't.

[KSC] Keep Sealed Cases

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! [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.

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

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

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

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

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

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

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

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.

• Navigate to your mod's folder at user/mods/[KSC]KeepSealedCases/.

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

• Change the enableLogging value from false to true.

  Display Spoiler

  Before:

  JSON: config.json

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

  <strong>After:</strong>

  JSON: config.json

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

  
  

• Save the config.json file and restart your SPT server.
• Perform the action in-game that is causing the issue (e.g., open a sealed case).
• A new log file will be generated inside your mod folder at user/mods/[KSC]KeepSealedCases/logs/ksc.log.
• Please share the contents of this ksc.log file when you report an issue. This information is essential for troubleshooting!
• 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.