Hardcore Armor Management (HAM)

[size=4][b]Description[/b][/size]
[b]Hardcore Armor Management[/b] transforms KCD2’s plate armor from a simple stat‑stick into a [b]living, skill‑based system[/b]. Every piece of heavy armor now requires time to put on or take off, and doing so while running, drunk, or hungover can literally trip you up. But as you repeatedly don and doff your gear, Henry becomes proficient—toggle times shorten, trip chances plummet, and you unlock the ability to perform delicate tasks even in full gauntlets.
The mod also introduces a [b]sleep‑armor penalty[/b], a [b]chest/door locker[/b], and [b]mastery buffs[/b] that alter your movement speed, exhaustion rate, and boot durability based on how skilled you are with each armor piece.

[size=4][b]How It Works (Player's View)[/b][/size]
[list]
[][b]You buy or find a shiny new plate helmet, arm armor, chest plate, leg armor, and gauntlets. You put them all on in the inventory screen.[/b][/]
[][b][b]The moment you close the inventory, every single piece is stripped off.[/b] Armor doesn't just magically appear on Henry—he has to strap it on.[/b][/]
[][b][b]You press the hotkey for a piece (say, [b]][/b] for chest).[/b] Audio plays (buckles, straps, metal clinks), and your screen briefly blurs. This takes a few seconds.[/b][/]
[][b][b]If you're sprinting while strapping on heavy plate legs, there's a good chance you'll trip and ragdoll.[/b] The faster you move, the riskier it gets. Being drunk or hungover makes it even worse.[/b][/]
[][b][b]After you've done this many times for a particular slot, Henry gets proficient.[/b] Toggle times shorten, the blur fades faster, and the chance of tripping drops. You'll see a notification when you reach Novice, Adept, Expert, or Master tier for that piece.[/b][/]
[][b][b]Plate gauntlets block delicate actions until you've mastered them.[/b] At first, you can't eat, wash, pick herbs, brew potions, or lockpick while wearing gauntlets. Each action unlocks at a certain tier (eating at Novice, washing at Adept, herbs/alchemy at Expert, lockpicking at Master).[/b][/]
[][b][b]Sleeping in armor reduces how much exhaustion you recover.[/b] The penalty per piece shrinks as your mastery rises, vanishing completely at Master rank.[/b][/]
[][b][b]Press [b]L[/b] to lock the nearest chest or door.[/b] It's not perfect (sphere‑scan limitations) but works for roleplaying.[/b][/]
[][b][b]Passive buffs change your movement speed, exhaustion rate, and boot durability based on your mastery.[/b] Low tiers penalize you; high tiers reward you.[/b][/]
[/list][b]Essentially, the mod turns putting on heavy armor into a [b]deliberate, risky, skill‑based ritual[/b] that evolves as Henry's proficiency grows.

[size=4][b]Installation instructions[/b][/size][/b]
[list]
[][b]Download the HAM file.[/b][/]
[][b]Extract into your KCD2 Mods folder so the structure looks correct.[/b][/]
[/list][b]
[size=4][b]Keybinds[/b][/size]
The following hotkeys are active after the mod is installed:[/b]
[list]
[][b][b]=[/b] – Toggle [b]Helmet[/b] (Head armor)[/b][/]
[][b][b][[/b] – Toggle [b]Arm armor[/b] (Arms)[/b][/]
[][b][b]][/b] – Toggle [b]Chest armor[/b] (Chest)                                                 [/b][/]
[][b][b]'[/b] – Toggle [b]Leg armor[/b] (Legs)[/b][/]
[][b][b]\[/b] – Toggle [b]Gloves[/b] (Hands)[/b][/]
[][b][b]L[/b] – Lock the nearest chest/door (Chest Locker, WIP)[/b][/]
[/list][b](If you squint, those keys sort of form a little guy. :) [b]Kinda.[/b])
[img width=200,height=200]https://files.catbox.moe/ufvjw7.png[/img]
The ragdoll keybind (used when you trip) is provided by the [b]Ragdoll Hotkey[/b] mod.

[size=4][b]Configuration[/b][/size]
All settings are in the file armortoggle.lua inside the .pak.
Open the .pak with 7‑Zip, extract the .lua, edit the values, save, and repack the archive (make sure the .pak stays uncompressed / Store mode).

[b]Resetting Skill Progress[/b]
Toggle counts are stored globally, not per‑save. If you start a new playthrough and want to reset all mastery tiers to zero, open the console ([b]~[/b]) and type:[/b]
[code]ham_reset_skills[/code][b]This will wipe all toggle counts so your new Henry starts fresh. You only need to do this once when beginning a new game.

