Islingr

----- # 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:** ```json "rngSystem": { "enabled": true, "type": "skill", ... } ``` **To Disable RNG (Guaranteed Reward):** ```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 "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 "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 "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: ```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. 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:** ```json { "enableLogging": false, "logFileName": "ksc.log" } ``` **After:** ```json { "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.

----- # 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:** ```json "rngSystem": { "enabled": true, "type": "skill", ... } ``` **To Disable RNG (Guaranteed Reward):** ```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 "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 "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 "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: ```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. 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:** ```json { "enableLogging": false, "logFileName": "ksc.log" } ``` **After:** ```json { "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.

I've updated the SPTVersion in the package.json and apologize for any inconvenience. More features are planned, though my schedule has been limited due to college and work. For any issues you experience, I kindly ask that you enable logging and send me the log file to investigate. Without the log, it is nearly impossible for me to figure out the cause. Instructions on how to enable logging can be found at the bottom of the mod's description page. When I get a chance, I will update the description's styling for the new website to make it easier to read.

The mod does in fact think it's made for 3.11.3. As a temporary fix until the mod author updates the file, users can open the package.json in a note pad, change the 3.11.3 to 3.11.4, and SPT will start up just fine. Minimal testing shows the mod works as it should/cases provide the weapon case after opened.

I've updated the SPTVersion in the package.json and apologize for any inconvenience. More features are planned, though my schedule has been limited due to college and work. For any issues you experience, I kindly ask that you enable logging and send me the log file to investigate. Without the log, it is nearly impossible for me to figure out the cause. Instructions on how to enable logging can be found at the bottom of the mod's description page. When I get a chance, I will update the description's styling for the new website to make it easier to read.

Version 1.0.4 of [KSC] Keep Sealed Cases