Add more hints on some actions

Don't show in changelog

Extensions/Physics3DBehavior/JsExtension.js

@@ -2226,7 +2226,17 @@ module.exports = {
         .addParameter('object', _('Object'), '', false)
         .addParameter('behavior', _('Behavior'), 'PhysicsCharacter3D')
         .addParameter('expression', _('Stick angle (in degrees)'))
+        .setParameterLongDescription(
+          _(
+            'A stick angle for a 3D Physics character of 0° means the object will move to the right, 90° backward and -90° (or 270°) forward.'
+          )
+        )
         .addParameter('expression', _('Stick force (between 0 and 1)'))
+        .setHint(
+          _(
+            "Simulating a stick control is usually used for connecting gamepads. For NPCs, it's usually better to rotate them toward target & simulate forward key instead."
+          )
+        )
         .markAsAdvanced()
         .setFunctionName('simulateStick');
 

Extensions/TopDownMovementBehavior/Extension.cpp

@@ -23,7 +23,9 @@ void DeclareTopDownMovementBehaviorExtension(gd::PlatformExtension& extension) {
             "events."),
           "Florian Rival",
           "Open source (MIT License)")
-      .SetShortDescription("Move objects in 4/8 directions via keyboard, joystick, or gamepad. Speed, acceleration, rotation.")
+      .SetShortDescription(
+          "Move objects in 4/8 directions via keyboard, joystick, or gamepad. "
+          "Speed, acceleration, rotation.")
       .SetDimension("2D")
       .SetCategory("Movement")
       .SetTags("top-down")
@@ -132,6 +134,9 @@ void DeclareTopDownMovementBehaviorExtension(gd::PlatformExtension& extension) {
       .AddParameter("object", _("Object"))
       .AddParameter("behavior", _("Behavior"), "TopDownMovementBehavior")
       .AddParameter("expression", _("Stick angle (in degrees)"))
+      .SetParameterLongDescription(
+          _("In top-down movement, a stick angle of 0° moves the object to the "
+            "right. 90° moves it down, and -90° moves it up."))
       .AddParameter("expression", _("Stick force (between 0 and 1)"))
       .MarkAsAdvanced()
       .SetFunctionName("SimulateStick");