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 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, made by the community of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop community-made extensions here.