Vantage Tacz Compat

Vantage TaCZ Compat

Комплексный мод, добавляющий травмы частей тела, систему расходуемых медикаментов, систему веса, механику выносливости и ИИ-противников для оружейного мода TaCZ — создан для модпака Vantage: Zero.

Основные возможности

Система веса

• Предметы в инвентаре имеют вес (КГ); основной инвентарь и вторая рука учитываются в общем весе
• Три уровня состояния: Норма → Перегруз (замедление) → Перегрузка (сильное замедление + снижение прыжка)
• Настраиваемые пороги (по умолчанию: тяжёлый 80 КГ, перегрузка 150 КГ)
• Эффект Weight Limit Boost временно повышает оба порога
• Независимое замедление от брони: надетая броня замедляет игрока пропорционально своему весу (по умолчанию 80% веса в %), складывается с системой веса
• Разные материалы брони имеют разный вес: Кожа 10 КГ/комплект, Железо 26 КГ/комплект, Незерит 42 КГ/комплект
• Подсказки предметов показывают вес; броня дополнительно показывает красное "-X% Move Speed"

Система травм частей тела

• Попадания из оружия TaCZ определяются по месту попадания — НЕ использует isHeadShot() из TaCZ
• 7 частей тела: Голова, Живот, Левая/Правая рука, Левая/Правая нога

• 4 эффекта ран:

  • Тяжёлая рана (Голова, шанс 20%): макс. здоровье -10%
  • Рана живота (Живот, шанс 20%): макс. здоровье -10%
  • Кровотечение (Руки, шанс 30%): 1 урон каждые ~6с, до 4 слоёв, останавливается при HP ≤1
  • Перелом (Ноги, шанс 20%): -15% скорости за каждую ногу, -30% при обеих ногах
• Все раны сохраняются до лечения или смерти
• Перелом от падения: падение ≥5 блоков вызывает, базовый шанс 50% + 10% за блок

Система обезболивающих

• Обезболивающее подавляет урон от кровотечения и замедление от переломов (иконки на HUD остаются видимыми)
• Переломы могут накапливаться, пока эффект подавлен
• По окончании: тошнота + звук крика, если есть тяжёлые раны/раны живота

Система расходуемых медикаментов

• Круговое меню (клавиша B): радиальный выбор в стиле ToolBelt, автоматически собирает расходники из инвентаря
• 3D-анимация от первого лица: модель следует за взглядом, с тряской камеры, руками игрока, освещением окружения
• HUD использования: полоса прогресса + название предмета + оставшиеся секунды + подсказка отмены

• Два режима прочности:

  • proportional: расходует прочность пропорционально недостающему здоровью — для лечебных предметов
  • fixed: 1 прочность за использование — для предметов, снимающих раны
• Проверки перед использованием: блокирует использование при полном здоровье или отсутствии подходящей раны, с сообщением обратной связи
• Ограничения во время использования: нельзя переключать хотбар / открывать инвентарь / стрелять / выбрасывать / менять предмет
• Отмена: нажмите R для отмены (HUD показывает подсказку клавиши, поддерживает иконки кнопок мыши)
• 7 расходников по умолчанию: Бинт, Обезболивающее, Стим, Шприц, Медицинский набор, Жгут, M2 IM Injection

Новая механика брони (урон пуль TaCZ)

• Урон пуль делится по armor_ignore: пробивающая часть наносит урон здоровью, непробивающая расходует прочность брони части тела
• Прочность брони исчерпана, но броня НЕ уничтожена — защита пропала, зарезервирована для ремонта
• Расходники могут ремонтировать броню, но навсегда снижают её максимальный запас прочности

Система выносливости

• Бег расходует выносливость, в покое восстанавливается (с короткой задержкой)
• Состояние усталости при истощении — блокирует бег до восстановления
• Прыжок стоит 10, скольжение стоит 20
• Эффект Stamina Restore мгновенно восполняет
• Ванильный голод отключён (требуется HungerStrike)
• Прицеливание отменяет бег
• Скольжение (клавиша V, отключено по умолчанию): скольжение во время бега, затухание скорости за 30 тиков, усиление прыжка при скольжении

Здоровье игрока

• Базовое здоровье = 20 + 30 = 50 HP (25 сердец), настраивается
• Полностью восстанавливается при первом входе и возрождении

Оверлеи HUD

• Здоровье: аватар + полоса здоровья + процент + 4 иконки прочности брони + полоса кислорода
• Выносливость: полоса над хотбаром, скрывается при полном заполнении, становится красной ниже 20
• Статус эффектов: блоки эффектов 9×9 с плавным заполнением прогресса
• Использование расходников: полоса прогресса + информация под прицелом

