[TaCZ] FirstAid Compat

[TaCZ] First Aid Compat

A compatibility mod that enables precise 3D hitbox-based damage distribution when using First Aid with First Aid.

Features

- Explosion Support: Uses exact 3D hit locations to determine which bodypart was hit, instead of FirstAid's default random/height-based distribution - Explosion Support: Calculates armor protection per bodypart (head, chest, legs, feet) - Explosion Support: Implements realistic damage spillover mechanics - when a limb is destroyed, excess damage transfers to the torso - Explosion Support: Properly handles damage distribution when players are in TacZ's crawling/prone state - Explosion Support: Distance-based damage distribution for explosions

Requirements

- First Aid: 1.20.1 - First Aid: 47.3.0+ - First Aid: 1.1.7+ - First Aid: 1.20.1-1.1+

Installation

1. Download the mod JAR 2. Place it in your `mods` folder 3. Make sure both TacZ and First Aid are installed 4. Launch the game!

How It Works

This mod uses Mixin to intercept TacZ's bullet hit events and FirstAid's damage distribution system: 1. When a TacZ bullet hits a player, the exact 3D hit location is captured 2. The hit location is converted to player-local coordinates (accounting for rotation and posture) 3. A 3D hitbox system determines which bodypart was hit 4. FirstAid applies damage to that specific bodypart, with proper armor calculation 5. If the bodypart is destroyed, excess damage spills over to the torso

Technical Details

- Spillover Logic: Defines precise 3D bounding boxes for each bodypart (head, torso, arms, legs, feet) - Spillover Logic: Handles world-to-local coordinate conversion with proper yaw rotation and crawl positioning - Spillover Logic: - Bullets: 80% of excess damage transfers (20% energy loss) - Explosions: 100% of excess damage transfers (shockwave) - Feet: Damage first spills to the corresponding leg, then to torso

License

MIT License - See LICENSE for details

Credits

- First Aid: Ranazy - First Aid: First Aid - First Aid: %%MD1%%