TaczAttributeAdd - Tacz属性拓展

TAA Mod - Tacz属性增强模组

属性系统

伤害属性

• 通用枪械伤害: taa:bullet_gundamage - 所有枪械的基础伤害加成

枪械专属伤害属性

• 手枪: taa:bulletgundamagepistol - 手枪专属伤害加成
• 步枪: taa:bulletgundamagerifle - 步枪专属伤害加成
• 霰弹枪: taa:bulletgundamageshotgun - 霰弹枪专属伤害加成
• 狙击步枪: taa:bulletgundamagesniper - 狙击步枪专属伤害加成
• 冲锋枪: taa:bulletgundamagesmg - 冲锋枪专属伤害加成
• 轻机枪: taa:bulletgundamagelmg - 轻机枪专属伤害加成
• 发射器: taa:bulletgundamagelauncher - 发射器专属伤害加成（如RPG）

核心枪械属性（共20项）

• 瞄准时间: taa:ads_time - 瞄准速度加成（数值越低越快）
• 弹药速度: taa:ammo_speed - 子弹速度加成
• 护甲穿透: taa:armor_ignore - 护甲穿透能力
• 有效射程: taa:effective_range - 最大有效射击距离
• 移动惩罚: taa:move_speed - 枪械移动速度降低
• 爆头倍率: taa:headshot_multiplier - 爆头伤害倍率
• 击退力: taa:knockback - 子弹击退力度
• 穿透次数: taa:pierce - 子弹实体穿透次数
• 射速: taa:roundsperminute - 每分钟射击速率
• 后坐力: taa:recoil - 枪械后坐力降低
• 散布度: taa:inaccuracy - 子弹散布减少（数值越低越好）
• 重量: taa:weight - 枪械重量降低（数值越低越好）
• 弹匣容量: taa:magazine_capacity - 弹匣容量加成
• 装填时间: taa:reload_time - 装填速度加成
• 近战伤害: taa:melee_damage - 近战攻击力加成
• 近战范围: taa:melee_distance - 近战攻击范围加成
• 子弹数量: taa:bullet_count - 每次射击弹丸数量加成

特殊效果

• 消音: taa:silence - 消音效果（<1.0激活被动消音）
• 点燃: taa:ignitefire - 子弹点燃几率

爆炸系统

• 爆炸半径: taa:explosion_radius - 爆炸半径加成
• 爆炸伤害: taa:explosion_damage - 爆炸伤害加成
• 爆炸击退: taa:explosion_knockbacknew - 爆炸击退效果
• 方块破坏: taa:explosiondestroyblocknew - 方块破坏能力
• 爆炸延迟: taa:explosion_delay - 爆炸延迟时间

配件修饰系统

• 近战伤害: melee_damage - 近战攻击伤害
• 近战范围: melee_distance - 近战有效范围
• 弹匣容量: magazine_capacity - 弹匣容量
• 装填时间: reload_time - 装填时间
• 子弹数量: bullet_count - 每次射击弹丸数量

属性值说明

• 基础值: 1.0（100%效果）
• 加成值:
• 示例：0.5 = 50%提升（最终倍率 = 1.0 + 0.5 = 1.5倍）
• 1.0 = 100%提升（无额外效果）
• 布尔属性: 0.0 = 假，1.0 = 真
• 被动激活: 如消音等属性在满足条件时自动触发（<1.0）

伤害计算模式

可配置模式（通过taa-attributes.toml）：

• MAX模式（默认）
• 公式：Math.max(basedamage, specificdamage)
• 选择基础伤害和枪械专属伤害中的较高值

• 叠加模式
• 公式：basedamage + specificdamage - 1.0
• 合并数值同时保留基础伤害

• 乘算模式
• 公式：basedamage * specificdamage
• 基础伤害与枪械专属伤害相乘

技术实现

核心组件

• PropertyCalculator: 处理所有属性计算
• PlayerAttributeHelper: 获取玩家属性
• PropertyCacheUpdater: 在附件缓存中更新计算值
• GunPropertiesInitializer: 动态初始化枪械属性
• AttributeConfig: 管理配置设置
• GunTypeContext: 追踪当前枪械类型上下文

客户端/服务器架构

• 客户端安全:
• UI方法使用@OnlyIn(Dist.CLIENT)注解
• 客户端混合配置在taa.mixins.json中
• 无服务器端客户端代码执行

• 数据一致性:
• 修饰器完全兼容TACZ配件系统
• 计算在服务器端执行
• 属性通过标准AttachmentPropertyManager更新

计算流程

• 枪械属性处理期间的事件触发
• 通过Tacz API识别枪械类型
• 在GunTypeContext中设置上下文
• 基于模式的计算执行
• 使用新值更新缓存
• TACZ系统应用最终属性

兼容性与配置

配件系统

• 5种新修饰器类型兼容TACZ配件：
• 近战伤害
• 近战范围
• 弹匣容量
• 装填时间
• 子弹数量
• 标准化实现确保跨模组兼容性