# llDetectedDamage

*LSL function*

```lsl
list list llDetectedDamage(integer number);
```

- `integer number`: Index of the detection information.

- Returns: `list`
- Energy: 10

Returns an `empty list` if **number** does not relate to a valid damage source or if called from a handler other than [on_damage](/events/on_damage/)

The list has the following format:

```lsl
[float damage, integer damage_type, float original_damage]
```

Returns a [list](https://wiki.secondlife.com/wiki/list) containing pending damage information.

```lsl title="How to use" frame="terminal"
list result = llDetectedDamage(0);
```

## Specification

`llDetectedDamage` returns a list describing a single damage event. This function is only available from within an [on_damage](/events/on_damage/) handler. If called from another detection event or from a non detection handler, it will return an empty list.

#### **damage**

**damage** is the current amount of damage that will be applied after all [on_damage](/events/on_damage/) events have completed processing.

#### **damage_type**

**damage_type** is an integer describing the type of damage that will be applied. This could either reflect one of the DAMAGE_TYPE\_\* constants, a custom damage type constant or be a repurposed field as it can be set to anything.

#### **original_damage**

**original_damage** is the original amount of damage that was specified when the event was triggered. Either through a collision or a call to [llDamage](/functions/llDamage/).

| Flag |  | Description |
| --- | --- | --- |
| [DAMAGE_TYPE_IMPACT](/constants/DAMAGE_TYPE_IMPACT/) | −1 | System damage generated by impact with terrain or a prim. |
| [DAMAGE_TYPE_GENERIC](/constants/DAMAGE_TYPE_GENERIC/) | 0 | Generic or legacy damage. |
| [DAMAGE_TYPE_ACID](/constants/DAMAGE_TYPE_ACID/) | 1 | Damage caused by a caustic substance, such as acid. |
| [DAMAGE_TYPE_BLUDGEONING](/constants/DAMAGE_TYPE_BLUDGEONING/) | 2 | Damage caused by a blunt object, such as a club. |
| [DAMAGE_TYPE_COLD](/constants/DAMAGE_TYPE_COLD/) | 3 | Damage inflicted by exposure to extreme cold. |
| [DAMAGE_TYPE_ELECTRIC](/constants/DAMAGE_TYPE_ELECTRIC/) | 4 | Damage caused by electricity. |
| [DAMAGE_TYPE_FIRE](/constants/DAMAGE_TYPE_FIRE/) | 5 | Damage inflicted by exposure to heat or flames. |
| [DAMAGE_TYPE_FORCE](/constants/DAMAGE_TYPE_FORCE/) | 6 | Damage inflicted by a great force or impact. |
| [DAMAGE_TYPE_NECROTIC](/constants/DAMAGE_TYPE_NECROTIC/) | 7 | Damage caused by a direct assault on life-force. |
| [DAMAGE_TYPE_PIERCING](/constants/DAMAGE_TYPE_PIERCING/) | 8 | Damage caused by a piercing object such as a bullet, spear, or arrow. |
| [DAMAGE_TYPE_POISON](/constants/DAMAGE_TYPE_POISON/) | 9 | Damage caused by poison. |
| [DAMAGE_TYPE_PSYCHIC](/constants/DAMAGE_TYPE_PSYCHIC/) | 10 | Damage caused by a direct assault on the mind. |
| [DAMAGE_TYPE_RADIANT](/constants/DAMAGE_TYPE_RADIANT/) | 11 | Damage caused by radiation or extreme light. |
| [DAMAGE_TYPE_SLASHING](/constants/DAMAGE_TYPE_SLASHING/) | 12 | Damage caused by a slashing object such as a sword or axe. |
| [DAMAGE_TYPE_SONIC](/constants/DAMAGE_TYPE_SONIC/) | 13 | Damage caused by loud noises, like a Crash Worship concert. |
| [DAMAGE_TYPE_EMOTIONAL](/constants/DAMAGE_TYPE_EMOTIONAL/) | 14 |  |

Damage types are provided as a convenience and a suggestion. Scripters are free to add custom ones for their own combat systems or repurpose the damage type fields.

To make it easy for the community to recognise and re-use custom damage types here is a table [that scripters can add onto](https://wiki.secondlife.com/wiki/Template:LSL_Constants/Custom_Damage_Types):

| Flag |  | Description | Subtype | Creator | System |
| --- | --- | --- | --- | --- | --- |
| [100](https://wiki.secondlife.com/wiki/nolink%3D%2A) | 100 | Negative damage to heal a wound, damaged limb, first aid, etc. Intended for generic healing of biological nature. Positive damage would be medical malpractice |  | [Nexii Malthus](https://wiki.secondlife.com/wiki/User:Nexii_Malthus) | [Vertical Sim](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/Vertical_Sim) / [SLMC](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/SLMC) |
| [101](https://wiki.secondlife.com/wiki/nolink%3D%2A) | 101 | Negative damage from repairing an object or something mechanical, welding torch or wrench on a vehicle/robot/mech, etc. Positive damage can be due to mistakes, low skill or sabotage. Intended for generic healing of non-biological nature (e.g. a mechanical tank or an electrical system) |  | [Nexii Malthus](https://wiki.secondlife.com/wiki/User:Nexii_Malthus) | [Vertical Sim](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/Vertical_Sim) / [SLMC](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/SLMC) |
| [102](https://wiki.secondlife.com/wiki/nolink%3D%2A) | 102 | Damage caused by an explosive blast, like a grenade | [DAMAGE_TYPE_FORCE](/constants/DAMAGE_TYPE_FORCE/) | [Nexii Malthus](https://wiki.secondlife.com/wiki/User:Nexii_Malthus) | [Vertical Sim](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/Vertical_Sim) / [SLMC](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/SLMC) |
| [103](https://wiki.secondlife.com/wiki/nolink%3D%2A) | 103 | Damage caused by crushing. Such as being crushed by water pressure. More of a constant type of force damage — can be nullified/reduced via diving suit | [DAMAGE_TYPE_FORCE](/constants/DAMAGE_TYPE_FORCE/) | [Nexii Malthus](https://wiki.secondlife.com/wiki/User:Nexii_Malthus) | [Vertical Sim](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/Vertical_Sim) / [SLMC](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/SLMC) |
| [104](https://wiki.secondlife.com/wiki/nolink%3D%2A) | 104 | Damage caused by anti-tank/anti-armor. Such as from a specialised armor piercing shell, rocket or other munition | [DAMAGE_TYPE_PIERCING](/constants/DAMAGE_TYPE_PIERCING/) | [Nexii Malthus](https://wiki.secondlife.com/wiki/User:Nexii_Malthus) | [Vertical Sim](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/Vertical_Sim) / [SLMC](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/SLMC) |
| [105](https://wiki.secondlife.com/wiki/nolink%3D%2A) | 105 | Damage caused by suffocation. Usually lacking a breathable atmosphere, such as from drowning or being in the vacuum of space |  | [Nexii Malthus](https://wiki.secondlife.com/wiki/User:Nexii_Malthus) | [Vertical Sim](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/Vertical_Sim) / [SLMC](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/SLMC) |
| [106](https://wiki.secondlife.com/wiki/nolink%3D%2A) | 106 | Special damage to indicate combatant chose to redeploy. You can code in side effect(s) such as using up a ticket off the team to do so |  | [Nexii Malthus](https://wiki.secondlife.com/wiki/User:Nexii_Malthus) | [Vertical Sim](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/Vertical_Sim) / [SLMC](https://wiki.secondlife.com/wiki/User:Nexii_Malthus/SLMC) |
| [200](https://wiki.secondlife.com/wiki/nolink%3D%2A) | 200 | Damage caused by lack of survival needs, such as starvation and dehydration. Negative damage used to heal through recovery by food and water |  | Adam Silver-Mane (Adamphillip) | Silver-mane's survival HUD |
| [201](https://wiki.secondlife.com/wiki/nolink%3D%2A) | 201 | Damage caused by active bleeding. Damage type check, sets health to 0 on unsustainable systemic failure |  | Adam Silver-Mane (Adamphillip) | Silver-mane's survival HUD |

## See also

### Functions

- [llAdjustDamage](/functions/llAdjustDamage/)

### Events

- [on_damage](/events/on_damage/)

---

*Source: [LlDetectedDamage](https://wiki.secondlife.com/wiki/LlDetectedDamage) on the Second Life Wiki. Content from the Second Life Wiki articles LlDetectedDamage (revision 1217096, 2024-08-10), Template:LSL Constants/Custom Damage Types (revision 1218868, 2026-06-03) and Template:LSL Constants/Damage Types (revision 1216840, 2024-06-26), CC BY-SA 3.0.*

---

From lsl.dev: https://lsl.dev/functions/llDetectedDamage/