AI-противники

• Солдат: ИИ с 3 состояниями (Патруль → Тревога → Бой), случайный ПП, разделение агрессии в отряде
• Снайпер: обездвижен, случайная снайперская винтовка, интервал между выстрелами 3~6 с
• Настраиваемые параметры ИИ и чёрный список оружия
• Яйца призыва во вкладке креатива

Привязки клавиш

Зависимости

Локализация

• English (US)
• 简体中文

Руководство по использованию

Установка

1. Установите Minecraft 1.20.1 + Forge 47.x

2. Поместите следующие моды в папку mods/:

   • TaCZ (≥1.1.4)
   • HungerStrike (≥8.0.0)
   • Vantage TaCZ Compat (этот мод)
3. Запустите игру

Быстрый старт

1. Ранения и лечение

• После попадания из оружия TaCZ вы можете получить разные ранения в зависимости от места попадания (голова — тяжёлое ранение, живот — ранение живота, рука — кровотечение, нога — перелом)

• Нажмите B, чтобы открыть колесо расходников, и выберите подходящий предмет:

  • Кровотечение → используйте жгут или бинт
  • Тяжёлое ранение / ранение живота / перелом → используйте бинт
  • Мало здоровья → используйте медицинскую аптечку или шприц
  • Нужен затяжной бой → используйте обезболивающее (подавление) или стимулятор (скорость)
• Также можно использовать обезболивающее, чтобы временно подавить эффекты кровотечения и перелома (осторожно с отходняком)

2. Контроль веса

• Откройте инвентарь и наведите курсор на предметы, чтобы увидеть их вес (КГ)
• Общий вес выше 80 КГ → Перегрузка (лёгкое замедление)
• Общий вес выше 150 КГ → Перегруз (сильное замедление + снижение прыжка)
• Вес брони НЕ учитывается в весе инвентаря, но броня замедляет вас отдельно (тяжелее броня = сильнее замедление)
• Эффект Weight Limit Boost временно повышает пороги

3. Контроль выносливости

• Бег расходует выносливость; при истощении вы не можете бежать, пока не восстановитесь выше 20
• Полоса выносливости находится над хотбаром; ниже 20 она становится красной
• Прыжок стоит 10 выносливости, подкат — 20

4. Процесс использования расходников

1. Нажмите B, чтобы открыть колесо
2. Наведите мышь на сектор нужного расходника (в центре отображается название предмета)
3. Отпустите B, чтобы подтвердить использование

4. Во время использования:

   • Внизу экрана появляются полоса прогресса и оставшееся время
   • На игрока накладывается Замедление II
   • Переключение хотбара, инвентарь, стрельба и выбрасывание предметов отключены
   • Нажмите R, чтобы отменить (эффекты не расходуются)
5. Когда использование завершается, автоматически проигрывается звук доставания оружия

Конфигурация

Все настройки находятся в config/vantagetaczcompat-common.toml. Изменения требуют перезапуска игры. Ключевые разделы:

Вес

[Weight]
    weightMax = 200.0              # Максимальный предел веса
    heavyThreshold = 80.0          # Порог перегрузки
    overloadThreshold = 150.0      # Порог перегруза
    armorSpeedPenaltyPerKg = 0.8   # Коэффициент замедления от брони (0.8 = 80% от веса)
    overloadJumpReduction = 0.5    # Снижение прыжка при перегрузе (0.5 = на 50% меньше высоты)
    weightLimitBoostAmount = 40.0  # Величина эффекта Weight Limit Boost
    # Переопределение веса предметов, формат: mod:item,weight
    itemWeights = ["minecraft:iron_block,8.0", "minecraft:netherite_chestplate,16.0", ...]

Ранения

[Damage Multipliers]
    headDamageMultiplier = 1.0       # Множитель урона в голову
    abdomenDamageMultiplier = 1.0    # Множитель урона в живот
    limbDamageMultiplier = 0.3       # Множитель урона в конечности

[Bullet Wound Chances]
    headWoundChance = 0.20           # Шанс тяжёлого ранения при попадании в голову
    abdomenWoundChance = 0.20        # Шанс ранения живота при попадании в живот
    bleedingChance = 0.30            # Шанс кровотечения при попадании в руку
    fractureChance = 0.20            # Шанс перелома при попадании в ногу

[Fall Fracture]
    fallFractureChance = 0.50        # Базовый шанс перелома
    fallFractureMinDistance = 5.0    # Минимальная высота падения
    fallFractureChancePerBlock = 0.10 # Шанс за каждый дополнительный блок

