Vantage Tacz Compat

# Vantage TaCZ Compat A comprehensive mod adding body-part injuries, a consumable medical system, a weight system, stamina mechanics, and AI enemies for the TaCZ gun mod — built for the Vantage: Zero modpack. ## Core Features ### Weight System - Inventory items have weight (KG); main inventory and offhand count toward total weight - **Three-tier status**: Normal → Encumbrance (slowdown) → Overloaded (severe slowdown + jump reduction) - Configurable thresholds (default: heavy 80 KG, overload 150 KG) - `Weight Limit Boost` effect temporarily raises both thresholds - **Independent armor slowdown**: worn armor slows the player by its weight (default 80% of weight as %), stacking with the weight system - Different armor materials have different weights: Leather 10 KG/set, Iron 26 KG/set, Netherite 42 KG/set - Item tooltips show weight; armor additionally shows red "-X% Move Speed" ### Body-Part Injury System - TaCZ gunshot hits are judged by hit location — does NOT use TaCZ's `isHeadShot()` - 7 body parts: Head, Abdomen, Left/Right Arm, Left/Right Leg - **4 wound effects**: - **Heavy Wound** (Head, 20% chance): max health -10% - **Abdomen Wound** (Abdomen, 20% chance): max health -10% - **Bleeding** (Arms, 30% chance): 1 damage every ~6s, up to 4 layers, stops at HP ≤1 - **Fracture** (Legs, 20% chance): -15% speed per leg, -30% with both legs - All wounds persist until treated or death - **Fall fracture**: ≥5 block fall triggers, base 50% + 10% per block ### Painkiller System - Painkiller suppresses bleeding damage and fracture slowdowns (HUD icons remain visible) - Fractures can still stack while suppressed - On expiry: nausea + scream sound if heavy/abdomen wounds present ### Consumable Medical System - **Wheel UI** (B key): ToolBelt-style radial selector, auto-aggregates inventory consumables - **First-person 3D animation**: model follows view, with camera shake, player arms, environment lighting - **In-use HUD**: progress bar + item name + remaining seconds + cancel hint - **Two durability modes**: - `proportional`: consumes durability proportional to missing health — for healing items - `fixed`: 1 durability per use — for wound-clearing items - **Pre-use checks**: blocks use if health full or no matching wound, with feedback message - **Use restrictions**: no hotbar switching / inventory / firing / drop / swap during use - **Cancel**: press R to cancel (HUD shows key hint, supports mouse button icons) - **7 default consumables**: Bandage, Painkiller, Stim, Syringe, Medical Kit, Tourniquet, M2 IM Injection ### New Armor Mechanic (TaCZ Bullet Damage) - Bullet damage splits by `armor_ignore`: piercing portion damages health, non-piercing consumes body-part armor durability - Armor durability exhausted but NOT destroyed — protection gone, reserved for repair - Consumables can repair armor, but permanently reduce its max durability cap ### Stamina System - Sprint drains stamina, idle regenerates (with short delay) - Fatigued state when exhausted — blocks sprint until recovered - Jumping costs 10, sliding costs 20 - `Stamina Restore` effect instantly refills - Vanilla hunger disabled (requires HungerStrike) - Aiming cancels sprint - **Slide** (V key, disabled by default): slide while sprinting, 30-tick speed decay, slide-jump boost ### Player Health - Base health = 20 + 30 = 50 HP (25 hearts), configurable - Fully restored on first join and respawn ### HUD Overlays - **Health**: avatar + health bar + percentage + 4 armor durability icons + oxygen bar - **Stamina**: bar above hotbar, hides when full, turns red below 20 - **Effect status**: 9×9 effect blocks with smooth progress fill - **Consumable use**: progress bar + info below crosshair ### AI Enemies - **Soldier**: 3-state AI (Patrol → Alert → Combat), random SMG, squad aggro sharing - **Sniper**: immobilized, random sniper rifle, 3~6s shot interval - Configurable AI parameters and gun blacklist - Creative tab spawn eggs ## Key Bindings | Key | Default | Function | |-----|---------|----------| | Consumable Wheel | B | Open consumable selection wheel | | Cancel Use | R | Cancel active consumable use | | Slide | V | Slide while sprinting (if enabled) | ## Dependencies | Mod | Required | Notes | |-----|----------|-------| | Forge | Yes | ≥46 | | Minecraft | Yes | 1.20.1 | | TaCZ | Yes | ≥1.1.4 | | HungerStrike | Yes | Disables vanilla hunger | | PlayerAnimator | No | Slide animations (optional) | | ParCool | No | Stim effect (optional) | ## Localization - English (US) - 简体中文 --- ## Usage Guide ### Installation 1. Install Minecraft 1.20.1 + Forge 47.x 2. Place the following mods into the `mods/` folder: - TaCZ (≥1.1.4) - HungerStrike (≥8.0.0) - Vantage TaCZ Compat (this mod) 3. Launch the game ### Quick Start #### 1. Injuries & Treatment - After being shot by a TaCZ weapon, you may receive different wounds depending on hit location (head Heavy Wound, abdomen Abdomen Wound, arm Bleeding, leg Fracture) - Press **B** to open