[size=4][b]Main features[/b][/size]
[b]Toggle‑Based Armor System[/b][/b]
[list]
[][b]Dedicated hotkeys for [b]Head, Arms, Chest, Legs, Hands[/b].[/b][/]
[][b]Each toggle takes several seconds and is accompanied by immersive audio and a brief cinematic blur.[/b][/]
[][b][b]Cancellable[/b] – press the same key again to abort.[/b][/]
[][b][b]Smart Auto‑Strip[/b] – on game load, the mod automatically re‑applies your saved armor state (no manual hotkey presses needed).[/b][/]
[/list][b]
[b]Skill Mastery Tiers[/b]
Every time you complete a toggle, that armor slot gains experience. Mastery is split into four ranks:[/b]
[list]
[][b][b]Novice (25%)[/b] – Slightly faster toggling, minor trip reduction.[/b][/]
[][b][b]Adept (50%)[/b] – Moderate speed & trip bonuses.[/b][/]
[][b][b]Expert (75%)[/b] – Significant bonuses.[/b][/]
[][b][b]Master (100%)[/b] – Max toggle speed, max trip reduction, and special perks.[/b][/]
[/list][b]The required toggles for Master are configurable (default: 100). All bonuses scale smoothly.

[b]Risk & Reward[/b][/b]
[list]
[][b][b]Speed‑based Tripping[/b] – running while toggling increases your chance to stumble and ragdoll. The faster you go, the riskier it gets.[/b][/]
[][b][b]Drunk / Hangover Penalties[/b] – being drunk or hungover drastically increases trip chances and toggle durations.[/b][/]
[][b][b]Slot‑specific Trip Multipliers[/b] – heavy legs are much more dangerous to toggle while moving than light gloves.[/b][/]
[/list][b]
[b]Gauntlet Restrictions (with mastery unlocks)[/b]
Wearing plate gauntlets blocks certain actions until you’ve mastered them:[/b]
[list]
[][b][b]Eating[/b] – unlocks at Novice.[/b][/]
[][b][b]Washing[/b] – unlocks at Adept.[/b][/]
[][b][b]Herbs / Alchemy[/b] – unlocks at Expert.[/b][/]
[][b][b]Lockpicking[/b] – unlocks at Master.[/b][/]
[/list][b]
🛏️ [b]Sleep Armor Penalty[/b]
Sleeping in plate armor reduces your exhaustion recovery. The penalty per piece decreases as your mastery grows, reaching zero at Master rank.

[b]Chest & Door Locker (WIP)[/b]
Press [b]L[/b] to lock the nearest lockable object (chest or door). Useful for role‑playing and securing your stash.

[b]Mastery Buffs (Integrated)[/b]
Passive, tier‑based stat changes are built into the mod—no extra downloads needed:[/b]
[list]
[][b][b]Movement Speed[/b] – penalized at low tiers, becomes a bonus at Master.[/b][/]
[][b][b]Exhaustion Speed[/b] – tire faster in untrained armor, slower when mastered.[/b][/]
[][b][b]Boot Durability[/b] (legs only) – plate legs wear out boots; mastery reduces the damage.[/b][/]
[/list][b]

[size=4][b]Requirements[/b][/size][/b]
[list]
[][b][b]KCDUtils[/b] – Provides UI notifications, audio triggers, math helpers, and the database interface. Required.[/b][/]
[][b][b]LuaDB[/b] – Standalone or bundled persistent storage mod. Handles saving/loading of toggle counts and armor state. Required.[/b][/]
[][b][b]Ragdoll Hotkey[/b] – Enables the on‑demand ragdoll effect used by HAM’s tripping mechanic. Also provides the ragdoll keybind that HAM forwards. Required.[/b][/]
[/list][b]
[size=4][b]Known Issues & Compatibility[/b][/size][/b]
[list]
[][b][b]Mod Conflicts:[/b] The glove‑restriction system overrides vanilla interaction triggers (washing, eating, alchemy, etc.). Mods that alter the same triggers may conflict.[/b][/]
[][b][b]Chest Locker:[/b] Currently uses a sphere‑scan; may occasionally target an object slightly to your side rather than straight ahead. This is an engine limitation.[/b][/]
[/list][b]
[size=4][b]Shout outs[/b][/size][/b]
[list]
[][b][b]Special thanks:[/b] The KCD2 modding community for their pioneering tools and documentation.[/b][/]
[][b][b]Ragdoll Keybind Mod author[/b] – for the ragdoll mechanic that makes tripping so much fun.[/b][/]
[][b][b]KCDUtils team[/b] – for creating the indispensable modding framework.[/b][/]
[][b][b]LuaDB author[/b] – for the persistence layer that makes all progress permanent.[/b][/]
[/list]