warscript 0.0.1-dev.5abc199 → 0.0.1-dev.5bc80ec

package/engine/ability-type-extended-tooltip.d.ts

@@ -0,0 +1,8 @@
+/** @noSelfInFile */
+import { AbilityTypeId } from "./object-data/entry/ability-type";
+/**
+ * The ability type's own extended tooltip for the level, unaffected by local display
+ * overrides (see {@link overrideAbilityTypeExtendedTooltipLocally}). Use it instead of
+ * `BlzGetAbilityExtendedTooltip` wherever the type's tooltip serves as a template.
+ */
+export declare const getAbilityTypeExtendedTooltip: (abilityTypeId: AbilityTypeId, level: number) => string;

package/engine/ability-type-extended-tooltip.lua

@@ -0,0 +1,44 @@
+local ____exports = {}
+local getAbilityExtendedTooltip = BlzGetAbilityExtendedTooltip
+local setAbilityExtendedTooltip = BlzSetAbilityExtendedTooltip
+local originalTooltipByLevelByAbilityTypeId = {}
+local overriddenTooltipByLevelByAbilityTypeId = {}
+--- The ability type's own extended tooltip for the level, unaffected by local display
+-- overrides (see {@link overrideAbilityTypeExtendedTooltipLocally}). Use it instead of
+-- `BlzGetAbilityExtendedTooltip` wherever the type's tooltip serves as a template.
+____exports.getAbilityTypeExtendedTooltip = function(abilityTypeId, level)
+    local ____opt_0 = originalTooltipByLevelByAbilityTypeId[abilityTypeId]
+    return ____opt_0 and ____opt_0[level] or getAbilityExtendedTooltip(abilityTypeId, level)
+end
+--- Replaces the displayed extended tooltip of every ability of the type for the local
+-- player only; `undefined` restores the type's own tooltip. The value is async: never
+-- feed it back into synchronous logic.
+-- 
+-- @internal For use by internal systems only.
+____exports.overrideAbilityTypeExtendedTooltipLocally = function(abilityTypeId, level, tooltip)
+    local overriddenTooltipByLevel = overriddenTooltipByLevelByAbilityTypeId[abilityTypeId]
+    if (overriddenTooltipByLevel and overriddenTooltipByLevel[level]) == tooltip then
+        return
+    end
+    local originalTooltipByLevel = originalTooltipByLevelByAbilityTypeId[abilityTypeId]
+    if originalTooltipByLevel == nil then
+        originalTooltipByLevel = {}
+        originalTooltipByLevelByAbilityTypeId[abilityTypeId] = originalTooltipByLevel
+    end
+    local originalTooltip = originalTooltipByLevel[level]
+    if originalTooltip == nil then
+        originalTooltip = getAbilityExtendedTooltip(abilityTypeId, level)
+        originalTooltipByLevel[level] = originalTooltip
+    end
+    if overriddenTooltipByLevel == nil then
+        overriddenTooltipByLevel = {}
+        overriddenTooltipByLevelByAbilityTypeId[abilityTypeId] = overriddenTooltipByLevel
+    end
+    if tooltip == nil then
+        overriddenTooltipByLevel[level] = nil
+    else
+        overriddenTooltipByLevel[level] = tooltip
+    end
+    setAbilityExtendedTooltip(abilityTypeId, tooltip or originalTooltip, level)
+end
+return ____exports

package/engine/behaviour/ability/apply-unit-behavior.lua

@@ -7,6 +7,8 @@ local __TS__New = ____lualib.__TS__New
 local ____exports = {}
 local ____ability = require("engine.behaviour.ability")
 local AbilityBehavior = ____ability.AbilityBehavior
+local ____unit = require("engine.internal.unit")
+local Unit = ____unit.Unit
 local ____ability = require("engine.object-field.ability")
 local AbilityField = ____ability.AbilityField
 local AbilityLevelField = ____ability.AbilityLevelField
@@ -56,4 +58,7 @@ end)
 AbilityLevelField.valueChangeEvent:addListener(function(ability)
     ____exports.ApplyUnitBehaviorAbilityBehavior:forAll(ability, "update")
 end)
