Category:LSL Combat2

This is a historical wiki category. Explore the current topic guides →

Help: {{Help}}LSL Header: {{LSL Header|ml=*}} __NOTOC__

The Combat2 Project is an enhancement to the Linden Combat system.

This is not meant to be a complete combat system on its own but to provide the tools that allow you to do that.

In Second Life there are a host of combat communities scattered across the grid. These communities use a wide variety of combat systems, HUDs and weapon systems. Some are completely custom, relying on scripts to arbitrate health and damage, while others are based on the Linden Lab Combat System (LLCS). See Combat for more.

The goal of the Combat2 project is to provide a coherent set of tools and systems that allow the residents to create complex and compelling combat systems using a common and easy to use framework.

key — llRezObjectWithParams(string inventory, list params)

void — llAdjustDamage(integer number, float new_damage)

void — llDamage(key target, float damage, integer damage_type)

list — llDetectedDamage(integer number)

key — llDetectedRezzer(integer number)

float — llGetHealth(key id)

event — on_damage(integer num_detected)

event — final_damage(integer num_detected)

event — on_death()

string — llGetStartString()

string — llDerezObject(key id, integer flag)

<h2>Introduced are new concepts</h2> Can apply damage directly Damage can have a damage type associated to it Damage events If a script (object, vehicle or attachment) has a damage event this will be called first before final damage is applied Scripts may modify the actual amount of damage in a damage event if the region allows it Objects have a health property Scripts have to manage this property themselves; Unlike agents the simulator will not apply damage to the object health and instead only trigger damage and final damage events Sensors can scan for damageable objects and avatars that are not on a safe parcel Combat Log has been added which allows for auditing and other usecases Records all damage events, damage adjustments and kills in a combat-specific public channel System generated messages by a specific ID that scripts may filter to Scripts may write to this channel if not restricted so by the region New region-wide settings, region owners may: Throttle damage per second dealt to a target by a single source Limit damage to a target by a maximum per a single event Select a number of options as to what happens when agent health drops to 0 such as: Teleport home (same as old LLCS) Teleport to region's telehub Teleport to parcel's landing point No action -- Which can allow a custom scripted respawn system to act instead for example Set a brief period of invulnerability, during which agents may neither deal nor receive damage Whether health is reset to 100% on death Tweak the speed of health regeneration per second or disable health regeneration Whether scripts are allowed to adjust damage or write to the combat log Currently these new settings are available through the Region Debug Console

<h2>New Functions and Events</h2> These are the functions and events directly related to Combat2 as well as new related functions <h2>Combat Log</h2> System-generated log messages are collected and sent into the COMBAT_CHANNEL in a JSON format. <h2>Damage Types</h2> The damage amount can be supported via a damage type field, which can match a default DAMAGE_TYPE_* or a custom integer; Additionally the field may be repurposed.

<h2>Scripting Details</h2>

Here are the new functions and events in detail

key — llRezObjectWithParams(string inventory, list params) — New function for rezzing objects with a variety of parameters, particularly useful for avoiding the overhead of starting a script for each bullet

void — llAdjustDamage(integer number, float new_damage) — Modifies the amount of damage that will be applied by the current on_damage event after it has completed processing

void — llDamage(key target, float damage, integer damage_type) — Delivers damage to tasks and agent in the same region with an integer describing the type of damage. Negative damage can be used to heal instead. You can also go above 100.0 damage unlike collideable damage

list — llDetectedDamage(integer number) — Returns a list describing a single damage event within an on_damage event

key — llDetectedRezzer(integer number) — Returns a key that is the UUID of the object or avatar that rezzed the detected object

float — llGetHealth(key id) — Returns the current health of an avatar or object in the region

event — on_damage(integer num_detected) — Triggered when damage has been inflicted on an avatar or task in the world but before damage has been applied or distributed

event — final_damage(integer num_detected) — Triggered after after all on_damage events in all scripts and attachments have processed and damage has been applied to the avatar or distributed to all seated avatars

event — on_death() — Triggered on all attachments worn by an avatar when that avatar's health reaches 0

