TaczAttributeAdd

TAA Mod - Мод улучшения атрибутов Tacz

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

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

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

Характеристики урона, специфичные для огнестрельного оружия

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

Основные характеристики огнестрельного оружия (всего 20)

• Время ADS: 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 = ложь, 1,0 = правда.
• Пассивная активация: такие атрибуты, как отключение звука, автоматически запускают условия (<1,0).

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

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

1. Максимальный режим (по умолчанию)

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

2. АДДИТИВНЫЙ РЕЖИМ

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

3. МУЛЬТИПЛИКАТИВНЫЙ РЕЖИМ

• Формула: base_damage * specific_damage
• Умножает базовый урон и урон, специфичный для огнестрельного оружия.

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

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

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

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

• Безопасность клиента:

• Методы пользовательского интерфейса, помеченные @OnlyIn(Dist.CLIENT).

• Миксины на стороне клиента, настроенные в taa.mixins.json.

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

• Согласованность данных:

• Модификаторы полностью совместимы с системой аксессуаров TACZ.

• Расчеты выполняются на стороне сервера

• Обновления атрибутов через стандартный AttachmentPropertyManager.

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

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

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

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

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