Skip to content

Server mod for SPTarkov (SPT) adding a new item with OP armor.

License

Notifications You must be signed in to change notification settings

jbs4bmx/HoltzmanShield

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Forks Stargazers Issues MIT License


logo

Holtzman Shield

More armor based loosely on the technology from Frank Herbert's Dune!

ko-fi

Table of Contents
  1. About The Project
  2. Getting Started
  3. Configuration
  4. Roadmap
  5. Contributing
  6. License
  7. Acknowledgments

About The Project

Type: Server Mod
Disclaimer: This mod is provided as-is with no guarantee of support.

This mod adds a new variant of armband based loosely on the shield technology from the Novel/Movies "Dune". It adds armor protection for body parts as defined in the configuration file. You may alter the level of protection by editing the values found in the 'config.json' file.

Values of armorCollider array assigned by Armor mod options.

Mod Option Configurable Value Assigned Value
Head true/false ParietalHead, BackHead, HeadCommon
Neck true/false NeckFront, NeckBack
Eyes true/false Eyes
Ears true/false Ears
Jaw true/false Jaw
Back true/false SpineTop, SpineDown
Arms true/false LeftUpperArm, LeftForearm, RightUpperArm, RightForearm
Sides true/false RightSideChestUp, RightSideChestDown, LeftSideChestUp, LeftSideChestDown
Front true/false RibcageUp, RibcageLow
Pelvis true/false Pelvis
Buttocks true/false PelvisBack
Legs true/false RightThigh, RightCalf, LeftThigh, LeftCalf

(back to top)

Built With

Frameworks/Libraries Name Link
TypeScript TypeScript Website
IDEs Name Link
VSCodium VSCodium Website

(back to top)

Getting Started

This section will explain how to install and use this mod.

Prerequisites

This mod requires the ArmBandCore mod to function properly.
EFT and SPT are required to use this mod.

Installation

For the purpose of these directions, "[SPT]" represents your SPT folder path.

Start by downloading the mod from the Releases page.

Follow these steps to install and configure the mod:

  1. Extract the contents of the zip file into the root of your [SPT] folder.
    • That's the same location as "SPT.Server.exe" and "SPT.Launcher.exe".
  2. Edit the Config to adjust the values to your liking.
  3. Start SPT.Server.exe and wait until it fully loads.
  4. Start SPT.Launcher.exe.
  5. Now you can launch the game and profit.

(back to top)

Configuration

Edit '.\config.jsonc' file as desired. Specify which areas to protect, the amount of protection, and which item you want HS to look like. You can even customize trader pricing and loyalty level requirements to make it easier or harder on yourself to acquire this item.

{
    "ArmorCoverage": {
        // Customize Holtzman Shield armor protection areas.
        // This value must be true or false.
        "Head": true,
        "Neck": true,
        "Eyes": true,
        "Ears": true,
        "Jaw": true,
        "Arms": true,
        "Front": true,
        "Back": true,
        "Sides": true,
        "Pelvis": true,
        "Buttocks": true,
        "Legs": true
    },
    "ArmorAmount": {
        // Customize Holtzman Shield armor durability level.
        // This must be a whole number ranging from 1-9999999.
        "Durability": 100000
    },
    "Resources": {
        // Customize Holtzman Shield item properties.
        "ArmorClass": "10",
        "ArmorMaterial": "Ceramic",
        "ArmorType": "Heavy",
        "ItemWeight": 0.01,

        // This is the amount of protection from bright lights.
        // This must be any number value between 0 and 1 (e.g., 0, 0.25, 0.5, 0.8, 1, etc.)
        "BlindnessProtection": 1,

        // I recommend keeping this at or below 100
        // This must be a whole number ranging from 1-2000.
        "RepairCost": 100,

        // Customize trader (Ragman) properties
        "traderPrice": 1000,
        "traderLoyaltyLevel": 1
    },
    "PreFab": {
        // If more than one is set to 'true', then PreFab will revert to default (Evasion).
        "Evasion": true,
        "Alpha": false,
        "DeadSkul": false,
        "TrainHard": false,
        "TwitchRivals": false,
        "Bear": false,
        "Kiba": false,
        "Labs": false,
        "RFArmy": false,
        "TerraGroup": false,
        "Untar": false,
        "USEC": false,
        "Blue": false,
        "Green": false,
        "Red": false,
        "White": false,
        "Yellow": false,
        "Unheard": false,
        "Arena": false,
        // The following item(s) is(are) not yet part of the game. (WIP - Ignore for now.)
        "BlackDivision": false
    },
    "GodMode": {
        // Disable damage dealt by blunt force trauma.
        "BluntForce": true,

        // (WIP) Disable damage from projectile penetration of armor.
        // This value is a work in progress and is not currently implemented in this mod. - Please ignore for now.
        "Penetration": false
    },
    "Blacklist": {
        // Set to 'true' to disable item spawning on PMC or Scav bots, or to remove from global loot pools.
        "pmc": false,
        "scav": false,
        "globalLoot": false
    }
}

(back to top)

Mod FAQ

Q: Where do I report bugs found with the current version of the mod?
A: You can report bugs for the current version of this mod on the HS Mod Page.

Q: Why can't I see the different prefab for the armband?
A: Make sure you only have one of the options set to true. The remaining prefab options should be false. Before you launch the game, be sure to clear (delete) the cache files.

(back to top)

Roadmap

  • Add Changelog
  • Fix bugs found/reported in SPT 3.9.5

Suggest changes or view/report issues here.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

You can also buy me a coffee! (This is not required, but I greatly appreciate any support provided.)
ko-fi

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Acknowledgments

Contributors:

  1. sugonyak
    • Assitance in testing and bug fixes.
  2. ShadowXtrex
    • Assitance in testing and bug fixes.
    • Code optimizations.

(back to top)

About

Server mod for SPTarkov (SPT) adding a new item with OP armor.

Resources

License

Stars

Watchers

Forks

Packages

No packages published