S&box Wiki

Revision Difference

Hitboxes#547931

<cat>Code.Misc</cat>⤶ <cat>Code.Physics</cat>⤶ <title>Hitboxes</title> # Using Hitbox Tags We removed hitgroups in favour of Hitbox Tags, similar to how we use them for collisions. Here's how they work. ## ModelDoc When editing a hitbox from ModelDoc, you'll see Hitbox Tags. Populate them with some useful keywords like so: <upload src="97/8dab065acd70d6e.png" size="18164" name="image.png" /> <note>You don't need to update the Citizen's hitbox tags, we've done that for you</note> ## API When running traces, you'll see TraceResult.Hitbox. That'll hold all the info you'll need when interacting with hitboxes. We also pass it with DamageInfo. Before, you'd be given a hitbox index, and that's it. It wasn't elegant at all. With hitbox tags, it's way more explicit: ```csharp ... var isHeadshot = damageInfo.Hitbox.HasTag( "head" ); if ( isHeadshot ) { // Multiply headshot damage by 2 damageInfo.Damage *= 2f; } ``` You can also grab the hitbox's name with [Hitbox.GetName()](https://asset.party/api/Hitbox.GetName()) - useful for debugging.