Vantage Tacz Compat

~~# Vantage TaCZ Compat

A body-part injury addon for TaCZ, designed for the Vantage: Zero modpack.

Body-part-specific injury system for TaCZ (Timeless & Classics Zero). Getting shot in different body parts inflicts different permanent wounds — head trauma, abdominal injuries, arm bleeding, and leg fractures. A custom Painkiller effect temporarily suppresses symptoms without healing the underlying injuries.

Features

Wound System

| Body Part | Wound | Effect |
|-----------|-------|--------|
| Head | Heavy Wound | Max health −10% (permanent until death) |
| Abdomen | Abdomen Wound | Max health −6 points (permanent until death) |
| Arms | Bleeding | Damage every 0.5–2s (scales with severity, stops at 1 HP) |
| Legs | Fracture | Movement speed −15% per leg (up to −30%) |

• Bleeding stacks up to 4 layers — each additional arm hit makes you bleed faster
• Fractures stack per leg — one leg = −15%, both = −30%
• Fall damage can also cause fractures (configurable height and chance)
• All wounds are permanent until death — respawning clears everything

Painkiller System

The vantagetaczcompat:painkiller effect temporarily suppresses bleeding damage and fracture slowdowns while keeping their HUD icons visible. When the painkiller wears off, all symptoms return immediately. If you have head or abdominal wounds, the painkiller comedown causes brief nausea and a scream sound effect.

Painkiller is not given by this mod. Your modpack's medical items or commands apply it.

Clear Effects (Medical Items)

| Effect | ID | Behavior |
|--------|-----|----------|
| Wound Treatment | vantagetaczcompat:clear_wound | Clears one layer by priority: Head → Abdomen → Fracture → Bleeding |
| Bleeding Treatment | vantagetaczcompat:clear_bleeding | Clears one layer of bleeding only |

Both are instant-use — apply, do their job, and disappear within one tick.

Dependencies

• Minecraft Forge 1.20.1 (47.x)
• TaCZ 1.1.4+

Commands

/effect give @s vantagetaczcompat:painkiller 60      # Painkiller, 60 seconds
/effect give @s vantagetaczcompat:heavy_wound infinite # Heavy Wound (for testing)
/effect give @s vantagetaczcompat:bleeding infinite 2  # Bleeding, level 3 (for testing)
/effect give @s vantagetaczcompat:fracture infinite 1  # Fracture, both legs (for testing)
/effect give @s vantagetaczcompat:clear_wound          # Clear one wound layer
/effect give @s vantagetaczcompat:clear_bleeding       # Clear one bleeding layer

Configuration

After first launch, edit config/vantagetaczcompat-common.toml:

[Bullet Wound Chances]
    headWoundChance = 0.20
    abdomenWoundChance = 0.20
    bleedingChance = 0.30
    fractureChance = 0.20

[Fall Fracture]
    fallFractureChance = 0.50
    fallFractureMinDistance = 3.0

All values are 0.0–1.0. Changes take effect after /reload or restart.

How It Works

• Listens to EntityHurtByGunEvent.Pre (TaCZ) for bullet hits
• Uses TaCZ's built-in headshot detection + custom body-part zoning
• Wound effects are standard MobEffect instances — visible in HUD, removable via commands
• No mixins, no coremods — pure Forge event bus
• Server-side logic; clients need the mod for effect icons and sounds

Modpack Usage

This mod is designed for modpack integration:

1. Create medical items (bandages, splints, painkillers) that apply the built-in effects
2. Tune wound chances via config to match your pack's difficulty
3. Replace scream.ogg with your own audio file
4. Customize effect icons by replacing the PNGs in textures/mob_effect/

Credits

• TaCZ by Serene Wave Studio / Timeless Squad
  ~~