S&box Wiki

Revision Difference

Hitboxes#547773

<cat>Code.Misc</cat> <title>Hitboxes</title> ⤶ <warning>This feature is not yet available.</warning>⤶ # 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.