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

• Install BepInExPack_TABS
• Install this mod with a mod manager, or extract into BepInEx/plugins/
• 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 '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