string — llGetStartString() — New function to retrieve the string passed with llRezObjectWithParams via REZ_PARAM_STRING, particularly useful for avoiding overhead and delay when having to communicate any necessary information

string — llDerezObject(key id, integer flag) — Derezzes an object previously rezzed from within the object containing the script

<h2>Additional</h2>

• Damage types — Provided for convenience and a suggestion. Scripters can add custom ones or repurpose the damage type fields
• llListen
  • Channel reserved at COMBAT_CHANNEL
  • System generated combat log messages sent by COMBAT_LOG_ID
  • Scripts may also write to this channel if the region allows it (see "restrict_combat_log" below)
• llSensor — Scripts may filter by DAMAGEABLE for objects in world that process damage (that is if they have a on_damage and/or final_damage event -- the object's health doesn't matter)
• llGetObjectDetails — Additional values around health, damage and type
  • OBJECT_HEALTH — Retrieves the health of an avatar or prim
  • OBJECT_DAMAGE — Retrieves the amount of damage a prim inflicts on collision
  • OBJECT_DAMAGE_TYPE — Retrieves the type of damage a prim inflicts on collision
• llRezObjectWithParams — Apply damage to rezzed objects
  • REZ_DAMAGE — The amount of damage applied to an agent upon collision with this object
  • REZ_DAMAGE_TYPE — The damage type to apply when this prim collides with another object
  • REZ_PARAM_STRING — String parameter that can be passed into the rezzed object with a maximum string length of 1024 bytes
• llSetLinkPrimitiveParamsFast — New parameter added to adjust damage amount and damage type for collision damage
  • PRIM_DAMAGE — Set damage amount and damage type
• llGetEnv — Several new values are added
  • "allow_damage_adjust" — Are scripts allowed to adjust damage
  • "restrict_combat_log" — Are scripts allowed to write to the combat log
  • "restore_health" — Is health reset to 100% on death
  • "invulnerability_time" — Invulnerablitiy time applied after avatar death
  • "damage_throttle" — The maximum number of points of damage a single source may inflict on a target per second. This is a Damage Per Second (DPS) throttle
  • "damage_limit" — The maximum number of points of damage a single damage collision or call via llDamage may inflict
  • "health_regen_rate" — The speed of health regeneration in hitpoints per second
  • "death_action" — Set the action to take when an avatar dies in the region
• llSetLinkSitFlags — Flags that can be applied to sit targets
  • SIT_FLAG_NO_COLLIDE — Disable the avatar's collision volume when they are seated on this sit target
  • SIT_FLAG_NO_DAMAGE — Do not distribute damage to agents sitting on this sit target

Damage Types

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

Related

• Thread on the Second Life community forums by Rider Linden announcing the project: Pew! Pew! Pew! Linden Damage & Combat 2.0
• Feedback for suggesting, voting and commenting on ideas
• Thread on draft proposal for Combat 2.1 changes by adding Teams & Respawns concepts from Rider Linden: https://community.secondlife.com/forums/topic/516319-combat-21-teams-respawn/

Known Issues

• Sitting Avatars with SIT_FLAGS_NO_DAMAGE may still attempt to process damage which can cause various issues, such as still generating damage logs and affecting objects with llSetDamage
  • Adjust SIT_FLAG_NO_DAMAGE so combat log reports are not generated
  • SIT_FLAGS_NO_DAMAGE still attempts to process LLCS damage on sitting avatars

Wishlist

• Combat2.1 Teams
• Combat2.1 Respawns
• PRIM_MAX_HEALTH

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.

From the Second Life Wiki

Community documentation adapted from Category:LSL Combat2, by Linden Research, Inc. and contributing residents.View contributors and history.

Built from these wiki pages, as imported:

• Category:LSL Combat2 (revision 1218481, 2025-10-11)
• Template:LSL Constants/Custom Damage Types (revision 1218868, 2026-06-03)
• Template:LSL Constants/Damage Types (revision 1216840, 2024-06-26)

Licensed under CC BY-SA 3.0. Last wiki edit: 2026-06-03.Formatting and links have been adapted for this site; API metadata follows the LSL definitions.