Artifact slots, shooting camera shake, ADS zoom, ladder speed, starting money, aim assist switches (1.24.0)

- Extra artifact slots on every body armor (+1..+4, capped at 5;
  ItemPrototypes ArtifactSlots, helmets untouched, edition armors via
  the DLC branch).
- Shooting camera shake: ShootingCameraShake plus the 39 per-weapon
  *ShootCameraShake entries (CameraShakePrototypes Scale).
- ADS zoom: AimingFOVModifier and OffsetAimingFOVModifier scaled on their
  distance to 1.0 (0 = no zoom, 2 = double, floor 0.2), DLC setups too.
- Ladder climb speed (Player MovementParams.ClimbSpeedCoef) and starting
  money (CoreVariables PlayerStartingMoney).
- Aim assist off for mouse and gamepad separately: every cone of the
  matching AimAssistPresetPrototypes presets set to the Empty cone (read
  live from the Empty preset). New game file -> CACHE_SCHEMA 18.
- tests/test_v124_tweaks.py checks all of it against vanilla/; run_all
  now 38 suites + test_generate. Docs, Nexus texts, header (250) updated.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Author: Zayn995

README.md

@@ -21,7 +21,7 @@ Everyone is free to use it. This README tells you everything you need.
   `../../../`) — into an `output` folder, or directly into `~mods`.
 - Fully **portable**: settings, cache and output live next to the exe.
 
