void TriggerAddUseWeaponEvent(unit unit, TypedCallback<unit, Float2> trigger, bool simple, WeaponFilter filter)

This event is triggered whenever a weapon is used. This function can also pass the the target unit and target location as parameters to the callback function.

• unit unit the unit that triggers this event. Use DCEI.UnitAny to trigger this event for any unit.
• object trigger the callback function that is run when the event is triggered.
• bool simple this flag reduces overhead by preventing the usage of DCEI.Wait() within the trigger. You should only set this to true if the trigger does not use DCEI.Wait().
• WeaponFilter filter could make this event only trigger on certain weapons

• Unit target_unit
• Float2 target_position

local function OnUnitUseWeapon(target_unit, target_pos)
    local unit = DCEI.TriggeringUnit
    local unit_name = DCEI.UnitName(unit)
    local weapon = DCEI.TriggeringWeaponName
    DCEI.LogMessage(unit_name .. " has attacked with " .. weapon ..".")
    
    local target_name = DCEI.UnitName(target_unit)
    DCEI.LogMessage("Target: " .. target_name .. " at (" .. target_pos.x .. ", " .. target_pos.y .. ")")
end
    
DCEI.TriggerAddUseWeaponEvent(DCEI.UnitAny, OnUnitUseWeapon, true)

• TriggeringWeaponId
• TriggeringWeaponName