[Auto] [Improve] Enhanced Spine object documentation with animation controls, point attachments, and skins (#446)

Author: github-actions[bot]

automated_updates_data.json

@@ -5,6 +5,7 @@
     { "date": "2026-02-16", "summary": "Improved core behavior documentation: added Window Center anchor option, draggable collision mask and Z-order details, destroy outside parameters" },
     { "date": "2026-02-16", "summary": "Enhanced pathfinding documentation with grid offset properties, path smoothing, obstacle cost clarification, and activation behavior" },
     { "date": "2026-02-16", "summary": "Improved UI and visual object documentation: enhanced light, button, slider, text, panel sprite, and particle emitter pages with detailed properties and usage tips" },
-    { "date": "2026-02-16", "summary": "Enhanced tween behavior documentation with scale center options, color modes, exponential interpolation, and effect properties" }
+    { "date": "2026-02-16", "summary": "Enhanced tween behavior documentation with scale center options, color modes, exponential interpolation, and effect properties" },
+    { "date": "2026-02-16", "summary": "Enhanced Spine object documentation with animation control details, point attachments, skins, mixing duration, and coordinate systems" }
   ]
 }

docs/gdevelop5/objects/spine/index.md

@@ -17,8 +17,10 @@ It supports smooth transitions between animations, as well as access to points a
 You can:
 
 - Load and display Spine animations exported from the Spine editor.
-- Control animation playback and blending.
-- Retrieve the position of specific **point attachments** defined in your Spine skeleton.
+- Control animation playback, pausing, and speed.
+- Configure smooth blending between animations with adjustable mixing duration.
+- Retrieve the position, rotation, and scale of specific **point attachments** defined in your Spine skeleton (both in local and world coordinates).
+- Apply different **skins** to change the character's appearance at runtime.
 - Use multiple animations with smooth transitions between them.
 
 It uses files exported from Spine (`.json`, `.atlas`, and image files) to render and animate characters or elements with smooth, interpolated bone-based movement.
@@ -38,8 +40,48 @@ In the object editor, you can configure:
 | Property            | Description                                                                                               |
 | ------------------- | --------------------------------------------------------------------------------------------------------- |
 | **Spine JSON file** | The main file describing bones, animations, and attachments.                                              |
-| **Scale**           | The overall display scale of the skeleton. Default value is **1**.                                        |
-| **Animations list** | List of available animations. Click **Scan** to automatically generate the list from the Spine JSON file. |
+| **Scale**           | The overall display scale of the skeleton. Default value is **1**. This scale is applied to the base size of the skeleton. |
+| **Skin name**       | The default skin to apply when the object is created. Leave empty to use the "default" skin defined in Spine. |
+| **Animations list** | List of available animations. Click **Scan** to automatically generate the list from the Spine JSON file. Each animation can be set to loop or play once. |
+
+## Key features
+
+### Animation control
+
+The Spine object provides full control over animation playback:
+
+- **Play animations by name or index**: Switch between different animations defined in your Spine skeleton.
+- **Animation speed scale**: Speed up or slow down animations by adjusting the speed scale (e.g., 0.5 for half speed, 2.0 for double speed).
+- **Pause and resume**: Pause the animation at any frame and resume playback later.
+- **Check animation completion**: Detect when a non-looping animation has finished playing.
+- **Animation mixing duration**: Set the duration (in seconds) for smooth transitions between animations. A value of 0 means instant switching, while higher values create smooth blending.
+
+### Point attachments
+
+Point attachments are invisible reference points defined in your Spine skeleton. You can use them to:
+
+- Position objects at specific bones (e.g., place a weapon in a character's hand).
+- Track the position of any part of the skeleton during animation.
+- Get both **local coordinates** (relative to the skeleton) and **world coordinates** (absolute position on the scene).
+- Retrieve position, rotation, and scale information for each point attachment.
+
+When accessing point attachments, you specify the **attachment name** and optionally the **slot name**. If the attachment and slot have the same name, you can leave the slot name empty.
+
+### Skins
+
+Skins allow you to change the appearance of your Spine character without changing the skeleton structure or animations:
+
+- Switch between different character outfits or appearances at runtime.
+- Each skin can have different images attached to the same bones.
+- The default skin is named "default" unless you specify otherwise in Spine.
+
+### Flipping and scaling
+
+The Spine object supports standard transformations:
+
+- **Flip horizontally or vertically**: Mirror the skeleton on the X or Y axis.
+- **Independent scale on X and Y**: Stretch or compress the skeleton in either direction.
+- **Resize**: Change the width and height of the skeleton, which adjusts the scale accordingly.
 
 ## Examples