Added mouse joints example

physics/box2d_mouse_joint_example/box2d_mouse_joint/all.texture_profiles

@@ -0,0 +1,18 @@
+path_settings {
+  path: "**"
+  profile: "Default"
+}
+profiles {
+  name: "Default"
+  platforms {
+    os: OS_ID_GENERIC
+    formats {
+      format: TEXTURE_FORMAT_RGBA
+      compression_level: BEST
+      compression_type: COMPRESSION_TYPE_DEFAULT
+    }
+    mipmaps: false
+    max_texture_size: 0
+    premultiply_alpha: true
+  }
+}

physics/box2d_mouse_joint_example/box2d_mouse_joint/assets/fonts/text28.font

@@ -0,0 +1,5 @@
+font: "/assets/fonts/SourceSansPro-Semibold.ttf"
+material: "/builtins/fonts/font-df.material"
+size: 28
+output_format: TYPE_DISTANCE_FIELD
+characters: " !\"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~"

physics/box2d_mouse_joint_example/box2d_mouse_joint/assets/images/sprites.atlas

@@ -0,0 +1,10 @@
+images {
+  image: "/assets/images/body_soft.png"
+}
+images {
+  image: "/assets/images/body_tight.png"
+}
+images {
+  image: "/assets/images/target.png"
+}
+extrude_borders: 2

physics/box2d_mouse_joint_example/box2d_mouse_joint/box2D_V2.appmanifest

@@ -0,0 +1,95 @@
+platforms:
+  arm64-ios:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      frameworks: []
+      linkFlags: []
+  x86_64-ios:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      frameworks: []
+      linkFlags: []
+  armv7-android:
+    context:
+      excludeLibs: []
+      excludeJars: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+      jetifier: true
+  arm64-android:
+    context:
+      excludeLibs: []
+      excludeJars: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+      jetifier: true
+  arm64-osx:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      frameworks: []
+      linkFlags: []
+  x86_64-osx:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      frameworks: []
+      linkFlags: []
+  x86_64-linux:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  arm64-linux:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  x86-win32:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  x86_64-win32:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  wasm-web:
+    context:
+      excludeLibs: []
+      excludeJsLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  wasm_pthread-web:
+    context:
+      excludeLibs: []
+      excludeJsLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []

physics/box2d_mouse_joint_example/box2d_mouse_joint/box2D_V3.appmanifest

@@ -0,0 +1,100 @@
+platforms:
+  armv7-ios:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+  arm64-ios:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      frameworks: []
+      linkFlags: []
+  x86_64-ios:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      frameworks: []
+      linkFlags: []
+  armv7-android:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeJars: []
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+      jetifier: true
+  arm64-android:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeJars: []
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+      jetifier: true
+  arm64-osx:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      frameworks: []
+      linkFlags: []
+  x86_64-osx:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      frameworks: []
+      linkFlags: []
+  x86_64-linux:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+  arm64-linux:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+  x86-win32:
+    context:
+      excludeLibs: [libphysics, libbox2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [libphysics_2d.lib, libbox2d.lib, libscript_box2d.lib, libphysics_3d.lib]
+      linkFlags: []
+  x86_64-win32:
+    context:
+      excludeLibs: [libphysics, libbox2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [libphysics_2d.lib, libbox2d.lib, libscript_box2d.lib, libphysics_3d.lib]
+      linkFlags: []
+  wasm-web:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeJsLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+  wasm_pthread-web:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeJsLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []

physics/box2d_mouse_joint_example/box2d_mouse_joint/example.md

@@ -0,0 +1,48 @@
+---
+tags: physics, box2d
+title: Box2D Mouse Joint
+brief: Create a mouse joint that pulls dynamic bodies toward a moving target.
+author: Defold Foundation
+scripts: box2d_mouse_joint_v3.script, box2d_mouse_joint_v2.script
+thumbnail: thumbnail.webp
+---
+
+This example shows how to create and control Box2D mouse joints from Lua. A visible target point moves automatically until you move the mouse or drag a touch point. Two dynamic bodies follow the same target with different spring settings, making the softer joint stretch behind the target while the tighter joint follows more closely.
+
+## What You'll Learn
+
+- How to get Box2D bodies from collision object components with `b2d.get_body()`.
+- How to create a mouse joint with `b2d.joint.create_mouse()`.
+- How `frequency` (V2) or `hertz` (V3), `damping_ratio`, and `max_force` affect spring-like motion.
+- How to update the joint target every frame with `b2d.joint.set_mouse_target()`.
+
+## Setup
+
+The collection contains 5 game objects:
+
+`controller`
+: Contains both backend scripts, `box2d_mouse_joint_v2.script` and `box2d_mouse_joint_v3.script`. Each script checks the active Box2D version and only one script runs.
+
+`target`
+: Contains the visible target sprite and a static collision object. The static body is used as the mouse-joint anchor.
+
+`soft_body`
+: Contains the orange sprite and a dynamic collision object. This body is connected with lower spring frequency/hertz and damping, so it follows the target more softly.
+
+`tight_body`
+: Contains the blue sprite and a dynamic collision object. This body is connected with higher spring frequency/hertz, damping, and max force, so it follows the target more tightly.
+
+`info`
+: Contains labels for the soft body, tight body, input instruction, and active Box2D backend.
+
+The project uses `box2D_V2.appmanifest` by default. To compare the newer backend, switch the native extension app manifest in `game.project` to `box2D_V3.appmanifest`.
+
+![setup](setup.png)
+
+## How It Works
+
+The mouse joint connects the invisible static body to a dynamic body. The joint does not move the body instantly. Instead, it applies a limited spring-damper force toward the target position. This is why the body can stretch, overshoot, and settle.
+
+The V2 script uses `frequency` and `damping_ratio` in the joint definition. The V3 script uses `hertz` and `damping_ratio`. Both scripts then call `b2d.joint.set_mouse_target()` every frame so the target can move continuously.
+
+The example creates two mouse joints with different values. The orange body uses a lower frequency/hertz and lower damping, so it visibly lags behind. The blue body uses a higher frequency/hertz, more damping, and a larger max force, so it feels tighter and follows the target more directly.