TaczAttributeAdd

TAA Mod - Tacz Attribute Enhancement Mod

Система атрибутов

Атрибуты урона

• Универсальный урон огнестрела: taa:bullet_gundamage - Базовый бонус к урону для всего огнестрельного оружия

Атрибуты урона для конкретных типов оружия

• Пистолет: taa:bullet_gundamage_pistol - Бонус к урону для пистолетов
• Винтовка: taa:bullet_gundamage_rifle - Бонус к урону для винтовок
• Дробовик: taa:bullet_gundamage_shotgun - Бонус к урону для дробовиков
• Снайперская винтовка: taa:bullet_gundamage_sniper - Бонус к урону для снайперских винтовок
• Пистолет-пулемёт: taa:bullet_gundamage_smg - Бонус к урону для пистолетов-пулемётов
• Ручной пулемёт: taa:bullet_gundamage_lmg - Бонус к урону для ручных пулемётов
• Гранатомёт: taa:bullet_gundamage_launcher - Бонус к урону для гранатомётов (например, РПГ)

Основные атрибуты огнестрела (всего 20)

• Время прицеливания: taa:ads_time - Бонус к скорости прицеливания (меньше = быстрее)
• Скорость пули: taa:ammo_speed - Бонус к скорости полёта пули
• Пробитие брони: taa:armor_ignore - Способность пробивать броню
• Эффективная дальность: taa:effective_range - Максимальная эффективная дистанция стрельбы
• Штраф к мобильности: taa:move_speed - Снижение скорости передвижения с оружием
• Множитель урона в голову: taa:headshot_multiplier - Множитель урона при попадании в голову
• Отбрасывание: taa:knockback - Сила отбрасывания пулей
• Количество пробитий: taa:pierce - Количество сущностей, которые пробивает пуля
• Скорострельность: taa:rounds_per_minute - Выстрелов в минуту
• Отдача: 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:explosion_destroy_blocknew - Способность разрушать блоки
• Задержка взрыва: taa:explosion_delay - Время задержки взрыва

Система модификаторов аксессуаров

• Урон в ближнем бою: melee_damage - Урон атаки в ближнем бою
• Дальность ближнего боя: melee_distance - Эффективная дальность ближнего боя
• Ёмкость магазина: magazine_capacity - Ёмкость магазина
• Время перезарядки: reload_time - Время перезарядки
• Количество пуль: bullet_count - Число снарядов за выстрел

Значения атрибутов

• Базовое значение: 1.0 (100% эффекта)
• Значения бонусов:
• Пример: 0.5 = увеличение на 50% (итоговый множитель = 1.0 + 0.5 = 1.5x)
• 1.0 = увеличение на 100% (без дополнительного эффекта)
• Булевы атрибуты: 0.0 = false, 1.0 = true
• Пассивная активация: Атрибуты вроде бесшумности автоматически срабатывают при выполнении условий (<1.0)

Режимы расчёта урона

Настраиваемые режимы (через taa-attributes.toml):

1. Режим MAX (по умолчанию)

   • Формула: Math.max(base_damage, specific_damage)
   • Выбирает большее значение между базовым и уроном для конкретного оружия

2. Режим ADDITIVE

   • Формула: base_damage + specific_damage - 1.0
   • Складывает значения, сохраняя базовый урон

3. Режим MULTIPLICATIVE

   • Формула: base_damage * specific_damage
   • Перемножает базовый урон и урон для конкретного оружия

Техническая реализация

Основные компоненты

• PropertyCalculator: обрабатывает все расчёты атрибутов
• PlayerAttributeHelper: получает атрибуты игрока
• PropertyCacheUpdater: обновляет рассчитанные значения в кэше attachment
• GunPropertiesInitializer: динамически инициализирует свойства огнестрельного оружия
• AttributeConfig: управляет настройками конфигурации
• GunTypeContext: отслеживает текущий контекст типа огнестрельного оружия

Архитектура клиент/сервер

• Безопасность клиента:
• Методы UI помечены @OnlyIn(Dist.CLIENT)
• Клиентские миксины настроены в taa.mixins.json

• Никакого выполнения клиентского кода на стороне сервера

• Согласованность данных:
• Модификаторы полностью совместимы с системой аксессуаров TACZ
• Расчёты выполняются на стороне сервера
• Обновление атрибутов через стандартный AttachmentPropertyManager

Рабочий процесс расчётов

1. Срабатывание события во время обработки атрибутов огнестрельного оружия
2. Определение типа огнестрельного оружия через Tacz API
3. Настройка контекста в GunTypeContext
4. Выполнение расчётов на основе режима
5. Обновление кэша новыми значениями
6. Система TACZ применяет финальные атрибуты

Совместимость и конфигурация

Система аксессуаров

• 5 новых типов модификаторов, совместимых с аксессуарами TACZ:
• Урон в ближнем бою
• Дальность ближнего боя
• Ёмкость магазина
• Время перезарядки
• Количество пуль
• Стандартизированная реализация для кросс-модовой совместимости