warscript 0.0.1-dev.524fae9 → 0.0.1-dev.5354486

package/decl/native.d.ts

@@ -2184,6 +2184,7 @@ declare const UNIT_WEAPON_IF_ATTACK_DAMAGE_SIDES_PER_DIE: junitweaponintegerfiel
 declare const UNIT_WEAPON_IF_ATTACK_MAXIMUM_NUMBER_OF_TARGETS: junitweaponintegerfield
 declare const UNIT_WEAPON_IF_ATTACK_ATTACK_TYPE: junitweaponintegerfield
 declare const UNIT_WEAPON_IF_ATTACK_WEAPON_SOUND: junitweaponintegerfield
+declare const UNIT_WEAPON_IF_ATTACK_WEAPON_TYPE: junitweaponintegerfield
 declare const UNIT_WEAPON_IF_ATTACK_AREA_OF_EFFECT_TARGETS: junitweaponintegerfield
 declare const UNIT_WEAPON_IF_ATTACK_TARGETS_ALLOWED: junitweaponintegerfield
 declare const UNIT_WEAPON_RF_ATTACK_BACKSWING_POINT: junitweaponrealfield

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/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

@@ -17,11 +17,85 @@ 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
@@ -38,7 +112,6 @@ function EmulateImpactAbilityBehavior.prototype.emulateImpact(self, caster)
     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.d.ts

@@ -49,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

@@ -18,8 +18,10 @@ 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
@@ -28,14 +30,48 @@ local MISSILE_MODEL_PATHS_ABILITY_STRING_ARRAY_FIELD = ____ability.MISSILE_MODEL
 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
@@ -126,20 +162,22 @@ function AbilityBehavior.prototype.getDuration(self, widget)
     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
@@ -215,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)
@@ -299,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"))

package/engine/buff.d.ts

@@ -14,6 +14,7 @@ import type { Widget } from "../core/types/widget";
 import { Destructor } from "../destroyable";
 import { Event } from "../event";
 import { AbilityBehavior } from "./behaviour/ability";
+import { SoundPresetId } from "./object-data/entry/sound-preset";
 export type BuffConstructor<T extends Buff<any> = Buff<any>, Args extends any[] = any> = OmitConstructor<typeof Buff<any>> & (new (...args: Args) => T);
 type EnumParameterValueType<T extends number> = T | AbilityEnumLevelField<T>;
 type NumberParameterValueType = number | AbilityNumberField | AbilityNumberLevelField;
@@ -63,6 +64,8 @@ export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     missProbability?: NumberParameterValueType;
     damageFactor?: NumberParameterValueType;
     receivedDamageFactor?: NumberParameterValueType;
+    /** The factor of melee attack damage returned to the attacker, as Spiked Carapace. */
+    returnedMeleeDamageFactor?: NumberParameterValueType;
     receivedMagicDamageFactor?: NumberParameterValueType;
     durationIncreaseOnAutoAttack?: NumberParameterValueType;
     maximumRemainingDuration?: NumberParameterValueType;
