Description

# TAA Mod - Tacz Attribute Enhancement Mod ## Attribute System ### Damage Attributes - **Universal Firearm Damage**: `taa:bullet_gundamage` - Base damage bonus for all firearms ### Firearm-Specific Damage Attributes - **Pistol**: `taa:bullet_gundamage_pistol` - Pistol-specific damage bonus - **Rifle**: `taa:bullet_gundamage_rifle` - Rifle-specific damage bonus - **Shotgun**: `taa:bullet_gundamage_shotgun` - Shotgun-specific damage bonus - **Sniper Rifle**: `taa:bullet_gundamage_sniper` - Sniper rifle-specific damage bonus - **SMG**: `taa:bullet_gundamage_smg` - Submachine gun-specific damage bonus - **LMG**: `taa:bullet_gundamage_lmg` - Light machine gun-specific damage bonus - **Launcher**: `taa:bullet_gundamage_launcher` - Launcher-specific damage bonus (e.g., RPGs) ### Core Firearm Attributes (20 Total) - **ADS Time**: `taa:ads_time` - Aim speed bonus (lower = faster) - **Ammo Speed**: `taa:ammo_speed` - Bullet velocity bonus - **Armor Penetration**: `taa:armor_ignore` - Armor penetration capability - **Effective Range**: `taa:effective_range` - Maximum effective shooting distance - **Mobility Penalty**: `taa:move_speed` - Firearm movement speed reduction - **Headshot Multiplier**: `taa:headshot_multiplier` - Headshot damage multiplier - **Knockback**: `taa:knockback` - Bullet knockback force - **Penetration Count**: `taa:pierce` - Bullet entity penetration count - **Firing Rate**: `taa:rounds_per_minute` - Rounds per minute rate - **Recoil**: `taa:recoil` - Firearm recoil reduction - **Inaccuracy**: `taa:inaccuracy` - Bullet spread reduction (lower = better) - **Weight**: `taa:weight` - Firearm weight reduction (lower = better) - **Magazine Capacity**: `taa:magazine_capacity` - Magazine size bonus - **Reload Time**: `taa:reload_time` - Reload speed bonus - **Melee Damage**: `taa:melee_damage` - Melee attack power bonus - **Melee Range**: `taa:melee_distance` - Melee attack range bonus - **Bullet Count**: `taa:bullet_count` - Projectiles per shot bonus ### Special Effects - **Silencing**: `taa:silence` - Silencing effectiveness (<1.0 activates passive silencing) - **Ignite**: `taa:ignitefire` - Bullet fire ignition chance ### Explosive System - **Explosion Radius**: `taa:explosion_radius` - Blast radius bonus - **Explosion Damage**: `taa:explosion_damage` - Blast damage bonus - **Explosion Knockback**: `taa:explosion_knockbacknew` - Blast knockback - **Block Destruction**: `taa:explosion_destroy_blocknew` - Block destruction capability - **Explosion Delay**: `taa:explosion_delay` - Blast delay time ### Accessory Modifier System - **Melee Damage**: `melee_damage` - Melee attack damage - **Melee Range**: `melee_distance` - Melee effective range - **Magazine Capacity**: `magazine_capacity` - Magazine capacity - **Reload Time**: `reload_time` - Reload time - **Bullet Count**: `bullet_count` - Projectiles per shot ### Attribute Value Specifications - **Base Value**: 1.0 (100% effect) - **Bonus Values**: - Example: 0.5 = 50% increase (final multiplier = 1.0 + 0.5 = 1.5x) - 1.0 = 100% increase (no additional effect) - **Boolean Attributes**: 0.0 = false, 1.0 = true - **Passive Activation**: Attributes like silencing automatically trigger conditions (<1.0) ## Damage Calculation Modes ### Configurable Modes (via `taa-attributes.toml`): 1. **MAX Mode** (Default) - Formula: `Math.max(base_damage, specific_damage)` - Selects higher value between base and firearm-specific damage 2. **ADDITIVE Mode** - Formula: `base_damage + specific_damage - 1.0` - Combines values while preserving base damage 3. **MULTIPLICATIVE Mode** - Formula: `base_damage * specific_damage` - Multiplies base and firearm-specific damage ## Technical Implementation ### Core Components - `PropertyCalculator`: Handles all attribute calculations - `PlayerAttributeHelper`: Retrieves player attributes - `PropertyCacheUpdater`: Updates calculated values in attachment cache - `GunPropertiesInitializer`: Dynamically initializes firearm properties - `AttributeConfig`: Manages configuration settings - `GunTypeContext`: Tracks current firearm type context ### Client/Server Architecture - **Client Safety**: - UI methods annotated with `@OnlyIn(Dist.CLIENT)` - Client-side mixins configured in `taa.mixins.json` - No server-side client code execution - **Data Consistency**: - Modifiers fully compatible with TACZ accessory system - Calculations performed server-side - Attribute updates via standard `AttachmentPropertyManager` ### Calculation Workflow 1. Event trigger during firearm attribute processing 2. Firearm type identification via Tacz API 3. Context setup in `GunTypeContext` 4. Mode-based calculation execution 5. Cache update with new values 6. TACZ system applies final attributes ## Compatibility & Configuration ### Accessory System - 5 new modifier types compatible with TACZ accessories: - Melee damage - Melee range - Magazine capacity - Reload time - Bullet count - Standardized implementation for cross-mod compatibility