[KSC] Keep Sealed Cases

Islingr added a new file:

File

[KSC] Keep Sealed Cases

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

Islingr

12 hours ago

Quote

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

hub.sp-tarkov.com/attachment/10550/

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.

Display Spoiler

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:

JSON: config.json

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

To Disable RNG (Guaranteed Reward):

JSON: config.json

    "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:

JSON: config.json

    "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:

JSON: config.json

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

JSON: config.json

        "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 Weapon Maintenance to the calculation, you would simply add it to the list:

JSON: config.json

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

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

Display More

Islingr added a new version:

File

[KSC] Keep Sealed Cases 1.0.4

Changelog - Version 1.0.4
This is a major feature update for [KSC] Keep Sealed Cases, introducing more intelligent inventory detection and a highly configurable RNG system.

Added
"Data Signature" Detection: Implemented a more robust method to detect when a case is truly "unpacked". The mod now only triggers when a target case is deleted AND multiple new items are added to the inventory in the same action. This prevents the mod from incorrectly sending a reward when a case is manually deleted,…

Islingr

12 hours ago

Quote

Changelog - Version 1.0.4

This is a major feature update for [KSC] Keep Sealed Cases, introducing more intelligent inventory detection and a highly configurable RNG system.

Added

"Data Signature" Detection: Implemented a more robust method to detect when a case is truly "unpacked". The mod now only triggers when a target case is deleted AND multiple new items are added to the inventory in the same action. This prevents the mod from incorrectly sending a reward when a case is manually deleted, fails to unpack due to space, or sent to another player via other mods(FIKA.)

Optional RNG System: Added a highly configurable, optional system to determine if a replacement case is received after unpacking. This can be fully customized in the config.json file. (Disabled in config by default)

Dual RNG Modes: Users can choose between a "simple" flat percentage chance or a new "skill"-based system.

Skill-Based Chance: When enabled, the success chance is dynamically calculated based on the player's current levels in Intellect, Attention, and Crafting. All values (Which skills to scale off of, base chance, bonus per skill level, and max chance) are tunable in the config.

Randomized Player Notifications: To enhance immersion, the mod now provides dynamic feedback.

If the RNG roll succeeds, you will receive your new case with one of several randomized success messages.

If the RNG roll fails, you will receive a lore-friendly message explaining that the case was "broken" in the process, ensuring you are never left wondering about the outcome.

File Logging System: Comprehensive overhaul of the logging system that writes detailed debug information to a file at user/mods/[KSC] KeepSealedCases/logs/ksc.log. This can be enabled or disabled in the config.json and will assist with any future troubleshooting. (Disabled in config by default)

Display More