+Unit.abilityLevelChangedEvent:addListener(function(_, ability)
+    ____exports.ApplyUnitBehaviorAbilityBehavior:forAll(ability, "update")
+end)
 return ____exports

package/engine/behaviour/ability/damage.d.ts

@@ -5,6 +5,7 @@ import { Unit } from "../../internal/unit";
 import { AbilityDependentValue } from "../../object-field/ability";
 import { Widget } from "../../../core/types/widget";
 import { DamageType, WeaponType } from "../../internal/unit+damage";
+import "../../internal/unit+damage";
 import { CombatClassifications } from "../../object-data/auxiliary/combat-classification";
 import { AttackType } from "../../object-data/auxiliary/attack-type";
 export type DamageAbilityBehaviorParameters = {
@@ -25,8 +26,11 @@ export declare abstract class DamageAbilityBehavior<T extends DamageAbilityBehav
     protected readonly damage: AbilityDependentValue<number>;
     protected readonly parameters?: T | undefined;
     protected constructor(ability: Ability, damage: AbilityDependentValue<number>, parameters?: T | undefined);
+    protected precalculatedDamage?: number;
     protected calculateDamage(caster: Unit): number;
     protected damageTarget(caster: Unit, target: Widget, damage?: number): void;
+    onChannelingStart(caster: Unit): void;
+    onStop(): void;
 }
 export declare class DamageSelfAbilityBehavior extends DamageAbilityBehavior {
     constructor(ability: Ability, damage: AbilityDependentValue<number>, parameters?: DamageAbilityBehaviorParameters);

package/engine/behaviour/ability/damage.lua

@@ -4,11 +4,10 @@ local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local ____exports = {}
 local ____ability = require("engine.behaviour.ability")
 local AbilityBehavior = ____ability.AbilityBehavior
-local ____unit = require("engine.internal.unit")
-local Unit = ____unit.Unit
 local ____ability = require("engine.standard.fields.ability")
 local ALLOWED_TARGETS_ABILITY_COMBAT_CLASSIFICATIONS_LEVEL_FIELD = ____ability.ALLOWED_TARGETS_ABILITY_COMBAT_CLASSIFICATIONS_LEVEL_FIELD
 local AREA_OF_EFFECT_ABILITY_FLOAT_LEVEL_FIELD = ____ability.AREA_OF_EFFECT_ABILITY_FLOAT_LEVEL_FIELD
+require("engine.internal.unit+damage")
 ____exports.DamageAbilityBehavior = __TS__Class()
 local DamageAbilityBehavior = ____exports.DamageAbilityBehavior
 DamageAbilityBehavior.name = "DamageAbilityBehavior"
@@ -39,7 +38,7 @@ function DamageAbilityBehavior.prototype.damageTarget(self, caster, target, dama
     local parameters = self.parameters
     caster:damageTarget(
         target,
-        damage or self:calculateDamage(caster),
+        damage or self.precalculatedDamage or self:calculateDamage(caster),
         nil,
         nil,
         self:resolveCurrentAbilityDependentValue(parameters and parameters.attackType),
@@ -48,6 +47,12 @@ function DamageAbilityBehavior.prototype.damageTarget(self, caster, target, dama
         self:resolveCurrentAbilityDependentValue(parameters and parameters.metadata)
     )
 end
+function DamageAbilityBehavior.prototype.onChannelingStart(self, caster)
+    self.precalculatedDamage = self:calculateDamage(caster)
+end
+function DamageAbilityBehavior.prototype.onStop(self)
+    self.precalculatedDamage = nil
+end
 ____exports.DamageSelfAbilityBehavior = __TS__Class()
 local DamageSelfAbilityBehavior = ____exports.DamageSelfAbilityBehavior
 DamageSelfAbilityBehavior.name = "DamageSelfAbilityBehavior"
@@ -76,21 +81,20 @@ function DamageAreaAbilityBehavior.prototype.____constructor(self, ability, dama
 end
 function DamageAreaAbilityBehavior.prototype.damageArea(self, caster, x, y)
     local parameters = self.parameters
-    local targets = Unit.getAllowedTargetsInCollisionRange(
-        caster,
-        self:resolveCurrentAbilityDependentValue(parameters and parameters.allowedTargetCombatClassifications or ALLOWED_TARGETS_ABILITY_COMBAT_CLASSIFICATIONS_LEVEL_FIELD),
+    caster:damageArea(
         x,
         y,
-        self:resolveCurrentAbilityDependentValue(parameters and parameters.areaOfEffect or AREA_OF_EFFECT_ABILITY_FLOAT_LEVEL_FIELD)
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.areaOfEffect or AREA_OF_EFFECT_ABILITY_FLOAT_LEVEL_FIELD),
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.allowedTargetCombatClassifications or ALLOWED_TARGETS_ABILITY_COMBAT_CLASSIFICATIONS_LEVEL_FIELD),
+        self.precalculatedDamage or self:calculateDamage(caster),
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.maximumDamage or 0),
+        nil,
+        nil,
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.attackType),
+        parameters and parameters.damageType,
+        parameters and parameters.weaponType,
+        self:resolveCurrentAbilityDependentValue(parameters and parameters.metadata)
     )
-    local damage = self:calculateDamage(caster)
-    local maximumDamage = self:resolveCurrentAbilityDependentValue(parameters and parameters.maximumDamage or 0)
-    if maximumDamage ~= 0 and damage > maximumDamage then
-        damage = maximumDamage / #targets
-    end
-    for ____, target in ipairs(targets) do
-        self:damageTarget(caster, target, damage)
-    end
 end
 ____exports.DamageSelfAreaAbilityBehavior = __TS__Class()
 local DamageSelfAreaAbilityBehavior = ____exports.DamageSelfAreaAbilityBehavior

package/engine/behaviour/ability/emulate-impact.d.ts

@@ -1,6 +1,20 @@
 /** @noSelfInFile */
 import { AbilityBehavior } from "../ability";
 import { Unit } from "../../internal/unit";
+import { Item } from "../../internal/item";
+import { Destructable } from "../../../core/types/destructable";
 export declare abstract class EmulateImpactAbilityBehavior extends AbilityBehavior {
+    /**
+     * Pays the cost of the cast and invokes only the common impact event: for impacts
+     * that have no cast target to report, such as ones triggered by a command.
+     */
     protected emulateImpact(caster: Unit): boolean;
+    protected emulateUnitTargetImpact(caster: Unit, target: Unit): boolean;
+    protected emulateItemTargetImpact(caster: Unit, target: Item): boolean;
+    protected emulateDestructibleTargetImpact(caster: Unit, target: Destructable): boolean;
+    protected emulatePointTargetImpact(caster: Unit, x: number, y: number): boolean;
+    protected emulateNoTargetImpact(caster: Unit): boolean;
+    /** Invokes the common impact event and the one matching the target, as a real impact. */
+    private emulateTargetImpact;
+    private payEmulatedImpact;
 }

package/engine/behaviour/ability/emulate-impact.lua

@@ -10,9 +10,6 @@ local Unit = ____unit.Unit
 local ____ability = require("engine.standard.fields.ability")
 local COOLDOWN_ABILITY_FLOAT_LEVEL_FIELD = ____ability.COOLDOWN_ABILITY_FLOAT_LEVEL_FIELD
 local MANA_COST_ABILITY_INTEGER_LEVEL_FIELD = ____ability.MANA_COST_ABILITY_INTEGER_LEVEL_FIELD
-local ____math = require("math")
-local max = ____math.max
-local MINIMUM_POSITIVE_NORMALIZED_FLOAT = ____math.MINIMUM_POSITIVE_NORMALIZED_FLOAT
 local ____sound = require("core.types.sound")
 local Sound3D = ____sound.Sound3D
 local SoundSettings = ____sound.SoundSettings
@@ -20,24 +17,101 @@ local ____ability = require("engine.internal.ability")
 local UnitAbility = ____ability.UnitAbility
 local ____event = require("event")
 local Event = ____event.Event
+local ____ability = require("engine.internal.unit.ability")
+local emulateAbilityImpactEvent = ____ability.emulateAbilityImpactEvent
 ____exports.EmulateImpactAbilityBehavior = __TS__Class()
 local EmulateImpactAbilityBehavior = ____exports.EmulateImpactAbilityBehavior
 EmulateImpactAbilityBehavior.name = "EmulateImpactAbilityBehavior"
 __TS__ClassExtends(EmulateImpactAbilityBehavior, AbilityBehavior)
 function EmulateImpactAbilityBehavior.prototype.emulateImpact(self, caster)
+    if not self:payEmulatedImpact(caster) then
+        return false
+    end
+    Event.invoke(Unit.abilityImpactEvent, caster, self.ability)
+    return true
+end
+function EmulateImpactAbilityBehavior.prototype.emulateUnitTargetImpact(self, caster, target)
+    return self:emulateTargetImpact(
+        caster,
+        target,
+        nil,
+        nil,
+        target.x,
+        target.y
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulateItemTargetImpact(self, caster, target)
+    return self:emulateTargetImpact(
+        caster,
+        nil,
+        target,
+        nil,
+        target.x,
+        target.y
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulateDestructibleTargetImpact(self, caster, target)
+    return self:emulateTargetImpact(
+        caster,
+        nil,
+        nil,
+        target,
+        target.x,
+        target.y
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulatePointTargetImpact(self, caster, x, y)
+    return self:emulateTargetImpact(
+        caster,
+        nil,
+        nil,
+        nil,
+        x,
+        y
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulateNoTargetImpact(self, caster)
+    return self:emulateTargetImpact(
+        caster,
+        nil,
+        nil,
+        nil,
+        0,
+        0
+    )
+end
+function EmulateImpactAbilityBehavior.prototype.emulateTargetImpact(self, caster, targetUnit, targetItem, targetDestructible, x, y)
+    if not self:payEmulatedImpact(caster) then
+        return false
+    end
+    emulateAbilityImpactEvent(
+        caster,
+        self.ability,
+        targetUnit,
+        targetItem,
+        targetDestructible,
+        x,
+        y
+    )
+    return true
+end
+function EmulateImpactAbilityBehavior.prototype.payEmulatedImpact(self, caster)
     local manaCost = self:resolveCurrentAbilityDependentValue(MANA_COST_ABILITY_INTEGER_LEVEL_FIELD)
     local cooldown = self:resolveCurrentAbilityDependentValue(COOLDOWN_ABILITY_FLOAT_LEVEL_FIELD)
     if self.ability.cooldownRemaining ~= 0 or caster.mana < manaCost or __TS__InstanceOf(self.ability, UnitAbility) and self.ability.isDisabled then
         return false
     end
     caster.mana = caster.mana - manaCost
-    self.ability.cooldownRemaining = max(cooldown, MINIMUM_POSITIVE_NORMALIZED_FLOAT)
+    if cooldown == 0 then
+        self.ability:interruptCast()
+    else
+        self.ability:startCooldown(cooldown)
+    end
     self:flashCasterEffect(caster)
     local soundPresetId = self.ability:getField(ABILITY_SF_EFFECT_SOUND)
     if soundPresetId ~= "" then
         Sound3D:playFromLabel(soundPresetId, SoundSettings.Ability, caster)
     end
-    Event.invoke(Unit.abilityImpactEvent, caster, self.ability)
     return true
 end
 return ____exports

package/engine/behaviour/ability/instant-impact.d.ts

@@ -1,6 +1,17 @@
 /** @noSelfInFile */
 import { Unit } from "../../internal/unit";
+import { Item } from "../../internal/item";
+import { Destructable } from "../../../core/types/destructable";
 import { EmulateImpactAbilityBehavior } from "./emulate-impact";
+/**
+ * Makes the ability take effect as soon as its cast starts, skipping the cast animation:
+ * the impact events fire with the cast's target, so target-specific impact handlers
+ * (`onPointTargetImpact`, `onUnitTargetImpact`, ...) work as with a native impact.
+ */
 export declare class InstantImpactAbilityBehavior extends EmulateImpactAbilityBehavior {
-    onCastingStart(caster: Unit): void;
+    onUnitTargetCastingStart(caster: Unit, target: Unit): void;
+    onItemTargetCastingStart(caster: Unit, target: Item): void;
+    onDestructibleTargetCastingStart(caster: Unit, target: Destructable): void;
+    onPointTargetCastingStart(caster: Unit, x: number, y: number): void;
+    onNoTargetCastingStart(caster: Unit): void;
 }

package/engine/behaviour/ability/instant-impact.lua

@@ -4,11 +4,26 @@ local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local ____exports = {}
 local ____emulate_2Dimpact = require("engine.behaviour.ability.emulate-impact")
 local EmulateImpactAbilityBehavior = ____emulate_2Dimpact.EmulateImpactAbilityBehavior
+--- Makes the ability take effect as soon as its cast starts, skipping the cast animation:
+-- the impact events fire with the cast's target, so target-specific impact handlers
+-- (`onPointTargetImpact`, `onUnitTargetImpact`, ...) work as with a native impact.
 ____exports.InstantImpactAbilityBehavior = __TS__Class()
 local InstantImpactAbilityBehavior = ____exports.InstantImpactAbilityBehavior
 InstantImpactAbilityBehavior.name = "InstantImpactAbilityBehavior"
 __TS__ClassExtends(InstantImpactAbilityBehavior, EmulateImpactAbilityBehavior)
-function InstantImpactAbilityBehavior.prototype.onCastingStart(self, caster)
-    self:emulateImpact(caster)
+function InstantImpactAbilityBehavior.prototype.onUnitTargetCastingStart(self, caster, target)
+    self:emulateUnitTargetImpact(caster, target)
+end
+function InstantImpactAbilityBehavior.prototype.onItemTargetCastingStart(self, caster, target)
+    self:emulateItemTargetImpact(caster, target)
+end
+function InstantImpactAbilityBehavior.prototype.onDestructibleTargetCastingStart(self, caster, target)
+    self:emulateDestructibleTargetImpact(caster, target)
+end
+function InstantImpactAbilityBehavior.prototype.onPointTargetCastingStart(self, caster, x, y)
+    self:emulatePointTargetImpact(caster, x, y)
+end
+function InstantImpactAbilityBehavior.prototype.onNoTargetCastingStart(self, caster)
+    self:emulateNoTargetImpact(caster)
 end
 return ____exports

package/engine/behaviour/ability/on-command-impact.d.ts

@@ -1,5 +1,6 @@
 /** @noSelfInFile */
 import { Unit } from "../../internal/unit";
+import "../../internal/unit/item-order-events";
 import { EmulateImpactAbilityBehavior } from "./emulate-impact";
 import { Ability } from "../../internal/ability";
 export declare class OnCommandImpactAbilityBehavior extends EmulateImpactAbilityBehavior {

package/engine/behaviour/ability/on-command-impact.lua

@@ -4,6 +4,7 @@ local __TS__ClassExtends = ____lualib.__TS__ClassExtends
 local ____exports = {}
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
+require("engine.internal.unit.item-order-events")
 local ____emulate_2Dimpact = require("engine.behaviour.ability.emulate-impact")
 local EmulateImpactAbilityBehavior = ____emulate_2Dimpact.EmulateImpactAbilityBehavior
 ____exports.OnCommandImpactAbilityBehavior = __TS__Class()

package/engine/behaviour/ability.d.ts

@@ -2,6 +2,7 @@
 import { Behavior } from "../behavior";
 import { Unit } from "../internal/unit";
 import "../internal/unit/ability";
+import "../internal/unit+ability";
 import { Ability } from "../internal/ability";
 import { AbilityTypeId } from "../object-data/entry/ability-type";
 import { Widget } from "../../core/types/widget";
@@ -26,11 +27,12 @@ export declare abstract class AbilityBehavior<Parameters extends {
     get unit(): Unit | undefined;
     protected resolveCurrentAbilityDependentValue<T extends boolean | number | string>(value: AbilityDependentValue<T>): T;
     protected resolveCurrentAbilityDependentValue<T extends boolean | number | string>(value?: AbilityDependentValue<T>): T | undefined;
-    protected flashCasterEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
-    protected flashTargetEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
-    protected flashAreaEffect(x: number, y: number, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
-    protected flashEffect(x: number, y: number, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
-    protected flashSpecialEffect(...args: [
+    protected getDuration(widget: Widget): number;
+    flashCasterEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
+    flashTargetEffect(widget: Widget, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
+    flashAreaEffect(x: number, y: number, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
+    flashEffect(x: number, y: number, ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]): void;
+    flashSpecialEffect(...args: [
         ...pointOrWidget: [x: number, y: number] | [widget: Widget],
         ...parametersOrDuration: [parameters?: EffectParameters] | [duration?: number, parameters?: EffectParameters]
     ]): void;
@@ -47,6 +49,12 @@ export declare abstract class AbilityBehavior<Parameters extends {
     onUnitLoseAbility(_unit: Unit): void;
     onCommand(caster: Unit, orderTypeStringId: string): void;
     onCastingStart(caster: Unit): void;
+    onWidgetTargetCastingStart(caster: Unit, target: Widget): void;
+    onUnitTargetCastingStart(caster: Unit, target: Unit): void;
+    onItemTargetCastingStart(caster: Unit, target: Item): void;
+    onDestructibleTargetCastingStart(caster: Unit, target: Destructable): void;
+    onPointTargetCastingStart(caster: Unit, x: number, y: number): void;
+    onNoTargetCastingStart(caster: Unit): void;
     onCastingFinish(caster: Unit): void;
     onChannelingStart(caster: Unit): void;
     onWidgetTargetChannelingStart(caster: Unit, target: Widget): void;

package/engine/behaviour/ability.lua

@@ -9,29 +9,69 @@ local ____behavior = require("engine.behavior")
 local Behavior = ____behavior.Behavior
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
+local UnitClassification = ____unit.UnitClassification
 require("engine.internal.unit.ability")
+require("engine.internal.unit+ability")
 local ____ability = require("engine.internal.ability")
 local Ability = ____ability.Ability
 local ____effect = require("core.types.effect")
 local Effect = ____effect.Effect
 local ____ability = require("engine.standard.fields.ability")
 local AREA_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.AREA_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
+local CASTER_EFFECT_COUNT_ABILITY_INTEGER_FIELD = ____ability.CASTER_EFFECT_COUNT_ABILITY_INTEGER_FIELD
 local CASTER_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD = ____ability.CASTER_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD
 local CASTER_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.CASTER_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
+local CASTER_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD = ____ability.CASTER_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD
+local DURATION_HERO_ABILITY_FLOAT_LEVEL_FIELD = ____ability.DURATION_HERO_ABILITY_FLOAT_LEVEL_FIELD
+local DURATION_NORMAL_ABILITY_FLOAT_LEVEL_FIELD = ____ability.DURATION_NORMAL_ABILITY_FLOAT_LEVEL_FIELD
 local EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
 local MISSILE_ARC_ABILITY_FLOAT_FIELD = ____ability.MISSILE_ARC_ABILITY_FLOAT_FIELD
 local MISSILE_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.MISSILE_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
 local MISSILE_SPEED_ABILITY_INTEGER_FIELD = ____ability.MISSILE_SPEED_ABILITY_INTEGER_FIELD
 local SPECIAL_EFFECT_ATTACHMENT_POINT_STRING_FIELD = ____ability.SPECIAL_EFFECT_ATTACHMENT_POINT_STRING_FIELD
 local SPECIAL_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.SPECIAL_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
+local TARGET_EFFECT_COUNT_ABILITY_INTEGER_FIELD = ____ability.TARGET_EFFECT_COUNT_ABILITY_INTEGER_FIELD
+local TARGET_EFFECT_FIFTH_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_FIFTH_ATTACHMENT_POINT_STRING_FIELD
 local TARGET_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD
+local TARGET_EFFECT_FOURTH_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_FOURTH_ATTACHMENT_POINT_STRING_FIELD
 local TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD
+local TARGET_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD
+local TARGET_EFFECT_SIXTH_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_SIXTH_ATTACHMENT_POINT_STRING_FIELD
+local TARGET_EFFECT_THIRD_ATTACHMENT_POINT_STRING_FIELD = ____ability.TARGET_EFFECT_THIRD_ATTACHMENT_POINT_STRING_FIELD
 local ____ability = require("engine.object-field.ability")
 local AbilityField = ____ability.AbilityField
 local AbilityLevelField = ____ability.AbilityLevelField
 local resolveCurrentAbilityDependentValue = ____ability.resolveCurrentAbilityDependentValue
 local ____missile = require("core.types.missile")
 local Missile = ____missile.Missile
+local CASTER_EFFECT_ATTACHMENT_POINT_STRING_FIELDS = {CASTER_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD, CASTER_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD}
+local TARGET_EFFECT_ATTACHMENT_POINT_STRING_FIELDS = {
+    TARGET_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_SECOND_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_THIRD_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_FOURTH_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_FIFTH_ATTACHMENT_POINT_STRING_FIELD,
+    TARGET_EFFECT_SIXTH_ATTACHMENT_POINT_STRING_FIELD
+}
+--- Flashes every preset of an effect preset list (caster/target effects): each model at
+-- its own attachment point. The effect count field limits the list; at least the first
+-- model is always flashed, as abilities without the count set expect.
+local function flashEffectPresets(ability, modelPathsField, attachmentPointFields, effectCountField, widget, ...)
+    local count = math.min(
+        math.max(
+            effectCountField:getValue(ability),
+            1
+        ),
+        #attachmentPointFields
+    )
+    for i = 0, count - 1 do
+        local modelPath = modelPathsField:getValue(ability, i)
+        if modelPath ~= "" then
+            local attachmentPoint = attachmentPointFields[i + 1]:getValue(ability)
+            Effect:flash(modelPath, widget, attachmentPoint ~= "" and attachmentPoint or "origin", ...)
+        end
+    end
+end
 local createBehaviorFunctionsByAbilityTypeId = {}
 local function invokeOnMissileArrival(_missile, success, abilityBehavior, ...)
     if success then
@@ -113,21 +153,31 @@ end
 function AbilityBehavior.prototype.resolveCurrentAbilityDependentValue(self, value)
     return resolveCurrentAbilityDependentValue(self.ability, value)
 end
+function AbilityBehavior.prototype.getDuration(self, widget)
+    if __TS__InstanceOf(widget, Unit) then
+        if widget.isHero or widget:getField(UNIT_IF_LEVEL) >= 6 or widget:hasClassification(UnitClassification.RESISTANT) then
+            return self:resolveCurrentAbilityDependentValue(DURATION_HERO_ABILITY_FLOAT_LEVEL_FIELD)
+        end
+    end
+    return self:resolveCurrentAbilityDependentValue(DURATION_NORMAL_ABILITY_FLOAT_LEVEL_FIELD)
+end
 function AbilityBehavior.prototype.flashCasterEffect(self, widget, ...)
-    local attachmentPoint = CASTER_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD:getValue(self.ability)
-    Effect:flash(
-        CASTER_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD:getValue(self.ability, 0),
+    flashEffectPresets(
+        self.ability,
+        CASTER_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD,
+        CASTER_EFFECT_ATTACHMENT_POINT_STRING_FIELDS,
+        CASTER_EFFECT_COUNT_ABILITY_INTEGER_FIELD,
         widget,
-        attachmentPoint ~= "" and attachmentPoint or "origin",
         ...
     )
 end
 function AbilityBehavior.prototype.flashTargetEffect(self, widget, ...)
-    local attachmentPoint = TARGET_EFFECT_FIRST_ATTACHMENT_POINT_STRING_FIELD:getValue(self.ability)
-    Effect:flash(
-        TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD:getValue(self.ability, 0),
+    flashEffectPresets(
+        self.ability,
+        TARGET_EFFECT_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD,
+        TARGET_EFFECT_ATTACHMENT_POINT_STRING_FIELDS,
+        TARGET_EFFECT_COUNT_ABILITY_INTEGER_FIELD,
         widget,
-        attachmentPoint ~= "" and attachmentPoint or "origin",
         ...
     )
 end
@@ -203,6 +253,18 @@ function AbilityBehavior.prototype.onCommand(self, caster, orderTypeStringId)
 end
 function AbilityBehavior.prototype.onCastingStart(self, caster)
 end
+function AbilityBehavior.prototype.onWidgetTargetCastingStart(self, caster, target)
+end
+function AbilityBehavior.prototype.onUnitTargetCastingStart(self, caster, target)
+end
+function AbilityBehavior.prototype.onItemTargetCastingStart(self, caster, target)
+end
+function AbilityBehavior.prototype.onDestructibleTargetCastingStart(self, caster, target)
+end
+function AbilityBehavior.prototype.onPointTargetCastingStart(self, caster, x, y)
+end
+function AbilityBehavior.prototype.onNoTargetCastingStart(self, caster)
+end
 function AbilityBehavior.prototype.onCastingFinish(self, caster)
 end
 function AbilityBehavior.prototype.onChannelingStart(self, caster)
@@ -287,6 +349,12 @@ __TS__SetDescriptor(
     Unit.abilityGainedEvent:addListener(createUnitEventListener("onUnitGainAbility"))
     Unit.abilityLostEvent:addListener(createUnitEventListener("onUnitLoseAbility"))
     Unit.abilityCastingStartEvent:addListener(createUnitEventListener("onCastingStart"))
+    Unit.abilityWidgetTargetCastingStartEvent:addListener(createUnitEventListener("onWidgetTargetCastingStart"))
+    Unit.abilityUnitTargetCastingStartEvent:addListener(createUnitEventListener("onUnitTargetCastingStart"))
+    Unit.abilityItemTargetCastingStartEvent:addListener(createUnitEventListener("onItemTargetCastingStart"))
+    Unit.abilityDestructibleTargetCastingStartEvent:addListener(createUnitEventListener("onDestructibleTargetCastingStart"))
+    Unit.abilityPointTargetCastingStartEvent:addListener(createUnitEventListener("onPointTargetCastingStart"))
+    Unit.abilityNoTargetCastingStartEvent:addListener(createUnitEventListener("onNoTargetCastingStart"))
     Unit.abilityCastingFinishEvent:addListener(createUnitEventListener("onCastingFinish"))
     Unit.abilityChannelingStartEvent:addListener(createUnitEventListener("onChannelingStart"))
     Unit.abilityWidgetTargetChannelingStartEvent:addListener(createUnitEventListener("onWidgetTargetChannelingStart"))
@@ -317,6 +385,19 @@ end)
 AbilityLevelField.valueChangeEvent:addListener(function(ability, field)
     ____exports.AbilityBehavior:forAll(ability, checkBehaviorOnValueChange, field)
 end)
+local function checkBehaviorOnLevelChange(behavior)
+    local subscribedValues = subscribedValuesByAbilityBehavior[behavior]
+    if subscribedValues ~= nil then
+        for value in pairs(subscribedValues) do
+            if __TS__InstanceOf(value, AbilityLevelField) then
+                behavior:onValueChange(value)
+            end
+        end
+    end
+end
+Unit.abilityLevelChangedEvent:addListener(function(_, ability)
+    ____exports.AbilityBehavior:forAll(ability, checkBehaviorOnLevelChange)
+end)
 Ability.onCreate:addListener(function(ability)
     local createBehaviorFunctions = createBehaviorFunctionsByAbilityTypeId[ability.typeId]
     if createBehaviorFunctions ~= nil then

package/engine/behaviour/unit.d.ts

@@ -2,6 +2,7 @@
 import { Behavior, BehaviorPriority } from "../behavior";
 import { Ability } from "../internal/ability";
 import { DamageEvent, DamagingEvent, Unit } from "../internal/unit";
+import "../internal/unit/equipment-inventory";
 import "../internal/unit+ability";
 import "../internal/unit-missile-launch";
 import { Item } from "../internal/item";

package/engine/behaviour/unit.lua

@@ -8,6 +8,7 @@ local ____behavior = require("engine.behavior")
 local Behavior = ____behavior.Behavior
 local ____unit = require("engine.internal.unit")
 local Unit = ____unit.Unit
+require("engine.internal.unit.equipment-inventory")
 require("engine.internal.unit+ability")
 require("engine.internal.unit-missile-launch")
 local ____linked_2Dset = require("utility.linked-set")