#### Stamina
```toml
[Stamina Values]
    staminaMax = 100.0            # Максимум выносливости
    staminaSprintDrain = 0.2      # Расход при беге за тик
    staminaRegen = 0.3            # Восстановление в покое за тик
    staminaRegenDelay = 20        # Задержка восстановления после расхода (тики)
    staminaJumpCost = 10.0        # Стоимость прыжка
    staminaSlideCost = 20.0       # Стоимость подката

Consumable Use

[Consumable Use]
    healIntervalTicks = 5          # Интервал цикла лечения (тики)
    slowdownAmplifier = 1          # Уровень замедления (1 = Замедление II)
    slowdownExtraDuration = 20     # Дополнительное замедление после анимации (тики)

New Armor Mechanic

[New Armor Mechanic]
    enableNewArmorMechanic = true  # Вкл/выкл
    armorDurabilityMultiplier = 4.0 # Непробивающий урон → множитель прочности брони

Пользовательские расходники

Этот мод загружает расходники через механизм пакетов расширений TaCZ. Пакет по умолчанию находится в .minecraft/tacz/vtc_default_consumable/.

Добавление нового расходника

1. Создайте файлы в директории пакета расширения:

   vtc_default_consumable/
   └── assets/vantagetaczcompat/
      ├── consumable/my_item.json                  ← Определение
      ├── geo_models/consumable/my_item_geo.json   ← 3D-модель
      ├── animations/consumable/my_item.animation.json ← Анимация использования
      └── textures/consumable/
          ├── model/my_item.png                    ← Текстура 3D-модели
          └── slot/my_item.png                     ← 2D-иконка в инвентаре

2. Пример файла определения:

   {
    "name": "item.vantagetaczcompat.my_item",
    "model": "vantagetaczcompat:consumable/my_item_geo",
    "texture": "vantagetaczcompat:consumable/model/my_item",
    "slot_texture": "vantagetaczcompat:consumable/slot/my_item",
    "animation": "vantagetaczcompat:consumable/my_item_use",
    "animation_duration": 3.0,
    "heal_start_delay": 0.5,
    "durability": 4,
    "use_ticks": 60,
    "durability_mode": "fixed",
    "armor_repair_type": null,
    "armor_max_durability_reduction_percent": 0.0,
    "effects_to_apply": [
      { "id": "vantagetaczcompat:clear_wound", "duration": 1, "amplifier": 0 }
    ],
    "effects_to_remove": []
   }

3. Добавьте перевод в lang-файл:

   { "item.vantagetaczcompat.my_item": "My Item" }

4. Нажмите F3+T для горячей перезагрузки ресурсов — новый расходник сразу появится во вкладке креатива

Полный справочник по полям см. в docs/consumable_json_format.md в проекте.

Пользовательские веса предметов

Добавьте записи в itemWeights в конфиге:

itemWeights = [
    "minecraft:iron_block,8.0",
    "mymod:my_item,15.5"
]

Формат — mod:item,weight. Для предметов не из списка используется формула по умолчанию (на основе соотношения стака).

Получение расходников

Откройте инвентарь креатива и найдите вкладку Vantage TaCZ Compat. Все загруженные расходники отображаются динамически. Они используют один зарегистрированный предмет, различаемый NBT-тегом ConsumableId.

FAQ

В: Расходники не появляются? О: Убедитесь, что .minecraft/tacz/vtc_default_consumable/ существует и содержит директорию consumable/. Мод автоматически экспортирует её при первом запуске. Если её нет, удалите директорию и перезапустите игру для её пересоздания.

В: Изменения конфига не применяются? О: Изменения конфига требуют перезапуска игры. Учтите, что изменение значений по умолчанию в gradle.properties НЕ обновляет автоматически существующий toml-файл — либо удалите config/vantagetaczcompat-common.toml для его пересоздания, либо отредактируйте toml-файл напрямую.

В: Не видно анимации от первого лица? О: Убедитесь, что ваша основная рука пуста или держит расходник. Модель расходника автоматически скрывает оружие и появляется во время использования.

В: Подсказка отмены не обновилась после переназначения клавиши? О: HUD динамически считывает текущую привязку клавиши и показывает соответствующую подсказку, включая значки кнопок мыши. Изменения вступают в силу сразу.

В: Почему броня не исчезает при 0 прочности? О: Это задумано в новой механике брони. Броня с 0 прочности теряет защиту, но сохраняется как предмет — на будущее, для расходников по ремонту.

В: Как отключить скольжение? О: Установите enableSlide = false в конфиге (по умолчанию отключено).