Skip to content
lsl.devlsl.devLSL Dev

llGetMass

View as MarkdownThis page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page
function
Function syntax
float llGetMass();
Returns
float
Energy
10

Returns a float representing the mass of the object (in lindograms). Returns the total linkset mass if called from the root, or the individual prim's mass if called from a child prim. Returns the wearer's mass if inside an attachment.

Returns a float that is the mass of object (in lindograms) that script is attached to.

How to use
float result = llGetMass();

Caveats

Section titled “Caveats”
  • The mass reported by this function is in lindograms, which function the same as kilograms within the bounds of Second Life, but not elsewhere. (See below)
  • Attachments do not affect an avatar’s mass, only certain Appearance settings.
  • Avatar mass is reported to either be unexpectedly low (when measured using llGetMass) or unexpectedly high (when measured using llGetMassMKS). This is likely due to the weight being calculated based on a fixed value, with a modifier for height. The fixed value being used is incorrect, likely due to an incorrect density value being used.

Examples

Section titled “Examples”
Example 1
//A way of making a constant force that returns the same speed visually whatever the object is
default
{
    touch_start()
    {
        llApplyImpulse(<0.0, 0.0, 5.0> * llGetMass(), FALSE);
        // This fires the object up at the same m/s whatever the size (or difference!)
    }
}//Written by El Taka

Notes

Section titled “Notes”

“Lindograms” is the name of the primary unit of mass used in Second Life.

While Second Life primarily makes use of the SI system of units, mass seems to be an exception.

Some speculate that lindograms were intended to be kilograms, but a mistake was made when factoring object density, causing the mass value returned to be 100 times less than the actual kilogram value. As a result, some new functions were implemented (such as llGetMassMKS) which report the correct kilogram weight of an object.

Functionally speaking, lindograms can be used in the same way kilograms are used1, however only within the bounds of Second Life. Trying to export mass values from Second Life will often run into issues, caused by the use of lindograms as a base unit of measurement.

From a technical point-of-view, a lindogram is equivalent to a metric quintal, however it is not treated as such.

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.

From the Second Life Wiki

Community documentation adapted from LlGetMass, by Linden Research, Inc. and contributing residents.View contributors and history.

Imported wiki revision:

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

Footnotes

Section titled “Footnotes”

  1. With exception to some functions, such as llSetPhysicsMaterial, which use kilograms, not lindograms. llGetMassMKS returns a kilogram value, not a lindogram value. ↩