@@ -87,6 +90,8 @@ export type BuffParameters<T extends Buff<any> = Buff> = Buff extends T ? {
     explodesOnExpiration?: BooleanParameterValueType;
     abilityCooldownFactor?: NumberParameterValueType;
     uniqueGroup?: BuffUniqueGroup;
+    /** Played on the unit whenever the buff is destroyed, whatever the reason. */
+    destructionSoundPresetId?: SoundPresetId;
 } : BuffParameters & (T extends Buff<infer AdditionalParameters> ? AdditionalParameters : object);
 declare const enum BuffPropertyKey {
     STATE = 100,
@@ -94,50 +99,51 @@ declare const enum BuffPropertyKey {
     SOURCE = 102,
     DURATION = 103,
     UNIQUE_GROUP = 104,
-    EFFECT_MODEL_PATH = 105,
-    SPECIAL_EFFECT_MODEL_PATH = 106,
-    DURATION_INCREASE_ON_AUTO_ATTACK = 107,
-    MAXIMUM_DURATION = 108,
-    MAXIMUM_REMAINING_DURATION = 109,
-    DAMAGE_OVER_DURATION = 110,
-    DAMAGE_PER_INTERVAL = 111,
-    DAMAGE_INTERVAL = 112,
-    REMAINING_DAMAGE_OVER_DURATION = 113,
-    DAMAGE_INTERVAL_TIMER = 114,
-    HEALING_OVER_DURATION = 115,
-    HEALING_PER_INTERVAL = 116,
-    HEALING_INTERVAL = 117,
-    REMAINING_HEALING_OVER_DURATION = 118,
-    HEALING_INTERVAL_TIMER = 119,
-    DAMAGE_ON_EXPIRATION = 120,
-    HEALING_ON_EXPIRATION = 121,
-    DAMAGE_UPON_DEATH_ALLOWED_TARGET_CLASSIFICATIONS = 122,
-    DAMAGE_UPON_DEATH = 123,
-    DAMAGE_UPON_DEATH_RANGE = 124,
-    MEDIUM_DAMAGE_UPON_DEATH = 125,
-    MEDIUM_DAMAGE_UPON_DEATH_RANGE = 126,
-    SMALL_DAMAGE_UPON_DEATH = 127,
-    SMALL_DAMAGE_UPON_DEATH_RANGE = 128,
-    AUTO_ATTACK_COUNT = 129,
-    MAXIMUM_AUTO_ATTACK_COUNT = 130,
-    DAMAGE_DEALT_EVENT_COUNT = 131,
-    MAXIMUM_DAMAGE_DEALT_EVENT_COUNT = 132,
-    DAMAGE_RECEIVED_EVENT_COUNT = 133,
-    MAXIMUM_DAMAGE_RECEIVED_EVENT_COUNT = 134,
-    ABSORBED_DAMAGE_FACTOR = 135,
-    MAXIMUM_DAMAGE_ABSORBED = 136,
-    DAMAGE_ABSORBED = 137,
-    DESTROYS_ON_MAXIMUM_DAMAGE_ABSORBED = 138,
-    TURNS_INTO_GHOST = 139,
-    STUNS = 140,
-    IGNORES_STUN_IMMUNITY = 141,
-    DISABLES_AUTO_ATTACK = 142,
-    PROVIDES_INVULNERABILITY = 143,
-    KILLS_ON_EXPIRATION = 144,
-    EXPLODES_ON_EXPIRATION = 145,
-    MISS_PROBABILITY = 146,
-    ABILITY_COOLDOWN_FACTOR = 147,
-    ABILITY_COOLDOWN_MODIFIER = 148
+    DESTRUCTION_SOUND_PRESET_ID = 105,
+    EFFECT_MODEL_PATH = 106,
+    SPECIAL_EFFECT_MODEL_PATH = 107,
+    DURATION_INCREASE_ON_AUTO_ATTACK = 108,
+    MAXIMUM_DURATION = 109,
+    MAXIMUM_REMAINING_DURATION = 110,
+    DAMAGE_OVER_DURATION = 111,
+    DAMAGE_PER_INTERVAL = 112,
+    DAMAGE_INTERVAL = 113,
+    REMAINING_DAMAGE_OVER_DURATION = 114,
+    DAMAGE_INTERVAL_TIMER = 115,
+    HEALING_OVER_DURATION = 116,
+    HEALING_PER_INTERVAL = 117,
+    HEALING_INTERVAL = 118,
+    REMAINING_HEALING_OVER_DURATION = 119,
+    HEALING_INTERVAL_TIMER = 120,
+    DAMAGE_ON_EXPIRATION = 121,
+    HEALING_ON_EXPIRATION = 122,
+    DAMAGE_UPON_DEATH_ALLOWED_TARGET_CLASSIFICATIONS = 123,
+    DAMAGE_UPON_DEATH = 124,
+    DAMAGE_UPON_DEATH_RANGE = 125,
+    MEDIUM_DAMAGE_UPON_DEATH = 126,
+    MEDIUM_DAMAGE_UPON_DEATH_RANGE = 127,
+    SMALL_DAMAGE_UPON_DEATH = 128,
+    SMALL_DAMAGE_UPON_DEATH_RANGE = 129,
+    AUTO_ATTACK_COUNT = 130,
+    MAXIMUM_AUTO_ATTACK_COUNT = 131,
+    DAMAGE_DEALT_EVENT_COUNT = 132,
+    MAXIMUM_DAMAGE_DEALT_EVENT_COUNT = 133,
+    DAMAGE_RECEIVED_EVENT_COUNT = 134,
+    MAXIMUM_DAMAGE_RECEIVED_EVENT_COUNT = 135,
+    ABSORBED_DAMAGE_FACTOR = 136,
+    MAXIMUM_DAMAGE_ABSORBED = 137,
+    DAMAGE_ABSORBED = 138,
+    DESTROYS_ON_MAXIMUM_DAMAGE_ABSORBED = 139,
+    TURNS_INTO_GHOST = 140,
+    STUNS = 141,
+    IGNORES_STUN_IMMUNITY = 142,
+    DISABLES_AUTO_ATTACK = 143,
+    PROVIDES_INVULNERABILITY = 144,
+    KILLS_ON_EXPIRATION = 145,
+    EXPLODES_ON_EXPIRATION = 146,
+    MISS_PROBABILITY = 147,
+    ABILITY_COOLDOWN_FACTOR = 148,
+    ABILITY_COOLDOWN_MODIFIER = 149
 }
 export declare const enum BuffTypeIdSelectionPolicy {
     LEAST_DURATION = 0
@@ -165,6 +171,7 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     private [BuffPropertyKey.SOURCE]?;
     private [BuffPropertyKey.DURATION];
     private [BuffPropertyKey.UNIQUE_GROUP]?;
+    private [BuffPropertyKey.DESTRUCTION_SOUND_PRESET_ID]?;
     private [BuffPropertyKey.EFFECT_MODEL_PATH];
     private [BuffPropertyKey.SPECIAL_EFFECT_MODEL_PATH];
     private [BuffPropertyKey.DURATION_INCREASE_ON_AUTO_ATTACK]?;
@@ -251,6 +258,8 @@ export declare class Buff<AdditionalParameters extends Prohibit<Record<string, a
     set damageFactor(damageFactor: number);
     get receivedDamageFactor(): number;
     set receivedDamageFactor(receivedDamageFactor: number);
+    get returnedMeleeDamageFactor(): number;
+    set returnedMeleeDamageFactor(returnedMeleeDamageFactor: number);
     get armorIncrease(): number;
     set armorIncrease(armorIncrease: number);
     get maxHealthIncrease(): number;