Draggable (for physics objects)

Drag a physics object with the mouse (or touch).

Authors and contributors to this experimental extension: VictrisGames.

Enables players to click and drag on physics objects to move them. The object retains velocity when the click is released, allowing players to fling objects across the screen.

Note:

The default "draggable" behavior will not work on objects with the physics behavior. This extension should be used instead.
This extension will only work on objects that have the physics behavior.
Kinematic physics mode is incompatible with this extension. The object will be changed to dynamic mode.

The Parking Jam example uses this extension (open the project online).

Tip

Learn how to install new extensions by following a step-by-step guide.

Draggable (for physics objects)

Drag a physics object with the mouse (or touch).

Behavior properties

Damping ratio (Range: 0 to 1) (🔢 Number). Default value is 1.
Enable automatic dragging (🔘 Boolean). If automatic dragging is disabled, use the "Start drag" and "Release drag" actions. Default value is true.
**Frequency (Hz) ** (🔢 Number). Default value is 10.
Maximum force (🔢 Number, Force (in Newton)). Default value is 500.
Mouse button (Choice, one of: "Left", "Right", "Middle"). Default value is Left.

See internal technical details

Damping ratio (Range: 0 to 1) is stored as Damping (Number). Default value is 1.
Enable automatic dragging is stored as EnableAutomaticDragging (Boolean). Default value is true.
**Frequency (Hz) ** is stored as Frequency (Number). Default value is 10.
Maximum force is stored as MaxForce (Number). Unit is Newton. Default value is 500.
Mouse button is stored as MouseButton (Choice). Default value is Left.

This behavior must be used on an object also having a behavior with type "Physics2::Physics2Behavior". This is stored on property PhysicsBehavior.

Behavior actions

Release dragged object
Release dragged object.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior

Technical note: parameter 2 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::ReleaseDrag.

Damping ratio
Change the joint damping ratio (range: 0 to 1) of the object.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::SetDamping.

Enable (or disable) automatic dragging
Enable (or disable) automatic dragging with the mouse or touch.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (❓ Yes or No): EnableAutomaticDragging

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::SetEnableAutomaticDragging.

Frequency
Change the joint frequency (per second) of the object.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::SetFrequency.

Maximum force
Change the maximum joint force (in Newtons) of the object.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::SetMaxForce.

Mouse button
Change the mouse button used to move the object.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔤 String): Value (one of: "Left", "Right", "Middle")

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::SetMouseButton.

Start dragging object
Start dragging object.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior

Technical note: parameter 2 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::StartDragging.

Behavior conditions

Damping ratio
Compare the joint damping ratio (range: 0 to 1) of the object. .

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::Damping.

Frequency
Compare the joint frequency (per second) of the object.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::Frequency.

Automatic dragging
Check if automatic dragging is enabled.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior

Technical note: parameter 2 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::IsAutomaticDraggingEnabled.

Is being dragged
Check if object is being dragged.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior

Technical note: parameter 2 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::IsBeingDragged.

Maximum force
Compare the maximum joint force (in Newtons) of the object.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::MaxForce.

Mouse button
Compare the mouse button used to move the object.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔤 String): Value to compare (one of: "Left", "Right", "Middle")

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is DraggablePhysics::DraggablePhysics::MouseButton.

Behavior expressions

Expression	Description
`Object.DraggablePhysics::Damping()`	Return the joint damping ratio (range: 0 to 1) of the object. .
`Object.DraggablePhysics::Frequency()`	Return the joint frequency (per second) of the object.
`Object.DraggablePhysics::MaxForce()`	Return the maximum joint force (in Newtons) of the object.
`Object.DraggablePhysics::MouseButton()`	Return the mouse button used to move the object.

This page is an auto-generated reference page about the Draggable (for physics objects) extension for GDevelop, the open-source, AI-powered, cross-platform game engine designed for everyone. Learn more about all GDevelop extensions here.