Skip to content
lsl.devlsl.devLSL Dev

llGetSimStats

View as MarkdownThis page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page
function
Function syntax
float llGetSimStats(
  1. integer stat_type// SIM_STAT_* flag of the statistic to retrieve. Values: SimulatorStat
);
Returns
float
Energy
10

Returns a float containing the value of the requested region statistic specified by stat_type.

Returns a float that is the requested statistic.

How to use
float result = llGetSimStats(0);

Specification

Section titled “Specification”
NamePossible ReturnDescription
SIM_STAT_PCT_CHARS_STEPPED0[0.0, 100.0]The % of pathfinding characters updated each frame, averaged over the last minute. The value corresponds to the “Characters Updated” stat in the viewer’s Statistics Bar.
SIM_STAT_PHYSICS_FPS1[0.0, Inf]Physics simulation FPS.
SIM_STAT_AGENT_UPDATES2[0.0, Inf]Agent updates per second.
SIM_STAT_FRAME_MS3[0.0, Inf]Total frame time.
SIM_STAT_NET_MS4[0.0, Inf]Time spent in ‘network’ segment of simulation frame.
SIM_STAT_OTHER_MS5[0.0, Inf]Main simulation segment of frame, encapsulating task, script and misc. updates.
SIM_STAT_PHYSICS_MS6[0.0, Inf]Time spent in ‘physics’ segment of simulation frame.
SIM_STAT_AGENT_MS7[0.0, Inf]Time spent in ‘agent’ segment of simulation frame.
SIM_STAT_IMAGE_MS8[0.0, Inf]Time spent in ‘image’ segment of simulation frame.
SIM_STAT_SCRIPT_MS9[0.0, Inf]Time spent in ‘script’ segment of simulation frame.
SIM_STAT_AGENT_COUNT10[0.0, Inf]Number of agents in region.
SIM_STAT_CHILD_AGENT_COUNT11[0.0, Inf]Number of child (neighboring) agents in region.
SIM_STAT_ACTIVE_SCRIPT_COUNT12[0.0, Inf]Number of active scripts in region.
SIM_STAT_PACKETS_IN13[0.0, Inf]Average packets in per second.
SIM_STAT_PACKETS_OUT14[0.0, Inf]Average packets out per second.
SIM_STAT_ASSET_DOWNLOADS15[0.0, Inf]Pending asset download count.
SIM_STAT_ASSET_UPLOADS16[0.0, Inf]Pending asset upload count.
SIM_STAT_UNACKED_BYTES17[0.0, Inf]Total unacknowledged bytes.
SIM_STAT_PHYSICS_STEP_MS18[0.0, Inf]Average physics step time.
SIM_STAT_PHYSICS_SHAPE_MS19[0.0, Inf]Average physics ‘shape’ segment update time.
SIM_STAT_PHYSICS_OTHER_MS20[0.0, Inf]Average physics ‘other’ segment update time.
SIM_STAT_SCRIPT_EPS21[0.0, Inf]Script events per second.
SIM_STAT_SPARE_MS22[0.0, Inf]Spare time left after frame.
SIM_STAT_SLEEP_MS23[0.0, Inf]Time spent sleeping.
SIM_STAT_IO_PUMP_MS24[0.0, Inf]PumpIO time.
SIM_STAT_SCRIPT_RUN_PCT25[0.0, 100.0]Percent of scripts run during frame.
SIM_STAT_AI_MS26[0.0, Inf]Time spent on AI step.

Examples

Section titled “Examples”
Example 1
default
{
    touch_start(integer num_detected)
    {
        float pct_chars_stepped = llGetSimStats(SIM_STAT_PCT_CHARS_STEPPED);
        llSay(0,
            "The percentage of pathfinding characters updated each frame was "
            + (string)pct_chars_stepped + "averaged over the last minute. The "
            + "value corresponds to the 'Characters Updated' stat in the "
            + "viewer's Statistics Bar. ");
    }
}

History

Section titled “History”

Date of Release 26/10/2012

See also

Section titled “See also”

Functions

Section titled “Functions”
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.