user: How do I use Rigidbody Operators in Blender? Include parameters, examples, warnings and best practices.

assistant: # Rigidbody Operators

bpy.ops.rigidbody.bake_to_keyframes(*\**, *frame_start=1*, *frame_end=250*, *step=1*)
:   Bake rigid body transformations of selected objects to keyframes

    Parameters:
    :   - **frame_start** (*int in* *[**0**,* *300000**]**,* *(**optional**)*) – Start Frame, Start frame for baking
        - **frame_end** (*int in* *[**1**,* *300000**]**,* *(**optional**)*) – End Frame, End frame for baking
        - **step** (*int in* *[**1**,* *120**]**,* *(**optional**)*) – Frame Step, Frame Step

    File:
    :   [startup/bl_operators/rigidbody.py:108](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/rigidbody.py#L108)

bpy.ops.rigidbody.connect(*\**, *con_type='FIXED'*, *pivot_type='CENTER'*, *connection_pattern='SELECTED_TO_ACTIVE'*)
:   Create rigid body constraints between selected rigid bodies

    Parameters:
    :   - **con_type** (enum in [`'FIXED'`, `'POINT'`, `'HINGE'`, `'SLIDER'`, `'PISTON'`, `'GENERIC'`, `'GENERIC_SPRING'`, `'MOTOR'`], (optional)) –

          Type, Type of generated constraint

          - `FIXED`
            Fixed – Glue rigid bodies together.
          - `POINT`
            Point – Constrain rigid bodies to move around common pivot point.
          - `HINGE`
            Hinge – Restrict rigid body rotation to one axis.
          - `SLIDER`
            Slider – Restrict rigid body translation to one axis.
          - `PISTON`
            Piston – Restrict rigid body translation and rotation to one axis.
          - `GENERIC`
            Generic – Restrict translation and rotation to specified axes.
          - `GENERIC_SPRING`
            Generic Spring – Restrict translation and rotation to specified axes with springs.
          - `MOTOR`
            Motor – Drive rigid body around or along an axis.
        - **pivot_type** (enum in [`'CENTER'`, `'ACTIVE'`, `'SELECTED'`], (optional)) –

          Location, Constraint pivot location

          - `CENTER`
            Center – Pivot location is between the constrained rigid bodies.
          - `ACTIVE`
            Active – Pivot location is at the active object position.
          - `SELECTED`
            Selected – Pivot location is at the selected object position.
        - **connection_pattern** (enum in [`'SELECTED_TO_ACTIVE'`, `'CHAIN_DISTANCE'`], (optional)) –

          Connection Pattern, Pattern used to connect objects

          - `SELECTED_TO_ACTIVE`
            Selected to Active – Connect selected objects to the active object.
          - `CHAIN_DISTANCE`
            Chain by Distance – Connect objects as a chain based on distance, starting at the active object.

    File:
    :   [startup/bl_operators/rigidbody.py:277](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/rigidbody.py#L277)

bpy.ops.rigidbody.constraint_add(*\**, *type='FIXED'*)
:   Add Rigid Body Constraint to active object

    Parameters:
    :   **type** (enum in [Rigidbody Constraint Type Items](bpy_types_enum_items/rigidbody_constraint_type_items.html#rna-enum-rigidbody-constraint-type-items), (optional)) – Rigid Body Constraint Type

bpy.ops.rigidbody.constraint_remove()
:   Remove Rigid Body Constraint from Object

bpy.ops.rigidbody.mass_calculate(*\**, *material='DEFAULT'*, *density=1.0*)
:   Automatically calculate mass values for Rigid Body Objects based on volume

    Parameters:
    :   - **material** (enum in [`'DEFAULT'`], (optional)) – Material Preset, Type of material that objects are made of (determines material density)
        - **density** (*float in* *[**1.17549e-38**,* *inf**]**,* *(**optional**)*) – Density, Density value (kg/m^3), allows custom value if the ‘Custom’ preset is used

bpy.ops.rigidbody.object_add(*\**, *type='ACTIVE'*)
:   Add active object as Rigid Body

    Parameters:
    :   **type** (enum in [Rigidbody Object Type Items](bpy_types_enum_items/rigidbody_object_type_items.html#rna-enum-rigidbody-object-type-items), (optional)) – Rigid Body Type

bpy.ops.rigidbody.object_remove()
:   Remove Rigid Body settings from Object

bpy.ops.rigidbody.object_settings_copy()
:   Copy Rigid Body settings from active object to selected

    File:
    :   [startup/bl_operators/rigidbody.py:45](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/rigidbody.py#L45)

bpy.ops.rigidbody.objects_add(*\**, *type='ACTIVE'*)
:   Add selected objects as Rigid Bodies

    Parameters:
    :   **type** (enum in [Rigidbody Object Type Items](bpy_types_enum_items/rigidbody_object_type_items.html#rna-enum-rigidbody-object-type-items), (optional)) – Rigid Body Type

bpy.ops.rigidbody.objects_remove()
:   Remove selected objects from Rigid Body simulation

bpy.ops.rigidbody.shape_change(*\**, *type='MESH'*)
:   Change collision shapes for selected Rigid Body Objects

    Parameters:
    :   **type** (enum in [Rigidbody Object Shape Items](bpy_types_enum_items/rigidbody_object_shape_items.html#rna-enum-rigidbody-object-shape-items), (optional)) – Rigid Body Shape

bpy.ops.rigidbody.world_add()
:   Add Rigid Body simulation world to the current scene

bpy.ops.rigidbody.world_remove()
:   Remove Rigid Body simulation world from the current scene