BreakableShields

Breakable Shields

Shields in Totally Accurate Battle Simulator are no longer invincible.

They gain their own health, take damage from melee hits and blocked projectiles, and drop from the unit's hands when broken.

Features

• Shield HP: 200 + 3 × holder max health (configurable); melee damage taken ×3
• Melee damage: Hitting a held shield damages the shield instead of ignoring it
• Projectile blocks: Successful blocks also chip shield HP
• Catch zone: An invisible collider 30% larger than the visible shield catches projectiles that would barely miss; the collider is shifted fully outward so it never extends into the holder's own body, and hits are projected back onto the visible shield so arrows and VFX always land on the shield, never in the air
• Shield bash stagger: When the shield's own CollisionWeapon actually deals damage, the target is staggered for damage × 0.005 seconds (100 damage = 0.5s). Stagger prevents moving and attacking but the unit stays standing — no ragdoll. Self and friendly hits never trigger
• Break behavior:
• Shield drops as a physics prop
• Blocking is disabled
• Two-handed grips release both hands
• Empty hands are filled with fist weapons so one-hand shield units stay playable

Install

1. Install BepInExPack_TABS
2. Install this mod with a mod manager, or extract into BepInEx/plugins/
3. Launch the game

Config

After first launch: BepInEx/config/local.breakableshields.cfg

Key — Default — Description

Enabled — true — Enable the mod

BaseHealth — 200 — Base shield HP

HolderHealthMultiplier — 3 — Extra HP = multiplier × holder max health

MeleeDamageMultiplier — 3 — Melee damage scale vs shields

ProjectileDamageMultiplier — 1 — Projectile damage scale vs shields

DropOnBreak — true — Drop shield on break

DisableBlockOnBreak — true — Disable blocking on break

ExtendedCatchScale — 1.3 — Invisible catch collider size relative to the visible shield

BashBaseDamage — 100 — Fallback bash damage when the shield's own CollisionWeapon deals none

BashStaggerPerDamage — 0.005 — Stagger seconds per point of bash damage (100 dmg = 0.5s)

DebugLog — false — Extra log spam

Notes

• Detects shields via BlockMove / SurfaceBlock components, or names containing shield / buckler / pavise
• Broken shields are renamed with _Broken and treated as dropped props
• The catch collider is removed while the shield is not held, so dropped shields rest on the ground normally
• Shield bash stagger requires the shield to have a CollisionWeapon component (i.e. the shield is configured as a weapon)

Changelog

2.0.0

• Shortened manifest description to fit Thunderstore's 256 character limit

1.0.0

• Initial release
• Shield HP = 200 + 3 × holder max health; melee damage taken ×3
• Invisible 30% larger catch zone with hit positions projected onto the visible shield
• Shield bash stagger proportional to damage actually dealt; movement/attack lock without ragdoll
• Shields drop when broken; empty hands receive fist weapons