Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


mass

The mass of the rigidbody.
Read time 1 minuteLast updated 6 days ago

Definition

  • Type: Property
  • Namespace: UnityEngine
  • Assembly: UnityEngine.PhysicsModule
public float mass { get; set; }

Remarks

Different Rigidbodies with large differences in mass can make the physics simulation unstable.
Higher mass objects push lower mass objects more when colliding. Think of a big truck, hitting a small car.
A common mistake is to assume that heavy objects fall faster than light ones. This is not true as the speed is dependent on gravity and damping.

Examples

// Expose mass to allow adjustment from// the inspector.using UnityEngine;using System.Collections;public class ExampleClass : MonoBehaviour{ public float mass; public Rigidbody rb; void Start() { rb = GetComponent<Rigidbody>(); rb.mass = mass; }}