-~240 tweaks in 13 tabs (Player, Vaulting, Weight & items, Combat, NPCs & AI,
+~250 tweaks in 13 tabs (Player, Vaulting, Weight & items, Combat, NPCs & AI,
 Mutants, Factions, Weapons, Ammo, Armor, World, Economy, Traders), plus per-weapon overrides
 for 91 weapons (unique named guns and the Pre-order/Deluxe/Ultimate
 edition guns included), per-round overrides for 34

release/NEXUS_DESCRIPTION.txt

@@ -1,7 +1,7 @@
 [center][size=6][b]S2Tweaker[/b][/size]
 [b]Build your own personal tweak mod - no modding knowledge needed.[/b]
 
-[i]~240 tweaks in 13 tabs · pick your values · one click builds your .pak[/i]
+[i]~250 tweaks in 13 tabs · pick your values · one click builds your .pak[/i]
 [i]For S.T.A.L.K.E.R. 2 patch 2.0.x[/i][/center]
 
 [line]
@@ -13,16 +13,16 @@ The full source code is open under the MIT license. There is a public S2Tweaker
 
 [b]Virus scan of exactly the file on this page:[/b]
 [list]
-[*]The mod itself: [url=https://www.virustotal.com/gui/file/05bc7bae990193f8a63f04f850496cf4cea05947d83e84d58a658dacb479f878]VirusTotal - 0 of 66[/url]
+[*]The mod itself: [url=[ZIP-LINK-1.24.0]]VirusTotal - [ZIP-RESULT-1.24.0][/url]
 [*]The program file inside it, S2Tweaker.exe: [url=https://www.virustotal.com/gui/file/d72294fb338bc2fc8896d25a7395a4db466425427e1559e77185d5135a830681]VirusTotal - 0 of 71[/url]. It is pythonw.exe from python.org, byte for byte, digitally signed by the Python Software Foundation - VirusTotal labels it "File distributed by Python Software Foundation"
 [/list]
-Those numbers are for 1.23.0 (S2Tweaker.exe is byte-identical to 1.21.0's and 1.22.0's, so its report is the same). There is no other executable in the package: the one unsigned helper program of earlier versions, repak.exe, is gone since 1.23.0 (see the changelog). Earlier versions were built with PyInstaller and kept collecting false positives (1.20.0: 1 of 65 for the ZIP, 2 of 70 for the exe) even after every setting had been tried; the changelog below explains what changed.
+Those numbers are for 1.24.0 (S2Tweaker.exe is byte-identical to the one in 1.21.0 to 1.23.0, so its report is the same). There is no other executable in the package: the one unsigned helper program of earlier versions, repak.exe, is gone since 1.23.0 (see the changelog). Earlier versions were built with PyInstaller and kept collecting false positives (1.20.0: 1 of 65 for the ZIP, 2 of 70 for the exe) even after every setting had been tried; the changelog below explains what changed.
 
 [quote][b]Honesty note:[/b] every patch the tool generates is cross-checked against the game's own config files, but it has [b]not been play-tested in-game yet[/b] - bug reports in the comments are very welcome![/quote]
 
 [heading]WHAT IT DOES[/heading]
 
-A small Windows tool with sliders and checkboxes. You pick your values, it builds a ready-to-use .pak mod from them. Everything is a multiplier or toggle on top of the real values read from your game. Around [b]240 tweaks[/b], sorted into 13 tabs (Player, Vaulting, Weight & items, Combat, NPCs & AI, Mutants, Factions, Weapons, Ammo, Armor, World, Economy, Traders):
+A small Windows tool with sliders and checkboxes. You pick your values, it builds a ready-to-use .pak mod from them. Everything is a multiplier or toggle on top of the real values read from your game. Around [b]250 tweaks[/b], sorted into 13 tabs (Player, Vaulting, Weight & items, Combat, NPCs & AI, Mutants, Factions, Weapons, Ammo, Armor, World, Economy, Traders):
 
 [b]Player[/b]
 [list]
@@ -32,6 +32,7 @@ A small Windows tool with sliders and checkboxes. You pick your values, it build
 [*]Radiation, bleeding, hunger & sleepiness, headshot multiplier, explosion damage
 [*]Hit camera shake / aim punch 0-300%
 [*]Interaction reach (pick up, loot, containers) and talk distance for NPC dialogs; saving: manual, quick and autosave slot limits plus the autosave interval
+[*]Ladder climb speed; starting money for a new game
 [/list]
 
 [b]Vaulting - its own tab[/b]
@@ -50,6 +51,7 @@ A small Windows tool with sliders and checkboxes. You pick your values, it build
 [*]Magazine size on all three levels - scales a weapon's base capacity and the magazines that weapon really uses (read from its own reload table); the global slider covers all 80 magazine attachments
 [*][b]Recoil reduction from upgrades[/b]: boosts the recoil-reduction upgrades and attachments (vanilla -5 % to -30 %, capped at -100 %) - at 2000 % any recoil upgrade removes the kick entirely. Only weapons with such an upgrade installed change; community-proven on patch 2.0
 [*]Melee damage and melee range (knife & rifle butt strike)
+[*]Shooting camera shake 0-200% and ADS zoom from none to double; aim assist switched off for mouse and/or gamepad
 [*]Jamming, scoped aim sway (without breaking the offset/lean aiming)
 [*]The tool resolves the game's real weapon links and tells you when a weapon shares stats with its variants
 [/list]
@@ -195,6 +197,17 @@ If the ~mods folder doesn't exist, create it.
 
 [heading]CHANGELOG[/heading]
 
+[b]v1.24.0 - Artifact slots, shooting camera shake, ADS zoom, ladder speed, starting money, aim assist switches[/b] (~250 tweaks + ammo swap, 13 tabs)
+[list]
+[*][b]Extra artifact slots[/b] (Armor): +1 to +4 slots on every body armor, capped at 5, the game's maximum (vanilla: most armors have 2, three have 5). Helmets are untouched. Like the 'Armor Artifact Slots' mod
+[*][b]Shooting camera shake[/b] (Weapons): how much the camera shakes when you fire, 0-200 %, every weapon's own shake entry (vanilla 1.0). 0 % is the 'No Screenshake' mod. Being hit stays on the separate 'Hit camera shake' slider
+[*][b]ADS zoom[/b] (Weapons): how far the view zooms in when aiming down sights, from no zoom at all to twice the vanilla zoom (vanilla FOV factor 0.92, 0.83 for some weapons). Scopes keep their magnification. The 'No zoom while aiming' and 'Zoom in when aiming' mods in one slider
+[*][b]Aim assist off[/b] (Weapons): two switches, one for the mouse and one for gamepads. The game applies stickiness and magnetism cones to both; their strength lives in curve assets that cannot be patched, so the switches unhook the cones completely
+[*][b]Ladder climb speed[/b] (Player, vanilla coefficient 0.6) and [b]starting money[/b] for a new game (Player, vanilla 0; no effect on existing saves)
+[*]The tool reads one more game file (aim assist presets). [b]The first start re-extracts your game data once[/b] (10-20 seconds); after that everything is cached again
+[*]Not play-tested in-game, like the rest of the tool. Existing paks stay valid
+[/list]
+
 [b]v1.23.0 - No more repak.exe: the pak files are handled by plain Python now[/b] (~240 tweaks + ammo swap, 13 tabs)
 [list]
 [*][b]What changes for you:[/b] nothing in the tool. The folder no longer contains repak.exe, the open-source pak tool that earlier versions bundled for reading your game files and writing the mod pak. That job is done by the tool's own Python code now (_internal\s2tweaker\pakfile.py), which needs nothing but Python's standard library
@@ -206,6 +219,7 @@ If the ~mods folder doesn't exist, create it.
 [/list]
 
 [b]v1.22.0 - Twelve sliders from the community wish list, and a TL;DR for the Oodle setup[/b] (~240 tweaks + ammo swap, 13 tabs)
+[spoiler]
 [list]
 [*][b]Melee range[/b] (Weapons): how far the knife and the butt strike reach (vanilla 1.6 m)
 [*][b]Interaction reach and talk distance[/b] (Player): pick up items, open stashes and containers and loot bodies from farther away (vanilla 2 m, bodies 0.65 m), and start conversations from farther away (vanilla 1.3 m) - the 'Social Distancing' idea
@@ -215,6 +229,7 @@ If the ~mods folder doesn't exist, create it.
 [*]The tool now reads three more game files (flashlights, save limits, autosave). [b]The first start re-extracts your game data once[/b] (10-20 seconds); after that everything is cached again
 [*]Not play-tested, like the rest of the tool. Your existing paks stay valid
 [/list]
+[/spoiler]
 
 [b]v1.21.0 - No more PyInstaller: the launcher is the signed python.org interpreter[/b] (~230 tweaks + ammo swap, 13 tabs)
 [spoiler]
@@ -501,6 +516,7 @@ If the ~mods folder doesn't exist, create it.
 [list]
 [*]Armor protection per damage type: physical (bullets/melee), burn, shock, chemical, radiation, PSY - scales YOUR armor only, NPC armor stays vanilla, upgrade bonuses untouched
 [*]Armor & exoskeleton carry-weight bonuses 0-300% (0% = armor grants no extra carry weight)
+[*]Extra artifact slots on every body armor, +1 to +4, capped at the game's maximum of 5
 [*]Rare artifact bias 25-500%: shifts the rarity roll toward Uncommon/Rare/Epic at Common's expense (total spawn chance unchanged; ranks that can't roll Rare/Epic in vanilla still won't)
 [/list]
 [/spoiler]

release/NEXUS_FILE_DESCRIPTIONS.txt

@@ -11,8 +11,8 @@ Text gehoert ins Feld "Changelog" darunter. Beides ohne externe Links.
 
 ==================================================================
 DATEI — Main Files
-Name:          S2Tweaker 1.23.0
-File version:  1.23.0
+Name:          S2Tweaker 1.24.0
+File version:  1.24.0
 File category: Main Files
 ==================================================================
 
@@ -21,6 +21,23 @@ Unzip everything into one folder, keep the DLLs and _internal next to the exe, r
 ------------------------------------------------------------------
 
 --- Changelog ----------------------------------------------------
+1.24.0 - artifact slots, shooting camera shake, ADS zoom, ladder
+speed, starting money, aim assist switches
+
+- Extra artifact slots (Armor): +1 to +4 on every body armor, capped
+  at 5 (the game's maximum). Helmets untouched.
+- Shooting camera shake (Weapons): 0-200 % of every weapon's own
+  shake; 0 % = no screen shake when firing. Being hit is separate.
+- ADS zoom (Weapons): from no zoom to twice the vanilla zoom when
+  aiming down sights (vanilla FOV factor 0.92 / 0.83). Scopes keep
+  their magnification.
+- Aim assist off (Weapons): one switch for the mouse, one for gamepads.
+- Ladder climb speed (Player, vanilla 0.6) and starting money for a
+  new game (Player, vanilla 0; existing saves unaffected).
+- One more game file is read (aim assist presets); the first start
+  re-extracts the game data once (10-20 s).
+- Not play-tested, like the rest of the tool. Existing paks stay valid.
+
 1.23.0 - no more repak.exe: pak files are handled by plain Python
 
 - The folder no longer contains repak.exe (the open-source pak tool

release/README.txt

@@ -7,14 +7,15 @@ version and generates a clean patch-based .pak mod from exactly the values
 you change. Everything left at "(vanilla)" is not touched, so it plays nice
 with your other mods.
 
-Around 240 tweaks in 13 tabs: Player, Vaulting, Weight & items, Combat,
+Around 250 tweaks in 13 tabs: Player, Vaulting, Weight & items, Combat,
 NPCs & AI, Mutants, Factions, Weapons, Ammo, Armor, World, Economy, Traders.
 
 WHAT YOU CAN TWEAK (short tour)
 -------------------------------
 - Player: health, stamina (incl. per-action costs), walk/crouch and
   run/sprint speed, jump height, fall damage, breath hold, interaction
-  reach and talk distance, save slots and autosave interval, max carry
+  reach and talk distance, ladder climb speed, save slots and autosave
+  interval, starting money for a new game, max carry
   weight + where the overweight penalty starts, item weights per category,
   radiation, bleeding, hunger & sleepiness, headshot multiplier,
   explosions, hit camera shake / aim punch
@@ -25,12 +26,14 @@ WHAT YOU CAN TWEAK (short tour)
   Deluxe/Ultimate/Pre-order edition guns included. 9 factors each (damage,
   spread, recoil, durability, fire rate, effective range, bleeding, ADS
   move speed, ADS aim-in speed), plus magazine size, melee damage and
-  range, jamming and scoped sway. Weapons are listed with their real in-game names
+  range, jamming, scoped sway, shooting camera shake, ADS zoom and two
+  switches that turn aim assist off for mouse or gamepad. Weapons are listed with their real in-game names
   ("GunAK74_ST - AKM-74S") and the search box finds both spellings
 - Ammo on TWO levels: global sliders (damage, armor piercing, armor
   damage, cover penetration) and per-round overrides for all 34 rounds in
   14 calibers - a round's own factor beats the global one
-- Armor: global protection sliders per damage type, per-armor overrides
+- Armor: global protection sliders per damage type, extra artifact slots
+  on every body armor (capped at the game's 5), per-armor overrides
   for all 57 armors and helmets (edition pieces included, real in-game
   names), armor durability, armor carry-weight bonuses
 - NPCs & AI: damage, health, accuracy, vision & hearing range, grenade

s2tweaker/__init__.py

@@ -4,6 +4,6 @@
 Haltbarkeit, Mutanten usw.) eine Mod-Pak-Datei fuer den ~mods-Ordner.
 """
 
-__version__ = "1.23.0"
+__version__ = "1.24.0"
 
 

s2tweaker/gamedata.py

@@ -59,10 +59,11 @@
     "FlashlightPrototypes.cfg.bin",          # NPC-Taschenlampen (05.09.2026)
     "SaveLoadVariables.cfg",                 # Speicherstaende-Limit (unbinarisiert)
     "AutoSaveVariables.cfg",                 # Autosave-Intervall (unbinarisiert)
+    "AimAssistPresetPrototypes.cfg.bin",     # Aim-Assist Maus/Gamepad (06.09.2026)
 ]
 
 # Bei Aenderungen an NEEDED_FILES erhoehen -> alte Caches werden neu aufgebaut
-CACHE_SCHEMA = 17
+CACHE_SCHEMA = 18
 
 # Mutanten-Art (Fraktion) -> Praefixe der Attacken-Structs in
 # AbilityPrototypes.cfg (verifiziert; docs/V15_DATA_RESEARCH.md).
@@ -372,6 +373,34 @@ def flashlights(self) -> CfgStruct:
         Lichtwerte; die Spieler-Lampe sitzt in Blueprint-Kurven."""
         return self._parse("FlashlightPrototypes.cfg")
 
+    @cached_property
+    def aimassist(self) -> CfgStruct:
+        """AimAssistPresetPrototypes: 15 Presets (Empty, Hip/AimMouse, Hip/
+        AimGamepad + je Waffenklasse _AR/_PT/_SG/_SMG/_MG). Die Staerke
+        steckt in CurveFloat-Assets, per cfg geht nur an/aus: Kegel-SIDs
+        auf den Empty-Kegel setzen."""
+        return self._parse("AimAssistPresetPrototypes.cfg")
+
+    def armor_artifact_slots(self) -> dict[str, tuple[int, str | None]]:
+        """{SID: (Vanilla-ArtifactSlots, Edition|None)} aller Spieler-
+        Koerperruestungen (Slot Body; Helme haben 0 und bleiben draussen)."""
+        result: dict[str, tuple[int, str | None]] = {}
+        for sid, (slot, _values) in self.player_armors().items():
+            if slot != "Body":
+                continue
+            dlc = self.dlc_player_armors().get(sid)
+            if dlc is not None:
+                chain = self.dlc_item_chain(dlc[2], sid)
+                raw = self._chain_get(chain, "ArtifactSlots")
+                edition: str | None = dlc[2]
+            else:
+                raw = self.resolve(self.items, sid, "ArtifactSlots")
+                edition = None
+            if raw is None:
+                continue
+            result[sid] = (int(parse_number(raw, 0.0)), edition)
+        return result
+
     @cached_property
     def saveload(self) -> CfgStruct:
         """SaveLoadVariables (unbinarisiert): DefaultConfig.SavesLimit je