llDamage
llDamage(key target,// Key of the target avatar or task to receive damage.float damage,// Amount of damage to inflict (can exceed 100, unlike collision-based damage).integer damage_type// Type of damage to deliver to the target (can correspond to a DAMAGE_TYPE_* constant). Values: DamageType
);- Energy
- 10
Generates a damage event delivering the specified amount of damage and damage_type to the targeted avatar or task in the same region.
This function delivers damage to tasks and agent in the same region.
llDamage(NULL_KEY, 0.0, 0);Specification
Section titled “Specification”The llDamage function triggers a damage event on the targeted task. If any scripts in the target process the on_damage event, they will be fired before the damage is applied or distributed.
| Flag | Description | |
|---|---|---|
DAMAGE_TYPE_IMPACT | −1 | System damage generated by impact with terrain or a prim. |
DAMAGE_TYPE_GENERIC | 0 | Generic or legacy damage. |
DAMAGE_TYPE_ACID | 1 | Damage caused by a caustic substance, such as acid. |
DAMAGE_TYPE_BLUDGEONING | 2 | Damage caused by a blunt object, such as a club. |
DAMAGE_TYPE_COLD | 3 | Damage inflicted by exposure to extreme cold. |
DAMAGE_TYPE_ELECTRIC | 4 | Damage caused by electricity. |
DAMAGE_TYPE_FIRE | 5 | Damage inflicted by exposure to heat or flames. |
DAMAGE_TYPE_FORCE | 6 | Damage inflicted by a great force or impact. |
DAMAGE_TYPE_NECROTIC | 7 | Damage caused by a direct assault on life-force. |
DAMAGE_TYPE_PIERCING | 8 | Damage caused by a piercing object such as a bullet, spear, or arrow. |
DAMAGE_TYPE_POISON | 9 | Damage caused by poison. |
DAMAGE_TYPE_PSYCHIC | 10 | Damage caused by a direct assault on the mind. |
DAMAGE_TYPE_RADIANT | 11 | Damage caused by radiation or extreme light. |
DAMAGE_TYPE_SLASHING | 12 | Damage caused by a slashing object such as a sword or axe. |
DAMAGE_TYPE_SONIC | 13 | Damage caused by loud noises, like a Crash Worship concert. |
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:
| Flag | Description | Subtype | Creator | System | |
|---|---|---|---|---|---|
| 100 | 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 | Vertical Sim / SLMC | |
| 101 | 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 | Vertical Sim / SLMC | |
| 102 | 102 | Damage caused by an explosive blast, like a grenade | DAMAGE_TYPE_FORCE | Nexii Malthus | Vertical Sim / SLMC |
| 103 | 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 | Nexii Malthus | Vertical Sim / SLMC |
| 104 | 104 | Damage caused by anti-tank/anti-armor. Such as from a specialised armor piercing shell, rocket or other munition | DAMAGE_TYPE_PIERCING | Nexii Malthus | Vertical Sim / SLMC |
| 105 | 105 | Damage caused by suffocation. Usually lacking a breathable atmosphere, such as from drowning or being in the vacuum of space | Nexii Malthus | Vertical Sim / SLMC | |
| 106 | 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 | Vertical Sim / SLMC | |
| 200 | 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 | 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 |
Caveats
Section titled “Caveats”- Calls are throttled to a rate of ≤10/30sec per recipient. Exceptions are:
- Recipient is avatar of the attachment.
- Recipient is sitting on the object.
- Triggering the damage throttle will shout an error to the debug channel and the script will continue running.
- The prim containing the script and the prim receiving the damage must both be in damage enable parcels.
- Targeting a seated avatar will redirect damage to the object the avatar is sitting on.
The on_damage event will NOT be triggered if the source of the damage is either:
- An attachment on the avatar.
- An object or vehicle that the avatar is sitting on.
final_damage will be triggered as normal.
The damage throttle is skipped if:
- Damage is negative.
- The source is an attachment on the avatar.
- The source is an object that the avatar is sitting on.
- The source is an object owned by a parcel owner or land group.
See also
Section titled “See also”Functions
Section titled “Functions”Events
Section titled “Events”Original wiki source
Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.