Changelog

Version: 2.1.0
Date: 2025-01-05
  Features:
    - Reworked stun drone and stun grenade behavior: damage and stun are now applied exactly on projectile impact via scripted handlers, not instantly on launch.
    - Added full quality support:
      * Stun drone equipment quality now increases damage, radius and stun duration.
      * Stun drone ammo quality increases per-shot damage, radius and stun duration.
      * Stun grenade quality increases AOE damage, radius and stun duration.
    - Added energy mechanics for the stun drone equipment:
      * Equipment now has its own internal energy buffer (500 kJ by default).
      * At normal quality this buffer is enough for 5 drone launches without recharging.
      * Higher quality effectively increases the number of shots from a full charge by lowering energy cost per shot.
    - Added a toggle for the stun drone system:
      * Shortcut button "Stun Drone System" in the shortcut bar.
      * Hotkey: Shift + T.
      * The system can be turned on/off per player.
  Changes:
    - Disabled the built-in active-defense attack of the equipment; all attack behavior is now fully handled by script to avoid double damage and ammo-free shots.
    - Separated projectile visuals:
      * Drones use stun-drone-moving / hr-stun-drone-moving.
      * Stun grenades use stun-grenade-moving / hr-stun-grenade-moving and appear smaller than drones.
    - Equipment tooltip now shows a non-zero "Energy per use" and a reasonable max power input, matching its scripted energy behavior.
    - Reworked stun logic to use only stickers and scripted AOE, avoiding engine-side create-sticker in projectile definitions.
  Bugfixes:
    - Fixed crashes caused by accessing invalid entities after they were killed by damage (added .valid checks everywhere).
    - Fixed errors when trying to create stun stickers on entities that do not accept stickers.
    - Fixed ammo consumption logic so that stun drone ammo of any quality (including legendary) is correctly detected and consumed.
    - Fixed desynchronization of visual effects and actual damage/stun application for stun drones.
    - Shortcut state:
      * The stun drone shortcut is now greyed out and unavailable when the player has no stun drone equipment in armor.
      * Shortcut toggle state is correctly updated on armor/equipment changes and on load.
       
  Новое:
    - Полностью переработана логика автодронов и оглушающих гранат: урон и стан теперь происходят строго в момент попадания снаряда (через on_script_trigger_effect), а не сразу при выстреле.
    - Добавлена поддержка качества:
      * Качество оборудования оглушающих дронов усиливает урон, радиус и длительность стана.
      * Качество боеприпасов оглушающих дронов влияет на урон, радиус и длительность стана конкретного выстрела.
      * Качество оглушающих гранат усиливает AOE-урон, радиус и длительность стана.
    - Добавлена энергетика для системы защиты:
      * Оборудование имеет собственный энергетический буфер (500 кДж по умолчанию).
      * При обычном качестве буфера хватает примерно на 5 выстрелов без подзарядки.
      * С ростом качества фактическое количество выстрелов от полного заряда растёт за счёт снижения стоимости выстрела по энергии.
    - Добавлена кнопка включения/выключения системы:
      * Ярлык «Система защиты оглушающими дронами» в панели ярлыков.
      * Горячая клавиша: Shift + T.
      * Состояние (вкл/выкл) хранится отдельно для каждого игрока.
  Изменения:
    - Встроенная атака active-defense-оборудования отключена, всё поведение реализовано только скриптом, чтобы избежать двойного урона и «бесплатных» выстрелов.
    - Разделены визуальные эффекты полёта: дроны и гранаты используют свои спрайты, гранаты визуально меньше.
    - Подсказка оборудования теперь показывает осмысленную «Энергию за использование» и максимальное потребление энергии, соответствующие скриптовой логике.
    - Логика стана полностью переведена на скриптовые AOE и стикеры, без create-sticker в определении снаряда.
  Исправления:
    - Исправлены вылеты при обращении к невалидным сущностям после нанесения урона (добавлены проверки .valid).
    - Исправлены ошибки при попытке создать стикер на сущностях, которые не поддерживают стикеры.
    - Исправлена проблема, из-за которой система не видела/не тратила боеприпасы улучшенного качества (включая легендарные).
    - Исправлена рассинхронизация между визуальным полётом дрона и фактическим моментом нанесения урона и стана.
    - Ярлык системы теперь становится серым и недоступен, если в броне нет соответствующего оборудования, и автоматически обновляется при изменении брони/оборудования.