[Platformer] Add a test about landing on jumpthru while overlapping another one.

- When pasting objects, the pasted objects are selected
- Fix the possibility to undo/redo an object paste

.vscode/settings.json

@@ -109,7 +109,8 @@
         "xutility": "cpp",
         "xlocbuf": "cpp",
         "xlocmes": "cpp",
-        "xmemory0": "cpp"
+        "xmemory0": "cpp",
+        "memory_resource": "cpp"
     },
     "files.exclude": {
         "Binaries/*build*": true,

Core/GDCore/Events/CodeGeneration/EventsCodeGenerator.cpp

@@ -315,31 +315,38 @@ gd::String EventsCodeGenerator::GenerateConditionCode(
 
   if (instrInfos.IsObjectInstruction()) {
     gd::String objectName = condition.GetParameter(0).GetPlainString();
-    gd::String objectType = gd::GetTypeOfObject(
-        GetGlobalObjectsAndGroups(), GetObjectsAndGroups(), objectName);
     if (!objectName.empty() && !instrInfos.parameters.empty()) {
       std::vector<gd::String> realObjects =
           ExpandObjectsName(objectName, context);
       for (std::size_t i = 0; i < realObjects.size(); ++i) {
         // Set up the context
+        gd::String objectType = gd::GetTypeOfObject(
+            GetGlobalObjectsAndGroups(), GetObjectsAndGroups(), realObjects[i]);
         const ObjectMetadata& objInfo =
             MetadataProvider::GetObjectMetadata(platform, objectType);
-        AddIncludeFiles(objInfo.includeFiles);
-        context.SetCurrentObject(realObjects[i]);
-        context.ObjectsListNeeded(realObjects[i]);
 
-        // Prepare arguments and generate the condition whole code
-        vector<gd::String> arguments = GenerateParametersCodes(
-            condition.GetParameters(), instrInfos.parameters, context);
-        conditionCode += GenerateObjectCondition(realObjects[i],
-                                                 objInfo,
-                                                 arguments,
-                                                 instrInfos,
-                                                 returnBoolean,
-                                                 condition.IsInverted(),
-                                                 context);
+        if (objInfo.IsUnsupportedBaseObjectCapability(
+                instrInfos.GetRequiredBaseObjectCapability())) {
+          conditionCode +=
+              "/* Object with unsupported capability - skipped. */\n";
+        } else {
+          AddIncludeFiles(objInfo.includeFiles);
+          context.SetCurrentObject(realObjects[i]);
+          context.ObjectsListNeeded(realObjects[i]);
 
-        context.SetNoCurrentObject();
+          // Prepare arguments and generate the condition whole code
+          vector<gd::String> arguments = GenerateParametersCodes(
+              condition.GetParameters(), instrInfos.parameters, context);
+          conditionCode += GenerateObjectCondition(realObjects[i],
+                                                   objInfo,
+                                                   arguments,
+                                                   instrInfos,
+                                                   returnBoolean,
+                                                   condition.IsInverted(),
+                                                   context);
+
+          context.SetNoCurrentObject();
+        }
       }
     }
   } else if (instrInfos.IsBehaviorInstruction()) {
@@ -489,27 +496,33 @@ gd::String EventsCodeGenerator::GenerateActionCode(
   // Call free function first if available
   if (instrInfos.IsObjectInstruction()) {
     gd::String objectName = action.GetParameter(0).GetPlainString();
-    gd::String objectType = gd::GetTypeOfObject(
-        GetGlobalObjectsAndGroups(), GetObjectsAndGroups(), objectName);
 
     if (!instrInfos.parameters.empty()) {
       std::vector<gd::String> realObjects =
           ExpandObjectsName(objectName, context);
       for (std::size_t i = 0; i < realObjects.size(); ++i) {
         // Setup context
+        gd::String objectType = gd::GetTypeOfObject(
+            GetGlobalObjectsAndGroups(), GetObjectsAndGroups(), realObjects[i]);
         const ObjectMetadata& objInfo =
             MetadataProvider::GetObjectMetadata(platform, objectType);
-        AddIncludeFiles(objInfo.includeFiles);
-        context.SetCurrentObject(realObjects[i]);
-        context.ObjectsListNeeded(realObjects[i]);
 
-        // Prepare arguments and generate the whole action code
-        vector<gd::String> arguments = GenerateParametersCodes(
-            action.GetParameters(), instrInfos.parameters, context);
-        actionCode += GenerateObjectAction(
-            realObjects[i], objInfo, arguments, instrInfos, context);
+        if (objInfo.IsUnsupportedBaseObjectCapability(
+                instrInfos.GetRequiredBaseObjectCapability())) {
+          actionCode += "/* Object with unsupported capability - skipped. */\n";
+        } else {
+          AddIncludeFiles(objInfo.includeFiles);
+          context.SetCurrentObject(realObjects[i]);
+          context.ObjectsListNeeded(realObjects[i]);
 
-        context.SetNoCurrentObject();
+          // Prepare arguments and generate the whole action code
+          vector<gd::String> arguments = GenerateParametersCodes(
+              action.GetParameters(), instrInfos.parameters, context);
+          actionCode += GenerateObjectAction(
+              realObjects[i], objInfo, arguments, instrInfos, context);
+
+          context.SetNoCurrentObject();
+        }
       }
     }
   } else if (instrInfos.IsBehaviorInstruction()) {
@@ -621,14 +634,15 @@ gd::String EventsCodeGenerator::GenerateParameterCodes(
     argOutput = GenerateGetBehaviorNameCode(parameter);
   } else if (metadata.type == "key") {
     argOutput = "\"" + ConvertToString(parameter) + "\"";
-  } else if (metadata.type == "password" ||  // Deprecated
-             metadata.type ==
-                 "musicfile" ||  // Should be renamed "largeAudioResource"
-             metadata.type ==
-                 "soundfile" ||            // Should be renamed "audioResource"
-             metadata.type == "police" ||  // Should be renamed "fontResource"
+  } else if (metadata.type == "audioResource" ||
              metadata.type == "bitmapFontResource" ||
-             metadata.type == "imageResource") {
+             metadata.type == "fontResource" ||
+             metadata.type == "imageResource" ||
+             metadata.type == "jsonResource" ||
+             metadata.type == "videoResource" ||
+             // Deprecated, old parameter names:
+             metadata.type == "password" || metadata.type == "musicfile" ||
+             metadata.type == "soundfile" || metadata.type == "police") {
     argOutput = "\"" + ConvertToString(parameter) + "\"";
   } else if (metadata.type == "mouse") {
     argOutput = "\"" + ConvertToString(parameter) + "\"";

Core/GDCore/Events/CodeGeneration/ExpressionCodeGenerator.cpp

@@ -219,14 +219,20 @@ gd::String ExpressionCodeGenerator::GenerateObjectFunctionCode(
     const ObjectMetadata& objInfo = MetadataProvider::GetObjectMetadata(
         codeGenerator.GetPlatform(), objectType);
 
-    codeGenerator.AddIncludeFiles(objInfo.includeFiles);
-    functionOutput = codeGenerator.GenerateObjectFunctionCall(
-        realObjects[i],
-        objInfo,
-        expressionMetadata.codeExtraInformation,
-        parametersCode,
-        functionOutput,
-        context);
+    if (objInfo.IsUnsupportedBaseObjectCapability(
+            expressionMetadata.GetRequiredBaseObjectCapability())) {
+      // Do nothing, skipping objects not supporting the capability required by
+      // this expression.
+    } else {
+      codeGenerator.AddIncludeFiles(objInfo.includeFiles);
+      functionOutput = codeGenerator.GenerateObjectFunctionCall(
+          realObjects[i],
+          objInfo,
+          expressionMetadata.codeExtraInformation,
+          parametersCode,
+          functionOutput,
+          context);
+    }
   }
 
   return functionOutput;

Core/GDCore/Events/Parsers/ExpressionParser2.h

@@ -13,6 +13,7 @@
 #include "ExpressionParser2Node.h"
 #include "GDCore/Extensions/Metadata/ExpressionMetadata.h"
 #include "GDCore/Extensions/Metadata/MetadataProvider.h"
+#include "GDCore/Extensions/Metadata/ObjectMetadata.h"
 #include "GDCore/Project/Layout.h"  // For GetTypeOfObject and GetTypeOfBehavior
 #include "GDCore/String.h"
 #include "GDCore/Tools/Localization.h"
@@ -484,10 +485,25 @@ class GD_CORE_API ExpressionParser2 {
           metadata,
           objectFunctionOrBehaviorName);
       function->diagnostic = std::move(parametersNode.diagnostic);
+
       if (!function->diagnostic)  // TODO: reverse the order of diagnostic?
         function->diagnostic = ValidateFunction(
             type, *function, objectNameLocation.GetStartPosition());
 
+      // If the function needs a capability on the object that may not be covered
+      // by all objects, check it now.
+      if (!metadata.GetRequiredBaseObjectCapability().empty()) {
+        const gd::ObjectMetadata &objectMetadata =
+            MetadataProvider::GetObjectMetadata(platform, objectType);
+
+        if (objectMetadata.IsUnsupportedBaseObjectCapability(
+                metadata.GetRequiredBaseObjectCapability())) {
+          function->diagnostic = RaiseTypeError(
+              _("This expression exists, but it can't be used on this object."),
+              objectNameLocation.GetStartPosition());
+        }
+      }
+
       function->location = ExpressionParserLocation(
           objectNameLocation.GetStartPosition(), GetCurrentPosition());
       function->objectNameLocation = objectNameLocation;

Core/GDCore/Extensions/Builtin/AdvancedExtension.cpp

@@ -11,25 +11,16 @@ namespace gd {
 
 void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAdvancedExtension(
     gd::PlatformExtension& extension) {
-  extension.SetExtensionInformation(
-      "BuiltinAdvanced",
-      _("Advanced control features"),
-      _("Advanced control features to be used in events."),
-      "Florian Rival",
-      "Open source (MIT License)");
-
   extension
-      .AddCondition("Toujours",
-                    _("Always"),
-                    _("This condition always returns true (or always false, if "
-                      "the condition is inverted)."),
-                    _("Always"),
-                    _("Other"),
-                    "res/conditions/toujours24.png",
-                    "res/conditions/toujours.png")
-      .SetHelpPath("/all-features/advanced-conditions")
-      .AddCodeOnlyParameter("conditionInverted", "")
-      .MarkAsAdvanced();
+      .SetExtensionInformation(
+          "BuiltinAdvanced",
+          _("Event functions"),
+          _("Advanced control features for functions made with events."),
+          "Florian Rival",
+          "Open source (MIT License)")
+      .SetCategory("Advanced");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Event functions"))
+      .SetIcon("res/function32.png");
 
   extension
       .AddAction(
@@ -38,9 +29,9 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAdvancedExtension(
           _("Set the return value of the events function to the specified "
             "number (to be used with \"Expression\" functions)."),
           _("Set return value to number _PARAM0_"),
-          _("Functions"),
-          "res/function24.png",
-          "res/function16.png")
+          "",
+          "res/function32.png",
+          "res/function32.png")
       .SetHelpPath("/events/functions/return")
       .AddParameter("expression", "The number to be returned")
       .MarkAsAdvanced();
@@ -52,9 +43,9 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAdvancedExtension(
           _("Set the return value of the events function to the specified text "
             "(to be used with \"String Expression\" functions)."),
           _("Set return value to text _PARAM0_"),
-          _("Functions"),
-          "res/function24.png",
-          "res/function16.png")
+          "",
+          "res/function32.png",
+          "res/function32.png")
       .SetHelpPath("/events/functions/return")
       .AddParameter("string", "The text to be returned")
       .MarkAsAdvanced();
@@ -65,9 +56,9 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAdvancedExtension(
                  _("Set the return value of the Condition events function to "
                    "either true (condition will pass) or false."),
                  _("Set return value of the condition to _PARAM0_"),
-                 _("Functions"),
-                 "res/function24.png",
-                 "res/function16.png")
+                 "",
+                 "res/function32.png",
+                 "res/function32.png")
       .SetHelpPath("/events/functions/return")
       .AddParameter("trueorfalse", "Should the condition be true or false?")
       .MarkAsAdvanced();
@@ -80,9 +71,9 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAdvancedExtension(
                       "a string, an empty string is considered as \"false\". "
                       "If it's a number, 0 is considered as \"false\"."),
                     _("Parameter _PARAM0_ is true"),
-                    _("Functions"),
-                    "res/function24.png",
-                    "res/function16.png")
+                    "",
+                    "res/function32.png",
+                    "res/function32.png")
       .AddParameter("functionParameterName", "Parameter name")
       .MarkAsAdvanced();
 
@@ -91,7 +82,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAdvancedExtension(
           "GetArgumentAsNumber",
           _("Get function parameter value"),
           _("Get function parameter (also called \"argument\") value"),
-          _("Functions"),
+          "",
           "res/function16.png")
       .AddParameter("functionParameterName", "Parameter name");
 
@@ -100,7 +91,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAdvancedExtension(
           "GetArgumentAsString",
           _("Get function parameter text"),
           _("Get function parameter (also called \"argument\") text "),
-          _("Functions"),
+          "",
           "res/function16.png")
       .AddParameter("functionParameterName", "Parameter name");
 }

Core/GDCore/Extensions/Builtin/AllBuiltinExtensions.h

@@ -15,8 +15,6 @@ namespace gd {
  * so that it provides standards events, objects or instructions of an
  * extension.
  *
- * TOOD: Usage example.
- *
  * \ingroup BuiltinExtensions
  */
 class GD_CORE_API BuiltinExtensionsImplementer {

Core/GDCore/Extensions/Builtin/AudioExtension.cpp

@@ -14,12 +14,15 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
   extension
       .SetExtensionInformation(
           "BuiltinAudio",
-          _("Audio"),
+          _("Sounds and musics"),
           _("GDevelop provides several conditions and actions to play audio "
             "files. They can be either long musics or short sound effects."),
           "Florian Rival",
           "Open source (MIT License)")
-      .SetExtensionHelpPath("/all-features/audio");
+      .SetExtensionHelpPath("/all-features/audio")
+      .SetCategory("Audio");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Sounds and musics"))
+      .SetIcon("res/actions/music24.png");
 
   extension
       .AddAction("PlaySoundCanal",
@@ -28,7 +31,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                    "you'll be able to manipulate it."),
                  _("Play the sound _PARAM1_ on the channel _PARAM2_, vol.: "
                    "_PARAM4_, loop: _PARAM3_"),
-                 _("Audio/Sounds on channels"),
+                 _("Sounds on channels"),
                  "res/actions/son24.png",
                  "res/actions/son.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -49,7 +52,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Stop the sound of a channel"),
                  _("Stop the sound on the specified channel."),
                  _("Stop the sound of channel _PARAM1_"),
-                 _("Audio/Sounds on channels"),
+                 _("Sounds on channels"),
                  "res/actions/son24.png",
                  "res/actions/son.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -61,7 +64,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Pause the sound of a channel"),
                  _("Pause the sound played on the specified channel."),
                  _("Pause the sound of channel _PARAM1_"),
-                 _("Audio/Sounds on channels"),
+                 _("Sounds on channels"),
                  "res/actions/son24.png",
                  "res/actions/son.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -73,7 +76,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Play the sound of a channel"),
                  _("Play the sound of the channel."),
                  _("Play the sound of channel _PARAM1_"),
-                 _("Audio/Sounds on channels"),
+                 _("Sounds on channels"),
                  "res/actions/son24.png",
                  "res/actions/son.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -87,7 +90,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                    "able to interact with it later."),
                  _("Play the music _PARAM1_ on channel _PARAM2_, vol.: "
                    "_PARAM4_, loop: _PARAM3_"),
-                 _("Audio/Music on channels"),
+                 _("Music on channels"),
                  "res/actions/music24.png",
                  "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -108,7 +111,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Stop the music on a channel"),
                  _("Stop the music on the specified channel"),
                  _("Stop the music of channel _PARAM1_"),
-                 _("Audio/Music on channels"),
+                 _("Music on channels"),
                  "res/actions/music24.png",
                  "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -120,7 +123,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Pause the music of a channel"),
                  _("Pause the music on the specified channel."),
                  _("Pause the music of channel _PARAM1_"),
-                 _("Audio/Music on channels"),
+                 _("Music on channels"),
                  "res/actions/music24.png",
                  "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -132,7 +135,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Play the music of a channel"),
                  _("Play the music of the channel."),
                  _("Play the music of channel _PARAM1_"),
-                 _("Audio/Music on channels"),
+                 _("Music on channels"),
                  "res/actions/music24.png",
                  "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -145,7 +148,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("This action modifies the volume of the sound on the "
                    "specified channel. The volume is between 0 and 100."),
                  _("the volume of the sound on channel _PARAM1_"),
-                 _("Audio/Sounds on channels"),
+                 _("Sounds on channels"),
                  "res/actions/sonVolume24.png",
                  "res/actions/sonVolume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -159,7 +162,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("This action modifies the volume of the music on the "
                    "specified channel. The volume is between 0 and 100."),
                  _("the volume of the music on channel _PARAM1_"),
-                 _("Audio/Music on channels"),
+                 _("Music on channels"),
                  "res/actions/musicVolume24.png",
                  "res/actions/musicVolume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -173,7 +176,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("This action modifies the global volume of the game. The "
                    "volume is between 0 and 100."),
                  _("the global sound level"),
-                 _("Audio"),
+                 "",
                  "res/actions/volume24.png",
                  "res/actions/volume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -186,7 +189,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("This action modifies the pitch (speed) of the sound on a "
                    "channel.\n1 is the default pitch."),
                  _("the pitch of the sound on channel _PARAM1_"),
-                 _("Audio/Sounds on channels"),
+                 _("Sounds on channels"),
                  "res/actions/son24.png",
                  "res/actions/son.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -200,7 +203,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("This action modifies the pitch of the music on the "
                    "specified channel. 1 is the default pitch"),
                  _("the pitch of the music on channel _PARAM1_"),
-                 _("Audio/Music on channels"),
+                 _("Music on channels"),
                  "res/actions/music24.png",
                  "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -214,7 +217,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("This action modifies the playing offset of the sound on a "
                    "channel"),
                  _("the playing offset of the sound on channel _PARAM1_"),
-                 _("Audio/Sounds on channels"),
+                 _("Sounds on channels"),
                  "res/actions/son24.png",
                  "res/actions/son.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -228,7 +231,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("This action modifies the playing offset of the music on "
                    "the specified channel"),
                  _("the playing offset of the music on channel _PARAM1_"),
-                 _("Audio/Music on channels"),
+                 _("Music on channels"),
                  "res/actions/music24.png",
                  "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -241,7 +244,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Play a sound"),
                  _("Play a sound."),
                  _("Play the sound _PARAM1_, vol.: _PARAM3_, loop: _PARAM2_"),
-                 _("Audio"),
+                 "",
                  "res/actions/son24.png",
                  "res/actions/son.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -261,7 +264,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Play a music file"),
                  _("Play a music file."),
                  _("Play the music _PARAM1_, vol.: _PARAM3_, loop: _PARAM2_"),
-                 _("Audio"),
+                 "",
                  "res/actions/music24.png",
                  "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -281,7 +284,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Preload a music file"),
                  _("Preload a music file in memory."),
                  _("Preload the music file _PARAM1_"),
-                 _("Audio/Loading"),
+                 _("Loading"),
                  "res/actions/music24.png",
                  "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -293,7 +296,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                  _("Preload a sound file"),
                  _("Preload a sound file in memory."),
                  _("Preload the sound file _PARAM1_"),
-                 _("Audio/Loading"),
+                 _("Loading"),
                  "res/actions/son24.png",
                  "res/actions/son.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -301,46 +304,43 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
       .MarkAsComplex();
 
   extension
-      .AddAction("UnloadMusic",
-                 _("Unload a music file"),
-                 _(
-                    "Unload a music file from memory. "
-                    "Unloading a music file will cause any music playing it to stop."
-                  ),
-                 _("Unload the music file _PARAM1_"),
-                 _("Audio/Loading"),
-                 "res/actions/music24.png",
-                 "res/actions/music.png")
+      .AddAction(
+          "UnloadMusic",
+          _("Unload a music file"),
+          _("Unload a music file from memory. "
+            "Unloading a music file will cause any music playing it to stop."),
+          _("Unload the music file _PARAM1_"),
+          _("Loading"),
+          "res/actions/music24.png",
+          "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("musicfile", _("Audio file (or audio resource name)"))
       .MarkAsComplex();
 
   extension
-      .AddAction("UnloadSound",
-                 _("Unload a sound file"),
-                 _(
-                    "Unload a sound file from memory. "
-                    "Unloading a sound file will cause any sounds playing it to stop."
-                  ),
-                 _("Unload the sound file _PARAM1_"),
-                 _("Audio/Loading"),
-                 "res/actions/son24.png",
-                 "res/actions/son.png")
+      .AddAction(
+          "UnloadSound",
+          _("Unload a sound file"),
+          _("Unload a sound file from memory. "
+            "Unloading a sound file will cause any sounds playing it to stop."),
+          _("Unload the sound file _PARAM1_"),
+          _("Loading"),
+          "res/actions/son24.png",
+          "res/actions/son.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("soundfile", _("Sound file (or sound resource name)"))
       .MarkAsComplex();
 
   extension
-      .AddAction("UnloadAllAudio",
-                 _("Unload all audio"),
-                 _(
-                   "Unload all the audio in memory. "
-                   "This will cause every sound and music of the game to stop."
-                  ),
-                 _("Unload all audio files"),
-                 _("Audio/Loading"),
-                 "res/actions/music24.png",
-                 "res/actions/music.png")
+      .AddAction(
+          "UnloadAllAudio",
+          _("Unload all audio"),
+          _("Unload all the audio in memory. "
+            "This will cause every sound and music of the game to stop."),
+          _("Unload all audio files"),
+          _("Loading"),
+          "res/actions/music24.png",
+          "res/actions/music.png")
       .AddCodeOnlyParameter("currentScene", "")
       .MarkAsComplex();
 
@@ -349,7 +349,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                     _("A music file is being played"),
                     _("Test if the music on a channel is being played"),
                     _("Music on channel _PARAM1_ is being played"),
-                    _("Audio/Music on channels"),
+                    _("Music on channels"),
                     "res/conditions/musicplaying24.png",
                     "res/conditions/musicplaying.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -361,7 +361,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                     _("A music file is paused"),
                     _("Test if the music on the specified channel is paused."),
                     _("Music on channel _PARAM1_ is paused"),
-                    _("Audio/Music on channels"),
+                    _("Music on channels"),
                     "res/conditions/musicpaused24.png",
                     "res/conditions/musicpaused.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -373,7 +373,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                     _("A music file is stopped"),
                     _("Test if the music on the specified channel is stopped."),
                     _("Music on channel _PARAM1_ is stopped"),
-                    _("Audio/Music on channels"),
+                    _("Music on channels"),
                     "res/conditions/musicstopped24.png",
                     "res/conditions/musicstopped.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -385,7 +385,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                     _("A sound is being played"),
                     _("Test if the sound on a channel is being played."),
                     _("Sound on channel _PARAM1_ is being played"),
-                    _("Audio/Sounds on channels"),
+                    _("Sounds on channels"),
                     "res/conditions/sonplaying24.png",
                     "res/conditions/sonplaying.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -397,7 +397,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                     _("A sound is paused"),
                     _("Test if the sound on the specified channel is paused."),
                     _("Sound on channel _PARAM1_ is paused"),
-                    _("Audio/Sounds on channels"),
+                    _("Sounds on channels"),
                     "res/conditions/sonpaused24.png",
                     "res/conditions/sonpaused.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -409,7 +409,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                     _("A sound is stopped"),
                     _("Test if the sound on the specified channel is stopped."),
                     _("Sound on channel _PARAM1_ is stopped"),
-                    _("Audio/Sounds on channels"),
+                    _("Sounds on channels"),
                     "res/conditions/sonstopped24.png",
                     "res/conditions/sonstopped.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -423,7 +423,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
           _("Test the volume of the sound on the specified channel. The volume "
             "is between 0 and 100."),
           _("the volume of the sound on channel _PARAM1_"),
-          _("Audio/Sounds on channels"),
+          _("Sounds on channels"),
           "res/conditions/sonVolume24.png",
           "res/conditions/sonVolume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -438,7 +438,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
           _("Test the volume of the music on a specified channel. The volume "
             "is between 0 and 100."),
           _("the volume of the music on channel _PARAM1_"),
-          _("Audio/Music on channels"),
+          _("Music on channels"),
           "res/conditions/musicVolume24.png",
           "res/conditions/musicVolume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -452,7 +452,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
           _("Global volume"),
           _("Test the global sound level. The volume is between 0 and 100."),
           _("the global game volume"),
-          _("Audio"),
+          "",
           "res/conditions/volume24.png",
           "res/conditions/volume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -465,7 +465,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
           _("Test the pitch of the sound on the specified channel. 1 is the "
             "default pitch."),
           _("the pitch of the sound on channel _PARAM1_"),
-          _("Audio/Sounds on channels"),
+          _("Sounds on channels"),
           "res/conditions/sonVolume24.png",
           "res/conditions/sonVolume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -480,7 +480,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
           _("Test the pitch (speed) of the music on a specified channel. 1 is "
             "the default pitch."),
           _("the pitch of the music on channel _PARAM1_"),
-          _("Audio/Music on channels"),
+          _("Music on channels"),
           "res/conditions/musicVolume24.png",
           "res/conditions/musicVolume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -494,7 +494,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
           _("Playing offset of the sound on a channel"),
           _("Test the playing offset of the sound on the specified channel."),
           _("the playing offset of the sound on channel _PARAM1_"),
-          _("Audio/Sounds on channels"),
+          _("Sounds on channels"),
           "res/conditions/sonVolume24.png",
           "res/conditions/sonVolume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -508,7 +508,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
           _("Playing offset of the music on a channel"),
           _("Test the playing offset of the music on the specified channel."),
           _("the playing offset of the music on channel _PARAM1_"),
-          _("Audio/Music on channels"),
+          _("Music on channels"),
           "res/conditions/musicVolume24.png",
           "res/conditions/musicVolume.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -577,7 +577,6 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsAudioExtension(
                      _("Sound level"),
                      "res/conditions/volume.png")
       .AddCodeOnlyParameter("currentScene", "");
-
 }
 
 }  // namespace gd

Core/GDCore/Extensions/Builtin/BaseObjectExtension.cpp

@@ -4,9 +4,9 @@
  * reserved. This project is released under the MIT License.
  */
 #include "AllBuiltinExtensions.h"
+#include "GDCore/Extensions/Metadata/MultipleInstructionMetadata.h"
 #include "GDCore/Project/Object.h"
 #include "GDCore/Tools/Localization.h"
-#include "GDCore/Extensions/Metadata/MultipleInstructionMetadata.h"
 
 using namespace std;
 namespace gd {
@@ -16,11 +16,17 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
   extension
       .SetExtensionInformation(
           "BuiltinObject",
-          _("Features for all objects"),
+          _("Objects"),
           _("Common features that can be used for all objects in GDevelop."),
           "Florian Rival",
           "Open source (MIT License)")
       .SetExtensionHelpPath("/objects/base_object/events");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Collision"))
+      .SetIcon("res/conditions/collision24.png");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Objects"))
+      .SetIcon("res/actions/create24.png");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Movement using forces"))
+      .SetIcon("res/actions/force24.png");
 
   gd::ObjectMetadata& obj = extension.AddObject<gd::Object>(
       "", _("Base object"), _("Base object"), "res/objeticon24.png");
@@ -92,7 +98,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
   obj.AddAction("SetCenter",
                 _("Center position"),
                 _("Change the position of an object, using its center."),
-                _("Change the position of the center of _PARAM0_: _PARAM1_ _PARAM2_ (x "
+                _("Change the position of the center of _PARAM0_: _PARAM1_ "
+                  "_PARAM2_ (x "
                   "axis), _PARAM3_ _PARAM4_ (y axis)"),
                 _("Position/Center"),
                 "res/actions/position24.png",
@@ -104,75 +111,91 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("expression", _("Y position"))
       .MarkAsSimple();
 
-  obj.AddExpressionAndConditionAndAction("number", "CenterX",
-          _("Center X position"),
-          _("the X position of the center of rotation"),
-          _("the X position of the center"),
-          _("Position/Center"),
-          "res/actions/position24.png")
+  obj.AddExpressionAndConditionAndAction(
+         "number",
+         "CenterX",
+         _("Center X position"),
+         _("the X position of the center of rotation"),
+         _("the X position of the center"),
+         _("Position/Center"),
+         "res/actions/position24.png")
       .AddParameter("object", _("Object"))
       .UseStandardParameters("number");
 
-  obj.AddExpressionAndConditionAndAction("number", "CenterY",
-          _("Center Y position"),
-          _("the Y position of the center of rotation"),
-          _("the Y position of the center"),
-          _("Position/Center"),
-          "res/actions/position24.png")
+  obj.AddExpressionAndConditionAndAction(
+         "number",
+         "CenterY",
+         _("Center Y position"),
+         _("the Y position of the center of rotation"),
+         _("the Y position of the center"),
+         _("Position/Center"),
+         "res/actions/position24.png")
       .AddParameter("object", _("Object"))
       .UseStandardParameters("number");
 
-  obj.AddExpressionAndCondition("number", "BoundingBoxLeft",
-          _("Bounding box left position"),
-          _("the bounding box (the area encapsulating the object) left position"),
-          _("the bounding box left position"),
-          _("Position/Bounding Box"),
-          "res/conditions/bounding-box-left.svg")
+  obj.AddExpressionAndCondition("number",
+                                "BoundingBoxLeft",
+                                _("Bounding box left position"),
+                                _("the bounding box (the area encapsulating "
+                                  "the object) left position"),
+                                _("the bounding box left position"),
+                                _("Position/Bounding Box"),
+                                "res/conditions/bounding-box-left.svg")
       .AddParameter("object", _("Object"))
       .UseStandardParameters("number");
 
-  obj.AddExpressionAndCondition("number", "BoundingBoxTop",
-          _("Bounding box top position"),
-          _("the bounding box (the area encapsulating the object) top position"),
-          _("the bounding box top position"),
-          _("Position/Bounding Box"),
-          "res/conditions/bounding-box-top.svg")
+  obj.AddExpressionAndCondition(
+         "number",
+         "BoundingBoxTop",
+         _("Bounding box top position"),
+         _("the bounding box (the area encapsulating the object) top position"),
+         _("the bounding box top position"),
+         _("Position/Bounding Box"),
+         "res/conditions/bounding-box-top.svg")
       .AddParameter("object", _("Object"))
       .UseStandardParameters("number");
 
-  obj.AddExpressionAndCondition("number", "BoundingBoxRight",
-          _("Bounding box right position"),
-          _("the bounding box (the area encapsulating the object) right position"),
-          _("the bounding box right position"),
-          _("Position/Bounding Box"),
-          "res/conditions/bounding-box-right.svg")
+  obj.AddExpressionAndCondition("number",
+                                "BoundingBoxRight",
+                                _("Bounding box right position"),
+                                _("the bounding box (the area encapsulating "
+                                  "the object) right position"),
+                                _("the bounding box right position"),
+                                _("Position/Bounding Box"),
+                                "res/conditions/bounding-box-right.svg")
       .AddParameter("object", _("Object"))
       .UseStandardParameters("number");
 
-  obj.AddExpressionAndCondition("number", "BoundingBoxBottom",
-          _("Bounding box bottom position"),
-          _("the bounding box (the area encapsulating the object) bottom position"),
-          _("the bounding box bottom position"),
-          _("Position/Bounding Box"),
-          "res/conditions/bounding-box-bottom.svg")
+  obj.AddExpressionAndCondition("number",
+                                "BoundingBoxBottom",
+                                _("Bounding box bottom position"),
+                                _("the bounding box (the area encapsulating "
+                                  "the object) bottom position"),
+                                _("the bounding box bottom position"),
+                                _("Position/Bounding Box"),
+                                "res/conditions/bounding-box-bottom.svg")
       .AddParameter("object", _("Object"))
       .UseStandardParameters("number");
 
-  obj.AddExpressionAndCondition("number", "BoundingBoxCenterX",
-          _("Bounding box center X position"),
-          _("the bounding box (the area encapsulating the object) center X position"),
-          _("the bounding box center X position"),
-          _("Position/Bounding Box"),
-          "res/conditions/bounding-box-center.svg")
+  obj.AddExpressionAndCondition("number",
+                                "BoundingBoxCenterX",
+                                _("Bounding box center X position"),
+                                _("the bounding box (the area encapsulating "
+                                  "the object) center X position"),
+                                _("the bounding box center X position"),
+                                _("Position/Bounding Box"),
+                                "res/conditions/bounding-box-center.svg")
       .AddParameter("object", _("Object"))
       .UseStandardParameters("number");
 
-  obj.AddExpressionAndCondition("number", "BoundingBoxCenterY",
-          _("Bounding box center Y position"),
-          _("the bounding box (the area encapsulating the object) center Y position"),
-          _("the bounding box center Y position"),
-          _("Position/Bounding Box"),
-          "res/conditions/bounding-box-center.svg")
+  obj.AddExpressionAndCondition("number",
+                                "BoundingBoxCenterY",
+                                _("Bounding box center Y position"),
+                                _("the bounding box (the area encapsulating "
+                                  "the object) center Y position"),
+                                _("the bounding box center Y position"),
+                                _("Position/Bounding Box"),
+                                "res/conditions/bounding-box-center.svg")
       .AddParameter("object", _("Object"))
       .UseStandardParameters("number");
 
@@ -289,7 +312,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
          "AddForceVersPos",
          _("Add a force to move toward a position"),
          _("Add a force to an object to make it move toward a position."),
-         _("Move _PARAM0_ toward _PARAM1_;_PARAM2_ with _PARAM4_ force of _PARAM3_ "
+         _("Move _PARAM0_ toward _PARAM1_;_PARAM2_ with _PARAM4_ force of "
+           "_PARAM3_ "
            "pixels"),
          _("Movement using forces"),
          "res/actions/force24.png",
@@ -306,11 +330,11 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
          "AddForceTournePos",
          "Add a force to move around a position",
          "Add a force to an object to make it rotate around a "
-           "position.\nNote that the movement is not precise, especially if "
-           "the speed is high.\nTo position an object around a position more "
-           "precisely, use the actions in the category \"Position\".",
+         "position.\nNote that the movement is not precise, especially if "
+         "the speed is high.\nTo position an object around a position more "
+         "precisely, use the actions in the category \"Position\".",
          "Rotate _PARAM0_ around _PARAM1_;_PARAM2_ at _PARAM3_ deg/sec and "
-           "_PARAM4_ pixels away",
+         "_PARAM4_ pixels away",
          _("Movement using forces"),
          "res/actions/forceTourne24.png",
          "res/actions/forceTourne.png")
@@ -563,7 +587,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
 
   obj.AddCondition("AngleOfDisplacement",
                    _("Angle of movement (using forces)"),
-                   _("Compare the angle of movement of an object according to the forces applied on it."),
+                   _("Compare the angle of movement of an object according to "
+                     "the forces applied on it."),
                    _("Angle of movement of _PARAM0_ is _PARAM1_ (tolerance"
                      ": _PARAM2_ degrees)"),
                    _("Movement using forces"),
@@ -719,14 +744,14 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("yesorno", _("Activate?"))
       .MarkAsAdvanced();
 
-  obj.AddAction(
-         "AddForceVers",
-         _("Add a force to move toward an object"),
-         _("Add a force to an object to make it move toward another."),
-         _("Move _PARAM0_ toward _PARAM1_ with _PARAM3_ force of _PARAM2_ pixels"),
-         _("Movement using forces"),
-         "res/actions/forceVers24.png",
-         "res/actions/forceVers.png")
+  obj.AddAction("AddForceVers",
+                _("Add a force to move toward an object"),
+                _("Add a force to an object to make it move toward another."),
+                _("Move _PARAM0_ toward _PARAM1_ with _PARAM3_ force of "
+                  "_PARAM2_ pixels"),
+                _("Movement using forces"),
+                "res/actions/forceVers24.png",
+                "res/actions/forceVers.png")
 
       .AddParameter("object", _("Object"))
       .AddParameter("objectPtr", _("Target Object"))
@@ -860,18 +885,20 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("expression", _("Time in seconds"))
       .SetHidden();
 
-  obj.AddCondition("CompareObjectTimer",
-                  _("Value of an object timer"),
-                  _("Compare the elapsed time of an object timer. This condition doesn't start the timer."),
-                  _("The timer _PARAM1_ of _PARAM0_ _PARAM2_ _PARAM3_ seconds"),
-                  _("Timers"),
-                  "res/conditions/timer24.png",
-                  "res/conditions/timer.png")
-    .AddParameter("object", _("Object"))
-    .AddParameter("string", _("Timer's name"))
-    .AddParameter("relationalOperator", _("Sign of the test"), "time")
-    .AddParameter("expression", _("Time in seconds"))
-    .SetManipulatedType("number");
+  obj.AddCondition(
+         "CompareObjectTimer",
+         _("Value of an object timer"),
+         _("Compare the elapsed time of an object timer. This condition "
+           "doesn't start the timer."),
+         _("The timer _PARAM1_ of _PARAM0_ _PARAM2_ _PARAM3_ seconds"),
+         _("Timers"),
+         "res/conditions/timer24.png",
+         "res/conditions/timer.png")
+      .AddParameter("object", _("Object"))
+      .AddParameter("string", _("Timer's name"))
+      .AddParameter("relationalOperator", _("Sign of the test"), "time")
+      .AddParameter("expression", _("Time in seconds"))
+      .SetManipulatedType("number");
 
   obj.AddCondition("ObjectTimerPaused",
                    _("Object timer paused"),
@@ -884,14 +911,15 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("string", _("Timer's name"))
       .MarkAsAdvanced();
 
-  obj.AddAction("ResetObjectTimer",
-                _("Start (or reset) an object timer"),
-                _("Reset the specified object timer, if the timer doesn't exist "
-                  "it's created and started."),
-                _("Reset the timer _PARAM1_ of _PARAM0_"),
-                _("Timers"),
-                "res/actions/timer24.png",
-                "res/actions/timer.png")
+  obj.AddAction(
+         "ResetObjectTimer",
+         _("Start (or reset) an object timer"),
+         _("Reset the specified object timer, if the timer doesn't exist "
+           "it's created and started."),
+         _("Start (or reset) the timer _PARAM1_ of _PARAM0_"),
+         _("Timers"),
+         "res/actions/timer24.png",
+         "res/actions/timer.png")
       .AddParameter("object", _("Object"))
       .AddParameter("string", _("Timer's name"));
 
@@ -1105,7 +1133,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("object", _("Object"))
       .AddParameter("objectPtr", _("Object"));
 
-   obj.AddExpression("XFromAngleAndDistance",
+  obj.AddExpression("XFromAngleAndDistance",
                     _("X position from angle and distance"),
                     _("Compute the X position when given an angle and distance "
                       "relative to the starting object. This is also known as "
@@ -1117,7 +1145,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("expression", _("Angle, in degrees"))
       .AddParameter("expression", _("Distance"));
 
-   obj.AddExpression("YFromAngleAndDistance",
+  obj.AddExpression("YFromAngleAndDistance",
                     _("Y position from angle and distance"),
                     _("Compute the Y position when given an angle and distance "
                       "relative to the starting object. This is also known as "
@@ -1150,13 +1178,14 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("object", _("Object"))
       .AddParameter("objectEffectName", _("Effect name"))
       .AddParameter("yesorno", _("Enable?"))
-      .MarkAsSimple();
+      .MarkAsSimple()
+      .SetRequiresBaseObjectCapability("effect");
 
   obj.AddAction("SetEffectDoubleParameter",
                 _("Effect parameter (number)"),
                 _("Change the value of a parameter of an effect.") + "\n" +
-                  _("You can find the parameter names (and change the effect "
-                    "names) in the effects window."),
+                    _("You can find the parameter names (and change the effect "
+                      "names) in the effects window."),
                 _("Set _PARAM2_ to _PARAM3_ for effect _PARAM1_ of _PARAM0_"),
                 _("Effects"),
                 "res/actions/effect24.png",
@@ -1165,13 +1194,15 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("objectEffectName", _("Effect name"))
       .AddParameter("objectEffectParameterName", _("Parameter name"))
       .AddParameter("expression", _("New value"))
-      .MarkAsSimple();
+      .MarkAsSimple()
+      .SetRequiresBaseObjectCapability("effect");
 
   obj.AddAction("SetEffectStringParameter",
                 _("Effect parameter (string)"),
-                _("Change the value (string) of a parameter of an effect.") + "\n" +
-                  _("You can find the parameter names (and change the effect "
-                    "names) in the effects window."),
+                _("Change the value (string) of a parameter of an effect.") +
+                    "\n" +
+                    _("You can find the parameter names (and change the effect "
+                      "names) in the effects window."),
                 _("Set _PARAM2_ to _PARAM3_ for effect _PARAM1_ of _PARAM0_"),
                 _("Effects"),
                 "res/actions/effect24.png",
@@ -1180,13 +1211,14 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("objectEffectName", _("Effect name"))
       .AddParameter("objectEffectParameterName", _("Parameter name"))
       .AddParameter("string", _("New value"))
-      .MarkAsSimple();
+      .MarkAsSimple()
+      .SetRequiresBaseObjectCapability("effect");
 
   obj.AddAction("SetEffectBooleanParameter",
                 _("Effect parameter (enable or disable)"),
                 _("Enable or disable a parameter of an effect.") + "\n" +
-                  _("You can find the parameter names (and change the effect "
-                    "names) in the effects window."),
+                    _("You can find the parameter names (and change the effect "
+                      "names) in the effects window."),
                 _("Enable _PARAM2_ for effect _PARAM1_ of _PARAM0_: _PARAM3_"),
                 _("Effects"),
                 "res/actions/effect24.png",
@@ -1195,27 +1227,30 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
       .AddParameter("objectEffectName", _("Effect name"))
       .AddParameter("objectEffectParameterName", _("Parameter name"))
       .AddParameter("yesorno", _("Enable?"))
-      .MarkAsSimple();
+      .MarkAsSimple()
+      .SetRequiresBaseObjectCapability("effect");
 
   obj.AddCondition("IsEffectEnabled",
-                  _("Effect is enabled"),
-                  _("Check if the effect on an object is enabled."),
-                  _("Effect _PARAM1_ of _PARAM0_ is enabled"),
-                  _("Effects"),
-                  "res/actions/effect24.png",
-                  "res/actions/effect.png")
+                   _("Effect is enabled"),
+                   _("Check if the effect on an object is enabled."),
+                   _("Effect _PARAM1_ of _PARAM0_ is enabled"),
+                   _("Effects"),
+                   "res/actions/effect24.png",
+                   "res/actions/effect.png")
       .AddParameter("object", _("Object"))
       .AddParameter("objectEffectName", _("Effect name"))
-      .MarkAsSimple();
+      .MarkAsSimple()
+      .SetRequiresBaseObjectCapability("effect");
 
   extension
       .AddAction("Create",
                  _("Create an object"),
                  _("Create an object at specified position"),
-                 _("Create object _PARAM1_ at position _PARAM2_;_PARAM3_ (layer: _PARAM4_)"),
-                 _("Objects"),
+                 _("Create object _PARAM1_ at position _PARAM2_;_PARAM3_ "
+                   "(layer: _PARAM4_)"),
+                 "",
                  "res/actions/create24.png",
-                 "res/actions/create.png")
+                 "res/actions/create24.png")
       .AddCodeOnlyParameter("objectsContext", "")
       .AddParameter("objectListWithoutPicking", _("Object to create"))
       .AddParameter("expression", _("X position"))
@@ -1231,9 +1266,9 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
                    "create the object with the specified name."),
                  _("Among objects _PARAM1_, create object named _PARAM2_ at "
                    "position _PARAM3_;_PARAM4_ (layer: _PARAM5_)"),
-                 _("Objects"),
+                 "",
                  "res/actions/create24.png",
-                 "res/actions/create.png")
+                 "res/actions/create24.png")
       .AddCodeOnlyParameter("objectsContext", "")
       .AddParameter("objectListWithoutPicking", _("Group of potential objects"))
       .SetParameterLongDescription(
@@ -1387,13 +1422,10 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
 
   extension
       .AddCondition(
-          "CollisionNP",  //"CollisionNP" cames from an old condition to test
-                          // collision between two sprites non precisely.
+          "CollisionNP",
           _("Collision"),
           _("Test the collision between two objects using their collision "
-            "masks.\nNote that some objects may not have collision "
-            "masks.\nSome others, like Sprite objects, also provide more "
-            "precise collision conditions."),
+            "masks."),
           _("_PARAM0_ is in collision with _PARAM1_"),
           _("Collision"),
           "res/conditions/collision24.png",
@@ -1437,7 +1469,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
           _("Cast a ray from _PARAM1_;_PARAM2_, angle: _PARAM3_ and max "
             "distance: _PARAM4_px, against _PARAM0_, and save the "
             "result in _PARAM5_, _PARAM6_"),
-          _("Collision"),
+          "",
           "res/conditions/raycast24.png",
           "res/conditions/raycast.png")
       .AddParameter("objectList", _("Objects to test against the ray"))
@@ -1468,7 +1500,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
           _("Cast a ray from from _PARAM1_;_PARAM2_ to _PARAM3_;_PARAM4_ "
             "against _PARAM0_, and save the "
             "result in _PARAM5_, _PARAM6_"),
-          _("Collision"),
+          "",
           "res/conditions/raycast24.png",
           "res/conditions/raycast.png")
       .AddParameter("objectList", _("Objects to test against the ray"))
@@ -1492,21 +1524,21 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsBaseObjectExtension(
                      _("Number of objects"),
                      _("Count the number of the specified objects being "
                        "currently picked in the event"),
-                     _("Objects"),
+                     "",
                      "res/conditions/nbObjet.png")
       .AddParameter("objectList", _("Object"));
 
   obj.AddStrExpression("ObjectName",
                        _("Object name"),
                        _("Return the name of the object"),
-                       _("Objects"),
+                       "",
                        "res/conditions/text.png")
       .AddParameter("object", _("Object"));
 
   obj.AddStrExpression("Layer",
                        _("Object layer"),
                        _("Return the name of the layer the object is on"),
-                       _("Objects"),
+                       "",
                        "res/actions/layer.png")
       .AddParameter("object", _("Object"));
 }

Core/GDCore/Extensions/Builtin/CameraExtension.cpp

@@ -15,7 +15,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
   extension
       .SetExtensionInformation(
           "BuiltinCamera",
-          _("Cameras and layers features"),
+          _("Layers and cameras"),
           "Each scene can be composed of multiple layers. These conditions "
           "and actions allow to manipulate them during the game. In "
           "particular, you can move the camera of a layer to center it on an "
@@ -23,6 +23,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           "Florian Rival",
           "Open source (MIT License)")
       .SetExtensionHelpPath("/interface/scene-editor/layers-and-cameras");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Layers and cameras"))
+      .SetIcon("res/conditions/camera24.png");
 
   extension
       .AddExpressionAndConditionAndAction(
@@ -31,7 +33,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           _("Camera center X position"),
           _("the X position of the center of a camera"),
           _("the X position of camera _PARAM4_ (layer: _PARAM3_)"),
-          _("Layers and cameras"),
+          "",
           "res/conditions/camera24.png")
       .AddCodeOnlyParameter("currentScene", "")
       .UseStandardParameters("number")
@@ -53,7 +55,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           _("Camera center Y position"),
           _("the Y position of the center of a camera"),
           _("the Y position of camera _PARAM4_ (layer: _PARAM3_)"),
-          _("Layers and cameras"),
+          "",
           "res/conditions/camera24.png")
       .AddCodeOnlyParameter("currentScene", "")
       .UseStandardParameters("number")
@@ -75,7 +77,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           _("Width of a camera"),
           _("the width of a camera of a layer"),
           _("the width of camera _PARAM2_ of layer _PARAM1_"),
-          _("Layers and cameras"),
+          "",
           "res/conditions/camera24.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("layer", _("Layer (base layer if empty)"))
@@ -91,7 +93,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           _("Height of a camera"),
           _("the height of a camera of a layer"),
           _("the height of camera _PARAM2_ of layer _PARAM1_"),
-          _("Layers and cameras"),
+          "",
           "res/conditions/camera24.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("layer", _("Layer (base layer if empty)"))
@@ -107,7 +109,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           _("Angle of a camera of a layer"),
           _("the angle of rotation of a camera"),
           _("the angle of camera (layer: _PARAM3_, camera: _PARAM4_)"),
-          _("Layers and cameras"),
+          "",
           "res/conditions/camera24.png")
       .AddCodeOnlyParameter("currentScene", "")
       .UseStandardParameters("number")
@@ -127,7 +129,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                  _("Add a camera to a layer"),
                  _("This action adds a camera to a layer"),
                  _("Add a camera to layer _PARAM1_"),
-                 _("Layers and cameras"),
+                 "",
                  "res/actions/camera24.png",
                  "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -162,7 +164,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                  _("Delete a camera of a layer"),
                  _("Remove the specified camera from a layer"),
                  _("Delete camera _PARAM2_ from layer _PARAM1_"),
-                 _("Layers and cameras"),
+                 "",
                  "res/actions/camera24.png",
                  "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -178,7 +180,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                    "layer. The zoom will be reset."),
                  _("Change the size of camera _PARAM2_ of _PARAM1_ to "
                    "_PARAM3_*_PARAM4_"),
-                 _("Layers and cameras"),
+                 "",
                  "res/actions/camera24.png",
                  "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -196,7 +198,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                    "specified layer."),
                  _("Set the render zone of camera _PARAM2_ from layer _PARAM1_ "
                    "to _PARAM3_;_PARAM4_ _PARAM5_;_PARAM6_"),
-                 _("Layers and cameras"),
+                 "",
                  "res/actions/camera24.png",
                  "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -223,7 +225,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                  _("Change camera zoom."),
                  _("Change camera zoom to _PARAM1_ (layer: _PARAM2_, camera: "
                    "_PARAM3_)"),
-                 _("Layers and cameras"),
+                 "",
                  "res/actions/camera24.png",
                  "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -242,7 +244,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
             "specified limits."),
           _("Center the camera on _PARAM1_ (limit : from _PARAM2_;_PARAM3_ to "
             "_PARAM4_;_PARAM5_) (layer: _PARAM7_, camera: _PARAM8_)"),
-          _("Layers and cameras"),
+          "",
           "res/actions/camera24.png",
           "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -272,7 +274,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           _("Center the camera on an object"),
           _("Center the camera on the specified object."),
           _("Center camera on _PARAM1_ (layer: _PARAM3_, camera: _PARAM4_)"),
-          _("Layers and cameras"),
+          "",
           "res/actions/camera24.png",
           "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -293,7 +295,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                  _("Show a layer"),
                  _("Show a layer."),
                  _("Show layer _PARAM1_"),
-                 _("Layers and cameras"),
+                 "",
                  "res/actions/layer24.png",
                  "res/actions/layer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -306,7 +308,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                  _("Hide a layer"),
                  _("Hide a layer."),
                  _("Hide layer _PARAM1_"),
-                 _("Layers and cameras"),
+                 "",
                  "res/actions/layer24.png",
                  "res/actions/layer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -319,7 +321,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                     _("Visibility of a layer"),
                     _("Test if a layer is set as visible."),
                     _("Layer _PARAM1_ is visible"),
-                    _("Layers and cameras"),
+                    "",
                     "res/conditions/layer24.png",
                     "res/conditions/layer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -335,7 +337,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
               _("You can find the parameter names (and change the effect "
                 "names) in the effects window."),
           _("Set _PARAM3_ to _PARAM4_ for effect _PARAM2_ of layer _PARAM1_"),
-          _("Layers and cameras/Effects"),
+          _("Effects"),
           "res/conditions/camera24.png",
           "res/conditions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -354,7 +356,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
               _("You can find the parameter names (and change the effect "
                 "names) in the effects window."),
           _("Set _PARAM3_ to _PARAM4_ for effect _PARAM2_ of layer _PARAM1_"),
-          _("Layers and cameras/Effects"),
+          _("Effects"),
           "res/conditions/camera24.png",
           "res/conditions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -373,7 +375,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
               _("You can find the parameter names (and change the effect "
                 "names) in the effects window."),
           _("Enable _PARAM3_ for effect _PARAM2_ of layer _PARAM1_: _PARAM4_"),
-          _("Layers and cameras/Effects"),
+          _("Effects"),
           "res/conditions/camera24.png",
           "res/conditions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -389,7 +391,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                     _("Layer effect is enabled"),
                     _("The effect on a layer is enabled"),
                     _("Effect _PARAM2_ on layer _PARAM1_ is enabled"),
-                    _("Layers and cameras/Effects"),
+                    _("Effects"),
                     "res/conditions/camera24.png",
                     "res/conditions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -403,7 +405,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                  _("Enable layer effect"),
                  _("Enable an effect on a layer"),
                  _("Enable effect _PARAM2_ on layer _PARAM1_: _PARAM3_"),
-                 _("Layers and cameras/Effects"),
+                 _("Effects"),
                  "res/conditions/camera24.png",
                  "res/conditions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -419,7 +421,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           _("Layer time scale"),
           _("Compare the time scale applied to the objects of the layer."),
           _("the time scale of layer _PARAM1_"),
-          _("Layers and cameras"),
+          "",
           "res/conditions/time24.png",
           "res/conditions/time.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -434,7 +436,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           _("Change layer time scale"),
           _("Change the time scale applied to the objects of the layer."),
           _("Set the time scale of layer _PARAM1_ to _PARAM2_"),
-          _("Layers and cameras"),
+          "",
           "res/actions/time24.png",
           "res/actions/time.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -449,7 +451,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                     _("Compare the default Z order set to objects when they "
                       "are created on a layer."),
                     _("the default Z order of objects created on _PARAM1_"),
-                    _("Layers and cameras"),
+                    "",
                     "res/conditions/layer24.png",
                     "res/conditions/layer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -465,7 +467,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
                    "created on a layer."),
                  _("Set the default Z order of objects created on _PARAM1_ to "
                    "_PARAM2_"),
-                 _("Layers and cameras"),
+                 "",
                  "res/actions/layer24.png",
                  "res/actions/layer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -480,7 +482,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           _("Set the ambient light color of the lighting layer in format "
             "\"R;G;B\" string."),
           _("Set the ambient color of the lighting layer _PARAM1_ to _PARAM2_"),
-          _("Layers and cameras/Lighting"),
+          _("Lighting"),
           "res/actions/color24.png",
           "res/actions/color.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -494,7 +496,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           "CameraViewportLeft",
           _("X position of the top left side point of a render zone"),
           _("X position of the top left side point of a render zone"),
-          _("Layers and cameras"),
+          "",
           "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("layer", _("Layer"))
@@ -506,7 +508,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           "CameraViewportTop",
           _("Y position of the top left side point of a render zone"),
           _("Y position of the top left side point of a render zone"),
-          _("Layers and cameras"),
+          "",
           "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("layer", _("Layer"))
@@ -518,7 +520,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           "CameraViewportRight",
           _("X position of the bottom right side point of a render zone"),
           _("X position of the bottom right side point of a render zone"),
-          _("Layers and cameras"),
+          "",
           "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("layer", _("Layer"))
@@ -530,7 +532,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
           "CameraViewportBottom",
           _("Y position of the bottom right side point of a render zone"),
           _("Y position of the bottom right side point of a render zone"),
-          _("Layers and cameras"),
+          "",
           "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("layer", _("Layer"))
@@ -541,7 +543,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
       .AddExpression("CameraZoom",
                      _("Zoom of a camera of a layer"),
                      _("Zoom of a camera of a layer"),
-                     _("Layers and cameras"),
+                     "",
                      "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("layer", _("Layer"), "", true)
@@ -553,7 +555,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
       .AddExpression("LayerTimeScale",
                      _("Layer time scale"),
                      _("Returns the time scale of the specified layer."),
-                     _("Layers and cameras"),
+                     "",
                      "res/actions/time.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("layer", _("Layer"));
@@ -562,7 +564,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsCameraExtension(
       .AddExpression("LayerDefaultZOrder",
                      _("Default Z Order for a layer"),
                      _("Default Z Order for a layer"),
-                     _("Layers and cameras"),
+                     "",
                      "res/actions/camera.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("layer", _("Layer"));

Core/GDCore/Extensions/Builtin/CommonConversionsExtension.cpp

@@ -15,18 +15,19 @@ BuiltinExtensionsImplementer::ImplementsCommonConversionsExtension(
   extension
       .SetExtensionInformation(
           "BuiltinCommonConversions",
-          _("Standard Conversions"),
+          _("Conversion"),
           "Expressions to convert number, texts and quantities.",
           "Florian Rival",
           "Open source (MIT License)")
       .SetExtensionHelpPath("/all-features/common-conversions");
-
+  extension.AddInstructionOrExpressionGroupMetadata(_("Conversion"))
+      .SetIcon("res/conditions/toujours24.png");
 
   extension
       .AddExpression("ToNumber",
                      _("Text > Number"),
                      _("Convert the text to a number"),
-                     _("Conversion"),
+                     "",
                      "res/conditions/toujours24.png")
       .AddParameter("string", _("Text to convert to a number"));
 
@@ -34,7 +35,7 @@ BuiltinExtensionsImplementer::ImplementsCommonConversionsExtension(
       .AddStrExpression("ToString",
                         _("Number > Text"),
                         _("Convert the result of the expression to text"),
-                        _("Conversion"),
+                        "",
                         "res/conditions/toujours24.png")
       .AddParameter("expression", _("Expression to be converted to text"));
 
@@ -43,7 +44,7 @@ BuiltinExtensionsImplementer::ImplementsCommonConversionsExtension(
                         _("Number > Text ( without scientific notation )"),
                         _("Convert the result of the expression to text, "
                           "without using the scientific notation"),
-                        _("Conversion"),
+                        "",
                         "res/conditions/toujours24.png")
       .AddParameter("expression", _("Expression to be converted to text"));
 
@@ -52,7 +53,7 @@ BuiltinExtensionsImplementer::ImplementsCommonConversionsExtension(
           "ToRad",
           _("Degrees > Radians"),
           _("Converts the angle, expressed in degrees, into radians"),
-          _("Conversion"),
+          "",
           "res/conditions/toujours24.png")
       .AddParameter("expression", _("Angle, in degrees"));
 
@@ -61,9 +62,76 @@ BuiltinExtensionsImplementer::ImplementsCommonConversionsExtension(
           "ToDeg",
           _("Radians > Degrees"),
           _("Converts the angle, expressed in radians, into degrees"),
-          _("Conversion"),
+          "",
           "res/conditions/toujours24.png")
       .AddParameter("expression", _("Angle, in radians"));
+
+  extension
+      .AddStrExpression("ToJSON",
+                        _("Convert scene variable to JSON"),
+                        _("Convert a scene variable to JSON"),
+                        _("JSON"),
+                        "res/conditions/toujours24.png")
+      .AddParameter("scenevar", _("Scene variable to be stringified"));
+
+  extension
+      .AddStrExpression("GlobalVarToJSON",
+                        _("Convert global variable to JSON"),
+                        _("Convert a global variable to JSON"),
+                        _("JSON"),
+                        "res/conditions/toujours24.png")
+      .AddParameter("globalvar", _("The global variable to be stringified"));
+
+  extension
+      .AddStrExpression("ObjectVarToJSON",
+                        _("Convert object variable to JSON"),
+                        _("Convert an object variable to JSON"),
+                        _("JSON"),
+                        "res/conditions/toujours24.png")
+      .AddParameter("objectPtr", _("The object with the variable"))
+      .AddParameter("objectvar", _("The object variable to be stringified"));
+
+  extension
+      .AddAction(
+          "JSONToVariableStructure",
+          _("Convert JSON to a scene variable"),
+          _("Parse a JSON object and store it into a scene variable"),
+          _("Parse JSON string _PARAM0_ and store it into variable _PARAM1_"),
+          "",
+          "res/actions/net24.png",
+          "res/actions/net.png")
+      .AddParameter("string", _("JSON string"))
+      .AddParameter("scenevar", _("Variable where store the JSON object"))
+      .MarkAsAdvanced();
+
+  extension
+      .AddAction("JSONToGlobalVariableStructure",
+                 _("Convert JSON to global variable"),
+                 _("Parse a JSON object and store it into a global variable"),
+                 _("Parse JSON string _PARAM0_ and store it into global "
+                   "variable _PARAM1_"),
+                 "",
+                 "res/actions/net24.png",
+                 "res/actions/net.png")
+      .AddParameter("string", _("JSON string"))
+      .AddParameter("globalvar",
+                    _("Global variable where store the JSON object"))
+      .MarkAsAdvanced();
+
+  extension
+      .AddAction("JSONToObjectVariableStructure",
+                 _("Convert JSON to object variable"),
+                 _("Parse a JSON object and store it into an object variable"),
+                 _("Parse JSON string _PARAM0_ and store it into variable "
+                   "_PARAM2_ of _PARAM1_"),
+                 "",
+                 "res/actions/net24.png",
+                 "res/actions/net.png")
+      .AddParameter("string", _("JSON string"))
+      .AddParameter("objectPtr", _("Object"))
+      .AddParameter("objectvar",
+                    _("Object variable where store the JSON object"))
+      .MarkAsAdvanced();
 }
 
 }  // namespace gd

Core/GDCore/Extensions/Builtin/CommonInstructionsExtension.cpp

@@ -4,7 +4,6 @@
  * reserved. This project is released under the MIT License.
  */
 #include "AllBuiltinExtensions.h"
-#include "GDCore/Tools/Localization.h"
 #include "GDCore/Events/Builtin/CommentEvent.h"
 #include "GDCore/Events/Builtin/ForEachChildVariableEvent.h"
 #include "GDCore/Events/Builtin/ForEachEvent.h"
@@ -14,6 +13,7 @@
 #include "GDCore/Events/Builtin/StandardEvent.h"
 #include "GDCore/Events/Builtin/WhileEvent.h"
 #include "GDCore/Events/Event.h"
+#include "GDCore/Tools/Localization.h"
 
 using namespace std;
 namespace gd {
@@ -24,19 +24,43 @@ BuiltinExtensionsImplementer::ImplementsCommonInstructionsExtension(
   extension
       .SetExtensionInformation(
           "BuiltinCommonInstructions",
-          _("Builtin events"),
+          _("Events and control flow"),
           "GDevelop comes with a set of events and conditions that allow to "
           "express the game logic and rules.",
           "Florian Rival",
           "Open source (MIT License)")
+      .SetCategory("Advanced")
       .SetExtensionHelpPath("/all-features/advanced-conditions");
+  extension
+      .AddInstructionOrExpressionGroupMetadata(_("Events and control flow"))
+      .SetIcon("res/conditions/toujours24.png");
+
+  extension
+      .AddCondition("Always",
+                    _("Always"),
+                    _("This condition always returns true (or always false, if "
+                      "the condition is inverted)."),
+                    _("Always"),
+                    "",
+                    "res/conditions/toujours24.png",
+                    "res/conditions/toujours.png")
+      .SetHelpPath("/all-features/advanced-conditions")
+      .AddCodeOnlyParameter("conditionInverted", "")
+      .MarkAsAdvanced();
+
+  // Compatibility with GD <= 5.0.127
+  extension
+      .AddDuplicatedCondition(
+          "Toujours", "BuiltinCommonInstructions::Always", {.unscoped = true})
+      .SetHidden();
+  // end of compatibility code
 
   extension
       .AddCondition("Or",
                     _("Or"),
                     _("Check if one of the sub conditions is true"),
                     _("If one of these conditions is true:"),
-                    _("Advanced"),
+                    "",
                     "res/conditions/or24.png",
                     "res/conditions/or.png")
       .SetCanHaveSubInstructions()
@@ -47,7 +71,7 @@ BuiltinExtensionsImplementer::ImplementsCommonInstructionsExtension(
                     _("And"),
                     _("Check if all sub conditions are true"),
                     _("If all of these conditions are true:"),
-                    _("Advanced"),
+                    "",
                     "res/conditions/and24.png",
                     "res/conditions/and.png")
       .SetCanHaveSubInstructions()
@@ -59,7 +83,7 @@ BuiltinExtensionsImplementer::ImplementsCommonInstructionsExtension(
           _("Not"),
           _("Return the contrary of the result of the sub conditions"),
           _("Invert the logical result of these conditions:"),
-          _("Advanced"),
+          "",
           "res/conditions/not24.png",
           "res/conditions/not.png")
       .SetCanHaveSubInstructions()
@@ -70,10 +94,52 @@ BuiltinExtensionsImplementer::ImplementsCommonInstructionsExtension(
       _("Trigger once while true"),
       _("Run actions only once, for each time the conditions have been met."),
       _("Trigger once"),
-      _("Advanced"),
+      "",
       "res/conditions/once24.png",
       "res/conditions/once.png");
 
+  extension
+      .AddCondition("CompareNumbers",
+                    _("Compare two numbers"),
+                    _("Compare the two numbers."),
+                    _("_PARAM0_ _PARAM1_ _PARAM2_"),
+                    "",
+                    "res/conditions/egal24.png",
+                    "res/conditions/egal.png")
+      .SetHelpPath("/all-features/advanced-conditions")
+      .AddParameter("expression", _("First expression"))
+      .AddParameter("relationalOperator", _("Sign of the test"), "number")
+      .AddParameter("expression", _("Second expression"))
+      .MarkAsAdvanced();
+
+  // Compatibility with GD <= 5.0.127
+  extension
+      .AddDuplicatedCondition(
+          "Egal", "BuiltinCommonInstructions::CompareNumbers", {.unscoped = true})
+      .SetHidden();
+  // end of compatibility code
+
+  extension
+      .AddCondition("CompareStrings",
+                    _("Compare two strings"),
+                    _("Compare the two strings."),
+                    _("_PARAM0_ _PARAM1_ _PARAM2_"),
+                    "",
+                    "res/conditions/egal24.png",
+                    "res/conditions/egal.png")
+      .SetHelpPath("/all-features/advanced-conditions")
+      .AddParameter("string", _("First string expression"))
+      .AddParameter("relationalOperator", _("Sign of the test"), "string")
+      .AddParameter("string", _("Second string expression"))
+      .MarkAsAdvanced();
+
+  // Compatibility with GD <= 5.0.127
+  extension
+      .AddDuplicatedCondition(
+          "StrEqual", "BuiltinCommonInstructions::CompareStrings", {.unscoped = true})
+      .SetHidden();
+  // end of compatibility code
+
   extension.AddEvent(
       "Standard",
       _("Standard event"),

Core/GDCore/Extensions/Builtin/ExternalLayoutsExtension.cpp

@@ -19,16 +19,19 @@ BuiltinExtensionsImplementer::ImplementsExternalLayoutsExtension(
                                "external layouts.",
                                "Florian Rival",
                                "Open source (MIT License)")
-      .SetExtensionHelpPath("/interface/scene-editor/external-layouts");
+      .SetExtensionHelpPath("/interface/scene-editor/external-layouts")
+      .SetCategory("Advanced");
+  extension.AddInstructionOrExpressionGroupMetadata(_("External layouts"))
+      .SetIcon("res/ribbon_default/externallayout32.png");
 
   extension
       .AddAction("CreateObjectsFromExternalLayout",
                  _("Create objects from an external layout"),
                  _("Create objects from an external layout."),
                  _("Create objects from the external layout named _PARAM1_"),
-                 _("External layouts"),
-                 "res/conditions/fichier24.png",
-                 "res/conditions/fichier.png")
+                 "",
+                 "res/ribbon_default/externallayout32.png",
+                 "res/ribbon_default/externallayout32.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Name of the external layout"))
       .AddParameter("expression", _("X position of the origin"), "", true)

Core/GDCore/Extensions/Builtin/FileExtension.cpp

@@ -20,7 +20,10 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
           "stored on the device and erased when the game is uninstalled.",
           "Florian Rival",
           "Open source (MIT License)")
-      .SetExtensionHelpPath("/all-features/storage");
+      .SetExtensionHelpPath("/all-features/storage")
+      .SetCategory("Device");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Storage"))
+      .SetIcon("res/conditions/fichier24.png");
 
   extension
       .AddCondition(
@@ -29,7 +32,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
           _("Check if an element (example : PlayerState/CurrentLevel) exists "
             "in the stored data.\nSpaces are forbidden in element names."),
           _("_PARAM1_ exists in storage _PARAM0_"),
-          _("Storage"),
+          "",
           "res/conditions/fichier24.png",
           "res/conditions/fichier.png")
       .AddParameter("string", _("Storage name"))
@@ -45,7 +48,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
             "action, but it will be slower.\nIf you use this action, do not "
             "forget to unload the storage from memory."),
           _("Load storage _PARAM0_ in memory"),
-          _("Storage"),
+          "",
           "res/actions/fichier24.png",
           "res/actions/fichier.png")
       .AddParameter("string", _("Storage name"))
@@ -57,7 +60,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
                  _("This action closes the structured data previously loaded "
                    "in memory, saving all changes made."),
                  _("Close structured data _PARAM0_"),
-                 _("Storage"),
+                 "",
                  "res/actions/fichier24.png",
                  "res/actions/fichier.png")
       .AddParameter("string", _("Storage name"))
@@ -72,7 +75,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
             "element using / (example : Root/Level/Current)\nSpaces are "
             "forbidden in element names."),
           _("Write _PARAM2_ in _PARAM1_ of storage _PARAM0_"),
-          _("Storage"),
+          "",
           "res/actions/fichier24.png",
           "res/actions/fichier.png")
       .AddParameter("string", _("Storage name"))
@@ -88,7 +91,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
             "the structure leading to the element using / (example : "
             "Root/Level/Current)\nSpaces are forbidden in element names."),
           _("Write _PARAM2_ in _PARAM1_ of storage _PARAM0_"),
-          _("Storage"),
+          "",
           "res/actions/fichier24.png",
           "res/actions/fichier.png")
       .AddParameter("string", _("Storage name"))
@@ -105,7 +108,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
             "(example : Root/Level/Current)\nSpaces are forbidden in element "
             "names."),
           _("Read _PARAM1_ from storage _PARAM0_ and store value in _PARAM3_"),
-          _("Storage"),
+          "",
           "res/actions/fichier24.png",
           "res/actions/fichier.png")
       .AddParameter("string", _("Storage name"))
@@ -124,7 +127,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
             "names."),
           _("Read _PARAM1_ from storage _PARAM0_ and store as text in "
             "_PARAM3_"),
-          _("Storage"),
+          "",
           "res/actions/fichier24.png",
           "res/actions/fichier.png")
       .AddParameter("string", _("Storage name"))
@@ -140,7 +143,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
                    "element using / (example : Root/Level/Current)\nSpaces are "
                    "forbidden in element names."),
                  _("Delete _PARAM1_ from storage _PARAM0_"),
-                 _("Storage"),
+                 "",
                  "res/actions/delete24.png",
                  "res/actions/delete.png")
       .AddParameter("string", _("Storage name"))
@@ -153,7 +156,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
           _("Clear a storage"),
           _("Clear the specified storage, removing all data saved in it."),
           _("Delete storage _PARAM0_"),
-          _("Storage"),
+          "",
           "res/actions/delete24.png",
           "res/actions/delete.png")
       .AddParameter("string", _("Storage name"));
@@ -163,32 +166,18 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsFileExtension(
                     _("A storage exists"),
                     _("Test if the specified storage exists."),
                     _("Storage _PARAM0_ exists"),
-                    _("Storage"),
+                    "",
                     "res/conditions/fichier24.png",
                     "res/conditions/fichier.png")
       .AddParameter("string", _("Storage name"))
       .MarkAsAdvanced();
 
-  extension
-      .AddAction("LaunchFile",
-                 _("Open a URL or a file"),
-                 _("This action launches the specified file or URL, in a "
-                   "browser (or in a new tab if the game is using the Web "
-                   "platform and is launched inside a browser)."),
-                 _("Open URL (or file) _PARAM0_"),
-                 _("Files"),
-                 "res/actions/launchFile24.png",
-                 "res/actions/launchFile.png")
-      .AddParameter("string", _("URL (or filename)"))
-      .AddCodeOnlyParameter("currentScene", "")
-      .MarkAsAdvanced();
-
   extension
       .AddAction("ExecuteCmd",
                  _("Execute a command"),
                  _("This action executes the specified command."),
                  _("Execute _PARAM0_"),
-                 _("Files"),
+                 _("Network"),
                  "res/actions/launchFile24.png",
                  "res/actions/launchFile.png")
       .AddParameter("string", _("Command"))

Core/GDCore/Extensions/Builtin/KeyboardExtension.cpp

@@ -14,21 +14,24 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsKeyboardExtension(
   extension
       .SetExtensionInformation(
           "BuiltinKeyboard",
-          _("Keyboard features"),
+          _("Keyboard"),
           _("Allows your game to respond to keyboard input. Note that this "
             "does not work with on-screen keyboard on touch devices: use "
             "instead conditions related to touch when making a game for "
             "mobile/touchscreen devices."),
           "Florian Rival",
           "Open source (MIT License)")
-      .SetExtensionHelpPath("/all-features/keyboard");
+      .SetExtensionHelpPath("/all-features/keyboard")
+      .SetCategory("Input");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Keyboard"))
+      .SetIcon("res/conditions/keyboard24.png");
 
   extension
       .AddCondition("KeyPressed",
                     _("Key pressed"),
                     _("Check if a key is pressed"),
                     _("_PARAM1_ key is pressed"),
-                    _("Keyboard"),
+                    "",
                     "res/conditions/keyboard24.png",
                     "res/conditions/keyboard.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -39,7 +42,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsKeyboardExtension(
                     _("Key released"),
                     _("Check if a key was just released"),
                     _("_PARAM1_ key is released"),
-                    _("Keyboard"),
+                    "",
                     "res/conditions/keyboard24.png",
                     "res/conditions/keyboard.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -51,7 +54,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsKeyboardExtension(
                     _("Check if a key, retrieved from the result of the "
                       "expression, is pressed"),
                     _("_PARAM1_ key is pressed"),
-                    _("Keyboard"),
+                    "",
                     "res/conditions/keyboard24.png",
                     "res/conditions/keyboard.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -64,7 +67,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsKeyboardExtension(
                     _("Check if a key, retrieved from the result of the "
                       "expression, was just released"),
                     _("_PARAM1_ key is released"),
-                    _("Keyboard"),
+                    "",
                     "res/conditions/keyboard24.png",
                     "res/conditions/keyboard.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -76,7 +79,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsKeyboardExtension(
                     _("Any key pressed"),
                     _("Check if any key is pressed"),
                     _("Any key is pressed"),
-                    _("Keyboard"),
+                    "",
                     "res/conditions/keyboard24.png",
                     "res/conditions/keyboard.png")
       .AddCodeOnlyParameter("currentScene", "");
@@ -86,7 +89,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsKeyboardExtension(
                     _("Any key released"),
                     _("Check if any key is released"),
                     _("Any key is released"),
-                    _("Keyboard"),
+                    "",
                     "res/conditions/keyboard24.png",
                     "res/conditions/keyboard.png")
       .AddCodeOnlyParameter("currentScene", "");
@@ -96,7 +99,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsKeyboardExtension(
           "LastPressedKey",
           _("Last pressed key"),
           _("Get the name of the latest key pressed on the keyboard"),
-          _("Keyboard"),
+          "",
           "res/conditions/keyboard.png")
       .AddCodeOnlyParameter("currentScene", "");
 }

Core/GDCore/Extensions/Builtin/MathematicalToolsExtension.cpp

@@ -18,13 +18,63 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       "A set of mathematical functions that can be used in expressions.",
       "Florian Rival",
       "Open source (MIT License)");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Mathematical tools"))
+      .SetIcon("res/mathfunction.png");
 
+  extension
+      .AddExpression("Random",
+                     _("Random integer"),
+                     _("Random integer"),
+                     "",
+                     "res/dice-6.svg")
+      .SetHelpPath("/all-features/expressions")
+      .AddParameter("expression", _("Maximum value"));
+
+  extension
+      .AddExpression("RandomInRange",
+                     _("Random integer in range"),
+                     _("Random integer in range"),
+                     "",
+                     "res/dice-6.svg")
+      .SetHelpPath("/all-features/expressions")
+      .AddParameter("expression", _("Minimum value"))
+      .AddParameter("expression", _("Maximum value"));
+
+  extension
+      .AddExpression("RandomFloat",
+                     _("Random float"),
+                     _("Random float"),
+                     "",
+                     "res/dice-6.svg")
+      .SetHelpPath("/all-features/expressions")
+      .AddParameter("expression", _("Maximum value"));
+
+  extension
+      .AddExpression("RandomFloatInRange",
+                     _("Random float in range"),
+                     _("Random float in range"),
+                     "",
+                     "res/dice-6.svg")
+      .SetHelpPath("/all-features/expressions")
+      .AddParameter("expression", _("Minimum value"))
+      .AddParameter("expression", _("Maximum value"));
+
+  extension
+      .AddExpression("RandomWithStep",
+                     _("Random value in steps"),
+                     _("Random value in steps"),
+                     "",
+                     "res/dice-6.svg")
+      .SetHelpPath("/all-features/expressions")
+      .AddParameter("expression", _("Minimum value"))
+      .AddParameter("expression", _("Maximum value"))
+      .AddParameter("expression", _("Step"));
 
   extension
       .AddExpression("normalize",
                      _("Normalize a value between `min` and `max` to a value between 0 and 1."),
                      _("Remap a value between 0 and 1."),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Value"))
       .AddParameter("expression", _("Min"))
@@ -34,7 +84,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("clamp",
                      _("Clamp (restrict a value to a given range)"),
                      _("Restrict a value to a given range"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Value"))
       .AddParameter("expression", _("Min"))
@@ -44,7 +94,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("AngleDifference",
                      _("Difference between two angles"),
                      _("Difference between two angles"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("First angle"))
       .AddParameter("expression", _("Second angle"));
@@ -53,7 +103,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("AngleBetweenPositions",
                      _("Angle between two positions"),
                      _("Compute the angle between two positions."),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("First point X position"))
       .AddParameter("expression", _("First point Y position"))
@@ -64,7 +114,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("DistanceBetweenPositions",
                      _("Distance between two positions"),
                      _("Compute the distance between two positions."),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("First point X position"))
       .AddParameter("expression", _("First point Y position"))
@@ -75,7 +125,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("mod",
                      _("Modulo"),
                      _("x mod y"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("x (as in x mod y)"))
       .AddParameter("expression", _("y (as in x mod y)"));
@@ -84,7 +134,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("min",
                      _("Minimum of two numbers"),
                      _("Minimum of two numbers"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("First expression"))
       .AddParameter("expression", _("Second expression"));
@@ -93,7 +143,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("max",
                      _("Maximum of two numbers"),
                      _("Maximum of two numbers"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("First expression"))
       .AddParameter("expression", _("Second expression"));
@@ -102,7 +152,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("abs",
                      _("Absolute value"),
                      _("Absolute value"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -110,7 +160,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("acos",
                      _("Arccosine"),
                      _("Arccosine"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -118,7 +168,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("acosh",
                      _("Hyperbolic arccosine"),
                      _("Hyperbolic arccosine"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -126,7 +176,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("asin",
                      _("Arcsine"),
                      _("Arcsine"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -134,7 +184,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("asinh",
                      _("Arcsine"),
                      _("Arcsine"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -142,7 +192,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("atan",
                      _("Arctangent"),
                      _("Arctangent"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -150,7 +200,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("atan2",
                      _("2 argument arctangent"),
                      _("2 argument arctangent (atan2)"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Y"))
       .AddParameter("expression", _("X"));
@@ -159,7 +209,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("atanh",
                      _("Hyperbolic arctangent"),
                      _("Hyperbolic arctangent"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -167,7 +217,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("cbrt",
                      _("Cube root"),
                      _("Cube root"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -175,7 +225,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("ceil",
                      _("Ceil (round up)"),
                      _("Round number up to an integer"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -183,7 +233,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("floor",
                      _("Floor (round down)"),
                      _("Round number down to an integer"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -191,7 +241,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("cos",
                      _("Cosine"),
                      _("Cosine of a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -199,7 +249,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("cosh",
                      _("Hyperbolic cosine"),
                      _("Hyperbolic cosine"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -207,7 +257,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("cot",
                      _("Cotangent"),
                      _("Cotangent of a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -215,7 +265,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("csc",
                      _("Cosecant"),
                      _("Cosecant of a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -223,7 +273,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("int",
                      _("Round"),
                      _("Round a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .SetHidden()
       .AddParameter("expression", _("Expression"));
@@ -232,7 +282,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("rint",
                      _("Round"),
                      _("Round a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .SetHidden()
       .AddParameter("expression", _("Expression"));
@@ -241,7 +291,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("round",
                      _("Round"),
                      _("Round a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -249,7 +299,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("exp",
                      _("Exponential"),
                      _("Exponential of a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -257,7 +307,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("log",
                      _("Logarithm"),
                      _("Logarithm"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -265,7 +315,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("ln",
                      _("Logarithm"),
                      _("Logarithm"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .SetHidden()
       .AddParameter("expression", _("Expression"));
@@ -274,7 +324,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("log2",
                      _("Base-2 logarithm"),
                      _("Base 2 Logarithm"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -282,7 +332,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("log10",
                      _("Base-10 logarithm"),
                      _("Base-10 logarithm"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -290,7 +340,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("nthroot",
                      _("Nth root"),
                      _("Nth root of a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Number"))
       .AddParameter("expression", _("N"));
@@ -299,7 +349,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("pow",
                      _("Power"),
                      _("Raise a number to power n"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Number"))
       .AddParameter("expression", _("The exponent (n in x^n)"));
@@ -308,7 +358,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("sec",
                      _("Secant"),
                      _("Secant"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -316,7 +366,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("sign",
                      _("Sign of a number"),
                      _("Return the sign of a number (1,-1 or 0)"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -324,7 +374,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("sin",
                      _("Sine"),
                      _("Sine of a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -332,7 +382,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("sinh",
                      _("Hyperbolic sine"),
                      _("Hyperbolic sine"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -340,7 +390,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("sqrt",
                      _("Square root"),
                      _("Square root of a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -348,7 +398,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("tan",
                      _("Tangent"),
                      _("Tangent of a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -356,7 +406,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("tanh",
                      _("Hyperbolic tangent"),
                      _("Hyperbolic tangent"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -364,7 +414,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("trunc",
                      _("Truncation"),
                      _("Truncate a number"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Expression"));
 
@@ -372,7 +422,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
       .AddExpression("lerp",
                      _("Lerp (Linear interpolation)"),
                      _("Linearly interpolate a to b by x"),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("a (in a+(b-a)*x)"))
       .AddParameter("expression", _("b (in a+(b-a)*x)"))
@@ -385,7 +435,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
                       "relative to the origin (0;0). This is also known as "
                       "getting the cartesian coordinates of a 2D vector, using "
                       "its polar coordinates."),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Angle, in degrees"))
       .AddParameter("expression", _("Distance"));
@@ -397,7 +447,7 @@ BuiltinExtensionsImplementer::ImplementsMathematicalToolsExtension(
                       "relative to the origin (0;0). This is also known as "
                       "getting the cartesian coordinates of a 2D vector, using "
                       "its polar coordinates."),
-                     _("Mathematical tools"),
+                     "",
                      "res/mathfunction.png")
       .AddParameter("expression", _("Angle, in degrees"))
       .AddParameter("expression", _("Distance"));

Core/GDCore/Extensions/Builtin/MouseExtension.cpp

@@ -23,7 +23,10 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
           "separately in different events.",
           "Florian Rival",
           "Open source (MIT License)")
-      .SetExtensionHelpPath("/all-features/mouse-touch");
+      .SetExtensionHelpPath("/all-features/mouse-touch")
+      .SetCategory("Input");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Mouse and touch"))
+      .SetIcon("res/actions/mouse24.png");
 
   extension
       .AddCondition(
@@ -32,7 +35,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
           _("Check if the mouse wheel is scrolling up. Use MouseWheelDelta "
             "expression if you want to know the amount that was scrolled."),
           _("The mouse wheel is scrolling up"),
-          _("Mouse and touch"),
+          "",
           "res/actions/mouse24.png",
           "res/actions/mouse.png")
 
@@ -46,7 +49,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
           _("Check if the mouse wheel is scrolling down. Use MouseWheelDelta "
             "expression if you want to know the amount that was scrolled."),
           _("The mouse wheel is scrolling down"),
-          _("Mouse and touch"),
+          "",
           "res/actions/mouse24.png",
           "res/actions/mouse.png")
 
@@ -64,7 +67,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
             "touchscreens. If you want to have multitouch and differentiate "
             "mouse movement and touches, just deactivate it with this action."),
           _("Move mouse cursor when touching screen: _PARAM1_"),
-          _("Mouse and touch"),
+          "",
           "res/conditions/touch24.png",
           "res/conditions/touch.png")
 
@@ -79,7 +82,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                  _("Center cursor horizontally"),
                  _("Put the cursor in the middle of the screen horizontally."),
                  _("Center cursor horizontally"),
-                 _("Mouse and touch"),
+                 "",
                  "res/actions/mouse24.png",
                  "res/actions/mouse.png")
 
@@ -91,7 +94,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                  _("Center cursor vertically"),
                  _("Put the cursor in the middle of the screen vertically."),
                  _("Center cursor vertically"),
-                 _("Mouse and touch"),
+                 "",
                  "res/actions/mouse24.png",
                  "res/actions/mouse.png")
 
@@ -103,7 +106,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                  _("Hide the cursor"),
                  _("Hide the cursor."),
                  _("Hide the cursor"),
-                 _("Mouse and touch"),
+                 "",
                  "res/actions/mouse24.png",
                  "res/actions/mouse.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -114,7 +117,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                  _("Show the cursor"),
                  _("Show the cursor."),
                  _("Show the cursor"),
-                 _("Mouse and touch"),
+                 "",
                  "res/actions/mouse24.png",
                  "res/actions/mouse.png")
 
@@ -126,7 +129,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                  _("Position the cursor of the mouse"),
                  _("Position the cursor at the given coordinates."),
                  _("Position cursor at _PARAM1_;_PARAM2_"),
-                 _("Mouse and touch"),
+                 "",
                  "res/actions/mouse24.png",
                  "res/actions/mouse.png")
 
@@ -140,7 +143,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                  _("Center the cursor"),
                  _("Center the cursor on the screen."),
                  _("Center the cursor"),
-                 _("Mouse and touch"),
+                 "",
                  "res/actions/mouse24.png",
                  "res/actions/mouse.png")
 
@@ -154,7 +157,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
           _("Cursor X position"),
           _("the X position of the cursor or of a touch"),
           _("the cursor (or touch) X position"),
-          _("Mouse and touch"),
+          "",
           "res/conditions/mouse24.png")
       .AddCodeOnlyParameter("currentScene", "")
       .UseStandardParameters("number")
@@ -174,7 +177,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
           _("Cursor Y position"),
           _("the Y position of the cursor or of a touch"),
           _("the cursor (or touch) Y position"),
-          _("Mouse and touch"),
+          "",
           "res/conditions/mouse24.png")
       .AddCodeOnlyParameter("currentScene", "")
       .UseStandardParameters("number")
@@ -193,7 +196,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                     _("Check if the specified mouse button is pressed or "
                       "if a touch is in contact with the screen."),
                     _("Touch or _PARAM1_ mouse button is down"),
-                    _("Mouse and touch"),
+                    "",
                     "res/conditions/mouse24.png",
                     "res/conditions/mouse.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -209,7 +212,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                     _("Mouse button released"),
                     _("Check if the specified mouse button was released."),
                     _("_PARAM1_ mouse button was released"),
-                    _("Mouse and touch"),
+                    "",
                     "res/conditions/mouse24.png",
                     "res/conditions/mouse.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -223,7 +226,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
           _("Check if a mouse button, retrieved from the result of the "
             "expression, is pressed."),
           _("_PARAM1_ mouse button is pressed"),
-          _("Mouse and touch"),
+          "",
           "res/conditions/mouse24.png",
           "res/conditions/mouse.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -241,7 +244,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
           _("Check if a mouse button, retrieved from the result of the "
             "expression, was just released."),
           _("_PARAM1_ mouse button is released"),
-          _("Mouse and touch"),
+          "",
           "res/conditions/mouse24.png",
           "res/conditions/mouse.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -258,7 +261,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                                  _("Touch X position"),
                                  _("the X position of a specific touch"),
                                  _("the touch #_PARAM1_ X position"),
-                                 _("Mouse and touch/Multitouch"),
+                                 _("Multitouch"),
                                  "res/conditions/touch24.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("expression", _("Touch identifier"))
@@ -274,7 +277,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
                                  _("Touch Y position"),
                                  _("the Y position of a specific touch"),
                                  _("the touch #_PARAM1_ Y position"),
-                                 _("Mouse and touch/Multitouch"),
+                                 _("Multitouch"),
                                  "res/conditions/touch24.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("expression", _("Touch identifier"))
@@ -294,7 +297,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
             "next time you use it, it will be for a new touch, or it will "
             "return false if no more touches have just started."),
           _("A new touch has started"),
-          _("Mouse and touch/Multitouch"),
+          _("Multitouch"),
           "res/conditions/touch24.png",
           "res/conditions/touch.png")
       .AddCodeOnlyParameter("currentScene", "");
@@ -309,7 +312,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
             "time you use it, it will be for a new touch, or it will return "
             "false if no more touches have just ended."),
           _("A touch has ended"),
-          _("Mouse and touch/Multitouch"),
+          _("Multitouch"),
           "res/conditions/touch24.png",
           "res/conditions/touch.png")
       .AddCodeOnlyParameter("currentScene", "");
@@ -326,7 +329,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
       .AddExpression("LastTouchId",
                      _("Identifier of the last touch"),
                      _("Identifier of the last touch"),
-                     _("Mouse and touch/Multitouch"),
+                     _("Multitouch"),
                      "res/conditions/touch.png")
       .AddCodeOnlyParameter("currentScene", "");
 
@@ -334,7 +337,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsMouseExtension(
       .AddExpression("LastEndedTouchId",
                      _("Identifier of the last ended touch"),
                      _("Identifier of the last ended touch"),
-                     _("Mouse and touch/Multitouch"),
+                     _("Multitouch"),
                      "res/conditions/touch.png")
       .AddCodeOnlyParameter("currentScene", "");
 }

Core/GDCore/Extensions/Builtin/NetworkExtension.cpp

@@ -14,12 +14,15 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsNetworkExtension(
   extension
       .SetExtensionInformation(
           "BuiltinNetwork",
-          _("Basic internet features"),
+          _("Network"),
           _("Features to send web requests, communicate with external \"APIs\" "
             "and other network related tasks."),
           "Florian Rival",
           "Open source (MIT License)")
-      .SetExtensionHelpPath("/all-features/network");
+      .SetExtensionHelpPath("/all-features/network")
+      .SetCategory("Network");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Network"))
+      .SetIcon("res/actions/net24.png");
 
   extension
       .AddAction(
@@ -30,7 +33,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsNetworkExtension(
           "as specified below, except if the server is configured to answer "
           "to all requests (cross-domain requests).",
           "Send _PARAM3_ request to _PARAM0__PARAM1_ with body: _PARAM2_",
-          _("Network"),
+          "",
           "res/actions/net24.png",
           "res/actions/net.png")
       .AddParameter("string", "Host, with protocol")
@@ -65,7 +68,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsNetworkExtension(
             "to all requests (cross-domain requests)."),
           _("Send a _PARAM2_ request to _PARAM0_ with body: _PARAM1_, and "
             "store the result in _PARAM4_ (or in _PARAM5_ in case of error)"),
-          _("Network"),
+          "",
           "res/actions/net24.png",
           "res/actions/net.png")
       .AddParameter("string", _("URL (API or web-page address)"))
@@ -92,20 +95,37 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsNetworkExtension(
             "explore the results with a *structure variable*."))
       .AddParameter(
           "scenevar", _("Variable where to store the error message"), "", true)
-      .SetParameterLongDescription(
-          _("Optional, only used if an error occurs. This will contain the "
-            "error message (if request could not be sent) or the [\"status "
-            "code\"](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes), "
-            "if the server returns a status >= 400."))
+      .SetParameterLongDescription(_(
+          "Optional, only used if an error occurs. This will contain the "
+          "[\"status "
+          "code\"](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) "
+          "if the server returns a status >= 400. If the request was not sent "
+          "at all (e.g. no internet or CORS issues), the variable will be set "
+          "to "
+          "\"REQUEST_NOT_SENT\"."))
       .MarkAsComplex();
 
+  extension
+      .AddAction("LaunchFile",
+                 _("Open a URL (web page) or a file"),
+                 _("This action launches the specified file or URL, in a "
+                   "browser (or in a new tab if the game is using the Web "
+                   "platform and is launched inside a browser)."),
+                 _("Open URL _PARAM0_ in a browser (or new tab)"),
+                 "",
+                 "res/actions/net24.png",
+                 "res/actions/net.png")
+      .AddParameter("string", _("URL (or filename)"))
+      .AddCodeOnlyParameter("currentScene", "")
+      .MarkAsAdvanced();
+
   extension
       .AddAction(
           "DownloadFile",
           _("Download a file"),
           _("Download a file from a web site"),
           _("Download file _PARAM1_ from _PARAM0_ under the name of _PARAM2_"),
-          _("Network"),
+          "",
           "res/actions/net24.png",
           "res/actions/net.png")
       .AddParameter("string", _("Host (for example : http://www.website.com)"))
@@ -123,78 +143,11 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsNetworkExtension(
             "terms of service of your game and if they player gave their "
             "consent, depending on how your game/company handles this."),
           _("Enable analytics metrics: _PARAM1_"),
-          _("Network"),
+          "",
           "res/actions/net24.png",
           "res/actions/net.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("yesorno", _("Enable the metrics?"));
-
-  extension
-      .AddAction(
-          "JSONToVariableStructure",
-          _("Convert JSON to a scene variable"),
-          _("Parse a JSON object and store it into a scene variable"),
-          _("Parse JSON string _PARAM0_ and store it into variable _PARAM1_"),
-          _("Network"),
-          "res/actions/net24.png",
-          "res/actions/net.png")
-      .AddParameter("string", _("JSON string"))
-      .AddParameter("scenevar", _("Variable where store the JSON object"))
-      .MarkAsAdvanced();
-
-  extension
-      .AddAction("JSONToGlobalVariableStructure",
-                 _("Convert JSON to global variable"),
-                 _("Parse a JSON object and store it into a global variable"),
-                 _("Parse JSON string _PARAM0_ and store it into global "
-                   "variable _PARAM1_"),
-                 _("Network"),
-                 "res/actions/net24.png",
-                 "res/actions/net.png")
-      .AddParameter("string", _("JSON string"))
-      .AddParameter("globalvar",
-                    _("Global variable where store the JSON object"))
-      .MarkAsAdvanced();
-
-  extension
-      .AddAction("JSONToObjectVariableStructure",
-                 _("Convert JSON to object variable"),
-                 _("Parse a JSON object and store it into an object variable"),
-                 _("Parse JSON string _PARAM0_ and store it into variable "
-                   "_PARAM2_ of _PARAM1_"),
-                 _("Network"),
-                 "res/actions/net24.png",
-                 "res/actions/net.png")
-      .AddParameter("string", _("JSON string"))
-      .AddParameter("objectPtr", _("Object"))
-      .AddParameter("objectvar",
-                    _("Object variable where store the JSON object"))
-      .MarkAsAdvanced();
-
-  extension
-      .AddStrExpression("ToJSON",
-                        _("Convert scene variable to JSON"),
-                        _("Convert a scene variable to JSON"),
-                        _("Conversion"),
-                        "res/conditions/toujours24.png")
-      .AddParameter("scenevar", _("Scene variable to be stringified"));
-
-  extension
-      .AddStrExpression("GlobalVarToJSON",
-                        _("Convert global variable to JSON"),
-                        _("Convert a global variable to JSON"),
-                        _("Conversion"),
-                        "res/conditions/toujours24.png")
-      .AddParameter("globalvar", _("The global variable to be stringified"));
-
-  extension
-      .AddStrExpression("ObjectVarToJSON",
-                        _("Convert object variable to JSON"),
-                        _("Convert an object variable to JSON"),
-                        _("Conversion"),
-                        "res/conditions/toujours24.png")
-      .AddParameter("objectPtr", _("The object with the variable"))
-      .AddParameter("objectvar", _("The object variable to be stringified"));
 }
 
 }  // namespace gd

Core/GDCore/Extensions/Builtin/SceneExtension.cpp

@@ -14,67 +14,19 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSceneExtension(
   extension
       .SetExtensionInformation(
           "BuiltinScene",
-          _("Scene management features"),
+          _("Scene"),
           _("Actions and conditions to manipulate the scenes during the game."),
           "Florian Rival",
           "Open source (MIT License)")
       .SetExtensionHelpPath("" /*TODO: Add a documentation page for this */);
-
-
-  extension
-      .AddExpression("Random",
-                     _("Random integer"),
-                     _("Random integer"),
-                     _("Random"),
-                     "res/actions/position.png")
-      .SetHelpPath("/all-features/expressions")
-      .AddParameter("expression", _("Maximum value"));
-
-  extension
-      .AddExpression("RandomInRange",
-                     _("Random integer in range"),
-                     _("Random integer in range"),
-                     _("Random"),
-                     "res/actions/position.png")
-      .SetHelpPath("/all-features/expressions")
-      .AddParameter("expression", _("Minimum value"))
-      .AddParameter("expression", _("Maximum value"));
-
-  extension
-      .AddExpression("RandomFloat",
-                     _("Random float"),
-                     _("Random float"),
-                     _("Random"),
-                     "res/actions/position.png")
-      .SetHelpPath("/all-features/expressions")
-      .AddParameter("expression", _("Maximum value"));
-
-  extension
-      .AddExpression("RandomFloatInRange",
-                     _("Random float in range"),
-                     _("Random float in range"),
-                     _("Random"),
-                     "res/actions/position.png")
-      .SetHelpPath("/all-features/expressions")
-      .AddParameter("expression", _("Minimum value"))
-      .AddParameter("expression", _("Maximum value"));
-
-  extension
-      .AddExpression("RandomWithStep",
-                     _("Random value in steps"),
-                     _("Random value in steps"),
-                     _("Random"),
-                     "res/actions/position.png")
-      .SetHelpPath("/all-features/expressions")
-      .AddParameter("expression", _("Minimum value"))
-      .AddParameter("expression", _("Maximum value"))
-      .AddParameter("expression", _("Step"));
+  extension.AddInstructionOrExpressionGroupMetadata(_("Scene"))
+      .SetIcon("res/conditions/depart24.png");
 
   extension
       .AddStrExpression("CurrentSceneName",
                         _("Current scene name"),
                         _("Name of the current scene"),
-                        _("Scene"),
+                        "",
                         "res/actions/texte.png")
       .AddCodeOnlyParameter("currentScene", "");
 
@@ -83,7 +35,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSceneExtension(
                     _("At the beginning of the scene"),
                     _("Is true only when scene just begins."),
                     _("At the beginning of the scene"),
-                    _("Scene"),
+                    "",
                     "res/conditions/depart24.png",
                     "res/conditions/depart.png")
       .SetHelpPath("/interface/scene-editor/events")
@@ -95,7 +47,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSceneExtension(
                     _("Scene just resumed"),
                     _("The scene has just resumed after being paused."),
                     _("Scene just resumed"),
-                    _("Scene"),
+                    "",
                     "res/conditions/depart24.png",
                     "res/conditions/depart.png")
       .SetHelpPath("/interface/scene-editor/events")
@@ -107,7 +59,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSceneExtension(
                  _("Change the scene"),
                  _("Stop this scene and start the specified one instead."),
                  _("Change to scene _PARAM1_"),
-                 _("Scene"),
+                 "",
                  "res/actions/replaceScene24.png",
                  "res/actions/replaceScene.png")
       .SetHelpPath("/interface/scene-editor/events")
@@ -124,7 +76,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSceneExtension(
                    "can use the \"Stop and go back to previous scene\" action "
                    "to go back to this scene."),
                  _("Pause the scene and start _PARAM1_"),
-                 _("Scene"),
+                 "",
                  "res/actions/pushScene24.png",
                  "res/actions/pushScene.png")
       .SetHelpPath("/interface/scene-editor/events")
@@ -139,7 +91,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSceneExtension(
           _("Stop this scene and go back to the previous paused one.\nTo pause "
             "a scene, use the \"Pause and start a new scene\" action."),
           _("Stop the scene and go back to the previous paused one"),
-          _("Scene"),
+          "",
           "res/actions/popScene24.png",
           "res/actions/popScene.png")
       .SetHelpPath("/interface/scene-editor/events")
@@ -151,7 +103,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSceneExtension(
                  _("Quit the game"),
                  _("Quit the game"),
                  _("Quit the game"),
-                 _("Scene"),
+                 "",
                  "res/actions/quit24.png",
                  "res/actions/quit.png")
       .SetHelpPath("/interface/scene-editor/events")
@@ -163,7 +115,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSceneExtension(
                  _("Change background color"),
                  _("Change the background color of the scene."),
                  _("Set background color to _PARAM1_"),
-                 _("Scene"),
+                 "",
                  "res/actions/background24.png",
                  "res/actions/background.png")
       .SetHelpPath("/interface/scene-editor/events")
@@ -177,41 +129,13 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSceneExtension(
                  _("mouse buttons must be taken "
                    "into account even\nif the window is not active."),
                  _("Disable input when focus is lost: _PARAM1_"),
-                 _("Scene"),
+                 "",
                  "res/actions/window24.png",
                  "res/actions/window.png")
       .SetHelpPath("/interface/scene-editor/events")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("yesorno", _("Deactivate input when focus is lost"))
       .MarkAsAdvanced();
-
-  extension
-      .AddCondition("Egal",
-                    _("Compare two numbers"),
-                    _("Compare the two numbers."),
-                    _("_PARAM0_ _PARAM1_ _PARAM2_"),
-                    _("Other"),
-                    "res/conditions/egal24.png",
-                    "res/conditions/egal.png")
-      .SetHelpPath("/all-features/advanced-conditions")
-      .AddParameter("expression", _("First expression"))
-      .AddParameter("relationalOperator", _("Sign of the test"), "number")
-      .AddParameter("expression", _("Second expression"))
-      .MarkAsAdvanced();
-
-  extension
-      .AddCondition("StrEqual",
-                    _("Compare two strings"),
-                    _("Compare the two strings."),
-                    _("_PARAM0_ _PARAM1_ _PARAM2_"),
-                    _("Other"),
-                    "res/conditions/egal24.png",
-                    "res/conditions/egal.png")
-      .SetHelpPath("/all-features/advanced-conditions")
-      .AddParameter("string", _("First string expression"))
-      .AddParameter("relationalOperator", _("Sign of the test"), "string")
-      .AddParameter("string", _("Second string expression"))
-      .MarkAsAdvanced();
 }
 
 }  // namespace gd

Core/GDCore/Extensions/Builtin/SpriteExtension/SpriteExtension.cpp

@@ -23,11 +23,14 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSpriteExtension(
                                "Open source (MIT License)")
       .SetExtensionHelpPath("/objects/sprite");
 
-  gd::ObjectMetadata& obj = extension.AddObject<SpriteObject>(
-      "Sprite",
-      _("Sprite"),
-      _("Animated object which can be used for most elements of a game"),
-      "CppPlatform/Extensions/spriteicon.png");
+  gd::ObjectMetadata& obj =
+      extension
+          .AddObject<SpriteObject>("Sprite",
+                                   _("Sprite"),
+                                   _("Animated object which can be used for "
+                                     "most elements of a game"),
+                                   "CppPlatform/Extensions/spriteicon.png")
+          .SetCategoryFullName(_("General"));
 
   obj.AddAction("Opacity",
                 _("Change sprite opacity"),
@@ -78,7 +81,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSpriteExtension(
          _("Direction"),
          "res/actions/direction24.png",
          "res/actions/direction.png")
-      .SetHidden() // Hide as 8 direction is not supported officially in the interface.
+      .SetHidden()  // Hide as 8 direction is not supported officially in the
+                    // interface.
       .AddParameter("object", _("Object"), "Sprite")
       .UseStandardOperatorParameters("number")
       .MarkAsAdvanced();
@@ -242,7 +246,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSpriteExtension(
          _("Direction"),
          "res/conditions/direction24.png",
          "res/conditions/direction.png")
-      .SetHidden() // Hide as 8 direction is not supported officially in the interface.
+      .SetHidden()  // Hide as 8 direction is not supported officially in the
+                    // interface.
       .AddParameter("object", _("Object"), "Sprite")
       .UseStandardRelationalOperatorParameters("number");
 
@@ -464,7 +469,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsSpriteExtension(
                     _("Direction of the object"),
                     _("Direction"),
                     "res/actions/direction.png")
-      .SetHidden() // Hide as 8 direction is not supported officially in the interface.
+      .SetHidden()  // Hide as 8 direction is not supported officially in the
+                    // interface.
       .AddParameter("object", _("Object"), "Sprite");
 
   obj.AddExpression("Anim",

Core/GDCore/Extensions/Builtin/SpriteExtension/SpriteObject.cpp

@@ -4,23 +4,24 @@
  * reserved. This project is released under the MIT License.
  */
 
+#include "GDCore/Extensions/Builtin/SpriteExtension/SpriteObject.h"
+
+#include <SFML/Graphics.hpp>
 #include <algorithm>
+
 #include "GDCore/CommonTools.h"
 #include "GDCore/Extensions/Builtin/SpriteExtension/Animation.h"
 #include "GDCore/Extensions/Builtin/SpriteExtension/Direction.h"
 #include "GDCore/Extensions/Builtin/SpriteExtension/Sprite.h"
-#include "GDCore/Extensions/Builtin/SpriteExtension/SpriteObject.h"
+#include "GDCore/IDE/Project/ArbitraryResourceWorker.h"
 #include "GDCore/Project/InitialInstance.h"
 #include "GDCore/Project/Layout.h"
 #include "GDCore/Project/Object.h"
 #include "GDCore/Project/Project.h"
+#include "GDCore/Project/PropertyDescriptor.h"
 #include "GDCore/Serialization/SerializerElement.h"
 #include "GDCore/Tools/Localization.h"
 
-#include <SFML/Graphics.hpp>
-#include "GDCore/Project/PropertyDescriptor.h"
-#include "GDCore/IDE/Project/ArbitraryResourceWorker.h"
-
 namespace gd {
 
 Animation SpriteObject::badAnimation;
@@ -103,7 +104,8 @@ void SpriteObject::DoSerializeTo(gd::SerializerElement& element) const {
   }
 }
 
-std::map<gd::String, gd::PropertyDescriptor> SpriteObject::GetProperties() const {
+std::map<gd::String, gd::PropertyDescriptor> SpriteObject::GetProperties()
+    const {
   std::map<gd::String, gd::PropertyDescriptor> properties;
   properties[_("Animate even if hidden or far from the screen")]
       .SetValue(updateIfNotVisible ? "true" : "false")
@@ -135,22 +137,30 @@ void SpriteObject::ExposeResources(gd::ArbitraryResourceWorker& worker) {
 }
 
 std::map<gd::String, gd::PropertyDescriptor>
-SpriteObject::GetInitialInstanceProperties(const gd::InitialInstance& position,
-                                           gd::Project& project,
-                                           gd::Layout& scene) {
+SpriteObject::GetInitialInstanceProperties(
+    const gd::InitialInstance& initialInstance,
+    gd::Project& project,
+    gd::Layout& scene) {
   std::map<gd::String, gd::PropertyDescriptor> properties;
-  properties[_("Animation")] = gd::String::From(position.GetRawDoubleProperty("animation"));
+  properties["animation"] =
+      gd::PropertyDescriptor(
+          gd::String::From(initialInstance.GetRawDoubleProperty("animation")))
+          .SetLabel(_("Animation"))
+          .SetType("number");
 
   return properties;
 }
 
-bool SpriteObject::UpdateInitialInstanceProperty(gd::InitialInstance& position,
-                                                 const gd::String& name,
-                                                 const gd::String& value,
-                                                 gd::Project& project,
-                                                 gd::Layout& scene) {
-  if (name == _("Animation"))
-    position.SetRawDoubleProperty("animation", value.To<int>());
+bool SpriteObject::UpdateInitialInstanceProperty(
+    gd::InitialInstance& initialInstance,
+    const gd::String& name,
+    const gd::String& value,
+    gd::Project& project,
+    gd::Layout& scene) {
+  if (name == "animation") {
+    initialInstance.SetRawDoubleProperty(
+        "animation", std::max(0, value.empty() ? 0 : value.To<int>()));
+  }
 
   return true;
 }

Core/GDCore/Extensions/Builtin/StringInstructionsExtension.cpp

@@ -20,18 +20,20 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
           "Florian Rival",
           "Open source (MIT License)")
       .SetExtensionHelpPath("" /*TODO: Add a documentation page for this */);
+  extension.AddInstructionOrExpressionGroupMetadata(_("Text manipulation"))
+      .SetIcon("res/actions/text24.png");
 
   extension.AddStrExpression("NewLine",
                              _("Insert a new line"),
                              _("Insert a new line"),
-                             _("Manipulation of text"),
+                             "",
                              "res/conditions/toujours24.png");
 
   extension
       .AddStrExpression("FromCodePoint",
                         _("Get character from code point"),
                         _("Get character from code point"),
-                        _("Manipulation of text"),
+                        "",
                         "res/conditions/toujours24.png")
 
       .AddParameter("expression", _("Code point"));
@@ -40,7 +42,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
       .AddStrExpression("ToUpperCase",
                         _("Uppercase a text"),
                         _("Uppercase a text"),
-                        _("Manipulation of text"),
+                        "",
                         "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"));
@@ -49,7 +51,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
       .AddStrExpression("ToLowerCase",
                         _("Lowercase a text"),
                         _("Lowercase a text"),
-                        _("Manipulation of text"),
+                        "",
                         "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"));
@@ -58,7 +60,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
       .AddStrExpression("SubStr",
                         _("Get a portion of a text"),
                         _("Get a portion of a text"),
-                        _("Manipulation of text"),
+                        "",
                         "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"))
@@ -71,7 +73,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
       .AddStrExpression("StrAt",
                         _("Get a character from a text"),
                         _("Get a character from a text"),
-                        _("Manipulation of text"),
+                        "",
                         "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"))
@@ -83,7 +85,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
       .AddStrExpression("StrRepeat",
                         _("Repeat a text"),
                         _("Repeat a text"),
-                        _("Manipulation of text"),
+                        "",
                         "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text to repeat"))
@@ -93,7 +95,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
       .AddExpression("StrLength",
                      _("Length of a text"),
                      _("Length of a text"),
-                     _("Manipulation of text"),
+                     "",
                      "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"));
@@ -103,7 +105,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
                      _("Search in a text"),
                      _("Search in a text (return the position of the result or "
                        "-1 if not found)"),
-                     _("Manipulation of text"),
+                     "",
                      "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"))
@@ -114,7 +116,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
                      "Search in a text from the end",
                      "Search in a text from the end (return the position of "
                      "the result or -1 if not found)",
-                     _("Manipulation of text"),
+                     "",
                      "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"))
@@ -128,7 +130,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
           _("Search the last occurence in a string (return the position of "
             "the result, from the beginning of the string, or -1 if not "
             "found)"),
-          _("Manipulation of text"),
+          "",
           "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"))
@@ -139,7 +141,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
                      _("Search in a text, starting from a position"),
                      _("Search in a text, starting from a position (return the "
                        "position of the result or -1 if not found)"),
-                     _("Manipulation of text"),
+                     "",
                      "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"))
@@ -154,7 +156,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
           "Search in a text from the end, starting from a position",
           "Search in a text from the end, starting from a position (return "
           "the position of the result or -1 if not found)",
-          _("Manipulation of text"),
+          "",
           "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"))
@@ -172,7 +174,7 @@ BuiltinExtensionsImplementer::ImplementsStringInstructionsExtension(
             "(return "
             " the position of the result, from the beginning of the string, or "
             "-1 if not found)"),
-          _("Manipulation of text"),
+          "",
           "res/conditions/toujours24.png")
 
       .AddParameter("string", _("Text"))

Core/GDCore/Extensions/Builtin/TimeExtension.cpp

@@ -14,13 +14,17 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
   extension
       .SetExtensionInformation(
           "BuiltinTime",
-          _("Time"),
+          _("Timers and time"),
           "Actions and conditions to run timers, get the current time or "
           "modify the time scale (speed at which the game is running - useful "
           "for slow motion effects).",
           "Florian Rival",
           "Open source (MIT License)")
       .SetExtensionHelpPath("/all-features/timers");
+  extension.AddInstructionOrExpressionGroupMetadata(
+      _("Timers and time")
+  )
+      .SetIcon("res/conditions/timer24.png");
 
   // Deprecated and replaced by CompareTimer
   extension
@@ -28,7 +32,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
                     _("Value of a scene timer"),
                     _("Test the elapsed time of a scene timer."),
                     _("The timer _PARAM2_ is greater than _PARAM1_ seconds"),
-                    _("Timers and time"),
+
+                    "",
                     "res/conditions/timer24.png",
                     "res/conditions/timer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -39,9 +44,11 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
   extension
       .AddCondition("CompareTimer",
                     _("Value of a scene timer"),
-                    _("Compare the elapsed time of a scene timer. This condition doesn't start the timer."),
+                    _("Compare the elapsed time of a scene timer. This "
+                      "condition doesn't start the timer."),
                     _("The timer _PARAM1_ _PARAM2_ _PARAM3_ seconds"),
-                    _("Timers and time"),
+
+                    "",
                     "res/conditions/timer24.png",
                     "res/conditions/timer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -55,7 +62,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
                     _("Time scale"),
                     _("Compare the time scale of the scene."),
                     _("the time scale of the scene"),
-                    _("Timers and time"),
+
+                    "",
                     "res/conditions/time24.png",
                     "res/conditions/time.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -67,7 +75,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
                     _("Scene timer paused"),
                     _("Test if the specified scene timer is paused."),
                     _("The timer _PARAM1_ is paused"),
-                    _("Timers and time"),
+
+                    "",
                     "res/conditions/timerPaused24.png",
                     "res/conditions/timerPaused.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -80,8 +89,9 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
           _("Start (or reset) a scene timer"),
           _("Reset the specified scene timer, if the timer doesn't exist "
             "it's created and started."),
-          _("Reset the timer _PARAM1_"),
-          _("Timers and time"),
+          _("Start (or reset) the timer _PARAM1_"),
+
+          "",
           "res/actions/timer24.png",
           "res/actions/timer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -92,7 +102,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
                  _("Pause a scene timer"),
                  _("Pause a scene timer."),
                  _("Pause timer _PARAM1_"),
-                 _("Timers and time"),
+
+                 "",
                  "res/actions/pauseTimer24.png",
                  "res/actions/pauseTimer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -104,7 +115,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
                  _("Unpause a scene timer"),
                  _("Unpause a scene timer."),
                  _("Unpause timer _PARAM1_"),
-                 _("Timers and time"),
+
+                 "",
                  "res/actions/unPauseTimer24.png",
                  "res/actions/unPauseTimer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -116,7 +128,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
                  _("Delete a scene timer"),
                  _("Delete a scene timer from memory."),
                  _("Delete timer _PARAM1_ from memory"),
-                 _("Timers and time"),
+
+                 "",
                  "res/actions/timer24.png",
                  "res/actions/timer.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -128,7 +141,8 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
                  _("Change time scale"),
                  _("Change the time scale of the scene."),
                  _("Set the time scale of the scene to _PARAM1_"),
-                 _("Timers and time"),
+
+                 "",
                  "res/actions/time24.png",
                  "res/actions/time.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -139,7 +153,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
       .AddExpression("TimeDelta",
                      _("Time elapsed since the last frame"),
                      _("Time elapsed since the last frame rendered on screen"),
-                     _("Time"),
+                     "",
                      "res/actions/time.png")
       .AddCodeOnlyParameter("currentScene", "");
 
@@ -147,7 +161,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
       .AddExpression("TempsFrame",
                      _("Time elapsed since the last frame"),
                      _("Time elapsed since the last frame rendered on screen"),
-                     _("Time"),
+                     "",
                      "res/actions/time.png")
       .SetHidden()
       .AddCodeOnlyParameter("currentScene", "");
@@ -156,7 +170,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
       .AddExpression("ElapsedTime",
                      _("Time elapsed since the last frame"),
                      _("Time elapsed since the last frame rendered on screen"),
-                     _("Time"),
+                     "",
                      "res/actions/time.png")
       .SetHidden()
       .AddCodeOnlyParameter("currentScene", "");
@@ -165,7 +179,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
       .AddExpression("TimerElapsedTime",
                      _("Scene timer value"),
                      _("Value of a scene timer"),
-                     _("Time"),
+                     "",
                      "res/actions/time.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Timer's name"));
@@ -174,7 +188,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
       .AddExpression("TimeFromStart",
                      _("Time elapsed since the beginning of the scene"),
                      _("Time elapsed since the beginning of the scene"),
-                     _("Time"),
+                     "",
                      "res/actions/time.png")
       .AddCodeOnlyParameter("currentScene", "");
 
@@ -182,7 +196,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
       .AddExpression("TempsDebut",
                      _("Time elapsed since the beginning of the scene"),
                      _("Time elapsed since the beginning of the scene"),
-                     _("Time"),
+                     "",
                      "res/actions/time.png")
       .SetHidden()
       .AddCodeOnlyParameter("currentScene", "");
@@ -191,7 +205,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
       .AddExpression("TimeScale",
                      _("Time scale"),
                      _("Returns the time scale of the scene."),
-                     _("Time"),
+                     "",
                      "res/actions/time.png")
       .AddCodeOnlyParameter("currentScene", "");
 
@@ -199,7 +213,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
       .AddExpression("Time",
                      _("Current time"),
                      _("Current time"),
-                     _("Time"),
+                     "",
                      "res/actions/time.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter(
@@ -210,7 +224,6 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
             "timestamp\""),
           "[\"hour\", \"min\", \"sec\", \"mon\", \"year\", \"wday\", \"mday\", "
           "\"yday\", \"timestamp\"]");
-
 }
 
 }  // namespace gd

Core/GDCore/Extensions/Builtin/VariablesExtension.cpp

@@ -14,7 +14,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
   extension
       .SetExtensionInformation(
           "BuiltinVariables",
-          _("Variable features"),
+          _("Variables"),
           "Actions, conditions and expressions to handle variables, from "
           "simple variables like the player score, the number of remaining "
           "lives to complex variables containing arbitrary data like an "
@@ -22,13 +22,15 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
           "Florian Rival",
           "Open source (MIT License)")
       .SetExtensionHelpPath("/all-features/variables");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Variables"))
+      .SetIcon("res/conditions/var24.png");
 
   extension
       .AddCondition("VarScene",
                     _("Value of a scene variable"),
                     _("Compare the value of a scene variable."),
                     _("the scene variable _PARAM0_"),
-                    _("Variables/Scene variables"),
+                    _("Scene variables"),
                     "res/conditions/var24.png",
                     "res/conditions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -39,7 +41,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                     _("Text of a scene variable"),
                     _("Compare the text of a scene variable."),
                     _("the text of scene variable _PARAM0_"),
-                    _("Variables/Scene variables"),
+                    _("Scene variables"),
                     "res/conditions/var24.png",
                     "res/conditions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -51,7 +53,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
           _("Boolean value of a scene variable"),
           _("Compare the boolean value of a scene variable."),
           _("The boolean value of scene variable _PARAM0_ is _PARAM1_"),
-          _("Variables/Scene variables"),
+          _("Scene variables"),
           "res/conditions/var24.png",
           "res/conditions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -64,7 +66,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
           _("Child existence"),
           _("Check if the specified child of the scene variable exists."),
           _("Child _PARAM1_ of scene variable _PARAM0_ exists"),
-          _("Variables/Scene variables/Collections/Structures"),
+          _("Scene variables/Collections/Structures"),
           "res/conditions/var24.png",
           "res/conditions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -77,7 +79,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                     _("Check if the specified child of the global "
                       "variable exists."),
                     _("Child _PARAM1_ of global variable _PARAM0_ exists"),
-                    _("Variables/Global variables/Collections/Structures"),
+                    _("Global variables/Collections/Structures"),
                     "res/conditions/var24.png",
                     "res/conditions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -89,7 +91,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                     "Test if a scene variable is defined",
                     "Test if the scene variable exists.",
                     "Scene variable _PARAM0_ is defined",
-                    _("Variables/Scene variables"),
+                    _("Scene variables"),
                     "res/conditions/var24.png",
                     "res/conditions/var.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -101,7 +103,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                     _("Value of a global variable"),
                     _("Compare the value of a global variable."),
                     _("the global variable _PARAM0_"),
-                    _("Variables/Global variables"),
+                    _("Global variables"),
                     "res/conditions/var24.png",
                     "res/conditions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -113,7 +115,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                     _("Text of a global variable"),
                     _("Compare the text of a global variable."),
                     _("the text of the global variable _PARAM0_"),
-                    _("Variables/Global variables"),
+                    _("Global variables"),
                     "res/conditions/var24.png",
                     "res/conditions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -126,7 +128,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
           _("Boolean value of a global variable"),
           _("Compare the boolean value of a global variable."),
           _("The boolean value of global variable _PARAM0_ is _PARAM1_"),
-          _("Variables/Global variables"),
+          _("Global variables"),
           "res/conditions/var24.png",
           "res/conditions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -138,7 +140,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                     "Test if a global variable is defined",
                     "Test if a global variable exists",
                     "Global variable _PARAM0_ is defined",
-                    _("Variables/Global variables"),
+                    _("Global variables"),
                     "res/conditions/var24.png",
                     "res/conditions/var.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -151,7 +153,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Value of a scene variable"),
                  _("Change the value of a scene variable."),
                  _("the scene variable _PARAM0_"),
-                 _("Variables/Scene variables"),
+                 _("Scene variables"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -162,7 +164,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("String of a scene variable"),
                  _("Modify the text of a scene variable."),
                  _("the text of scene variable _PARAM0_"),
-                 _("Variables/Scene variables"),
+                 _("Scene variables"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -174,7 +176,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
           _("Boolean value of a scene variable"),
           _("Modify the boolean value of a scene variable."),
           _("Set the boolean value of scene variable _PARAM0_ to _PARAM1_"),
-          _("Variables/Scene variables"),
+          _("Scene variables"),
           "res/conditions/var24.png",
           "res/conditions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -187,7 +189,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                      _("If it was true, it will become false, and if it was "
                        "false it will become true."),
                  _("Toggle the boolean value of scene variable _PARAM0_"),
-                 _("Variables/Scene variables"),
+                 _("Scene variables"),
                  "res/conditions/var24.png",
                  "res/conditions/var.png")
       .AddParameter("scenevar", _("Variable"));
@@ -197,7 +199,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Value of a global variable"),
                  _("Change the value of a global variable"),
                  _("the global variable _PARAM0_"),
-                 _("Variables/Global variables"),
+                 _("Global variables"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -209,7 +211,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("String of a global variable"),
                  _("Modify the text of a global variable."),
                  _("the text of global variable _PARAM0_"),
-                 _("Variables/Global variables"),
+                 _("Global variables"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -222,7 +224,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
           _("Boolean value of a global variable"),
           _("Modify the boolean value of a global variable."),
           _("Set the boolean value of global variable _PARAM0_ to _PARAM1_"),
-          _("Variables/Global variables"),
+          _("Global variables"),
           "res/conditions/var24.png",
           "res/conditions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -235,7 +237,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                      _("If it was true, it will become false, and if it was "
                        "false it will become true."),
                  _("Toggle the boolean value of global variable _PARAM0_"),
-                 _("Variables/Global variables"),
+                 _("Global variables"),
                  "res/conditions/var24.png",
                  "res/conditions/var.png")
       .AddParameter("globalvar", _("Variable"));
@@ -245,7 +247,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Remove a child"),
                  _("Remove a child from a scene variable."),
                  _("Remove child _PARAM1_ from scene variable _PARAM0_"),
-                 _("Variables/Scene variables/Collections/Structures"),
+                 _("Scene variables/Collections/Structures"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -257,7 +259,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Remove a child"),
                  _("Remove a child from a global variable."),
                  _("Remove child _PARAM1_ from global variable _PARAM0_"),
-                 _("Variables/Global variables/Collections/Structures"),
+                 _("Global variables/Collections/Structures"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -269,7 +271,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Clear scene variable"),
                  _("Remove all the children from the scene variable."),
                  _("Clear children from scene variable _PARAM0_"),
-                 _("Variables/Scene variables/Collections"),
+                 _("Scene variables/Collections"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -280,7 +282,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Clear global variable"),
                  _("Remove all the children from the global variable."),
                  _("Clear children from global variable _PARAM0_"),
-                 _("Variables/Global variables/Collections"),
+                 _("Global variables/Collections"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -291,7 +293,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Append variable to a scene array"),
                  _("Appends a variable at the end of a scene array variable."),
                  _("Append variable _PARAM1_ to array variable _PARAM0_"),
-                 _("Variables/Scene variables/Collections/Arrays"),
+                 _("Scene variables/Collections/Arrays"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("scenevar", _("Array variable"))
@@ -304,7 +306,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Append a string to a scene array"),
                  _("Appends a string at the end of a scene array variable."),
                  _("Append string _PARAM1_ to array variable _PARAM0_"),
-                 _("Variables/Scene variables/Collections/Arrays"),
+                 _("Scene variables/Collections/Arrays"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("scenevar", _("Array variable"))
@@ -316,7 +318,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Append a number to a scene array"),
                  _("Appends a number at the end of a scene array variable."),
                  _("Append number _PARAM1_ to array variable _PARAM0_"),
-                 _("Variables/Scene variables/Collections/Arrays"),
+                 _("Scene variables/Collections/Arrays"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("scenevar", _("Array variable"))
@@ -328,7 +330,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Append a boolean to a scene array"),
                  _("Appends a boolean at the end of a scene array variable."),
                  _("Append boolean _PARAM1_ to array variable _PARAM0_"),
-                 _("Variables/Scene variables/Collections/Arrays"),
+                 _("Scene variables/Collections/Arrays"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("scenevar", _("Array variable"))
@@ -341,7 +343,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
           _("Remove variable from a scene array (by index)"),
           _("Removes a variable at the specified index of a scene array variable."),
           _("Remove variable at index _PARAM1_ from scene array variable _PARAM0_"),
-          _("Variables/Scene variables/Collections/Arrays"),
+          _("Scene variables/Collections/Arrays"),
           "res/actions/var24.png",
           "res/actions/var.png")
       .AddParameter("scenevar", _("Variable"))
@@ -353,7 +355,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Append variable to a global array"),
                  _("Appends a variable at the end of a global array variable."),
                  _("Append variable _PARAM1_ to array variable _PARAM0_"),
-                 _("Variables/Global variables/Collections/Arrays"),
+                 _("Global variables/Collections/Arrays"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("globalvar", _("Array variable"))
@@ -367,7 +369,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
           _("Remove variable from a global array (by index)"),
           _("Removes a variable at the specified index of a global array variable."),
           _("Remove variable at index _PARAM1_ from global array variable _PARAM0_"),
-          _("Variables/Global variables/Collections/Arrays"),
+          _("Global variables/Collections/Arrays"),
           "res/actions/var24.png",
           "res/actions/var.png")
       .AddParameter("globalvar", _("Variable"))
@@ -379,7 +381,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Append a string to a global array"),
                  _("Appends a string at the end of a global array variable."),
                  _("Append string _PARAM1_ to array variable _PARAM0_"),
-                 _("Variables/Global variables/Collections/Arrays"),
+                 _("Global variables/Collections/Arrays"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("globalvar", _("Array variable"))
@@ -391,7 +393,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Append a number to a global array"),
                  _("Appends a number at the end of a global array variable."),
                  _("Append number _PARAM1_ to array variable _PARAM0_"),
-                 _("Variables/Global variables/Collections/Arrays"),
+                 _("Global variables/Collections/Arrays"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("globalvar", _("Array variable"))
@@ -403,7 +405,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
                  _("Append a boolean to a global array"),
                  _("Appends a boolean at the end of a global array variable."),
                  _("Append boolean _PARAM1_ to array variable _PARAM0_"),
-                 _("Variables/Global variables/Collections/Arrays"),
+                 _("Global variables/Collections/Arrays"),
                  "res/actions/var24.png",
                  "res/actions/var.png")
       .AddParameter("globalvar", _("Array variable"))
@@ -414,7 +416,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
       .AddExpression("GlobalVariableChildCount",
                      _("Number of children of a global variable"),
                      _("Number of children of a global variable"),
-                     _("Variables/Global variables"),
+                     _("Global variables"),
                      "res/actions/var.png")
       .AddParameter("globalvar", _("Variable"));
 
@@ -422,7 +424,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
       .AddExpression("VariableChildCount",
                      _("Number of children of a scene variable"),
                      _("Number of children of a scene variable"),
-                     _("Variables/Scene variables"),
+                     _("Scene variables"),
                      "res/actions/var.png")
       .AddParameter("scenevar", _("Variable"));
 
@@ -430,7 +432,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
       .AddExpression("Variable",
                      _("Value of a scene variable"),
                      _("Value of a scene variable"),
-                     _("Variables/Scene variables"),
+                     _("Scene variables"),
                      "res/actions/var.png")
       .AddParameter("scenevar", _("Variable"));
 
@@ -438,7 +440,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
       .AddStrExpression("VariableString",
                         _("Text of a scene variable"),
                         _("Text of a scene variable"),
-                        _("Variables/Scene variables"),
+                        _("Scene variables"),
                         "res/actions/var.png")
       .AddParameter("scenevar", _("Variable"));
 
@@ -446,7 +448,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
       .AddExpression("GlobalVariable",
                      _("Value of a global variable"),
                      _("Value of a global variable"),
-                     _("Variables/Global variables"),
+                     _("Global variables"),
                      "res/actions/var.png")
       .AddParameter("globalvar", _("Name of the global variable"));
 
@@ -454,7 +456,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsVariablesExtension(
       .AddStrExpression("GlobalVariableString",
                         _("Text of a global variable"),
                         _("Text of a global variable"),
-                        _("Variables/Global variables"),
+                        _("Global variables"),
                         "res/actions/var.png")
       .AddParameter("globalvar", _("Variable"));
 }

Core/GDCore/Extensions/Builtin/WindowExtension.cpp

@@ -14,13 +14,17 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
   extension
       .SetExtensionInformation(
           "BuiltinWindow",
-          _("Window features"),
+          _("Game window and resolution"),
           "Provides actions and conditions to manipulate the game window. "
           "Depending on the platform on which the game is running, not all of "
           "these features can be applied.",
           "Florian Rival",
           "Open source (MIT License)")
       .SetExtensionHelpPath("/all-features/window");
+  extension
+      .AddInstructionOrExpressionGroupMetadata(
+          _("Game window and resolution"))
+      .SetIcon("res/actions/window24.png");
 
   extension
       .AddAction(
@@ -28,7 +32,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
           _("De/activate fullscreen"),
           _("This action activates or deactivates fullscreen."),
           _("Activate fullscreen: _PARAM1_ (keep aspect ratio: _PARAM2_)"),
-          _("Game's window and resolution"),
+          "",
           "res/actions/fullscreen24.png",
           "res/actions/fullscreen.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -44,7 +48,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
                     _("Fullscreen activated?"),
                     _("Check if the game is currently in fullscreen."),
                     _("The game is in fullscreen"),
-                    _("Game's window and resolution"),
+                    "",
                     "res/actions/fullscreen24.png",
                     "res/actions/fullscreen.png")
       .AddCodeOnlyParameter("currentScene", "");
@@ -56,7 +60,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
                    "game frame and the window borders."),
                  _("Set margins of game window to "
                    "_PARAM1_;_PARAM2_;_PARAM3_;_PARAM4_"),
-                 _("Game's window and resolution"),
+                 "",
                  "res/actions/window24.png",
                  "res/actions/window.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -72,7 +76,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
                    "the game area size. This won't change the size of the "
                    "window in which the game is running."),
                  _("Set game resolution to _PARAM1_x_PARAM2_"),
-                 _("Game's window and resolution"),
+                 "",
                  "res/actions/window24.png",
                  "res/actions/window.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -89,7 +93,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
             "window size. Game resolution can still be updated."),
           _("Set game window size to _PARAM1_x_PARAM2_ (also update game "
             "resolution: _PARAM3_)"),
-          _("Game's window and resolution"),
+          "",
           "res/actions/window24.png",
           "res/actions/window.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -106,7 +110,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
                    "only works on Windows, macOS and Linux (not when the game "
                    "is executed in a web-browser or on iOS/Android)."),
                  _("Center the game window"),
-                 _("Game's window and resolution"),
+                 "",
                  "res/actions/window24.png",
                  "res/actions/window.png")
       .AddCodeOnlyParameter("currentScene", "");
@@ -118,7 +122,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
                    "should be changed to fit the game window - or if the game "
                    "resolution should not be updated automatically."),
                  _("Set game resolution resize mode to _PARAM1_"),
-                 _("Game's window and resolution"),
+                 "",
                  "res/actions/window24.png",
                  "res/actions/window.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -139,7 +143,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
                    "be the case if the game resolution resize mode is "
                    "configured to adapt the width or the height of the game."),
                  _("Automatically adapt the game resolution: _PARAM1_"),
-                 _("Game's window and resolution"),
+                 "",
                  "res/actions/window24.png",
                  "res/actions/window.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -152,7 +156,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
                  _("Change the window's icon"),
                  _("This action changes the icon of the game's window."),
                  _("Use _PARAM1_ as the icon for the game's window."),
-                 _("Game's window and resolution"),
+                 "",
                  "res/actions/window24.png",
                  "res/actions/window.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -163,7 +167,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
                  _("Change the window's title"),
                  _("This action changes the title of the game's window."),
                  _("Change window title to _PARAM1_"),
-                 _("Game's window and resolution"),
+                 "",
                  "res/actions/window24.png",
                  "res/actions/window.png")
       .AddCodeOnlyParameter("currentScene", "")
@@ -174,7 +178,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
           "SceneWindowWidth",
           _("Width of the scene window"),
           _("Width of the scene window (or scene canvas for HTML5 games)"),
-          _("Screen"),
+          "",
           "res/window.png")
       .AddCodeOnlyParameter("currentScene", "");
 
@@ -183,7 +187,7 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
           "SceneWindowHeight",
           _("Height of the scene window"),
           _("Height of the scene window (or scene canvas for HTML5 games)"),
-          _("Screen"),
+          "",
           "res/window.png")
       .AddCodeOnlyParameter("currentScene", "");
 
@@ -191,27 +195,27 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsWindowExtension(
       "ScreenWidth",
       _("Width of the screen/page"),
       _("Width of the screen (or the page for HTML5 games in browser)"),
-      _("Screen"),
+      "",
       "res/display16.png");
 
   extension.AddExpression(
       "ScreenHeight",
       _("Height of the screen/page"),
       _("Height of the screen (or the page for HTML5 games in browser)"),
-      _("Screen"),
+      "",
       "res/display16.png");
 
   extension.AddExpression("ColorDepth",
                           _("Color depth"),
                           _("Color depth"),
-                          _("Screen"),
+                          "",
                           "res/display16.png");
 
   extension
       .AddStrExpression("WindowTitle",
                         _("Window's title"),
                         _("Window's title"),
-                        _("Screen"),
+                        "",
                         "res/window.png")
       .AddCodeOnlyParameter("currentScene", "");
 }

Core/GDCore/Extensions/Metadata/BehaviorMetadata.cpp

@@ -234,6 +234,40 @@ BehaviorMetadata::AddExpressionAndConditionAndAction(
     const gd::String& sentenceName,
     const gd::String& group,
     const gd::String& icon) {
+  if (type != "number" && type != "string" && type != "boolean") {
+    gd::LogError(
+        "Unrecognised type passed to AddExpressionAndConditionAndAction: " +
+        type + ". Verify this type is valid and supported.");
+  }
+
+  gd::String conditionDescriptionTemplate =
+      type == "boolean" ? _("Check if <subject>.") : _("Compare <subject>.");
+  auto& condition =
+      AddScopedCondition(name,
+                         fullname,
+                         conditionDescriptionTemplate.FindAndReplace(
+                             "<subject>", descriptionSubject),
+                         sentenceName,
+                         group,
+                         icon,
+                         icon);
+
+  gd::String actionDescriptionTemplate = type == "boolean"
+                                             ? _("Set (or unset) if <subject>.")
+                                             : _("Change <subject>.");
+  auto& action = AddScopedAction(
+      "Set" + name,
+      fullname,
+      actionDescriptionTemplate.FindAndReplace("<subject>", descriptionSubject),
+      sentenceName,
+      group,
+      icon,
+      icon);
+
+  if (type == "boolean") {
+    return MultipleInstructionMetadata::WithConditionAndAction(condition, action);
+  }
+
   gd::String expressionDescriptionTemplate = _("Return <subject>.");
   auto& expression =
       type == "number"
@@ -250,27 +284,6 @@ BehaviorMetadata::AddExpressionAndConditionAndAction(
                              group,
                              icon);
 
-  gd::String conditionDescriptionTemplate = _("Compare <subject>.");
-  auto& condition =
-      AddScopedCondition(name,
-                         fullname,
-                         conditionDescriptionTemplate.FindAndReplace(
-                             "<subject>", descriptionSubject),
-                         sentenceName,
-                         group,
-                         icon,
-                         icon);
-
-  gd::String actionDescriptionTemplate = _("Change <subject>.");
-  auto& action = AddScopedAction(
-      "Set" + name,
-      fullname,
-      actionDescriptionTemplate.FindAndReplace("<subject>", descriptionSubject),
-      sentenceName,
-      group,
-      icon,
-      icon);
-
   return MultipleInstructionMetadata::WithExpressionAndConditionAndAction(
       expression, condition, action);
 }

Core/GDCore/Extensions/Metadata/BehaviorMetadata.h

@@ -250,6 +250,27 @@ class GD_CORE_API BehaviorMetadata {
     return sharedDatasInstance.get();
   }
 
+  /**
+   * \brief Return a reference to a map containing the names of the actions
+   * (as keys) and the metadata associated with (as values).
+   */
+  std::map<gd::String, gd::InstructionMetadata>& GetAllActions() { return actionsInfos; };
+
+  /**
+   * \see gd::PlatformExtension::GetAllActions
+   */
+  std::map<gd::String, gd::InstructionMetadata>& GetAllConditions() { return conditionsInfos; };
+
+  /**
+   * \see gd::PlatformExtension::GetAllActions
+   */
+  std::map<gd::String, gd::ExpressionMetadata>& GetAllExpressions() { return expressionsInfos; };
+
+  /**
+   * \see gd::PlatformExtension::GetAllActions
+   */
+  std::map<gd::String, gd::ExpressionMetadata>& GetAllStrExpressions() { return strExpressionsInfos; };
+
 #if defined(GD_IDE_ONLY)
   std::map<gd::String, gd::InstructionMetadata> conditionsInfos;
   std::map<gd::String, gd::InstructionMetadata> actionsInfos;

Core/GDCore/Extensions/Metadata/ExpressionMetadata.cpp

@@ -72,4 +72,11 @@ gd::ExpressionMetadata& ExpressionMetadata::AddCodeOnlyParameter(
   return *this;
 }
 
+
+gd::ExpressionMetadata& ExpressionMetadata::SetRequiresBaseObjectCapability(
+    const gd::String& capability) {
+  requiredBaseObjectCapability = capability;
+  return *this;
+}
+
 }  // namespace gd

Core/GDCore/Extensions/Metadata/ExpressionMetadata.h

@@ -222,6 +222,23 @@ class GD_CORE_API ExpressionMetadata {
     return *this;
   };
 
+  /**
+   * \brief Mark this (object) expression as requiring the specified capability,
+   * offered by the base object.
+   * This is useful for some objects that don't support this capability, so that
+   * the editor can hide the expression as it does not apply to them.
+   */
+  ExpressionMetadata& SetRequiresBaseObjectCapability(
+      const gd::String& capability);
+
+  /**
+   * \brief Get the required specified capability for this (object) expression,
+   * or an empty string if there is nothing specific required.
+   */
+  const gd::String& GetRequiredBaseObjectCapability() const {
+    return requiredBaseObjectCapability;
+  };
+
   /**
    * \brief Set the function that should be called when generating the source
    * code from events.
@@ -273,6 +290,7 @@ class GD_CORE_API ExpressionMetadata {
   gd::String smallIconFilename;
   gd::String extensionNamespace;
   bool isPrivate;
+  gd::String requiredBaseObjectCapability;
 };
 
 }  // namespace gd

Core/GDCore/Extensions/Metadata/InstructionMetadata.cpp

@@ -10,6 +10,7 @@
 #include "GDCore/CommonTools.h"
 #include "GDCore/Serialization/SerializerElement.h"
 #include "GDCore/Tools/Localization.h"
+#include "GDCore/Tools/Log.h"
 #include "ParameterMetadata.h"
 
 namespace gd {
@@ -66,8 +67,9 @@ InstructionMetadata& InstructionMetadata::AddParameter(
           ? (supplementaryInformation.empty()
                  ? ""
                  : extensionNamespace +
-                       supplementaryInformation  //... so prefix it with the extension
-                                           // namespace.
+                       supplementaryInformation  //... so prefix it with the
+                                                 // extension
+                                                 // namespace.
              )
           : supplementaryInformation;  // Otherwise don't change anything
 
@@ -93,32 +95,55 @@ InstructionMetadata& InstructionMetadata::UseStandardOperatorParameters(
     const gd::String& type) {
   SetManipulatedType(type);
 
-  AddParameter("operator", _("Modification's sign"), type);
-  AddParameter(type == "number" ? "expression" : type, _("Value"));
-  size_t operatorParamIndex = parameters.size() - 2;
-  size_t valueParamIndex = parameters.size() - 1;
+  if (type == "boolean") {
+    AddParameter("yesorno", _("New value"));
+    size_t valueParamIndex = parameters.size() - 1;
 
-  if (isObjectInstruction || isBehaviorInstruction) {
-    gd::String templateSentence =
-        _("Change <subject> of _PARAM0_: <operator> <value>");
+    if (isObjectInstruction || isBehaviorInstruction) {
+      gd::String templateSentence = _("Set _PARAM0_ as <subject>: <value>");
 
-    sentence =
-        templateSentence.FindAndReplace("<subject>", sentence)
-            .FindAndReplace(
-                "<operator>",
-                "_PARAM" + gd::String::From(operatorParamIndex) + "_")
-            .FindAndReplace("<value>",
-                            "_PARAM" + gd::String::From(valueParamIndex) + "_");
+      sentence =
+          templateSentence
+              .FindAndReplace("<subject>", sentence)
+              .FindAndReplace("<value>",
+                              "_PARAM" + gd::String::From(valueParamIndex) + "_");
+    } else {
+      gd::String templateSentence = _("Change <subject>: <value>");
+
+      sentence =
+          templateSentence
+              .FindAndReplace("<subject>", sentence)
+              .FindAndReplace("<value>",
+                              "_PARAM" + gd::String::From(valueParamIndex) + "_");
+    }
   } else {
-    gd::String templateSentence = _("Change <subject>: <operator> <value>");
+    AddParameter("operator", _("Modification's sign"), type);
+    AddParameter(type == "number" ? "expression" : type, _("Value"));
 
-    sentence =
-        templateSentence.FindAndReplace("<subject>", sentence)
-            .FindAndReplace(
-                "<operator>",
-                "_PARAM" + gd::String::From(operatorParamIndex) + "_")
-            .FindAndReplace("<value>",
-                            "_PARAM" + gd::String::From(valueParamIndex) + "_");
+    size_t operatorParamIndex = parameters.size() - 2;
+    size_t valueParamIndex = parameters.size() - 1;
+
+    if (isObjectInstruction || isBehaviorInstruction) {
+      gd::String templateSentence = _("Change <subject> of _PARAM0_: <operator> <value>");
+
+      sentence =
+          templateSentence.FindAndReplace("<subject>", sentence)
+              .FindAndReplace(
+                  "<operator>",
+                  "_PARAM" + gd::String::From(operatorParamIndex) + "_")
+              .FindAndReplace("<value>",
+                              "_PARAM" + gd::String::From(valueParamIndex) + "_");
+    } else {
+      gd::String templateSentence = _("Change <subject>: <operator> <value>");
+
+      sentence =
+          templateSentence.FindAndReplace("<subject>", sentence)
+              .FindAndReplace(
+                  "<operator>",
+                  "_PARAM" + gd::String::From(operatorParamIndex) + "_")
+              .FindAndReplace("<value>",
+                              "_PARAM" + gd::String::From(valueParamIndex) + "_");
+    }
   }
 
   return *this;
@@ -129,34 +154,62 @@ InstructionMetadata::UseStandardRelationalOperatorParameters(
     const gd::String& type) {
   SetManipulatedType(type);
 
-  AddParameter("relationalOperator", _("Sign of the test"), type);
-  AddParameter(type == "number" ? "expression" : type, _("Value to compare"));
-  size_t operatorParamIndex = parameters.size() - 2;
-  size_t valueParamIndex = parameters.size() - 1;
+  if (type == "boolean") {
+    if (isObjectInstruction || isBehaviorInstruction) {
+      gd::String templateSentence = _("_PARAM0_ is <subject>");
 
-  if (isObjectInstruction || isBehaviorInstruction) {
-    gd::String templateSentence = _("<subject> of _PARAM0_ <operator> <value>");
+      sentence =
+          templateSentence
+              .FindAndReplace("<subject>", sentence);
+    } else {
+      gd::String templateSentence = _("<subject>");
 
-    sentence =
-        templateSentence.FindAndReplace("<subject>", sentence)
-            .FindAndReplace(
-                "<operator>",
-                "_PARAM" + gd::String::From(operatorParamIndex) + "_")
-            .FindAndReplace("<value>",
-                            "_PARAM" + gd::String::From(valueParamIndex) + "_");
+      sentence =
+          templateSentence.FindAndReplace("<subject>", sentence);
+    }
   } else {
-    gd::String templateSentence = _("<subject> <operator> <value>");
+    AddParameter("relationalOperator", _("Sign of the test"), type);
+    AddParameter(type == "number" ? "expression" : type, _("Value to compare"));
+    size_t operatorParamIndex = parameters.size() - 2;
+    size_t valueParamIndex = parameters.size() - 1;
 
-    sentence =
-        templateSentence.FindAndReplace("<subject>", sentence)
-            .FindAndReplace(
-                "<operator>",
-                "_PARAM" + gd::String::From(operatorParamIndex) + "_")
-            .FindAndReplace("<value>",
-                            "_PARAM" + gd::String::From(valueParamIndex) + "_");
+    if (isObjectInstruction || isBehaviorInstruction) {
+      gd::String templateSentence = _("<subject> of _PARAM0_ <operator> <value>");
+
+      sentence =
+          templateSentence.FindAndReplace("<subject>", sentence)
+              .FindAndReplace(
+                  "<operator>",
+                  "_PARAM" + gd::String::From(operatorParamIndex) + "_")
+              .FindAndReplace("<value>",
+                              "_PARAM" + gd::String::From(valueParamIndex) + "_");
+    } else {
+      gd::String templateSentence = _("<subject> <operator> <value>");
+
+      sentence =
+          templateSentence.FindAndReplace("<subject>", sentence)
+              .FindAndReplace(
+                  "<operator>",
+                  "_PARAM" + gd::String::From(operatorParamIndex) + "_")
+              .FindAndReplace("<value>",
+                              "_PARAM" + gd::String::From(valueParamIndex) + "_");
+    }
   }
 
   return *this;
 }
 
+InstructionMetadata& InstructionMetadata::SetRequiresBaseObjectCapability(
+    const gd::String& capability) {
+  if (!IsObjectInstruction() && !IsBehaviorInstruction()) {
+    gd::LogError("Tried to add capability \"" + capability +
+                 "\" to instruction named \"" + fullname +
+                 "\", which is not an object or behavior instruction.");
+    return *this;
+  }
+
+  requiredBaseObjectCapability = capability;
+  return *this;
+}
+
 }  // namespace gd

Core/GDCore/Extensions/Metadata/InstructionMetadata.h

@@ -138,18 +138,19 @@ class GD_CORE_API InstructionMetadata {
    * \param description Description for parameter
    * \param supplementaryInformation Additional information that can be used for
    * rendering or logic. For example:
-   * - If type is "object", this argument will describe which objects are allowed.
-   * If this argument is empty, all objects are allowed.
-   * - If type is "operator", this argument will be used to display only pertinent operators.
-   * \param parameterIsOptional true if the parameter must be optional, false
-   * otherwise.
+   * - If type is "object", this argument will describe which objects are
+   * allowed. If this argument is empty, all objects are allowed.
+   * - If type is "operator", this argument will be used to display only
+   * pertinent operators. \param parameterIsOptional true if the parameter must
+   * be optional, false otherwise.
    *
    * \see EventsCodeGenerator::GenerateParametersCodes
    */
-  InstructionMetadata &AddParameter(const gd::String &type,
-                                    const gd::String &label,
-                                    const gd::String &supplementaryInformation = "",
-                                    bool parameterIsOptional = false);
+  InstructionMetadata &AddParameter(
+      const gd::String &type,
+      const gd::String &label,
+      const gd::String &supplementaryInformation = "",
+      bool parameterIsOptional = false);
 
   /**
    * \brief Add a parameter not displayed in editor.
@@ -197,8 +198,7 @@ class GD_CORE_API InstructionMetadata {
    * \see AddParameter
    */
   InstructionMetadata &SetParameterExtraInfo(const gd::String &extraInfo) {
-    if (!parameters.empty())
-      parameters.back().SetExtraInfo(extraInfo);
+    if (!parameters.empty()) parameters.back().SetExtraInfo(extraInfo);
     return *this;
   };
 
@@ -236,16 +236,29 @@ class GD_CORE_API InstructionMetadata {
   /**
    * \brief Check if the instruction is an object instruction.
    */
-  bool IsObjectInstruction() const {
-    return isObjectInstruction;
-  }
+  bool IsObjectInstruction() const { return isObjectInstruction; }
 
   /**
    * \brief Check if the instruction is a behavior instruction.
    */
-  bool IsBehaviorInstruction() const {
-    return isBehaviorInstruction;
-  }
+  bool IsBehaviorInstruction() const { return isBehaviorInstruction; }
+
+  /**
+   * \brief Mark this (object) instruction as requiring the specified
+   * capability, offered by the base object. This is useful for some objects
+   * that don't support this capability, so that the editor can hide the
+   * instruction as it does not apply to them.
+   */
+  InstructionMetadata &SetRequiresBaseObjectCapability(
+      const gd::String &capability);
+
+  /**
+   * \brief Get the required specified capability for this (object) instruction,
+   * or an empty string if there is nothing specific required.
+   */
+  const gd::String &GetRequiredBaseObjectCapability() const {
+    return requiredBaseObjectCapability;
+  };
 
   /**
    * \brief Consider that the instruction is easy for a user to understand.
@@ -450,6 +463,7 @@ class GD_CORE_API InstructionMetadata {
   bool isPrivate;
   bool isObjectInstruction;
   bool isBehaviorInstruction;
+  gd::String requiredBaseObjectCapability;
 };
 
 }  // namespace gd

Core/GDCore/Extensions/Metadata/InstructionOrExpressionGroupMetadata.h

@@ -0,0 +1,31 @@
+/*
+ * GDevelop Core
+ * Copyright 2008-2022 Florian Rival (Florian.Rival@gmail.com). All rights
+ * reserved. This project is released under the MIT License.
+ */
+#pragma once
+#include "GDCore/String.h"
+
+namespace gd {
+/**
+ * \brief Contains information about how to display a group of instructions
+ * to the user.
+ */
+class GD_CORE_API InstructionOrExpressionGroupMetadata {
+ public:
+  InstructionOrExpressionGroupMetadata(){};
+
+  /**
+   * \brief Sets the icon shown to users.
+   */
+  InstructionOrExpressionGroupMetadata& SetIcon(const gd::String& icon_) {
+    icon = icon_;
+    return *this;
+  };
+
+  const gd::String& GetIcon() const { return icon; };
+
+ private:
+  gd::String icon;
+};
+}  // namespace gd

Core/GDCore/Extensions/Metadata/MultipleInstructionMetadata.h

@@ -31,6 +31,11 @@ class GD_CORE_API MultipleInstructionMetadata {
       gd::InstructionMetadata &action) {
     return MultipleInstructionMetadata(expression, condition, action);
   }
+  static MultipleInstructionMetadata WithConditionAndAction(
+      gd::InstructionMetadata &condition,
+      gd::InstructionMetadata &action) {
+    return MultipleInstructionMetadata(condition, action);
+  }
 
   /**
    * \see gd::InstructionMetadata::AddParameter
@@ -96,6 +101,17 @@ class GD_CORE_API MultipleInstructionMetadata {
     return *this;
   };
 
+  /**
+   * \see gd::InstructionMetadata::SetRequiresBaseObjectCapability
+   */
+  MultipleInstructionMetadata &SetRequiresBaseObjectCapability(
+      const gd::String &capability) {
+    if (expression) expression->SetRequiresBaseObjectCapability(capability);
+    if (condition) condition->SetRequiresBaseObjectCapability(capability);
+    if (action) action->SetRequiresBaseObjectCapability(capability);
+    return *this;
+  }
+
   /**
    * \see gd::InstructionMetadata::UseStandardOperatorParameters
    * \see gd::InstructionMetadata::UseStandardRelationalOperatorParameters
@@ -179,6 +195,9 @@ class GD_CORE_API MultipleInstructionMetadata {
                               gd::InstructionMetadata &condition_,
                               gd::InstructionMetadata &action_)
       : expression(&expression_), condition(&condition_), action(&action_){};
+  MultipleInstructionMetadata(gd::InstructionMetadata &condition_,
+                              gd::InstructionMetadata &action_)
+      : expression(nullptr), condition(&condition_), action(&action_){};
 
   gd::ExpressionMetadata *expression;
   gd::InstructionMetadata *condition;

Core/GDCore/Extensions/Metadata/ObjectMetadata.cpp

@@ -261,23 +261,14 @@ ObjectMetadata::AddExpressionAndConditionAndAction(
     const gd::String& sentenceName,
     const gd::String& group,
     const gd::String& icon) {
-  gd::String expressionDescriptionTemplate = _("Return <subject>.");
-  auto& expression =
-      type == "number"
-          ? AddExpression(name,
-                          fullname,
-                          expressionDescriptionTemplate.FindAndReplace(
-                              "<subject>", descriptionSubject),
-                          group,
-                          icon)
-          : AddStrExpression(name,
-                             fullname,
-                             expressionDescriptionTemplate.FindAndReplace(
-                                 "<subject>", descriptionSubject),
-                             group,
-                             icon);
+  if (type != "number" && type != "string" && type != "boolean") {
+    gd::LogError(
+        "Unrecognised type passed to AddExpressionAndConditionAndAction: " +
+        type + ". Verify this type is valid and supported.");
+  }
 
-  gd::String conditionDescriptionTemplate = _("Compare <subject>.");
+  gd::String conditionDescriptionTemplate =
+      type == "boolean" ? _("Check if <subject>.") : _("Compare <subject>.");
   auto& condition =
       AddScopedCondition(name,
                          fullname,
@@ -288,7 +279,9 @@ ObjectMetadata::AddExpressionAndConditionAndAction(
                          icon,
                          icon);
 
-  gd::String actionDescriptionTemplate = _("Change <subject>.");
+  gd::String actionDescriptionTemplate = type == "boolean"
+                                             ? _("Set (or unset) if <subject>.")
+                                             : _("Change <subject>.");
   auto& action = AddScopedAction(
       "Set" + name,
       fullname,
@@ -298,6 +291,27 @@ ObjectMetadata::AddExpressionAndConditionAndAction(
       icon,
       icon);
 
+
+  if (type == "boolean") {
+    return MultipleInstructionMetadata::WithConditionAndAction(condition, action);
+  }
+
+  gd::String expressionDescriptionTemplate = _("Return <subject>.");
+  auto& expression =
+      type == "number"
+          ? AddExpression(name,
+                          fullname,
+                          expressionDescriptionTemplate.FindAndReplace(
+                              "<subject>", descriptionSubject),
+                          group,
+                          icon)
+          : AddStrExpression(name,
+                            fullname,
+                            expressionDescriptionTemplate.FindAndReplace(
+                                "<subject>", descriptionSubject),
+                            group,
+                            icon);
+
   return MultipleInstructionMetadata::WithExpressionAndConditionAndAction(
       expression, condition, action);
 }

Core/GDCore/Extensions/Metadata/ObjectMetadata.h

@@ -7,6 +7,7 @@
 #define OBJECTMETADATA_H
 #include <functional>
 #include <map>
+#include <set>
 #include <memory>
 
 #include "GDCore/Extensions/Metadata/ExpressionMetadata.h"
@@ -200,13 +201,48 @@ class GD_CORE_API ObjectMetadata {
     return *this;
   }
 
+  /**
+   * \brief Set the (user friendly) name of the group this object must
+   * be categorised in.
+   */
+  ObjectMetadata& SetCategoryFullName(const gd::String& categoryFullName_) {
+    categoryFullName = categoryFullName_;
+    return *this;
+  }
+
+  /**
+   * \brief The "capabilities" that are offered by the base object that are
+   * *not* supported by this object, and should be hidden in the editor
+   * inferface.
+   */
+  const std::set<gd::String>& GetUnsupportedBaseObjectCapabilities() const {
+    return unsupportedBaseObjectCapabilities;
+  }
+
+  /**
+   * \brief Add a "capability" that is offered by the base object that is *not*
+   * supported by this object, and should be hidden in the editor inferface.
+   */
+  ObjectMetadata& AddUnsupportedBaseObjectCapability(
+      const gd::String& capability) {
+    unsupportedBaseObjectCapabilities.insert(capability);
+    return *this;
+  }
+
+  /**
+   * \brief Check if a "capability" that is offered by the base object is *not*
+   * supported by this object, and should be hidden in the editor inferface.
+   */
+  bool IsUnsupportedBaseObjectCapability(const gd::String& capability) const {
+    return unsupportedBaseObjectCapabilities.find(capability) != unsupportedBaseObjectCapabilities.end();
+  }
+
   const gd::String& GetName() const { return name; }
-#if defined(GD_IDE_ONLY)
   const gd::String& GetFullName() const { return fullname; }
+  const gd::String& GetCategoryFullName() const { return categoryFullName; }
   const gd::String& GetHelpUrl() const { return helpUrl; }
   const gd::String& GetDescription() const { return description; }
   const gd::String& GetIconFilename() const { return iconFilename; }
-#endif
 
   /**
    * \brief Set the URL pointing to the help page about this object
@@ -227,7 +263,27 @@ class GD_CORE_API ObjectMetadata {
    */
   ObjectMetadata& AddIncludeFile(const gd::String& includeFile);
 
-#if defined(GD_IDE_ONLY)
+  /**
+   * \brief Return a reference to a map containing the names of the actions
+   * (as keys) and the metadata associated with (as values).
+   */
+  std::map<gd::String, gd::InstructionMetadata>& GetAllActions() { return actionsInfos; };
+
+  /**
+   * \see gd::PlatformExtension::GetAllActions
+   */
+  std::map<gd::String, gd::InstructionMetadata>& GetAllConditions() { return conditionsInfos; };
+
+  /**
+   * \see gd::PlatformExtension::GetAllActions
+   */
+  std::map<gd::String, gd::ExpressionMetadata>& GetAllExpressions() { return expressionsInfos; };
+
+  /**
+   * \see gd::PlatformExtension::GetAllActions
+   */
+  std::map<gd::String, gd::ExpressionMetadata>& GetAllStrExpressions() { return strExpressionsInfos; };
+
   std::map<gd::String, gd::InstructionMetadata> conditionsInfos;
   std::map<gd::String, gd::InstructionMetadata> actionsInfos;
   std::map<gd::String, gd::ExpressionMetadata> expressionsInfos;
@@ -235,19 +291,19 @@ class GD_CORE_API ObjectMetadata {
 
   std::vector<gd::String> includeFiles;
   gd::String className;
-#endif
   CreateFunPtr createFunPtr;
 
  private:
   gd::String extensionNamespace;
   gd::String name;
   gd::String helpPath;
-#if defined(GD_IDE_ONLY)
   gd::String helpUrl;  ///< Deprecated. Use helpPath instead.
   gd::String fullname;
   gd::String description;
   gd::String iconFilename;
-#endif
+  gd::String categoryFullName;
+  std::set<gd::String> unsupportedBaseObjectCapabilities;
+
   std::shared_ptr<gd::Object>
       blueprintObject;  ///< The "blueprint" object to be copied when a new
                         ///< object is asked. Can be null in case a creation

Core/GDCore/Extensions/Platform.cpp

@@ -4,6 +4,7 @@
  * reserved. This project is released under the MIT License.
  */
 #include "Platform.h"
+
 #include "GDCore/Extensions/PlatformExtension.h"
 #include "GDCore/Project/Object.h"
 #include "GDCore/String.h"
@@ -14,16 +15,21 @@ using namespace std;
 
 namespace gd {
 
-Platform::Platform(): enableExtensionLoadingLogs(false) {}
+InstructionOrExpressionGroupMetadata
+    Platform::badInstructionOrExpressionGroupMetadata;
+
+Platform::Platform() : enableExtensionLoadingLogs(false) {}
 
 Platform::~Platform() {}
 
 bool Platform::AddExtension(std::shared_ptr<gd::PlatformExtension> extension) {
   if (!extension) return false;
 
-  if (enableExtensionLoadingLogs) std::cout << "Loading " << extension->GetName() << "...";
+  if (enableExtensionLoadingLogs)
+    std::cout << "Loading " << extension->GetName() << "...";
   if (IsExtensionLoaded(extension->GetName())) {
-    if (enableExtensionLoadingLogs) std::cout << " (replacing existing extension)";
+    if (enableExtensionLoadingLogs)
+      std::cout << " (replacing existing extension)";
     RemoveExtension(extension->GetName());
   }
   if (enableExtensionLoadingLogs) std::cout << std::endl;
@@ -38,6 +44,11 @@ bool Platform::AddExtension(std::shared_ptr<gd::PlatformExtension> extension) {
         extension->GetObjectCreationFunctionPtr(objectsTypes[i]);
   }
 
+  for (const auto& it :
+       extension->GetAllInstructionOrExpressionGroupMetadata()) {
+    instructionOrExpressionGroupMetadata[it.first] = it.second;
+  }
+
   return true;
 }
 

Core/GDCore/Extensions/Platform.h

@@ -9,8 +9,9 @@
 #include <map>
 #include <memory>
 #include <vector>
-#include "GDCore/String.h"
 
+#include "GDCore/Extensions/Metadata/InstructionOrExpressionGroupMetadata.h"
+#include "GDCore/String.h"
 namespace gd {
 class InstructionsMetadataHolder;
 class Project;
@@ -52,7 +53,6 @@ class GD_CORE_API Platform {
    */
   virtual gd::String GetFullName() const { return "Unnamed platform"; }
 
-#if defined(GD_IDE_ONLY)
   /**
    * \brief Must return a text describing the platform in a few words.
    */
@@ -67,7 +67,6 @@ class GD_CORE_API Platform {
    * \brief Must return a filename to a 32*32 image file for the platform.
    */
   virtual gd::String GetIcon() const { return ""; }
-#endif
 
   /** \name Extensions management
    * Member functions used to manage the extensions
@@ -123,6 +122,19 @@ class GD_CORE_API Platform {
    * anymore.
    */
   virtual void RemoveExtension(const gd::String& name);
+
+  /**
+   * \brief Get the metadata (icon, etc...) of a group used for instructions or
+   * expressions.
+   */
+  const InstructionOrExpressionGroupMetadata& GetInstructionOrExpressionGroupMetadata(
+      const gd::String& name) const {
+    auto it = instructionOrExpressionGroupMetadata.find(name);
+    if (it == instructionOrExpressionGroupMetadata.end())
+      return badInstructionOrExpressionGroupMetadata;
+
+    return it->second;
+  }
   ///@}
 
   /** \name Factory method
@@ -137,7 +149,6 @@ class GD_CORE_API Platform {
   std::unique_ptr<gd::Object> CreateObject(gd::String type,
                                            const gd::String& name) const;
 
-#if defined(GD_IDE_ONLY)
   /**
    * \brief Create an event of given type
    */
@@ -149,28 +160,18 @@ class GD_CORE_API Platform {
    * \brief Activate or disable the logs on the standard output when
    * loading an extension.
    */
-  void EnableExtensionLoadingLogs(bool enable) { enableExtensionLoadingLogs = enable; };
-
-  /**
-   * \brief Called when the IDE is about to shut down: Take this opportunity for
-   * erasing for example any temporary file.
-   * @deprecated This should be removed.
-   */
-  virtual void OnIDEClosed(){};
-
-  /**
-   * \brief Called when the IDE is initialized and ready to be used.
-   * @deprecated This should be removed.
-   */
-  virtual void OnIDEInitialized(){};
-
-#endif
+  void EnableExtensionLoadingLogs(bool enable) {
+    enableExtensionLoadingLogs = enable;
+  };
 
  private:
   std::vector<std::shared_ptr<PlatformExtension>>
       extensionsLoaded;  ///< Extensions of the platform
   std::map<gd::String, CreateFunPtr>
       creationFunctionTable;  ///< Creation functions for objects
+  std::map<gd::String, InstructionOrExpressionGroupMetadata>
+      instructionOrExpressionGroupMetadata;
+  static InstructionOrExpressionGroupMetadata badInstructionOrExpressionGroupMetadata;
   bool enableExtensionLoadingLogs;
 };
 

Core/GDCore/Extensions/PlatformExtension.cpp

@@ -165,6 +165,40 @@ PlatformExtension::AddExpressionAndConditionAndAction(
     const gd::String& sentenceName,
     const gd::String& group,
     const gd::String& icon) {
+  if (type != "number" && type != "string" && type != "boolean") {
+    gd::LogError(
+        "Unrecognised type passed to AddExpressionAndConditionAndAction: " +
+        type + ". Verify this type is valid and supported.");
+  }
+
+  gd::String conditionDescriptionTemplate =
+      type == "boolean" ? _("Check if <subject>.") : _("Compare <subject>.");
+  auto& condition = AddCondition(name,
+                                 fullname,
+                                 conditionDescriptionTemplate.FindAndReplace(
+                                     "<subject>", descriptionSubject),
+                                 sentenceName,
+                                 group,
+                                 icon,
+                                 icon);
+
+  gd::String actionDescriptionTemplate = type == "boolean"
+                                             ? _("Set (or unset) if <subject>.")
+                                             : _("Change <subject>.");
+  auto& action = AddAction(
+      "Set" + name,
+      fullname,
+      actionDescriptionTemplate.FindAndReplace("<subject>", descriptionSubject),
+      sentenceName,
+      group,
+      icon,
+      icon);
+
+  if (type == "boolean") {
+    return MultipleInstructionMetadata::WithConditionAndAction(condition,
+                                                               action);
+  }
+
   gd::String expressionDescriptionTemplate = _("Return <subject>.");
   auto& expression =
       type == "number"
@@ -175,32 +209,11 @@ PlatformExtension::AddExpressionAndConditionAndAction(
                           group,
                           icon)
           : AddStrExpression(name,
-                             fullname,
-                             expressionDescriptionTemplate.FindAndReplace(
-                                 "<subject>", descriptionSubject),
-                             group,
-                             icon);
-
-  gd::String conditionDescriptionTemplate = _("Compare <subject>.");
-  auto& condition = AddCondition(name,
-                                 fullname,
-                                 conditionDescriptionTemplate.FindAndReplace(
-                                     "<subject>", descriptionSubject),
-                                 sentenceName,
-                                 group,
-                                 icon,
-                                 icon);
-
-  // TODO: update the checks
-  gd::String actionDescriptionTemplate = _("Change <subject>.");
-  auto& action = AddAction(
-      "Set" + name,
-      fullname,
-      actionDescriptionTemplate.FindAndReplace("<subject>", descriptionSubject),
-      sentenceName,
-      group,
-      icon,
-      icon);
+                              fullname,
+                              expressionDescriptionTemplate.FindAndReplace(
+                                  "<subject>", descriptionSubject),
+                              group,
+                              icon);
 
   return MultipleInstructionMetadata::WithExpressionAndConditionAndAction(
       expression, condition, action);
@@ -372,9 +385,13 @@ gd::InstructionMetadata& PlatformExtension::AddDuplicatedAction(
 }
 
 gd::InstructionMetadata& PlatformExtension::AddDuplicatedCondition(
-    const gd::String& newConditionName, const gd::String& copiedConditionName) {
-  gd::String newNameWithNamespace = GetNameSpace() + newConditionName;
-  gd::String copiedNameWithNamespace = GetNameSpace() + copiedConditionName;
+    const gd::String& newConditionName,
+    const gd::String& copiedConditionName,
+    gd::DuplicatedInstructionOptions options) {
+  gd::String newNameWithNamespace =
+      (options.unscoped ? "" : GetNameSpace()) + newConditionName;
+  gd::String copiedNameWithNamespace =
+      (options.unscoped ? "" : GetNameSpace()) + copiedConditionName;
 
   auto copiedCondition = conditionsInfos.find(copiedNameWithNamespace);
   if (copiedCondition == conditionsInfos.end()) {
@@ -512,7 +529,8 @@ PlatformExtension::GetAllStrExpressionsForBehavior(gd::String autoType) {
   return badExpressionsMetadata;
 }
 
-gd::BaseEventSPtr PlatformExtension::CreateEvent(const gd::String& eventType) const {
+gd::BaseEventSPtr PlatformExtension::CreateEvent(
+    const gd::String& eventType) const {
   if (eventsInfos.find(eventType) != eventsInfos.end()) {
     if (eventsInfos.find(eventType)->second.instance ==
         std::shared_ptr<BaseEvent>()) {
@@ -754,7 +772,8 @@ void PlatformExtension::StripUnimplementedInstructionsAndExpressions() {
 }
 #endif
 
-PlatformExtension::PlatformExtension() : deprecated(false) {}
+PlatformExtension::PlatformExtension()
+    : deprecated(false), category(_("General")) {}
 
 PlatformExtension::~PlatformExtension() {}
 

Core/GDCore/Extensions/PlatformExtension.h

@@ -5,8 +5,7 @@
  * project is released under the MIT License.
  */
 
-#ifndef GDCORE_PLATFORMEXTENSION_H
-#define GDCORE_PLATFORMEXTENSION_H
+#pragma once
 #include <map>
 #include <memory>
 #include <vector>
@@ -16,6 +15,7 @@
 #include "GDCore/Extensions/Metadata/DependencyMetadata.h"
 #include "GDCore/Extensions/Metadata/EffectMetadata.h"
 #include "GDCore/Extensions/Metadata/EventMetadata.h"
+#include "GDCore/Extensions/Metadata/InstructionOrExpressionGroupMetadata.h"
 #include "GDCore/Extensions/Metadata/ObjectMetadata.h"
 #include "GDCore/Project/PropertyDescriptor.h"
 #include "GDCore/String.h"
@@ -71,6 +71,10 @@ class GD_CORE_API CompilationInfo {
   int sizeOfpInt;
 };
 
+struct GD_CORE_API DuplicatedInstructionOptions {
+  bool unscoped;
+};
+
 /**
  * \brief Base class for implementing platform's extensions.
  *
@@ -105,10 +109,18 @@ class GD_CORE_API PlatformExtension {
     return *this;
   }
 
+  /**
+   * \brief Set the category of the extension.
+   */
+  PlatformExtension& SetCategory(const gd::String& category_) {
+    category = category_;
+    return *this;
+  }
+
   /**
    * \brief Set the path to the help, relative to the GDevelop documentation
    * root. For example, "/all-features/collisions" for
-   * "http://wiki.compilgames.net/doku.php/gdevelop5/all-features/collisions".
+   * "https://wiki.gdevelop.io/gdevelop5/all-features/collisions".
    *
    * The instructions, objects and behaviors will have this help path set by
    * default, unless you call SetHelpPath on them.
@@ -271,7 +283,6 @@ class GD_CORE_API PlatformExtension {
                               const gd::String& smallicon_,
                               std::shared_ptr<gd::BaseEvent> instance);
 
-#if defined(GD_IDE_ONLY)
   /**
    * \brief Create a new action which is the duplicate of the specified one.
    *
@@ -288,7 +299,8 @@ class GD_CORE_API PlatformExtension {
    */
   gd::InstructionMetadata& AddDuplicatedCondition(
       const gd::String& newConditionName,
-      const gd::String& copiedConditionName);
+      const gd::String& copiedConditionName,
+      gd::DuplicatedInstructionOptions options = {.unscoped = false});
   /**
    * \brief Create a new expression which is the duplicate of the specified one.
    *
@@ -315,7 +327,15 @@ class GD_CORE_API PlatformExtension {
   gd::PropertyDescriptor& RegisterProperty(const gd::String& name) {
     return extensionPropertiesMetadata[name];
   };
-#endif
+
+  /**
+   * \brief Add some metadata (icon, etc...) for a group used for instructions
+   * or expressions.
+   */
+  InstructionOrExpressionGroupMetadata& AddInstructionOrExpressionGroupMetadata(
+      const gd::String& name) {
+    return instructionOrExpressionGroupMetadata[name];
+  }
 
   /**
    * \brief Delete all instructions having no function name or custom code
@@ -339,6 +359,11 @@ class GD_CORE_API PlatformExtension {
    */
   const gd::String& GetName() const { return name; }
 
+  /**
+   * \brief Return the category of the extension
+   */
+  const gd::String& GetCategory() const { return category; }
+
   /**
    * \brief Return a description of the extension
    */
@@ -452,7 +477,6 @@ class GD_CORE_API PlatformExtension {
    */
   std::map<gd::String, gd::EventMetadata>& GetAllEvents();
 
-#if defined(GD_IDE_ONLY)
   /**
    * \brief Return a reference to a map containing the names of the actions
    * (as keys) and the metadata associated with (as values).
@@ -537,8 +561,16 @@ class GD_CORE_API PlatformExtension {
   std::map<gd::String, gd::PropertyDescriptor>& GetAllProperties() {
     return extensionPropertiesMetadata;
   }
+
+  /**
+   * \brief Get the metadata (icon, etc...) for groups used for instructions
+   * or expressions.
+   */
+  const std::map<gd::String, InstructionOrExpressionGroupMetadata>&
+  GetAllInstructionOrExpressionGroupMetadata() const {
+    return instructionOrExpressionGroupMetadata;
+  }
   ///@}
-#endif
 
   /**
    * \brief Return the name of all the extensions which are considered provided
@@ -566,6 +598,7 @@ class GD_CORE_API PlatformExtension {
                   ///< actions/conditions/expressions/objects/behavior/event.
   gd::String fullname;      ///< Name displayed to users in the editor.
   gd::String informations;  ///< Description displayed to users in the editor.
+  gd::String category;
   gd::String author;        ///< Author displayed to users in the editor.
   gd::String license;       ///< License name displayed to users in the editor.
   bool deprecated;  ///< true if the extension is deprecated and shouldn't be
@@ -577,7 +610,6 @@ class GD_CORE_API PlatformExtension {
   std::map<gd::String, gd::ObjectMetadata> objectsInfos;
   std::map<gd::String, gd::BehaviorMetadata> behaviorsInfo;
   std::map<gd::String, gd::EffectMetadata> effectsMetadata;
-#if defined(GD_IDE_ONLY)
   std::map<gd::String, gd::InstructionMetadata> conditionsInfos;
   std::map<gd::String, gd::InstructionMetadata> actionsInfos;
   std::map<gd::String, gd::ExpressionMetadata> expressionsInfos;
@@ -585,12 +617,12 @@ class GD_CORE_API PlatformExtension {
   std::vector<gd::DependencyMetadata> extensionDependenciesMetadata;
   std::map<gd::String, gd::EventMetadata> eventsInfos;
   std::map<gd::String, gd::PropertyDescriptor> extensionPropertiesMetadata;
-#endif
+  std::map<gd::String, InstructionOrExpressionGroupMetadata>
+      instructionOrExpressionGroupMetadata;
 
   ObjectMetadata badObjectMetadata;
   BehaviorMetadata badBehaviorMetadata;
   EffectMetadata badEffectMetadata;
-#if defined(GD_IDE_ONLY)
   static std::map<gd::String, gd::InstructionMetadata>
       badConditionsMetadata;  ///< Used when a condition is not found in the
                               ///< extension
@@ -600,12 +632,10 @@ class GD_CORE_API PlatformExtension {
   static std::map<gd::String, gd::ExpressionMetadata>
       badExpressionsMetadata;  ///< Used when an expression is not found in the
                                ///< extension
-#endif
 };
 
 }  // namespace gd
 
-#if defined(GD_IDE_ONLY)
 /** \brief Macro used by extensions in their constructor to declare how they
  * have been compiled. \see gd::CompilationInfo
  */
@@ -619,23 +649,5 @@ class GD_CORE_API PlatformExtension {
   compilationInfo.gccMinorVersion = __GNUC_MINOR__;     \
   compilationInfo.gccPatchLevel = __GNUC_PATCHLEVEL__;  \
   compilationInfo.informationCompleted = true;
-#else
-/** \brief Macro used by extensions in their constructor to declare how they
- * have been compiled. \see gd::CompilationInfo
- */
-#define GD_COMPLETE_EXTENSION_COMPILATION_INFORMATION() \
-  compilationInfo.runtimeOnly = true;                   \
-  compilationInfo.sfmlMajorVersion = 2;                 \
-  compilationInfo.sfmlMinorVersion = 0;                 \
-  compilationInfo.gdCoreVersion = GD_VERSION_STRING;    \
-  compilationInfo.sizeOfpInt = sizeof(int*);            \
-  compilationInfo.gccMajorVersion = __GNUC__;           \
-  compilationInfo.gccMinorVersion = __GNUC_MINOR__;     \
-  compilationInfo.gccPatchLevel = __GNUC_PATCHLEVEL__;  \
-  compilationInfo.informationCompleted = true;
-
-#endif
 
 #include "GDCore/Extensions/PlatformExtension.inl"
-
-#endif  // GDCORE_PLATFORMEXTENSION_H

Core/GDCore/IDE/Events/EventsPositionFinder.cpp

@@ -0,0 +1,27 @@
+#include "GDCore/IDE/Events/EventsPositionFinder.h"
+
+#include <map>
+#include <memory>
+#include <vector>
+
+#include "GDCore/Events/Event.h"
+#include "GDCore/Events/EventsList.h"
+#include "GDCore/String.h"
+
+namespace gd {
+class BaseEvent;
+class EventsList;
+}  // namespace gd
+
+namespace gd {
+bool EventsPositionFinder::DoVisitEvent(gd::BaseEvent& event) {
+  auto it = std::find(searchedEvents.begin(), searchedEvents.end(), &event);
+  if (it != searchedEvents.end()) {
+    positions[it - searchedEvents.begin()] = index;
+  }
+  index++;
+  return false;
+}
+EventsPositionFinder::~EventsPositionFinder() {}
+
+}  // namespace gd

Core/GDCore/IDE/Events/EventsPositionFinder.h

@@ -0,0 +1,48 @@
+#ifndef EventsPositionFinder_H
+#define EventsPositionFinder_H
+#include "GDCore/Events/EventsList.h"
+#include "GDCore/IDE/Events/ArbitraryEventsWorker.h"
+#include "GDCore/String.h"
+
+namespace gd {
+class BaseEvent;
+class EventsList;
+}  // namespace gd
+
+namespace gd {
+
+/**
+ * \brief Scans an event list to retrieve the position of a list of searched
+ * events when the events list is flattened.
+ *
+ * \ingroup IDE
+ */
+class GD_CORE_API EventsPositionFinder : public ArbitraryEventsWorker {
+ public:
+  EventsPositionFinder() : index(0){};
+  virtual ~EventsPositionFinder();
+
+  /**
+   * Return the positions of all searched events
+   */
+  const std::vector<std::size_t>& GetPositions() const { return positions; }
+
+  /**
+   * Add an event for which the position must be reported in `GetPositions`.
+   */
+  void AddEventToSearch(gd::BaseEvent* event) {
+    searchedEvents.push_back(event);
+    positions.push_back(gd::String::npos);
+  }
+
+ private:
+  bool DoVisitEvent(gd::BaseEvent& event) override;
+
+  std::vector<gd::BaseEvent*> searchedEvents;
+  std::vector<std::size_t> positions;
+  std::size_t index;
+};
+
+}  // namespace gd
+
+#endif  // EventsPositionFinder_H

Core/GDCore/IDE/Events/ExpressionsParameterMover.cpp

@@ -95,7 +95,7 @@ class GD_CORE_API ExpressionParameterMover
         // Move parameter of an object function
         const gd::String& thisObjectType = gd::GetTypeOfObject(
             globalObjectsContainer, objectsContainer, node.objectName);
-        if (thisObjectType == behaviorType) {
+        if (thisObjectType == objectType) {
           moveParameter(node.parameters);
           hasDoneMoving = true;
         }

Core/GDCore/IDE/PlatformManager.cpp

@@ -33,11 +33,4 @@ gd::Platform* PlatformManager::GetPlatform(
   return NULL;
 }
 
-void PlatformManager::NotifyPlatformIDEInitialized() const {
-  for (std::size_t i = 0; i < platformsLoaded.size(); ++i) {
-    if (platformsLoaded[i] != std::shared_ptr<gd::Platform>())
-      platformsLoaded[i]->OnIDEInitialized();
-  }
-}
-
 }  // namespace gd

Core/GDCore/IDE/PlatformManager.h

@@ -43,12 +43,6 @@ class GD_CORE_API PlatformManager {
     return platformsLoaded;
   };
 
-  /**
-   * \brief Notify each platform that the IDE is ready, by calling their
-   * OnIDEInitialized member function.
-   */
-  void NotifyPlatformIDEInitialized() const;
-
   static PlatformManager *Get() {
     if (NULL == _singleton) {
       _singleton = new PlatformManager;
@@ -65,11 +59,6 @@ class GD_CORE_API PlatformManager {
    */
   static void DestroySingleton() {
     if (NULL != _singleton) {
-      for (std::size_t i = 0; i < _singleton->platformsLoaded.size(); ++i) {
-        if (_singleton->platformsLoaded[i] != std::shared_ptr<gd::Platform>())
-          _singleton->platformsLoaded[i]->OnIDEClosed();
-      }
-
       delete _singleton;
       _singleton = NULL;
     }

Core/GDCore/Project/EventsFunctionsExtension.cpp

@@ -33,6 +33,7 @@ void EventsFunctionsExtension::Init(const gd::EventsFunctionsExtension& other) {
   description = other.description;
   name = other.name;
   fullName = other.fullName;
+  category = other.category;
   tags = other.tags;
   author = other.author;
   authorIds = other.authorIds;
@@ -50,6 +51,7 @@ void EventsFunctionsExtension::SerializeTo(SerializerElement& element) const {
   element.SetAttribute("description", description);
   element.SetAttribute("name", name);
   element.SetAttribute("fullName", fullName);
+  element.SetAttribute("category", category);
   if (!originName.empty() || !originIdentifier.empty()) {
     element.AddChild("origin")
         .SetAttribute("name", originName)
@@ -87,6 +89,7 @@ void EventsFunctionsExtension::UnserializeFrom(
   description = element.GetStringAttribute("description");
   name = element.GetStringAttribute("name");
   fullName = element.GetStringAttribute("fullName");
+  category = element.GetStringAttribute("category");
   author = element.GetStringAttribute("author");
   previewIconUrl = element.GetStringAttribute("previewIconUrl");
   iconUrl = element.GetStringAttribute("iconUrl");

Core/GDCore/Project/EventsFunctionsExtension.h

@@ -84,6 +84,12 @@ class GD_CORE_API EventsFunctionsExtension : public EventsFunctionsContainer {
     return *this;
   }
 
+  const gd::String& GetCategory() const { return category; };
+  EventsFunctionsExtension& SetCategory(const gd::String& category_) {
+    category = category_;
+    return *this;
+  }
+
   const std::vector<gd::String>& GetTags() const { return tags; };
   std::vector<gd::String>& GetTags() { return tags; };
 
@@ -238,6 +244,7 @@ class GD_CORE_API EventsFunctionsExtension : public EventsFunctionsContainer {
   gd::String description;
   gd::String name;
   gd::String fullName;
+  gd::String category;
   std::vector<gd::String> tags;
   std::vector<gd::String> authorIds;
   gd::String author;

Core/GDCore/Project/Project.cpp

@@ -495,6 +495,7 @@ void Project::UnserializeFrom(const SerializerElement& element) {
   const SerializerElement& propElement =
       element.GetChild("properties", 0, "Info");
   SetName(propElement.GetChild("name", 0, "Nom").GetValue().GetString());
+  SetDescription(propElement.GetChild("description", 0).GetValue().GetString());
   SetVersion(propElement.GetStringAttribute("version", "1.0.0"));
   SetGameResolutionSize(
       propElement.GetChild("windowWidth", 0, "WindowW").GetValue().GetInt(),
@@ -634,6 +635,7 @@ void Project::UnserializeFrom(const SerializerElement& element) {
         layoutElement.GetStringAttribute("name", "", "nom"), -1);
     layout.UnserializeFrom(*this, layoutElement);
   }
+  SetFirstLayout(element.GetChild("firstLayout").GetStringValue());
 
   externalEvents.clear();
   const SerializerElement& externalEventsElement =
@@ -703,6 +705,7 @@ void Project::SerializeTo(SerializerElement& element) const {
 
   SerializerElement& propElement = element.AddChild("properties");
   propElement.AddChild("name").SetValue(GetName());
+  propElement.AddChild("description").SetValue(GetDescription());
   propElement.SetAttribute("version", GetVersion());
   propElement.AddChild("author").SetValue(GetAuthor());
   propElement.AddChild("windowWidth").SetValue(GetGameResolutionWidth());
@@ -908,6 +911,7 @@ Project& Project::operator=(const Project& other) {
 
 void Project::Init(const gd::Project& game) {
   name = game.name;
+  firstLayout = game.firstLayout;
   version = game.version;
   windowWidth = game.windowWidth;
   windowHeight = game.windowHeight;

Core/GDCore/Project/Project.h

@@ -56,15 +56,25 @@ class GD_CORE_API Project : public ObjectsContainer {
   ///@{
 
   /**
-   * \brief Change project name
+   * \brief Change the project name
    */
   void SetName(const gd::String& name_) { name = name_; };
 
   /**
-   * \brief Get project name
+   * \brief Get the project name
    */
   const gd::String& GetName() const { return name; }
 
+  /**
+   * \brief Change the project description
+   */
+  void SetDescription(const gd::String& description_) { description = description_; };
+
+  /**
+   * \brief Get the project description
+   */
+  const gd::String& GetDescription() const { return description; }
+
   /**
    * \brief Change the version of the project.
    * This can be freely set, but should follow "X.Y.Z" format for compatibility
@@ -73,7 +83,7 @@ class GD_CORE_API Project : public ObjectsContainer {
   void SetVersion(const gd::String& version_) { version = version_; };
 
   /**
-   * \brief Get project version.
+   * \brief Get the project version.
    */
   const gd::String& GetVersion() const { return version; }
 
@@ -83,7 +93,7 @@ class GD_CORE_API Project : public ObjectsContainer {
   void SetAuthor(const gd::String& author_) { author = author_; };
 
   /**
-   * \brief Get project author name.
+   * \brief Get the project author name.
    */
   const gd::String& GetAuthor() const { return author; }
 
@@ -98,14 +108,14 @@ class GD_CORE_API Project : public ObjectsContainer {
   std::vector<gd::String>& GetAuthorIds() { return authorIds; };
 
   /**
-   * \brief Change project package name.
+   * \brief Change the project package name.
    */
   void SetPackageName(const gd::String& packageName_) {
     packageName = packageName_;
   };
 
   /**
-   * \brief Get project package name.
+   * \brief Get the project package name.
    */
   const gd::String& GetPackageName() const { return packageName; }
 
@@ -119,7 +129,7 @@ class GD_CORE_API Project : public ObjectsContainer {
   };
 
   /**
-   * \brief Get project orientation ("default", "landscape", "portrait").
+   * \brief Get the project orientation ("default", "landscape", "portrait").
    */
   const gd::String& GetOrientation() const { return orientation; }
 
@@ -884,6 +894,7 @@ class GD_CORE_API Project : public ObjectsContainer {
   void Init(const gd::Project& project);
 
   gd::String name;            ///< Game name
+  gd::String description;     ///< Game description
   gd::String version;         ///< Game version number (used for some exports)
   unsigned int windowWidth;   ///< Window default width
   unsigned int windowHeight;  ///< Window default height

Core/GDCore/Project/ResourcesManager.cpp

@@ -18,6 +18,16 @@
 #include "GDCore/Tools/Localization.h"
 #include "GDCore/Tools/Log.h"
 
+namespace {
+gd::String NormalizePathSeparator(const gd::String& path) {
+  gd::String normalizedPath = path;
+  while (normalizedPath.find('\\') != gd::String::npos)
+    normalizedPath.replace(normalizedPath.find('\\'), 1, "/");
+
+  return normalizedPath;
+}
+}  // namespace
+
 namespace gd {
 
 gd::String Resource::badStr;
@@ -126,19 +136,20 @@ std::vector<gd::String> ResourcesManager::GetAllResourceNames() const {
 }
 
 std::vector<gd::String> ResourcesManager::FindFilesNotInResources(
-    const std::vector<gd::String>& filesToCheck) const {
-  std::unordered_set<gd::String> resourceFiles;
-  for (const auto& resource: resources) {
-    resourceFiles.insert(resource->GetFile());
+    const std::vector<gd::String>& filePathsToCheck) const {
+  std::unordered_set<gd::String> resourceFilePaths;
+  for (const auto& resource : resources) {
+    resourceFilePaths.insert(NormalizePathSeparator(resource->GetFile()));
   }
 
-  std::vector<gd::String> filesNotInResources;
-  for(const gd::String& file: filesToCheck) {
-    if (resourceFiles.find(file) == resourceFiles.end())
-      filesNotInResources.push_back(file);
+  std::vector<gd::String> filePathsNotInResources;
+  for (const gd::String& file : filePathsToCheck) {
+    gd::String normalizedPath = NormalizePathSeparator(file);
+    if (resourceFilePaths.find(normalizedPath) == resourceFilePaths.end())
+      filePathsNotInResources.push_back(file);
   }
 
-  return filesNotInResources;
+  return filePathsNotInResources;
 }
 
 std::map<gd::String, gd::PropertyDescriptor> Resource::GetProperties() const {
@@ -532,11 +543,7 @@ void ResourcesManager::SerializeTo(SerializerElement& element) const {
 }
 
 void ImageResource::SetFile(const gd::String& newFile) {
-  file = newFile;
-
-  // Convert all backslash to slashs.
-  while (file.find('\\') != gd::String::npos)
-    file.replace(file.find('\\'), 1, "/");
+  file = NormalizePathSeparator(newFile);
 }
 
 void ImageResource::UnserializeFrom(const SerializerElement& element) {
@@ -554,11 +561,7 @@ void ImageResource::SerializeTo(SerializerElement& element) const {
 }
 
 void AudioResource::SetFile(const gd::String& newFile) {
-  file = newFile;
-
-  // Convert all backslash to slashs.
-  while (file.find('\\') != gd::String::npos)
-    file.replace(file.find('\\'), 1, "/");
+  file = NormalizePathSeparator(newFile);
 }
 
 void AudioResource::UnserializeFrom(const SerializerElement& element) {
@@ -576,11 +579,7 @@ void AudioResource::SerializeTo(SerializerElement& element) const {
 }
 
 void FontResource::SetFile(const gd::String& newFile) {
-  file = newFile;
-
-  // Convert all backslash to slashs.
-  while (file.find('\\') != gd::String::npos)
-    file.replace(file.find('\\'), 1, "/");
+  file = NormalizePathSeparator(newFile);
 }
 
 void FontResource::UnserializeFrom(const SerializerElement& element) {
@@ -594,11 +593,7 @@ void FontResource::SerializeTo(SerializerElement& element) const {
 }
 
 void VideoResource::SetFile(const gd::String& newFile) {
-  file = newFile;
-
-  // Convert all backslash to slashs.
-  while (file.find('\\') != gd::String::npos)
-    file.replace(file.find('\\'), 1, "/");
+  file = NormalizePathSeparator(newFile);
 }
 
 void VideoResource::UnserializeFrom(const SerializerElement& element) {
@@ -612,11 +607,7 @@ void VideoResource::SerializeTo(SerializerElement& element) const {
 }
 
 void JsonResource::SetFile(const gd::String& newFile) {
-  file = newFile;
-
-  // Convert all backslash to slashs.
-  while (file.find('\\') != gd::String::npos)
-    file.replace(file.find('\\'), 1, "/");
+  file = NormalizePathSeparator(newFile);
 }
 
 void JsonResource::UnserializeFrom(const SerializerElement& element) {
@@ -649,13 +640,8 @@ bool JsonResource::UpdateProperty(const gd::String& name,
   return true;
 }
 
-
 void BitmapFontResource::SetFile(const gd::String& newFile) {
-  file = newFile;
-
-  // Convert all backslash to slashs.
-  while (file.find('\\') != gd::String::npos)
-    file.replace(file.find('\\'), 1, "/");
+  file = NormalizePathSeparator(newFile);
 }
 
 void BitmapFontResource::UnserializeFrom(const SerializerElement& element) {

Core/GDCore/Project/ResourcesManager.h

@@ -447,7 +447,7 @@ class GD_CORE_API ResourcesManager {
    * \brief Return a list of the files, from the specified input list,
    * that are not used as files by the resources.
    */
-  std::vector<gd::String> FindFilesNotInResources(const std::vector<gd::String>& filesToCheck) const;
+  std::vector<gd::String> FindFilesNotInResources(const std::vector<gd::String>& filePathsToCheck) const;
 
   /**
    * \brief Return a (smart) pointer to a resource.

Core/tests/DummyPlatform.cpp

@@ -14,7 +14,7 @@
 
 class BehaviorWithRequiredBehaviorProperty : public gd::Behavior {
  public:
-  BehaviorWithRequiredBehaviorProperty() {};
+  BehaviorWithRequiredBehaviorProperty(){};
   virtual ~BehaviorWithRequiredBehaviorProperty(){};
   virtual Behavior* Clone() const override {
     return new BehaviorWithRequiredBehaviorProperty(*this);
@@ -25,7 +25,8 @@ class BehaviorWithRequiredBehaviorProperty : public gd::Behavior {
     std::map<gd::String, gd::PropertyDescriptor> properties;
     properties["requiredBehaviorProperty"]
         .SetLabel("A required behavior")
-        .SetValue(behaviorContent.GetStringAttribute("requiredBehaviorProperty"))
+        .SetValue(
+            behaviorContent.GetStringAttribute("requiredBehaviorProperty"))
         .SetType("Behavior")
         .AddExtraInfo("MyExtension::MyBehavior");
     return properties;
@@ -48,7 +49,7 @@ class BehaviorWithRequiredBehaviorProperty : public gd::Behavior {
 class BehaviorWithRequiredBehaviorPropertyRequiringAnotherBehavior
     : public gd::Behavior {
  public:
-  BehaviorWithRequiredBehaviorPropertyRequiringAnotherBehavior() {};
+  BehaviorWithRequiredBehaviorPropertyRequiringAnotherBehavior(){};
   virtual ~BehaviorWithRequiredBehaviorPropertyRequiringAnotherBehavior(){};
   virtual Behavior* Clone() const override {
     return new BehaviorWithRequiredBehaviorPropertyRequiringAnotherBehavior(
@@ -60,7 +61,8 @@ class BehaviorWithRequiredBehaviorPropertyRequiringAnotherBehavior
     std::map<gd::String, gd::PropertyDescriptor> properties;
     properties["requiredBehaviorProperty"]
         .SetLabel("A required behavior")
-        .SetValue(behaviorContent.GetStringAttribute("requiredBehaviorProperty"))
+        .SetValue(
+            behaviorContent.GetStringAttribute("requiredBehaviorProperty"))
         .SetType("Behavior")
         .AddExtraInfo("MyExtension::BehaviorWithRequiredBehaviorProperty");
     return properties;
@@ -87,11 +89,26 @@ void SetupProjectWithDummyPlatform(gd::Project& project,
 
   std::shared_ptr<gd::PlatformExtension> baseObjectExtension =
       std::shared_ptr<gd::PlatformExtension>(new gd::PlatformExtension);
+
+  // Create the base object. All objects "inherits" from it.
   baseObjectExtension->SetExtensionInformation(
       "BuiltinObject", "Base Object dummy extension", "", "", "");
-  auto baseObject = baseObjectExtension->AddObject<gd::Object>(
+  auto& baseObject = baseObjectExtension->AddObject<gd::Object>(
       "", "Dummy Base Object", "Dummy Base Object", "");
 
+  // Add this expression for all objects. But it requires a "capability".
+  baseObject
+      .AddStrExpression("GetSomethingRequiringEffectCapability",
+                        "Get something, but this requires the effect capability for the object.",
+                        "",
+                        "",
+                        "")
+      .AddParameter("object", _("Object"), "")
+      .AddParameter("expression", _("Number parameter"))
+      .SetRequiresBaseObjectCapability("effect")
+      .SetFunctionName("getSomethingRequiringEffectCapability");
+
+  // Create an extension with various stuff inside.
   std::shared_ptr<gd::PlatformExtension> extension =
       std::shared_ptr<gd::PlatformExtension>(new gd::PlatformExtension);
   extension->SetExtensionInformation(
@@ -116,7 +133,8 @@ void SetupProjectWithDummyPlatform(gd::Project& project,
                   "",
                   "",
                   "")
-      .AddParameter("bitmapFontResource", "Parameter 1 (a bitmap font resource)")
+      .AddParameter("bitmapFontResource",
+                    "Parameter 1 (a bitmap font resource)")
       .AddParameter("imageResource", "Parameter 2 (an image resource)")
       .AddParameter("soundfile", "Parameter 3 (an audio resource)")
       .SetFunctionName("doSomethingWithResources");
@@ -260,10 +278,10 @@ void SetupProjectWithDummyPlatform(gd::Project& project,
         .SetFunctionName("getBehaviorStringWith1Param");
     behavior
         .AddExpression("GetBehaviorNumberWith1Param",
-                          "Get number from behavior with 1 param",
-                          "",
-                          "",
-                          "")
+                       "Get number from behavior with 1 param",
+                       "",
+                       "",
+                       "")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "MyExtension::MyBehavior")
         .AddParameter("expression", _("Number parameter"))
@@ -310,6 +328,16 @@ void SetupProjectWithDummyPlatform(gd::Project& project,
         gd::make_unique<gd::BehaviorsSharedData>());
   }
 
+  {
+    auto& object = extension
+                       ->AddObject<gd::Object>(
+                           "FakeObjectWithUnsupportedCapability",
+                           "FakeObjectWithUnsupportedCapability",
+                           "This is FakeObjectWithUnsupportedCapability",
+                           "")
+                       .AddUnsupportedBaseObjectCapability("effect");
+  }
+
   platform.AddExtension(baseObjectExtension);
   platform.AddExtension(extension);
   project.AddPlatform(platform);

Core/tests/ExpressionCodeGenerator.cpp

@@ -23,6 +23,14 @@ TEST_CASE("ExpressionCodeGenerator", "[common][events]") {
   layout1.InsertNewObject(project, "MyExtension::Sprite", "MySpriteObject", 0);
   layout1.InsertNewObject(
       project, "MyExtension::Sprite", "MyOtherSpriteObject", 1);
+  layout1.InsertNewObject(project,
+                          "MyExtension::FakeObjectWithUnsupportedCapability",
+                          "MyFakeObjectWithUnsupportedCapability",
+                          2);
+  auto &group = layout1.GetObjectGroups().InsertNew("AllObjects");
+  group.AddObject("MySpriteObject");
+  group.AddObject("MyOtherSpriteObject");
+  group.AddObject("MyFakeObjectWithUnsupportedCapability");
 
   gd::ExpressionParser2 parser(platform, project, layout1);
 
@@ -283,6 +291,51 @@ TEST_CASE("ExpressionCodeGenerator", "[common][events]") {
               "getNumberWith2Params(1, \"2\")");
     }
   }
+  SECTION("Invalid function calls (capabilities)") {
+    {
+      // Capability is supported, so the expression is valid.
+      auto node = parser.ParseExpression(
+          "string",
+          "MySpriteObject.GetSomethingRequiringEffectCapability(123)");
+      gd::ExpressionCodeGenerator expressionCodeGenerator(codeGenerator,
+                                                          context);
+
+      REQUIRE(node);
+      node->Visit(expressionCodeGenerator);
+      REQUIRE(
+          expressionCodeGenerator.GetOutput() ==
+          "MySpriteObject.getSomethingRequiringEffectCapability(123) ?? \"\"");
+    }
+    {
+      // Capability is not supported, so the expression is not even valid.
+      auto node =
+          parser.ParseExpression("string",
+                                 "MyFakeObjectWithUnsupportedCapability."
+                                 "GetSomethingRequiringEffectCapability(123)");
+      gd::ExpressionCodeGenerator expressionCodeGenerator(codeGenerator,
+                                                          context);
+
+      REQUIRE(node);
+      node->Visit(expressionCodeGenerator);
+      REQUIRE(expressionCodeGenerator.GetOutput() == "\"\"");
+    }
+    {
+      // We use a group, capability is supported only by one object of the
+      // group. The expression itself is valid, but code generation should skip
+      // the objects with unsupported capability.
+      auto node = parser.ParseExpression(
+          "string", "AllObjects.GetSomethingRequiringEffectCapability(123)");
+      gd::ExpressionCodeGenerator expressionCodeGenerator(codeGenerator,
+                                                          context);
+
+      REQUIRE(node);
+      node->Visit(expressionCodeGenerator);
+      REQUIRE(
+          expressionCodeGenerator.GetOutput() ==
+          "MyOtherSpriteObject.getSomethingRequiringEffectCapability(123) ?? "
+          "MySpriteObject.getSomethingRequiringEffectCapability(123) ?? \"\"");
+    }
+  }
   SECTION("Invalid variables") {
     {
       // Test an empty expression

Core/tests/ExpressionParser2.cpp

@@ -19,6 +19,10 @@ TEST_CASE("ExpressionParser2", "[common][events]") {
   SetupProjectWithDummyPlatform(project, platform);
   auto &layout1 = project.InsertNewLayout("Layout1", 0);
   layout1.InsertNewObject(project, "MyExtension::Sprite", "MySpriteObject", 0);
+  layout1.InsertNewObject(project,
+                          "MyExtension::FakeObjectWithUnsupportedCapability",
+                          "MyFakeObjectWithUnsupportedCapability",
+                          1);
 
   gd::ExpressionParser2 parser(platform, project, layout1);
 
@@ -1351,6 +1355,33 @@ TEST_CASE("ExpressionParser2", "[common][events]") {
     }
   }
 
+  SECTION(
+      "Valid function call with an object expression requiring a capability") {
+    auto node = parser.ParseExpression(
+        "string", "MySpriteObject.GetSomethingRequiringEffectCapability(123)");
+    REQUIRE(node != nullptr);
+
+    gd::ExpressionValidator validator;
+    node->Visit(validator);
+    REQUIRE(validator.GetErrors().size() == 0);
+  }
+
+  SECTION(
+      "Invalid function call with an object expression requiring a "
+      "capability") {
+    auto node =
+        parser.ParseExpression("string",
+                               "MyFakeObjectWithUnsupportedCapability."
+                               "GetSomethingRequiringEffectCapability(123)");
+    REQUIRE(node != nullptr);
+
+    gd::ExpressionValidator validator;
+    node->Visit(validator);
+    REQUIRE(validator.GetErrors().size() == 1);
+    REQUIRE(validator.GetErrors()[0]->GetMessage() ==
+            "This expression exists, but it can't be used on this object.");
+  }
+
   SECTION("Fuzzy/random tests") {
     {
       auto testExpression = [&parser](const gd::String &expression) {

Extensions/AdMob/JsExtension.js

@@ -35,7 +35,11 @@ module.exports = {
         'Florian Rival',
         'MIT'
       )
-      .setExtensionHelpPath('/all-features/admob');
+      .setExtensionHelpPath('/all-features/admob')
+      .setCategory('Ads');
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('AdMob'))
+      .setIcon('JsPlatform/Extensions/admobicon24.png');
 
     extension
       .registerProperty('AdMobAppIdAndroid')
@@ -87,7 +91,7 @@ module.exports = {
             'account being flagged for invalid activity.'
         ),
         _('Enable test mode (serving test ads, for development): _PARAM0_'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -105,7 +109,7 @@ module.exports = {
           'Check if a banner is currently loading. It will be shown automatically when loaded.'
         ),
         _('Banner is loading'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -119,7 +123,7 @@ module.exports = {
         _('Banner showing'),
         _('Check if there is a banner being displayed.'),
         _('Banner is showing'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -133,7 +137,7 @@ module.exports = {
         _('Banner had an error'),
         _('Check if there was a error while displaying a banner.'),
         _('Banner ad had an error'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -159,7 +163,7 @@ module.exports = {
         _(
           'Configure the banner with Android ad unit ID: _PARAM0_, iOS ad unit ID: _PARAM1_, display at top: _PARAM2_'
         ),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -190,7 +194,7 @@ module.exports = {
         _('Show banner'),
         _('Show the banner that was previously set up.'),
         _('Show banner'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -206,7 +210,7 @@ module.exports = {
           'Hide the banner. You can show it again with the corresponding action.'
         ),
         _('Hide banner'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -224,7 +228,7 @@ module.exports = {
         _('Interstitial loading'),
         _('Check if an interstitial is currently loading.'),
         _('Interstitial is loading'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -238,7 +242,7 @@ module.exports = {
         _('Interstitial ready'),
         _('Check if an interstitial is ready to be displayed.'),
         _('Interstitial is ready'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -252,7 +256,7 @@ module.exports = {
         _('Interstitial showing'),
         _('Check if there is an interstitial being displayed.'),
         _('Interstitial is showing'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -266,7 +270,7 @@ module.exports = {
         _('Interstitial had an error'),
         _('Check if there was a error while loading the interstitial.'),
         _('Interstitial ad had an error'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -284,7 +288,7 @@ module.exports = {
         _(
           'Load interstitial with Android ad unit ID: _PARAM0_, iOS ad unit ID: _PARAM1_ (display automatically when loaded: _PARAM2_)'
         ),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -315,7 +319,7 @@ module.exports = {
           'Show the interstitial that was loaded. Will work only when the interstitial is fully loaded.'
         ),
         _('Show the loaded interstitial'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -330,7 +334,7 @@ module.exports = {
         _('Video loading'),
         _('Check if a reward video is currently loading.'),
         _('Reward video is loading'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -344,7 +348,7 @@ module.exports = {
         _('Video ready'),
         _('Check if a reward video is ready to be displayed.'),
         _('Reward video is ready'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -358,7 +362,7 @@ module.exports = {
         _('Video showing'),
         _('Check if there is a reward video being displayed.'),
         _('Reward video is showing'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -372,7 +376,7 @@ module.exports = {
         _('Video had an error'),
         _('Check if there was a error while loading the rewarded video.'),
         _('Video ad had an error'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -388,7 +392,7 @@ module.exports = {
           'Check if the reward of the video was given to the user.\nYou can mark this reward as cleared, so that the condition will be false and you can show later another reward video.'
         ),
         _('User got the reward of the video (and clear this reward: _PARAM0_)'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -413,7 +417,7 @@ module.exports = {
         _(
           'Load reward video with Android ad unit ID: _PARAM0_, iOS ad unit ID: _PARAM1_ (display automatically when loaded: _PARAM2_)'
         ),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -444,7 +448,7 @@ module.exports = {
           'Show the reward video that was loaded. Will work only when the video is fully loaded.'
         ),
         _('Show the loaded reward video'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )
@@ -460,7 +464,7 @@ module.exports = {
           'Mark the video reward as claimed. Useful if you used the condition to check if the reward was given to the user without clearing the reward.'
         ),
         _('Mark the reward of the video as claimed'),
-        _('AdMob'),
+        '',
         'JsPlatform/Extensions/admobicon24.png',
         'JsPlatform/Extensions/admobicon16.png'
       )

Extensions/AdvancedWindow/JsExtension.js

@@ -18,15 +18,20 @@ module.exports = {
     gd /*: libGDevelop */
   ) {
     const extension = new gd.PlatformExtension();
-    extension.setExtensionInformation(
-      'AdvancedWindow',
-      _('Advanced window management'),
-      _(
-        'Provides advanced features related to the game window positioning and interaction with the operating system.'
-      ),
-      'Arthur Pacaud (arthuro555)',
-      'MIT'
-    );
+    extension
+      .setExtensionInformation(
+        'AdvancedWindow',
+        _('Advanced window management'),
+        _(
+          'Provides advanced features related to the game window positioning and interaction with the operating system.'
+        ),
+        'Arthur Pacaud (arthuro555)',
+        'MIT'
+      )
+      .setCategory('Device');
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('Advanced window management'))
+      .setIcon('res/actions/window24.png');
 
     extension
       .addAction(
@@ -34,7 +39,7 @@ module.exports = {
         _('Change focus of the window'),
         _('Make the window gain or lose focus.'),
         _('Focus the window: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -52,7 +57,7 @@ module.exports = {
         _('Window focused'),
         _('Checks if the window is focused.'),
         _('The window is focused'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -68,7 +73,7 @@ module.exports = {
         _('Change visibility of the window'),
         _('Make the window visible or invisible.'),
         _('Window visible: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -86,7 +91,7 @@ module.exports = {
         _('Window visible'),
         _('Checks if the window is visible.'),
         _('The window is visible'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -102,7 +107,7 @@ module.exports = {
         _('Maximize the window'),
         _('Maximize or unmaximize the window.'),
         _('Maximize window: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -120,7 +125,7 @@ module.exports = {
         _('Window maximized'),
         _('Checks if the window is maximized.'),
         _('The window is maximized'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -136,7 +141,7 @@ module.exports = {
         _('Minimize the window'),
         _('Minimize or unminimize the window.'),
         _('Minimize window: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -154,7 +159,7 @@ module.exports = {
         _('Window minimized'),
         _('Checks if the window is minimized.'),
         _('The window is minimized'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -170,7 +175,7 @@ module.exports = {
         _('Enable the window'),
         _('Enables or disables the window.'),
         _('Enable window: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -188,7 +193,7 @@ module.exports = {
         _('Window enabled'),
         _('Checks if the window is enabled.'),
         _('The window is enabled'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -204,7 +209,7 @@ module.exports = {
         _('Allow resizing'),
         _('Enables or disables resizing of the window by the user.'),
         _('Enable window resizing: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -222,7 +227,7 @@ module.exports = {
         _('Window resizable'),
         _('Checks if the window can be resized.'),
         _('The window can be resized'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -238,7 +243,7 @@ module.exports = {
         _('Allow moving'),
         _('Enables or disables moving of the window by the user.'),
         _('Enable window moving: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -256,7 +261,7 @@ module.exports = {
         _('Window movable'),
         _('Checks if the window can be moved.'),
         _('The window can be moved'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -272,7 +277,7 @@ module.exports = {
         _('Allow maximizing'),
         _('Enables or disables maximizing of the window by the user.'),
         _('Enable window maximizing: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -290,7 +295,7 @@ module.exports = {
         _('Window maximizable'),
         _('Checks if the window can be maximized.'),
         _('The window can be maximized'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -303,10 +308,10 @@ module.exports = {
     extension
       .addAction(
         'SetMinimizable',
-        _('Allow mimizing'),
+        _('Allow minimizing'),
         _('Enables or disables minimizing of the window by the user.'),
         _('Enable window minimizing: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -324,7 +329,7 @@ module.exports = {
         _('Window minimizable'),
         _('Checks if the window can be minimized.'),
         _('The window can be minimized'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -340,7 +345,7 @@ module.exports = {
         _('Allow full-screening'),
         _('Enables or disables full-screening of the window by the user.'),
         _('Enable window full-screening: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -358,7 +363,7 @@ module.exports = {
         _('Window full-screenable'),
         _('Checks if the window can be full-screened.'),
         _('The window can be set in fullscreen'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -374,7 +379,7 @@ module.exports = {
         _('Allow closing'),
         _('Enables or disables closing of the window by the user.'),
         _('Enable window closing: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -392,7 +397,7 @@ module.exports = {
         _('Window closable'),
         _('Checks if the window can be closed.'),
         _('The window can be closed'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -419,7 +424,7 @@ module.exports = {
         _('Make the windows always on top'),
         _('Puts the window constantly above all other windows.'),
         _('Make window always on top: _PARAM0_, level: _PARAM1_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -449,7 +454,7 @@ module.exports = {
         _('Window always on top'),
         _('Checks if the window is always on top.'),
         _('The window is always on top'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -467,7 +472,7 @@ module.exports = {
           'Puts the window in kiosk mode. This prevents the user from exiting fullscreen.'
         ),
         _('Enable kiosk mode: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -485,7 +490,7 @@ module.exports = {
         _('Kiosk mode'),
         _('Checks if the window is currently in kiosk mode.'),
         _('The window is in kiosk mode'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -501,7 +506,7 @@ module.exports = {
         _('Enable window shadow'),
         _('Enables or disables the window shadow.'),
         _('Enable window shadow: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -519,7 +524,7 @@ module.exports = {
         _('Shadow enabled'),
         _("Checks if the window currently has it's shadow enabled."),
         _('The window has a shadow'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -537,7 +542,7 @@ module.exports = {
           'Enables or disables the content protection mode. This should prevent screenshots of the game from being taken.'
         ),
         _('Enable content protection: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -555,7 +560,7 @@ module.exports = {
         _('Allow focusing'),
         _('Allow or disallow the user to focus the window.'),
         _('Allow to focus the window: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -573,7 +578,7 @@ module.exports = {
         _('Flash the window'),
         _('Make the window flash or end flashing.'),
         _('Make the window flash: _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -591,12 +596,14 @@ module.exports = {
         _('Set window opacity'),
         _('Changes the window opacity.'),
         _('Set the window opacity to _PARAM0_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
       .addParameter('expression', _('New opacity'), '', false)
-      .setParameterLongDescription('A number between 0 (fully transparent) and 1 (fully opaque).')
+      .setParameterLongDescription(
+        'A number between 0 (fully transparent) and 1 (fully opaque).'
+      )
       .getCodeExtraInformation()
       .setIncludeFile(
         'Extensions/AdvancedWindow/electron-advancedwindowtools.js'
@@ -609,7 +616,7 @@ module.exports = {
         _('Set window position'),
         _('Changes the window position.'),
         _('Set the window position to _PARAM0_;_PARAM1_'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window24.png',
         'res/actions/window.png'
       )
@@ -626,7 +633,7 @@ module.exports = {
         'WindowX',
         _('Window X position'),
         _('Returns the current window X position.'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window.png'
       )
       .getCodeExtraInformation()
@@ -640,7 +647,7 @@ module.exports = {
         'WindowY',
         _('Window Y position'),
         _('Returns the current window Y position.'),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window.png'
       )
       .getCodeExtraInformation()
@@ -656,7 +663,7 @@ module.exports = {
         _(
           'Returns the current window opacity (a number from 0 to 1, 1 being fully opaque).'
         ),
-        _('Advanced window management/Windows, Linux, macOS'),
+        _('Windows, Linux, macOS'),
         'res/actions/window.png'
       )
       .getCodeExtraInformation()

Extensions/AnchorBehavior/Extension.cpp

@@ -23,7 +23,7 @@ void DeclareAnchorBehaviorExtension(gd::PlatformExtension& extension) {
       "AnchorBehavior",
       _("Anchor"),
       "Anchor",
-      _("Behavior that anchors objects to the window's bounds."),
+      _("Anchor objects to the window's bounds."),
       "",
       "CppPlatform/Extensions/AnchorIcon.png",
       "AnchorBehavior",

Extensions/BBText/JsExtension.js

@@ -67,19 +67,22 @@ module.exports = {
         .getOrCreate('color')
         .setValue(objectContent.color)
         .setType('color')
-        .setLabel(_('Base color'));
+        .setLabel(_('Base color'))
+        .setGroup(_('Appearance'));
 
       objectProperties
         .getOrCreate('opacity')
         .setValue(objectContent.opacity.toString())
         .setType('number')
-        .setLabel(_('Opacity (0-255)'));
+        .setLabel(_('Opacity (0-255)'))
+        .setGroup(_('Appearance'));
 
       objectProperties
         .getOrCreate('fontSize')
         .setValue(objectContent.fontSize.toString())
         .setType('number')
-        .setLabel(_('Base size'));
+        .setLabel(_('Base size'))
+        .setGroup(_('Font'));
 
       objectProperties
         .getOrCreate('align')
@@ -88,33 +91,36 @@ module.exports = {
         .addExtraInfo('left')
         .addExtraInfo('center')
         .addExtraInfo('right')
-        .setLabel(_('Base alignment'));
+        .setLabel(_('Base alignment'))
+        .setGroup(_('Appearance'));
 
       objectProperties
         .getOrCreate('fontFamily')
         .setValue(objectContent.fontFamily)
         .setType('resource')
         .addExtraInfo('font')
-        .setLabel(_('Base font family'));
+        .setLabel(_('Font'))
+        .setGroup(_('Font'));
 
       objectProperties
         .getOrCreate('wordWrap')
         .setValue(objectContent.wordWrap ? 'true' : 'false')
         .setType('boolean')
-        .setLabel(_('Word wrapping'));
+        .setLabel(_('Word wrapping'))
+        .setGroup(_('Appearance'));
 
       objectProperties
         .getOrCreate('visible')
         .setValue(objectContent.visible ? 'true' : 'false')
         .setType('boolean')
-        .setLabel(_('Visible on start'));
+        .setLabel(_('Visible on start'))
+        .setGroup(_('Appearance'));
 
       return objectProperties;
     };
     objectBBText.setRawJSONContent(
       JSON.stringify({
-        text:
-          '[b]bold[/b] [i]italic[/i] [size=15]smaller[/size] [font=times]times[/font] font\n[spacing=12]spaced out[/spacing]\n[outline=yellow]outlined[/outline] [shadow=red]DropShadow[/shadow] ',
+        text: '[b]bold[/b] [i]italic[/i] [size=15]smaller[/size] [font=times]times[/font] font\n[spacing=12]spaced out[/spacing]\n[outline=yellow]outlined[/outline] [shadow=red]DropShadow[/shadow] ',
         opacity: 255,
         fontSize: 20,
         visible: true,
@@ -161,7 +167,8 @@ module.exports = {
       .addIncludeFile('Extensions/BBText/bbtextruntimeobject-pixi-renderer.js')
       .addIncludeFile(
         'Extensions/BBText/pixi-multistyle-text/dist/pixi-multistyle-text.umd.js'
-      );
+      )
+      .setCategoryFullName(_('Texts'));
 
     /**
      * Utility function to add both a setter and a getter to a property from a list.
@@ -511,7 +518,8 @@ module.exports = {
       this._pixiObject.alpha = opacity / 255;
 
       const color = properties.get('color').getValue();
-      this._pixiObject.textStyles.default.fill = objectsRenderingService.rgbOrHexToHexNumber(color);
+      this._pixiObject.textStyles.default.fill =
+        objectsRenderingService.rgbOrHexToHexNumber(color);
 
       const fontSize = properties.get('fontSize').getValue();
       this._pixiObject.textStyles.default.fontSize = `${fontSize}px`;

Extensions/BitmapText/JsExtension.js

@@ -29,7 +29,9 @@ module.exports = {
       .setExtensionInformation(
         'BitmapText',
         _('Bitmap Text'),
-        _('Displays a text using a "Bitmap Font" (an image representing characters). This is more performant than a traditional Text object and it allows for complete control on the characters aesthetic.'),
+        _(
+          'Displays a text using a "Bitmap Font" (an image representing characters). This is more performant than a traditional Text object and it allows for complete control on the characters aesthetic.'
+        ),
         'Aurélien Vivet',
         'Open source (MIT License)'
       )
@@ -67,7 +69,8 @@ module.exports = {
         .getOrCreate('opacity')
         .setValue(objectContent.opacity.toString())
         .setType('number')
-        .setLabel(_('Opacity (0-255)'));
+        .setLabel(_('Opacity (0-255)'))
+        .setGroup(_('Appearance'));
 
       objectProperties
         .getOrCreate('align')
@@ -76,46 +79,51 @@ module.exports = {
         .addExtraInfo('left')
         .addExtraInfo('center')
         .addExtraInfo('right')
-        .setLabel(_('Alignment, when multiple lines are displayed'));
+        .setLabel(_('Alignment, when multiple lines are displayed'))
+        .setGroup(_('Appearance'));
 
       objectProperties
         .getOrCreate('bitmapFontResourceName')
         .setValue(objectContent.bitmapFontResourceName)
         .setType('resource')
         .addExtraInfo('bitmapFont') //fnt or xml files
-        .setLabel(_('Bitmap Font'));
+        .setLabel(_('Bitmap Font'))
+        .setGroup(_("Font"));
 
       objectProperties
         .getOrCreate('textureAtlasResourceName')
         .setValue(objectContent.textureAtlasResourceName)
         .setType('resource')
         .addExtraInfo('image')
-        .setLabel(_('Bitmap atlas image'));
+        .setLabel(_('Bitmap atlas image'))
+        .setGroup(_("Font"));
 
       objectProperties
         .getOrCreate('scale')
         .setValue(objectContent.scale.toString())
         .setType('number')
-        .setLabel(_('Text scale'));
+        .setLabel(_('Text scale'))
+        .setGroup(_('Appearance'));
 
       objectProperties
         .getOrCreate('tint')
         .setValue(objectContent.tint)
         .setType('color')
-        .setLabel(_('Font tint'));
+        .setLabel(_('Font tint'))
+        .setGroup(_("Font"));
 
       objectProperties
         .getOrCreate('wordWrap')
         .setValue(objectContent.wordWrap ? 'true' : 'false')
         .setType('boolean')
-        .setLabel(_('Word wrapping'));
+        .setLabel(_('Word wrapping'))
+        .setGroup(_('Appearance'));
 
       return objectProperties;
     };
     bitmapTextObject.setRawJSONContent(
       JSON.stringify({
-        text:
-          'This text use the default bitmap font.\nUse a custom Bitmap Font to create your own texts.',
+        text: 'This text use the default bitmap font.\nUse a custom Bitmap Font to create your own texts.',
         opacity: 255,
         scale: 1,
         fontSize: 20,
@@ -162,7 +170,8 @@ module.exports = {
       .setIncludeFile('Extensions/BitmapText/bitmaptextruntimeobject.js')
       .addIncludeFile(
         'Extensions/BitmapText/bitmaptextruntimeobject-pixi-renderer.js'
-      );
+      )
+      .setCategoryFullName(_('Texts'));
 
     object
       .addExpressionAndConditionAndAction(
@@ -265,7 +274,12 @@ module.exports = {
         'res/actions/font.png'
       )
       .addParameter('object', _('Bitmap text'), 'BitmapTextObject', false)
-      .addParameter('bitmapFontResource', _('Bitmap font resource name'), '', false)
+      .addParameter(
+        'bitmapFontResource',
+        _('Bitmap font resource name'),
+        '',
+        false
+      )
       .setParameterLongDescription(
         'The resource name of the font file, without quotes.'
       )
@@ -384,7 +398,7 @@ module.exports = {
     objectsEditorService.registerEditorConfiguration(
       'BitmapText::BitmapTextObject',
       objectsEditorService.getDefaultObjectJsImplementationPropertiesEditor({
-        helpPagePath: '/objects/bitmaptext',
+        helpPagePath: '/objects/bitmap_text',
       })
     );
   },
@@ -634,7 +648,8 @@ module.exports = {
       this._pixiObject.align = align;
 
       const color = properties.get('tint').getValue();
-      this._pixiObject.tint = objectsRenderingService.rgbOrHexToHexNumber(color);
+      this._pixiObject.tint =
+        objectsRenderingService.rgbOrHexToHexNumber(color);
 
       const scale = properties.get('scale').getValue() || 1;
       this._pixiObject.scale.set(scale);

Extensions/DebuggerTools/JsExtension.js

@@ -25,13 +25,18 @@ module.exports = {
     gd /*: libGDevelop */
   ) {
     const extension = new gd.PlatformExtension();
-    extension.setExtensionInformation(
-      'DebuggerTools',
-      _('Debugger Tools'),
-      _('Allow to interact with the editor debugger from the game.'),
-      'Arthur Pacaud (arthuro555), Aurélien Vivet (Bouh)',
-      'MIT'
-    );
+    extension
+      .setExtensionInformation(
+        'DebuggerTools',
+        _('Debugger Tools'),
+        _('Allow to interact with the editor debugger from the game.'),
+        'Arthur Pacaud (arthuro555), Aurélien Vivet (Bouh)',
+        'MIT'
+      )
+      .setCategory('Advanced');
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('Debugger Tools'))
+      .setIcon('res/actions/bug32.png');
 
     extension
       .addAction(
@@ -42,7 +47,7 @@ module.exports = {
             'Note that events will be still executed until the end before the game is paused.'
         ),
         _('Pause game execution'),
-        _('Debugger Tools'),
+        '',
         'res/actions/bug32.png',
         'res/actions/bug32.png'
       )
@@ -61,7 +66,7 @@ module.exports = {
         _(
           'Enable debugging view of bounding boxes/collision masks: _PARAM1_ (include invisible objects: _PARAM2_, point names: _PARAM3_, custom points: _PARAM4_)'
         ),
-        _('Debugger Tools'),
+        '',
         'res/actions/planicon24.png',
         'res/actions/planicon.png'
       )
@@ -91,7 +96,7 @@ module.exports = {
         _(
           'Log message _PARAM0_ of type _PARAM1_ to the console in group _PARAM2_'
         ),
-        _('Debugger Tools'),
+        '',
         'res/actions/bug32.png',
         'res/actions/bug32.png'
       )

Extensions/DestroyOutsideBehavior/Extension.cpp

@@ -26,7 +26,7 @@ void DeclareDestroyOutsideBehaviorExtension(gd::PlatformExtension& extension) {
       extension.AddBehavior("DestroyOutside",
                             _("Destroy when outside of the screen"),
                             _("DestroyOutside"),
-                            _("Automatically destroy the object when it goes "
+                            _("Destroy objects automatically when they go "
                               "outside of the screen's borders."),
                             "",
                             "CppPlatform/Extensions/destroyoutsideicon.png",

Extensions/DeviceSensors/JsExtension.js

@@ -30,7 +30,10 @@ module.exports = {
       ),
       "Matthias Meike",
       "Open source (MIT License)"
-    ).setExtensionHelpPath("/all-features/device-sensors");
+    ).setExtensionHelpPath("/all-features/device-sensors")
+    .setCategory('Device');
+    extension.addInstructionOrExpressionGroupMetadata(_("Device sensors"))
+        .setIcon("JsPlatform/Extensions/orientation_active32.png");
 
     extension
       .addCondition(
@@ -40,8 +43,8 @@ module.exports = {
           "The condition is true if the device orientation sensor is currently active"
         ),
         _("Orientation sensor is active"),
-        _("Sensors/Orientation"),
-        "JsPlatform/Extensions/orientation_active24.png",
+        _("Orientation"),
+        "JsPlatform/Extensions/orientation_active32.png",
         "JsPlatform/Extensions/orientation_active32.png"
       )
       .getCodeExtraInformation()
@@ -58,8 +61,8 @@ module.exports = {
           "Compare the value of orientation alpha. (Range: 0 to 360°)"
         ),
         _("the orientation alpha"),
-        _("Sensors/Orientation"),
-        "JsPlatform/Extensions/orientation_alpha24.png",
+        _("Orientation"),
+        "JsPlatform/Extensions/orientation_alpha32.png",
         "JsPlatform/Extensions/orientation_alpha32.png"
       )
       .addParameter("relationalOperator", _("Sign of the test"), "number")
@@ -78,8 +81,8 @@ module.exports = {
           "Compare the value of orientation beta. (Range: -180 to 180°)"
         ),
         _("the orientation beta"),
-        _("Sensors/Orientation"),
-        "JsPlatform/Extensions/orientation_beta24.png",
+        _("Orientation"),
+        "JsPlatform/Extensions/orientation_beta32.png",
         "JsPlatform/Extensions/orientation_beta32.png"
       )
       .addParameter("relationalOperator", _("Sign of the test"), "number")
@@ -98,8 +101,8 @@ module.exports = {
           "Compare the value of orientation gamma. (Range: -90 to 90°)"
         ),
         _("the orientation gamma"),
-        _("Sensors/Orientation"),
-        "JsPlatform/Extensions/orientation_gamma24.png",
+        _("Orientation"),
+        "JsPlatform/Extensions/orientation_gamma32.png",
         "JsPlatform/Extensions/orientation_gamma32.png"
       )
       .addParameter("relationalOperator", _("Sign of the test"), "number")
@@ -116,8 +119,8 @@ module.exports = {
         _("Activate orientation sensor"),
         _("Activate the orientation sensor. (remember to turn it off again)"),
         _("Activate the orientation sensor."),
-        _("Sensors/Orientation"),
-        "JsPlatform/Extensions/orientation_active24.png",
+        _("Orientation"),
+        "JsPlatform/Extensions/orientation_active32.png",
         "JsPlatform/Extensions/orientation_active32.png"
       )
         .getCodeExtraInformation()
@@ -132,8 +135,8 @@ module.exports = {
         _("Deactivate orientation sensor"),
         _("Deactivate the orientation sensor."),
         _("Deactivate the orientation sensor."),
-        _("Sensors/Orientation"),
-        "JsPlatform/Extensions/orientation_inactive24.png",
+        _("Orientation"),
+        "JsPlatform/Extensions/orientation_inactive32.png",
         "JsPlatform/Extensions/orientation_inactive32.png"
       )
         .getCodeExtraInformation()
@@ -147,7 +150,7 @@ module.exports = {
         "OrientationAbsolute",
         _("Is Absolute"),
         _("Get if the devices orientation is absolute and not relative"),
-        _("Sensors/Orientation"),
+        _("Orientation"),
 	"JsPlatform/Extensions/orientation_absolute16.png"
       )
       .getCodeExtraInformation()
@@ -161,7 +164,7 @@ module.exports = {
         "OrientationAlpha",
         _("Alpha value"),
         _("Get the devices orientation Alpha (compass)"),
-        _("Sensors/Orientation"),
+        _("Orientation"),
 	"JsPlatform/Extensions/orientation_alpha16.png"
       )
       .getCodeExtraInformation()
@@ -175,7 +178,7 @@ module.exports = {
         "OrientationBeta",
         _("Beta value"),
         _("Get the devices orientation Beta"),
-        _("Sensors/Orientation"),
+        _("Orientation"),
 	"JsPlatform/Extensions/orientation_beta16.png"
       )
       .getCodeExtraInformation()
@@ -189,7 +192,7 @@ module.exports = {
         "OrientationGamma",
         _("Gamma value"),
         _("Get the devices orientation Gamma value"),
-        _("Sensors/Orientation"),
+        _("Orientation"),
 	"JsPlatform/Extensions/orientation_gamma16.png"
       )
       .getCodeExtraInformation()
@@ -206,8 +209,8 @@ module.exports = {
           "The condition is true if the device motion sensor is currently active"
         ),
         _("Motion sensor is active"),
-        _("Sensors/Motion"),
-        "JsPlatform/Extensions/motion_active24.png",
+        _("Motion"),
+        "JsPlatform/Extensions/motion_active32.png",
         "JsPlatform/Extensions/motion_active32.png"
       )
       .getCodeExtraInformation()
@@ -224,8 +227,8 @@ module.exports = {
           "Compare the value of rotation alpha. (Note: few devices support this sensor)"
         ),
         _("the rotation alpha"),
-        _("Sensors/Motion"),
-        "JsPlatform/Extensions/motion_rotation_alpha24.png",
+        _("Motion"),
+        "JsPlatform/Extensions/motion_rotation_alpha32.png",
         "JsPlatform/Extensions/motion_rotation_alpha32.png"
       )
       .addParameter("relationalOperator", _("Sign of the test"), "number")
@@ -244,8 +247,8 @@ module.exports = {
           "Compare the value of rotation beta. (Note: few devices support this sensor)"
         ),
         _("the rotation beta"),
-        _("Sensors/Motion"),
-        "JsPlatform/Extensions/motion_rotation_beta24.png",
+        _("Motion"),
+        "JsPlatform/Extensions/motion_rotation_beta32.png",
         "JsPlatform/Extensions/motion_rotation_beta32.png"
       )
       .addParameter("relationalOperator", _("Sign of the test"), "number")
@@ -264,8 +267,8 @@ module.exports = {
           "Compare the value of rotation gamma. (Note: few devices support this sensor)"
         ),
         _("the rotation gamma"),
-        _("Sensors/Motion"),
-        "JsPlatform/Extensions/motion_rotation_gamma24.png",
+        _("Motion"),
+        "JsPlatform/Extensions/motion_rotation_gamma32.png",
         "JsPlatform/Extensions/motion_rotation_gamma32.png"
       )
       .addParameter("relationalOperator", _("Sign of the test"), "number")
@@ -284,8 +287,8 @@ module.exports = {
           "Compare the value of acceleration on the X-axis (m/s²)."
         ),
         _("the acceleration X"),
-        _("Sensors/Motion"),
-        "JsPlatform/Extensions/motion_acceleration_x24.png",
+        _("Motion"),
+        "JsPlatform/Extensions/motion_acceleration_x32.png",
         "JsPlatform/Extensions/motion_acceleration_x32.png"
       )
       .addParameter("relationalOperator", _("Sign of the test"), "number")
@@ -304,8 +307,8 @@ module.exports = {
           "Compare the value of acceleration on the Y-axis (m/s²)."
         ),
         _("the acceleration Y"),
-        _("Sensors/Motion"),
-        "JsPlatform/Extensions/motion_acceleration_y24.png",
+        _("Motion"),
+        "JsPlatform/Extensions/motion_acceleration_y32.png",
         "JsPlatform/Extensions/motion_acceleration_y32.png"
       )
       .addParameter("relationalOperator", _("Sign of the test"), "number")
@@ -324,8 +327,8 @@ module.exports = {
           "Compare the value of acceleration on the Z-axis (m/s²)."
         ),
         _("the acceleration Z"),
-        _("Sensors/Motion"),
-        "JsPlatform/Extensions/motion_acceleration_z24.png",
+        _("Motion"),
+        "JsPlatform/Extensions/motion_acceleration_z32.png",
         "JsPlatform/Extensions/motion_acceleration_z32.png"
       )
       .addParameter("relationalOperator", _("Sign of the test"), "number")
@@ -342,8 +345,8 @@ module.exports = {
         _("Activate motion sensor"),
         _("Activate the motion sensor. (remember to turn it off again)"),
         _("Activate the motion sensor."),
-        _("Sensors/Motion"),
-        "JsPlatform/Extensions/motion_active24.png",
+        _("Motion"),
+        "JsPlatform/Extensions/motion_active32.png",
         "JsPlatform/Extensions/motion_active32.png"
       )
         .getCodeExtraInformation()
@@ -358,8 +361,8 @@ module.exports = {
         _("Deactivate motion sensor"),
         _("Deactivate the motion sensor."),
         _("Deactivate the motion sensor."),
-        _("Sensors/Motion"),
-        "JsPlatform/Extensions/motion_inactive24.png",
+        _("Motion"),
+        "JsPlatform/Extensions/motion_inactive32.png",
         "JsPlatform/Extensions/motion_inactive32.png"
       )
         .getCodeExtraInformation()
@@ -373,7 +376,7 @@ module.exports = {
         "RotationAlpha",
         _("Alpha value"),
         _("Get the devices rotation Alpha"),
-        _("Sensors/Motion"),
+        _("Motion"),
 	"JsPlatform/Extensions/motion_rotation_alpha16.png"
       )
       .getCodeExtraInformation()
@@ -387,7 +390,7 @@ module.exports = {
         "RotationBeta",
         _("Beta value"),
         _("Get the devices rotation Beta"),
-        _("Sensors/Motion"),
+        _("Motion"),
 	"JsPlatform/Extensions/motion_rotation_beta16.png"
       )
       .getCodeExtraInformation()
@@ -401,7 +404,7 @@ module.exports = {
         "RotationGamma",
         _("Gamma value"),
         _("Get the devices rotation Gamma"),
-        _("Sensors/Motion"),
+        _("Motion"),
 	"JsPlatform/Extensions/motion_rotation_gamma16.png"
       )
       .getCodeExtraInformation()
@@ -415,7 +418,7 @@ module.exports = {
         "AccelerationX",
         _("Acceleration X value"),
         _("Get the devices acceleration on the X-axis (m/s²)"),
-        _("Sensors/Motion"),
+        _("Motion"),
 	"JsPlatform/Extensions/motion_acceleration_x16.png"
       )
       .getCodeExtraInformation()
@@ -429,7 +432,7 @@ module.exports = {
         "AccelerationY",
         _("Acceleration Y value"),
         _("Get the devices acceleration on the Y-axis (m/s²)"),
-        _("Sensors/Motion"),
+        _("Motion"),
 	"JsPlatform/Extensions/motion_acceleration_y16.png"
       )
       .getCodeExtraInformation()
@@ -443,7 +446,7 @@ module.exports = {
         "AccelerationZ",
         _("Acceleration Z value"),
         _("Get the devices acceleration on the Z-axis (m/s²)"),
-        _("Sensors/Motion"),
+        _("Motion"),
 	"JsPlatform/Extensions/motion_acceleration_z16.png"
       )
       .getCodeExtraInformation()

Extensions/DeviceVibration/JsExtension.js

@@ -34,7 +34,10 @@ module.exports = {
         'Matthias Meike',
         'Open source (MIT License)'
       )
-      .setExtensionHelpPath('/all-features/device-vibration');
+      .setExtensionHelpPath('/all-features/device-vibration')
+      .setCategory('Device');
+      extension.addInstructionOrExpressionGroupMetadata(_("Device vibration"))
+          .setIcon("JsPlatform/Extensions/vibration_start32.png");
 
     extension
       .addDependency()
@@ -49,8 +52,8 @@ module.exports = {
         _('Vibrate'),
         _('Vibrate (Duration in ms).'),
         _('Start vibration for _PARAM0_ ms'),
-        _('Vibration'),
-        'JsPlatform/Extensions/vibration_start24.png',
+        '',
+        'JsPlatform/Extensions/vibration_start32.png',
         'JsPlatform/Extensions/vibration_start32.png'
       )
       .addParameter('expression', _('Duration'), '', false)
@@ -66,8 +69,8 @@ module.exports = {
           'Vibrate (Duration in ms). You can add multiple comma-separated values where every second value determines the period of silence between two vibrations. This is a string value so use quotes.'
         ),
         _('Start vibration for _PARAM0_ ms'),
-        _('Vibration'),
-        'JsPlatform/Extensions/vibration_pattern_start24.png',
+        '',
+        'JsPlatform/Extensions/vibration_pattern_start32.png',
         'JsPlatform/Extensions/vibration_pattern_start32.png'
       )
       .addParameter(
@@ -86,8 +89,8 @@ module.exports = {
         _('Stop vibration'),
         _('Stop the vibration'),
         _('Stop vibration'),
-        _('Vibration'),
-        'JsPlatform/Extensions/vibration_stop24.png',
+        '',
+        'JsPlatform/Extensions/vibration_stop32.png',
         'JsPlatform/Extensions/vibration_stop32.png'
       )
       .getCodeExtraInformation()

Extensions/DialogueTree/JsExtension.js

@@ -28,12 +28,16 @@ module.exports = {
     extension
       .setExtensionInformation(
         'DialogueTree',
-        _('Dialogue Tree (Experimental)'),
+        _('Dialogue Tree (experimental)'),
         'Handle dialogue trees, made using Yarn Spinner. Useful to make complex dialogues with multiple choices. The Yarn Spinner editor is embedded in GDevelop so you can edit your dialogues without leaving GDevelop.',
         'Todor Imreorov',
         'Open source (MIT License)'
       )
-      .setExtensionHelpPath('/all-features/dialogue-tree');
+      .setExtensionHelpPath('/all-features/dialogue-tree')
+      .setCategory('Advanced');
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('Dialogue Tree (experimental)'))
+      .setIcon('JsPlatform/Extensions/yarn32.png');
 
     extension
       .addAction(
@@ -43,8 +47,8 @@ module.exports = {
           'Load a dialogue data object - Yarn json format, stored in a scene variable. Use this command to load all the Dialogue data at the beginning of the game.'
         ),
         _('Load dialogue data from Scene variable _PARAM1_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter(
@@ -66,8 +70,8 @@ module.exports = {
           'Load a dialogue data object - Yarn json format, stored in a Json file. Use this command to load all the Dialogue data at the beginning of the game.'
         ),
         _('Load dialogue data from json file _PARAM1_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addCodeOnlyParameter('currentScene', '')
@@ -90,8 +94,8 @@ module.exports = {
           'Start dialogue from branch. Use this to initiate the dialogue from a specified branch.'
         ),
         _('Start dialogue from branch _PARAM0_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('Dialogue branch'), '', false)
@@ -104,8 +108,8 @@ module.exports = {
         _('Stop running dialogue'),
         _('Stop the running dialogue. Use this to interrupt dialogue parsing.'),
         _('Stop running dialogue'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -119,8 +123,8 @@ module.exports = {
           'Go to the next dialogue line. Use this to advance to the next dialogue line when the player presses a button.'
         ),
         _('Go to the next dialogue line'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -134,8 +138,8 @@ module.exports = {
           'Set the selected option as confirmed, which will validate it and go forward to the next node. Use other actions to select options (see "select next option" and "Select previous option").'
         ),
         _('Confirm selected Option'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -149,8 +153,8 @@ module.exports = {
           'Select next Option (add 1 to selected option number). Use this when the dialogue line is of type "options" and the player has pressed a button to change selected option.'
         ),
         _('Select next Option'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -164,8 +168,8 @@ module.exports = {
           'Select previous Option (subtract 1 from selected option number). Use this when the dialogue line is of type "options" and the player has pressed a button to change selected option.'
         ),
         _('Select previous Option'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -179,8 +183,8 @@ module.exports = {
           'Select option by number. Use this when the dialogue line is of type "options" and the player has pressed a button to change selected option.'
         ),
         _('Select option at index _PARAM0_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('expression', _('Option index number'), '', false)
@@ -195,8 +199,8 @@ module.exports = {
           'Scroll clipped text. Use this with a timer and "get clipped text" when you want to create a typewriter effect. Every time the action runs, a new character appears from the text.'
         ),
         _('Scroll clipped text'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -210,8 +214,8 @@ module.exports = {
           'Complete the clipped text scrolling. Use this action whenever you want to skip scrolling.'
         ),
         _('Complete clipped text scrolling'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -225,8 +229,8 @@ module.exports = {
           'Set dialogue state string variable. Use this to set a variable that the dialogue data is using.'
         ),
         _('Set dialogue state string variable _PARAM0_ to _PARAM1_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('State Variable Name'), '', false)
@@ -242,8 +246,8 @@ module.exports = {
           'Set dialogue state number variable. Use this to set a variable that the dialogue data is using.'
         ),
         _('Set dialogue state number variable _PARAM0_ to _PARAM1_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('State Variable Name'), '', false)
@@ -259,8 +263,8 @@ module.exports = {
           'Set dialogue state boolean variable. Use this to set a variable that the dialogue data is using.'
         ),
         _('Set dialogue state boolean variable _PARAM0_ to _PARAM1_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('State Variable Name'), '', false)
@@ -276,8 +280,8 @@ module.exports = {
           'Save dialogue state. Use this to store the dialogue state into a variable, which can later be used for saving the game. That way player choices can become part of the game save.'
         ),
         _('Save dialogue state to _PARAM0_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('globalvar', _('Global Variable'))
@@ -292,8 +296,8 @@ module.exports = {
           'Load dialogue state. Use this to restore dialogue state, if you have stored in a variable before with the "Save state" action.'
         ),
         _('Load dialogue state from _PARAM0_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('globalvar', _('Global Variable'), '', false)
@@ -308,8 +312,8 @@ module.exports = {
           'Clear dialogue state. This resets all dialogue state accumulated by the player choices. Useful when the player is starting a new game.'
         ),
         _('Clear dialogue state'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -320,7 +324,7 @@ module.exports = {
         'LineText',
         _('Get the current dialogue line text'),
         _('Returns the current dialogue line text'),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -331,7 +335,7 @@ module.exports = {
         'OptionsCount',
         _('Get the number of options in an options line type'),
         _('Get the number of options in an options line type'),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -344,7 +348,7 @@ module.exports = {
         _(
           "Get the text of an option from an Options line type, using the option's Number. The numbers start from 0."
         ),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('expression', _('Option Index Number'), '', false)
@@ -358,7 +362,7 @@ module.exports = {
         _(
           "Get the text of all available options from an Options line type as a horizontal list. You can also pass the selected option's cursor string, which by default is ->"
         ),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('Options Selection Cursor'), '', false)
@@ -373,7 +377,7 @@ module.exports = {
         _(
           "Get the text of all available options from an Options line type as a vertical list. You can also pass the selected option's cursor string, which by default is ->"
         ),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('Options Selection Cursor'), '', false)
@@ -388,7 +392,7 @@ module.exports = {
         _(
           'Get the number of the currently selected option. Use this to help you render the option selection marker at the right place.'
         ),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -401,7 +405,7 @@ module.exports = {
         _(
           'Get dialogue line text clipped by the typewriter effect. Use the "Scroll clipped text" action to control the typewriter effect.'
         ),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -412,7 +416,7 @@ module.exports = {
         'BranchTitle',
         _('Get the title of the current branch of the running dialogue'),
         _('Get the title of the current branch of the running dialogue'),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -423,7 +427,7 @@ module.exports = {
         'BranchTags',
         _('Get the tags of the current branch of the running dialogue'),
         _('Get the tags of the current branch of the running dialogue'),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -438,7 +442,7 @@ module.exports = {
         _(
           'Get a tag of the current branch of the running dialogue via its index'
         ),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('expression', _('Tag Index Number'), '', false)
@@ -452,7 +456,7 @@ module.exports = {
         _(
           'Get the parameters of a command call - <<command withParameter anotherParameter>>'
         ),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('expression', _('parameter Index Number'), '', true)
@@ -464,7 +468,7 @@ module.exports = {
         'CommandParametersCount',
         _('Get the number of parameters in the currently passed command'),
         _('Get the number of parameters in the currently passed command'),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -479,7 +483,7 @@ module.exports = {
         _(
           'Get parameter from a Tag found by the branch contains tag condition'
         ),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('expression', _('parameter Index Number'), '', true)
@@ -491,7 +495,7 @@ module.exports = {
         'VisitedBranchTitles',
         _('Get a list of all visited branches'),
         _('Get a list of all visited branches'),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -502,7 +506,7 @@ module.exports = {
         'BranchText',
         _('Get the full raw text of the current branch'),
         _('Get the full raw text of the current branch'),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -513,7 +517,7 @@ module.exports = {
         'Variable',
         _('Get dialogue state value'),
         _('Get dialogue state value'),
-        _('Dialogue Tree (experimental)'),
+        '',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('Variable Name'), '', false)
@@ -528,8 +532,8 @@ module.exports = {
           'Check if a specific Command is called. If it is a <<command withParameter>>, you can even get the parameter with the CommandParameter expression.'
         ),
         _('Command <<_PARAM0_>> is called'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('Command String'), '', false)
@@ -544,8 +548,8 @@ module.exports = {
           'Check if the current dialogue line line is one of the three existing types. Use this to set what logic is executed for each type.\nThe three types are as follows:\n- text: when displaying dialogue text.\n- options: when displaying [[branching/options]] for dialogue choices.\n-command: when <<commands>> are triggered by the dialogue data.'
         ),
         _('The dialogue line is _PARAM0_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter(
@@ -565,8 +569,8 @@ module.exports = {
           'Check if the dialogue is running. Use this to for things like locking the player movement while speaking with a non player character.'
         ),
         _('Dialogue is running'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -580,8 +584,8 @@ module.exports = {
           'Check if the dialogue has a branch with specified name. Use this to check if a dialogue branch exists in the loaded dialogue data.'
         ),
         _('Dialogue has a branch named _PARAM0_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('Branch name'), '', false)
@@ -596,8 +600,8 @@ module.exports = {
           'Check if a selected option has changed when the current dialogue line type is options. Use this to detect when the player has selected another option, so you can re-draw where the selection arrow is.'
         ),
         _('Selected option has changed'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()
@@ -611,8 +615,8 @@ module.exports = {
           'Check if the current dialogue branch title is equal to a string. Use this to trigger game events when the player has visited a specific dialogue branch.'
         ),
         _('The current dialogue branch title is _PARAM0_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('title name'), '', false)
@@ -627,8 +631,8 @@ module.exports = {
           'Check if the current dialogue branch contains a specific tag. Tags are an alternative useful way to <<commands>> to drive game logic with the dialogue data.'
         ),
         _('The current dialogue branch contains a _PARAM0_ tag'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('tag name'), '', false)
@@ -641,8 +645,8 @@ module.exports = {
         _('Branch title has been visited'),
         _('Check if a branch has been visited'),
         _('Branch title _PARAM0_ has been visited'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('branch title'), '', false)
@@ -657,8 +661,8 @@ module.exports = {
           'Compare dialogue state string variable. Use this to trigger game events via dialogue variables.'
         ),
         _('Dialogue state string variable _PARAM0_ is equal to _PARAM1_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('State variable'), '', false)
@@ -674,8 +678,8 @@ module.exports = {
           'Compare dialogue state number variable. Use this to trigger game events via dialogue variables.'
         ),
         _('Dialogue state number variable _PARAM0_ is equal to _PARAM1_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('State variable'), '', false)
@@ -691,8 +695,8 @@ module.exports = {
           'Compare dialogue state variable. Use this to trigger game events via dialogue variables.'
         ),
         _('Dialogue state boolean variable _PARAM0_ is equal to _PARAM1_'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .addParameter('string', _('State variable'), '', false)
@@ -708,8 +712,8 @@ module.exports = {
           'Check if the clipped text scrolling has completed. Use this to prevent the player from going to the next dialogue line before the typing effect has revealed the entire text.'
         ),
         _('Clipped text has completed scrolling'),
-        _('Dialogue Tree (experimental)'),
-        'JsPlatform/Extensions/yarn24.png',
+        '',
+        'JsPlatform/Extensions/yarn32.png',
         'JsPlatform/Extensions/yarn32.png'
       )
       .getCodeExtraInformation()

Extensions/DraggableBehavior/Extension.cpp

@@ -26,7 +26,7 @@ void DeclareDraggableBehaviorExtension(gd::PlatformExtension& extension) {
       "Draggable",
       _("Draggable object"),
       _("Draggable"),
-      _("Allows objects to be moved using the mouse (or touch)."),
+      _("Move objects by holding a mouse button (or touch)."),
       "",
       "CppPlatform/Extensions/draggableicon.png",
       "DraggableBehavior",

Extensions/ExampleJsExtension/JsExtension.js

@@ -32,6 +32,9 @@ module.exports = {
       'Florian Rival',
       'MIT'
     );
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('My Dummy Extension'))
+      .setIcon('CppPlatform/Extensions/topdownmovementicon.png');
 
     // Register Properties
     extension
@@ -106,7 +109,7 @@ module.exports = {
           'This is an example of a condition displayed in the events sheet. Will return true if the number is less than 10 and the length of the text is less than 5.'
         ),
         _('Call the example condition with _PARAM0_ and _PARAM1_'),
-        _('Dummy Extension'),
+        '',
         'res/conditions/camera24.png',
         'res/conditions/camera.png'
       )
@@ -123,7 +126,7 @@ module.exports = {
         'DummyExpression',
         _('Dummy expression example'),
         _('This is an example of an expression'),
-        _('Dummy Extension'),
+        '',
         'res/actions/camera.png'
       )
       .addParameter('expression', _('Maximum'), '', false)
@@ -135,7 +138,7 @@ module.exports = {
         'DummyStrExpression',
         _('Dummy string expression example'),
         _('This is an example of an expression returning a string'),
-        _('Dummy Extension'),
+        '',
         'res/actions/camera.png'
       )
       .getCodeExtraInformation()
@@ -194,7 +197,7 @@ module.exports = {
         'DummyBehavior',
         _('Dummy behavior for testing'),
         'DummyBehavior',
-        _('This dummy behavior does nothing'),
+        _('Do nothing.'),
         '',
         'CppPlatform/Extensions/topdownmovementicon.png',
         'DummyBehavior',
@@ -277,7 +280,7 @@ module.exports = {
         'DummyBehaviorWithSharedData',
         _('Dummy behavior with shared data for testing'),
         'DummyBehaviorWithSharedData',
-        _('This dummy behavior uses shared data and does nothing'),
+        _('Do nothing but use shared data.'),
         '',
         'CppPlatform/Extensions/topdownmovementicon.png',
         'DummyBehaviorWithSharedData',
@@ -410,7 +413,8 @@ module.exports = {
       .setIncludeFile('Extensions/ExampleJsExtension/dummyruntimeobject.js')
       .addIncludeFile(
         'Extensions/ExampleJsExtension/dummyruntimeobject-pixi-renderer.js'
-      );
+      )
+      .setCategoryFullName(_('Testing'));
 
     object
       .addAction(

Extensions/FacebookInstantGames/JsExtension.js

@@ -32,7 +32,10 @@ module.exports = {
         "Florian Rival",
         "Open source (MIT License)"
       )
-      .setExtensionHelpPath("/publishing/publishing-to-facebook-instant-games");
+      .setExtensionHelpPath("/publishing/publishing-to-facebook-instant-games")
+      .setCategory('Third-party');
+    extension.addInstructionOrExpressionGroupMetadata(_("Facebook Instant Games"))
+        .setIcon("JsPlatform/Extensions/facebookicon32.png");
 
     extension
       .addAction(
@@ -44,9 +47,9 @@ module.exports = {
         _(
           "Save the content of _PARAM1_ in key _PARAM0_ of player data (store success message in _PARAM2_ or error in _PARAM3_)"
         ),
-        _("Facebook Instant Games/Player data"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Player data"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .addParameter("string", 'Data key name (e.g: "Lives")', "", false)
       .addParameter("scenevar", "Scene variable with the content to save", "", false)
@@ -76,9 +79,9 @@ module.exports = {
         _(
           "Load player data with key _PARAM0_ in _PARAM1_ (or error in _PARAM2_)"
         ),
-        _("Facebook Instant Games/Player data"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Player data"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .addParameter("string", _('Data key name (e.g: "Lives")'), "", false)
       .addParameter(
@@ -109,9 +112,9 @@ module.exports = {
         _(
           "In leaderboard _PARAM0_, save score _PARAM1_ for the player and extra data from _PARAM2_ (store success message in _PARAM3_ or error in _PARAM4_)"
         ),
-        _("Facebook Instant Games/Leaderboards"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Leaderboards"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .addParameter(
         "string",
@@ -152,9 +155,9 @@ module.exports = {
         _(
           "Load player entry from leaderboard _PARAM0_. Set rank in _PARAM1_, score in _PARAM2_ (extra data if any in _PARAM3_ and error in _PARAM4_)"
         ),
-        _("Facebook Instant Games/Leaderboards"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Leaderboards"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .addParameter(
         "string",
@@ -198,9 +201,9 @@ module.exports = {
         _("Check if ads are supported"),
         _("Check if showing ads is supported on this device (only mobile phones can show ads)"),
         _("Ads can be shown on this device"),
-        _("Facebook Instant Games/Ads"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Ads"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .getCodeExtraInformation()
       .setIncludeFile(
@@ -214,9 +217,9 @@ module.exports = {
         _("Is the interstitial ad ready"),
         _("Check if the interstitial ad requested from Facebook is loaded and ready to be shown."),
         _("The interstitial ad is loaded and ready to be shown"),
-        _("Facebook Instant Games/Ads"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Ads"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .getCodeExtraInformation()
       .setIncludeFile(
@@ -230,9 +233,9 @@ module.exports = {
         _("Load and prepare an interstitial ad"),
         _("Request and load an interstitial ad from Facebook, so that it is ready to be shown."),
         _("Request and load an interstitial ad from Facebook (ad placement id: _PARAM0_, error in _PARAM1_)"),
-        _("Facebook Instant Games/Ads"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Ads"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .addParameter(
         "string",
@@ -258,9 +261,9 @@ module.exports = {
         _("Show the loaded interstitial ad"),
         _("Show the interstitial ad previously loaded in memory. This won't work if you did not load the interstitial before."),
         _("Show the interstitial ad previously loaded in memory (if any error, store it in _PARAM0_)"),
-        _("Facebook Instant Games/Ads"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Ads"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .addParameter(
         "scenevar",
@@ -280,9 +283,9 @@ module.exports = {
         _("Is the rewarded video ready"),
         _("Check if the rewarded video requested from Facebook is loaded and ready to be shown."),
         _("The rewarded video is loaded and ready to be shown"),
-        _("Facebook Instant Games/Ads"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Ads"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .getCodeExtraInformation()
       .setIncludeFile(
@@ -296,9 +299,9 @@ module.exports = {
         _("Load and prepare a rewarded video"),
         _("Request and load a rewarded video from Facebook, so that it is ready to be shown."),
         _("Request and load a rewarded video from Facebook (ad placement id: _PARAM0_, error in _PARAM1_)"),
-        _("Facebook Instant Games/Ads"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Ads"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .addParameter(
         "string",
@@ -324,9 +327,9 @@ module.exports = {
         _("Show the loaded rewarded video"),
         _("Show the rewarded video previously loaded in memory. This won't work if you did not load the video before."),
         _("Show the rewarded video previously loaded in memory (if any error, store it in _PARAM0_)"),
-        _("Facebook Instant Games/Ads"),
-        "JsPlatform/Extensions/facebookicon24.png",
-        "JsPlatform/Extensions/facebookicon16.png"
+        _("Ads"),
+        "JsPlatform/Extensions/facebookicon32.png",
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .addParameter(
         "scenevar",
@@ -345,8 +348,8 @@ module.exports = {
         "PlayerId",
         _("Player identifier"),
         _("Get the player unique identifier"),
-        _("Facebook Instant Games"),
-        "JsPlatform/Extensions/facebookicon16.png"
+        '',
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .getCodeExtraInformation()
       .setIncludeFile(
@@ -359,8 +362,8 @@ module.exports = {
         "PlayerName",
         _("Player name"),
         _("Get the player name"),
-        _("Facebook Instant Games"),
-        "JsPlatform/Extensions/facebookicon16.png"
+        '',
+        "JsPlatform/Extensions/facebookicon32.png"
       )
       .getCodeExtraInformation()
       .setIncludeFile(

Extensions/FileSystem/JsExtension.js

@@ -28,12 +28,16 @@ module.exports = {
     extension
       .setExtensionInformation(
         'FileSystem',
-        _('Filesystem'),
+        _('File system'),
         _('Access the filesystem of the operating system.'),
         'Matthias Meike',
         'Open source (MIT License)'
       )
-      .setExtensionHelpPath('/all-features/filesystem');
+      .setExtensionHelpPath('/all-features/filesystem')
+      .setCategory('Device');
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('File system'))
+      .setIcon('JsPlatform/Extensions/filesystem_create_folder32.png');
 
     extension
       .addCondition(
@@ -41,8 +45,8 @@ module.exports = {
         _('File or directory exists'),
         _('Check if the file or directory exists.'),
         _('The path _PARAM0_ exists'),
-        _('Filesystem/Windows, Linux, MacOS'),
-        'JsPlatform/Extensions/filesystem_path_exists24.png',
+        _('Windows, Linux, MacOS'),
+        'JsPlatform/Extensions/filesystem_path_exists32.png',
         'JsPlatform/Extensions/filesystem_path_exists32.png'
       )
       .addParameter('string', _('Path to file or directory'), '', false)
@@ -56,8 +60,8 @@ module.exports = {
         _('Create a directory'),
         _('Create a new directory at the specified path.'),
         _('Create directory _PARAM0_'),
-        _('Filesystem/Windows, Linux, MacOS'),
-        'JsPlatform/Extensions/filesystem_create_folder24.png',
+        _('Windows, Linux, MacOS'),
+        'JsPlatform/Extensions/filesystem_create_folder32.png',
         'JsPlatform/Extensions/filesystem_create_folder32.png'
       )
       .addParameter('string', _('Directory'), '', false)
@@ -81,8 +85,8 @@ module.exports = {
           'Save a text into a file. Only use this on small files to avoid any lag or freeze during the game execution.'
         ),
         _('Save _PARAM0_ into file _PARAM1_'),
-        _('Filesystem/Windows, Linux, MacOS'),
-        'JsPlatform/Extensions/filesystem_save_file24.png',
+        _('Windows, Linux, MacOS'),
+        'JsPlatform/Extensions/filesystem_save_file32.png',
         'JsPlatform/Extensions/filesystem_save_file32.png'
       )
       .addParameter('string', _('String (text)'), '', false)
@@ -107,8 +111,8 @@ module.exports = {
           "Save a text into a file asynchronously. Use this for large files to avoid any lag or freeze during game execution. The 'result' variable gets updated when the operation has finished."
         ),
         _('Save _PARAM0_ into file _PARAM1_'),
-        _('Filesystem/Windows, Linux, MacOS/Asynchronous'),
-        'JsPlatform/Extensions/filesystem_save_file24.png',
+        _('Windows, Linux, MacOS/Asynchronous'),
+        'JsPlatform/Extensions/filesystem_save_file32.png',
         'JsPlatform/Extensions/filesystem_save_file32.png'
       )
       .addParameter('string', _('String (text)'), '', false)
@@ -133,8 +137,8 @@ module.exports = {
           'Save a scene variable (including, for structure, all the children) into a file in JSON format. Only use this on small files to avoid any lag or freeze during the game execution.'
         ),
         _('Save scene variable _PARAM0_ into file _PARAM1_ as JSON'),
-        _('Filesystem/Windows, Linux, MacOS'),
-        'JsPlatform/Extensions/filesystem_save_file24.png',
+        _('Windows, Linux, MacOS'),
+        'JsPlatform/Extensions/filesystem_save_file32.png',
         'JsPlatform/Extensions/filesystem_save_file32.png'
       )
       .addParameter('scenevar', _('Scene variable'), '', false)
@@ -159,8 +163,8 @@ module.exports = {
           "Save the scene variable (including, for structures, all the children) into a file in JSON format, asynchronously. Use this for large files to avoid any lag or freeze during game execution. The 'result' variable gets updated when the operation has finished."
         ),
         _('Save scene variable _PARAM0_ into file _PARAM1_ as JSON'),
-        _('Filesystem/Windows, Linux, MacOS/Asynchronous'),
-        'JsPlatform/Extensions/filesystem_save_file24.png',
+        _('Windows, Linux, MacOS/Asynchronous'),
+        'JsPlatform/Extensions/filesystem_save_file32.png',
         'JsPlatform/Extensions/filesystem_save_file32.png'
       )
       .addParameter('scenevar', _('Scene variable'), '', false)
@@ -185,8 +189,8 @@ module.exports = {
           "Load a text from a file, asynchronously. Use this for large files to avoid any lag or freeze during game execution. The content of the file will be available in the scene variable after a small delay (usually a few milliseconds). The 'result' variable gets updated when the operation has finished."
         ),
         _('Load text from _PARAM1_ into scene variable _PARAM0_ (Async)'),
-        _('Filesystem/Windows, Linux, MacOS/Asynchronous'),
-        'JsPlatform/Extensions/filesystem_load_file24.png',
+        _('Windows, Linux, MacOS/Asynchronous'),
+        'JsPlatform/Extensions/filesystem_load_file32.png',
         'JsPlatform/Extensions/filesystem_load_file32.png'
       )
       .addParameter('scenevar', _('Scene variable'), '', false)
@@ -211,8 +215,8 @@ module.exports = {
           'Load a text from a file. Only use this on small files to avoid any lag or freeze during the game execution.'
         ),
         _('Load text from _PARAM1_ into scene variable _PARAM0_'),
-        _('Filesystem/Windows, Linux, MacOS'),
-        'JsPlatform/Extensions/filesystem_load_file24.png',
+        _('Windows, Linux, MacOS'),
+        'JsPlatform/Extensions/filesystem_load_file32.png',
         'JsPlatform/Extensions/filesystem_load_file32.png'
       )
       .addParameter('scenevar', _('Scene variable'), '', false)
@@ -237,8 +241,8 @@ module.exports = {
           'Load a JSON formatted text from a file and convert it to a scene variable (potentially a structure variable with children). Only use this on small files to avoid any lag or freeze during the game execution.'
         ),
         _('Load JSON from _PARAM1_ into scene variable _PARAM0_'),
-        _('Filesystem/Windows, Linux, MacOS'),
-        'JsPlatform/Extensions/filesystem_save_file24.png',
+        _('Windows, Linux, MacOS'),
+        'JsPlatform/Extensions/filesystem_save_file32.png',
         'JsPlatform/Extensions/filesystem_save_file32.png'
       )
       .addParameter('scenevar', _('Scene variable'), '', false)
@@ -263,8 +267,8 @@ module.exports = {
           "Load a JSON formatted text from a file and convert it to a scene variable (potentially a structure variable with children), asynchronously. Use this for large files to avoid any lag or freeze during game execution. The content of the file will be available as a scene variable after a small delay (usually a few milliseconds). The 'result' variable gets updated when the operation has finished."
         ),
         _('Load JSON from _PARAM1_ into scene variable _PARAM0_'),
-        _('Filesystem/Windows, Linux, MacOS/Asynchronous'),
-        'JsPlatform/Extensions/filesystem_save_file24.png',
+        _('Windows, Linux, MacOS/Asynchronous'),
+        'JsPlatform/Extensions/filesystem_save_file32.png',
         'JsPlatform/Extensions/filesystem_save_file32.png'
       )
       .addParameter('scenevar', _('Scene variable'), '', false)
@@ -287,8 +291,8 @@ module.exports = {
         _('Delete a file'),
         _('Delete a file from the filesystem.'),
         _('Delete the file _PARAM0_'),
-        _('Filesystem/Windows, Linux, MacOS'),
-        'JsPlatform/Extensions/filesystem_delete_file24.png',
+        _('Windows, Linux, MacOS'),
+        'JsPlatform/Extensions/filesystem_delete_file32.png',
         'JsPlatform/Extensions/filesystem_delete_file32.png'
       )
       .addParameter('string', _('File path'), '', false)
@@ -312,8 +316,8 @@ module.exports = {
           'Delete a file from the filesystem asynchronously. The option result variable will be updated once the file is deleted.'
         ),
         _('Delete the file _PARAM0_'),
-        _('Filesystem/Windows, Linux, MacOS/Asynchronous'),
-        'JsPlatform/Extensions/filesystem_delete_file24.png',
+        _('Windows, Linux, MacOS/Asynchronous'),
+        'JsPlatform/Extensions/filesystem_delete_file32.png',
         'JsPlatform/Extensions/filesystem_delete_file32.png'
       )
       .addParameter('string', _('File path'), '', false)
@@ -334,7 +338,7 @@ module.exports = {
         'DesktopPath',
         _('Desktop folder'),
         _('Get the path to the desktop folder.'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addCodeOnlyParameter('currentScene', '')
@@ -347,7 +351,7 @@ module.exports = {
         'DocumentsPath',
         _('Documents folder'),
         _('Get the path to the documents folder.'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addCodeOnlyParameter('currentScene', '')
@@ -360,7 +364,7 @@ module.exports = {
         'PicturesPath',
         _('Pictures folder'),
         _('Get the path to the pictures folder.'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addCodeOnlyParameter('currentScene', '')
@@ -373,7 +377,7 @@ module.exports = {
         'ExecutablePath',
         _('Game executable file'),
         _('Get the path to this game executable file.'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addCodeOnlyParameter('currentScene', '')
@@ -386,7 +390,7 @@ module.exports = {
         'ExecutableFolderPath',
         _('Game executable folder'),
         _('Get the path to this game executable folder.'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addCodeOnlyParameter('currentScene', '')
@@ -399,7 +403,7 @@ module.exports = {
         'UserdataPath',
         _('Userdata folder (for application settings)'),
         _('Get the path to userdata folder (for application settings).'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addCodeOnlyParameter('currentScene', '')
@@ -412,7 +416,7 @@ module.exports = {
         'UserHomePath',
         _("User's Home folder"),
         _('Get the path to the user home folder.'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addCodeOnlyParameter('currentScene', '')
@@ -425,7 +429,7 @@ module.exports = {
         'TempPath',
         _('Temp folder'),
         _('Get the path to temp folder.'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addCodeOnlyParameter('currentScene', '')
@@ -438,7 +442,7 @@ module.exports = {
         'PathDelimiter',
         _('Path delimiter'),
         _('Get the operating system path delimiter.'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .getCodeExtraInformation()
@@ -452,7 +456,7 @@ module.exports = {
         _(
           'Returns the portion of the path that represents the directories, without the ending file name.'
         ),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addParameter('string', _('File or folder path'), '', false)
@@ -465,7 +469,7 @@ module.exports = {
         'FileName',
         _('Get file name from a path'),
         _('Returns the name of the file with its extension, if any.'),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addParameter('string', _('File path'), '', false)
@@ -480,7 +484,7 @@ module.exports = {
         _(
           'Returns the extension of the file designated by the given path, including the extension period. For example: ".txt".'
         ),
-        _('Filesystem/Windows, Linux, MacOS'),
+        _('Windows, Linux, MacOS'),
         'JsPlatform/Extensions/filesystem_folder32.png'
       )
       .addParameter('string', _('File path'), '', false)

Extensions/Firebase/JsExtension.js

@@ -28,7 +28,11 @@ module.exports = {
         'Arthur Pacaud (arthuro555)',
         'MIT'
       )
-      .setExtensionHelpPath('/all-features/firebase');
+      .setExtensionHelpPath('/all-features/firebase')
+      .setCategory('Network');
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('Firebase'))
+      .setIcon('JsPlatform/Extensions/firebase.png');
 
     extension
       .registerProperty('FirebaseConfig')
@@ -42,7 +46,7 @@ module.exports = {
         _('Enable analytics'),
         _('Enables Analytics for that project.'),
         _('Enable analytics'),
-        _('Firebase/Analytics'),
+        _('Analytics'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -64,7 +68,7 @@ module.exports = {
             'Can also pass additional data to the Analytics'
         ),
         _('Trigger Event _PARAM0_ with argument _PARAM1_'),
-        _('Firebase/Analytics'),
+        _('Analytics'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -90,7 +94,7 @@ module.exports = {
             'For advanced usage only.'
         ),
         _("Set current user's ID to _PARAM0_"),
-        _('Firebase/Analytics'),
+        _('Analytics'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -114,7 +118,7 @@ module.exports = {
             'Can be used to classify user in Analytics.'
         ),
         _('Set property _PARAM0_ of the current user to _PARAM1_'),
-        _('Firebase/Analytics'),
+        _('Analytics'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -136,7 +140,7 @@ module.exports = {
         'GetRemoteConfigString',
         _('Get Remote setting as String'),
         _('Get a setting from Firebase Remote Config as a string.'),
-        _('Firebase/Remote Config'),
+        _('Remote Config'),
         'JsPlatform/Extensions/firebase.png'
       )
       .addParameter('string', _('Setting Name'), '', false)
@@ -156,7 +160,7 @@ module.exports = {
         'GetRemoteConfigNumber',
         _('Get Remote setting as Number'),
         _('Get a setting from Firebase Remote Config as Number.'),
-        _('Firebase/Remote Config'),
+        _('Remote Config'),
         'JsPlatform/Extensions/firebase.png'
       )
       .addParameter('string', _('Setting Name'), '', false)
@@ -177,7 +181,7 @@ module.exports = {
         _('Set Remote Config Auto Update Inteval'),
         _('Sets Remote Config Auto Update Inteval.'),
         _('Set Remote Config Auto Update Inteval to _PARAM0_'),
-        _('Firebase/Remote Config'),
+        _('Remote Config'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -205,7 +209,7 @@ module.exports = {
             'the config is still loading.'
         ),
         _('Set default config to _PARAM0_'),
-        _('Firebase/Remote Config'),
+        _('Remote Config'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -229,7 +233,7 @@ module.exports = {
         _('Force sync the configuration'),
         _('Use this to sync the Remote Config with the client at any time.'),
         _('Synchronize Remote Config'),
-        _('Firebase/Remote Config'),
+        _('Remote Config'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -248,7 +252,7 @@ module.exports = {
         _('Create account with with email'),
         _('Create an account with email and password as credentials.'),
         _('Create account with email _PARAM0_ and password _PARAM1_'),
-        _('Firebase/Authentication'),
+        _('Authentication'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -275,7 +279,7 @@ module.exports = {
         _('Sign into an account with email'),
         _('Sign into an account with email and password as credentials. '),
         _('Connect to account with email _PARAM0_ and password _PARAM1_'),
-        _('Firebase/Authentication'),
+        _('Authentication'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -300,7 +304,7 @@ module.exports = {
         _('Log out of the account'),
         _('Logs out of the current account. '),
         _('Log out from the account'),
-        _('Firebase/Authentication'),
+        _('Authentication'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -321,7 +325,7 @@ module.exports = {
             'Provider authentication only works in the browser! Not on previews or pc/mobile exports.'
         ),
         _('Connect to account with Provider _PARAM0_'),
-        _('Firebase/Authentication'),
+        _('Authentication'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -350,7 +354,7 @@ module.exports = {
         _('Sign In as an anonymous guest'),
         _('Sign into a temporary anonymous account.'),
         _('Authenticate anonymously'),
-        _('Firebase/Authentication'),
+        _('Authentication'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -376,7 +380,7 @@ module.exports = {
             'this before actions requiring authentications.'
         ),
         _('Check for authentication'),
-        _('Firebase/Authentication'),
+        _('Authentication'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -394,7 +398,7 @@ module.exports = {
         _(
           'Get the user authentififcation token. The token is the proof of authentication.'
         ),
-        _('Firebase/Authentication'),
+        _('Authentication'),
         'JsPlatform/Extensions/firebase.png'
       )
       .addParameter('string', _('Setting Name'), '', false)
@@ -412,7 +416,7 @@ module.exports = {
         _('Is the user email address verified'),
         _('Checks if the email address of the user got verified.'),
         _('The email of the user is verified'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -430,7 +434,7 @@ module.exports = {
         'GetUserEmail',
         _('Get the user email address'),
         _('Gets the user email address.'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -447,7 +451,7 @@ module.exports = {
         'GetAccountCreationTime',
         _('Get the accounts creation time'),
         _('Gets the accounts creation time.'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -464,7 +468,7 @@ module.exports = {
         'GetLastLoginTime',
         _('Get the user last login time'),
         _('Gets the user last login time.'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -481,7 +485,7 @@ module.exports = {
         'GetUserDisplayName',
         _('Get the user display name'),
         _('Gets the user display name.'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -498,7 +502,7 @@ module.exports = {
         'GetPhoneNumber',
         _('Get the user phone number'),
         _('Gets the user phone number.'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -518,7 +522,7 @@ module.exports = {
           'Gets the user Unique IDentifier. Use that to link data to an ' +
             'user instead of the name or email.'
         ),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -535,7 +539,7 @@ module.exports = {
         'GetTenantID',
         _('Get the user tenant ID'),
         _('Gets the user tenant ID. For advanced usage only.'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -552,7 +556,7 @@ module.exports = {
         'GetRefreshToken',
         _('Get the user refresh token'),
         _('Gets the user refresh token. For advanced usage only.'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -569,7 +573,7 @@ module.exports = {
         'GetPhotoURL',
         _('Get the user profile picture URL'),
         _('Gets an URL to the user profile picture.'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -587,7 +591,7 @@ module.exports = {
         _('Send a verification email'),
         _('Send a link per email to verify the user email.'),
         _('Send verification email'),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -606,7 +610,7 @@ module.exports = {
         _('Set display name'),
         _('Sets the user display name.'),
         _("Set the user's display name to _PARAM0_"),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -626,7 +630,7 @@ module.exports = {
         _('Set the user profile picture'),
         _('Sets the user profile picture URL to a new one.'),
         _("Set the user's profile picture URL to _PARAM0_"),
-        _('Firebase/Authentication/User Management'),
+        _('Authentication/User Management'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -652,7 +656,7 @@ module.exports = {
         _(
           "Change the user's email to _PARAM0_ and store result in _PARAM4_ (send verification email: _PARAM3_)"
         ),
-        _('Firebase/Authentication/User Management/Advanced'),
+        _('Authentication/User Management/Advanced'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -693,7 +697,7 @@ module.exports = {
         _(
           "Change the user's email to _PARAM0_ and store result in _PARAM2_ (send verification email: _PARAM1_)"
         ),
-        _('Firebase/Authentication/User Management/Advanced'),
+        _('Authentication/User Management/Advanced'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -732,7 +736,7 @@ module.exports = {
           'Change the user password to _PARAM2_ and store result in ' +
             '_PARAM4_ (send verification email: _PARAM3_)'
         ),
-        _('Firebase/Authentication/User Management/Advanced'),
+        _('Authentication/User Management/Advanced'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -774,7 +778,7 @@ module.exports = {
           'Change the user password to _PARAM0_ and store result in ' +
             '_PARAM2_ (send verification email: _PARAM1_)'
         ),
-        _('Firebase/Authentication/User Management/Advanced'),
+        _('Authentication/User Management/Advanced'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -810,7 +814,7 @@ module.exports = {
             'Deletes the user account.'
         ),
         _('Delete the user account and store result in _PARAM2_'),
-        _('Firebase/Authentication/User Management/Advanced'),
+        _('Authentication/User Management/Advanced'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -841,7 +845,7 @@ module.exports = {
             'This is the same as "Delete the user account" but reauthenticates via an external provider.'
         ),
         _('Delete the user account and store result in _PARAM0_'),
-        _('Firebase/Authentication/User Management/Advanced'),
+        _('Authentication/User Management/Advanced'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -868,7 +872,7 @@ module.exports = {
         _('Enable performance measuring'),
         _('Enables performance measuring.'),
         _('Enable performance measuring'),
-        _('Firebase/Performance Measuring'),
+        _('Performance Measuring'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -889,7 +893,7 @@ module.exports = {
             'They are used to measure performance of custom events.'
         ),
         _('Create performance tracker: _PARAM0_'),
-        _('Firebase/Performance Measuring'),
+        _('Performance Measuring'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -911,7 +915,7 @@ module.exports = {
         _('Start a tracer'),
         _('Start measuring performance for that tracer'),
         _('Start performance measuring on tracer _PARAM0_'),
-        _('Firebase/Performance Measuring'),
+        _('Performance Measuring'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -933,7 +937,7 @@ module.exports = {
         _('Stop a tracer'),
         _('Stop measuring performance for that tracer'),
         _('Stop performance measuring on tracer _PARAM0_'),
-        _('Firebase/Performance Measuring'),
+        _('Performance Measuring'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -960,7 +964,7 @@ module.exports = {
         _(
           'Record performance for _PARAM1_ms with a delay of _PARAM2_ms (store in tracker _PARAM0_)'
         ),
-        _('Firebase/Performance Measuring'),
+        _('Performance Measuring'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -996,7 +1000,7 @@ module.exports = {
           'Call HTTP Function _PARAM0_ with parameter(s) _PARAM1_ ' +
             '(Callback variables: Value: _PARAM2_ State: _PARAM3_)'
         ),
-        _('Firebase/Functions'),
+        _('Functions'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1033,7 +1037,7 @@ module.exports = {
             _('Enable Messaging'),
 			_('Enables Firebase push messaging.'),
 			_('Enable Firebase Messaging with Public Key _PARAM0_.'),
-            _('Firebase/Messaging'),
+            _('Messaging'),
 			'JsPlatform/Extensions/firebase.png',
 			'JsPlatform/Extensions/firebase.png'
 		  )
@@ -1055,7 +1059,7 @@ module.exports = {
         _(
           'Set a field to the timstamp on the server when the request arrives there'
         ),
-        _('Firebase/Cloud Firestore'),
+        _('Cloud Firestore'),
         'JsPlatform/Extensions/firebase.png'
       )
       .getCodeExtraInformation()
@@ -1080,7 +1084,7 @@ module.exports = {
             'A query allows to get a filtered and ordered list of documents in a collection.'
         ),
         _('Create a query named _PARAM0_ for collection _PARAM1_'),
-        _('Firebase/Cloud Firestore/Queries/Initialize'),
+        _('Cloud Firestore/Queries/Initialize'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1103,7 +1107,7 @@ module.exports = {
         _('Start a query from another query'),
         _('Start a query with the same collection and filters as another one.'),
         _('Create a query named _PARAM0_ from query _PARAM1_'),
-        _('Firebase/Cloud Firestore/Queries/Initialize'),
+        _('Cloud Firestore/Queries/Initialize'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1134,7 +1138,7 @@ module.exports = {
         _(
           'Filter query _PARAM0_ to remove documents whose field _PARAM1_ is not _PARAM2__PARAM3_'
         ),
-        _('Firebase/Cloud Firestore/Queries/Filters'),
+        _('Cloud Firestore/Queries/Filters'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1167,7 +1171,7 @@ module.exports = {
         _(
           'Filter query _PARAM0_ to remove documents whose field _PARAM1_ is not _PARAM2__PARAM3_'
         ),
-        _('Firebase/Cloud Firestore/Queries/Filters'),
+        _('Cloud Firestore/Queries/Filters'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1198,7 +1202,7 @@ module.exports = {
         _('Order by field value'),
         _('Orders all documents in the query by a the value of a field.'),
         _('Order query _PARAM0_ by field _PARAM1_ (direction: _PARAM2_)'),
-        _('Firebase/Cloud Firestore/Queries/Filters'),
+        _('Cloud Firestore/Queries/Filters'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1234,7 +1238,7 @@ module.exports = {
         _(
           'Limit query _PARAM0_ to _PARAM1_ documents (begin from the end: _PARAM2_)'
         ),
-        _('Firebase/Cloud Firestore/Queries/Filters'),
+        _('Cloud Firestore/Queries/Filters'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1266,7 +1270,7 @@ module.exports = {
         _(
           'Skip documents with fields (before: _PARAM2_) value _PARAM1_ in query _PARAM0_ (include documents at that value: _PARAM3_)'
         ),
-        _('Firebase/Cloud Firestore/Queries/Filters'),
+        _('Cloud Firestore/Queries/Filters'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1308,7 +1312,7 @@ module.exports = {
         _(
           'Execute query _PARAM0_ and store results into _PARAM1_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Cloud Firestore/Queries/Execute'),
+        _('Cloud Firestore/Queries/Execute'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1350,7 +1354,7 @@ module.exports = {
         _(
           'Watch and automatically execute query _PARAM0_ and store results into _PARAM1_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Cloud Firestore/Queries/Execute'),
+        _('Cloud Firestore/Queries/Execute'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1392,7 +1396,7 @@ module.exports = {
             'This needs to be called before any other firestore operation, otherwise it will fail.'
         ),
         _('Enable persistence'),
-        _('Firebase/Cloud Firestore'),
+        _('Cloud Firestore'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1416,7 +1420,7 @@ module.exports = {
             'This needs to be called before any other firestore operation, otherwise it will fail.'
         ),
         _('Disable persistence'),
-        _('Firebase/Cloud Firestore'),
+        _('Cloud Firestore'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1437,7 +1441,7 @@ module.exports = {
         _('Re-enable network'),
         _('Re-enables the connection to the database after disabling it.'),
         _('Re-enable network'),
-        _('Firebase/Cloud Firestore'),
+        _('Cloud Firestore'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1462,7 +1466,7 @@ module.exports = {
             'cache, and any write operations will be queued until the network is restored.'
         ),
         _('Disable network'),
-        _('Firebase/Cloud Firestore'),
+        _('Cloud Firestore'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1485,7 +1489,7 @@ module.exports = {
         _(
           'Write _PARAM2_ to firestore in document _PARAM1_ of collection _PARAM0_ (store result state in _PARAM3_)'
         ),
-        _('Firebase/Cloud Firestore/Documents'),
+        _('Cloud Firestore/Documents'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1517,7 +1521,7 @@ module.exports = {
         _(
           'Add _PARAM1_ to firestore collection _PARAM0_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Cloud Firestore/Documents'),
+        _('Cloud Firestore/Documents'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1548,7 +1552,7 @@ module.exports = {
         _(
           'Write _PARAM3_ to firestore in field _PARAM2_ of document _PARAM1_ in collection _PARAM0_ (store result state in _PARAM4_, Merge: _PARAM5_)'
         ),
-        _('Firebase/Cloud Firestore/Fields'),
+        _('Cloud Firestore/Fields'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1582,7 +1586,7 @@ module.exports = {
         _(
           'Update firestore document _PARAM1_ in collection _PARAM0_ with _PARAM2_ (store result state in _PARAM3_)'
         ),
-        _('Firebase/Cloud Firestore/Documents'),
+        _('Cloud Firestore/Documents'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1614,7 +1618,7 @@ module.exports = {
         _(
           'Update field _PARAM2_ of firestore document _PARAM1_ in collection _PARAM0_ with _PARAM3_ (store result state in _PARAM4_)'
         ),
-        _('Firebase/Cloud Firestore/Fields'),
+        _('Cloud Firestore/Fields'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1647,7 +1651,7 @@ module.exports = {
         _(
           'Delete firestore document _PARAM1_ in collection _PARAM0_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Cloud Firestore/Documents'),
+        _('Cloud Firestore/Documents'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1678,7 +1682,7 @@ module.exports = {
         _(
           'Delete field _PARAM2_ of firestore document _PARAM1_ in collection _PARAM0_ with (store result state in _PARAM3_)'
         ),
-        _('Firebase/Cloud Firestore/Fields'),
+        _('Cloud Firestore/Fields'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1710,7 +1714,7 @@ module.exports = {
         _(
           'Load firestore document _PARAM1_ from collection _PARAM0_ into _PARAM2_ (store result state in _PARAM3_)'
         ),
-        _('Firebase/Cloud Firestore/Documents'),
+        _('Cloud Firestore/Documents'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1747,7 +1751,7 @@ module.exports = {
         _(
           'Load field _PARAM2_ of firestore document _PARAM1_ in collection _PARAM0_ into _PARAM3_ (store result state in _PARAM4_)'
         ),
-        _('Firebase/Cloud Firestore/Fields'),
+        _('Cloud Firestore/Fields'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1787,7 +1791,7 @@ module.exports = {
         _(
           'Check for existence of _PARAM1_ in collection _PARAM0_ and store result in _PARAM2_ (store result state in _PARAM3_)'
         ),
-        _('Firebase/Cloud Firestore/Documents'),
+        _('Cloud Firestore/Documents'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1826,7 +1830,7 @@ module.exports = {
         _(
           'Check for existence of _PARAM2_ in document _PARAM1_ of collection _PARAM0_ and store result in _PARAM3_ (store result state in _PARAM4_)'
         ),
-        _('Firebase/Cloud Firestore/Fields'),
+        _('Cloud Firestore/Fields'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1866,7 +1870,7 @@ module.exports = {
         _(
           'List all documents in _PARAM0_ and store result in _PARAM1_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Cloud Firestore'),
+        _('Cloud Firestore'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1905,7 +1909,7 @@ module.exports = {
         _(
           'Save _PARAM0_ in location _PARAM1_ to Firebase storage and store access URL in _PARAM3_ (Format: _PARAM2_, Store result state in _PARAM4_)'
         ),
-        _('Firebase/Storage'),
+        _('Storage'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1946,7 +1950,7 @@ module.exports = {
         _(
           'Get a download url for _PARAM0_ and store it in _PARAM1_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Storage'),
+        _('Storage'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -1980,7 +1984,7 @@ module.exports = {
         _(
           'Write _PARAM1_ to Database in _PARAM0_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -2007,7 +2011,7 @@ module.exports = {
         _(
           'Write _PARAM2_ in field _PARAM1_ of _PARAM0_ (store result state in _PARAM3_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -2035,7 +2039,7 @@ module.exports = {
         _(
           'Update varable _PARAM0_ with _PARAM1_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -2062,7 +2066,7 @@ module.exports = {
         _(
           'Update field _PARAM1_ of _PARAM0_ with _PARAM2_ (store result state in _PARAM3_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -2090,7 +2094,7 @@ module.exports = {
         _(
           'Delete variable _PARAM0_ from database (store result state in _PARAM1_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -2116,7 +2120,7 @@ module.exports = {
         _(
           'Delete field _PARAM1_ of variable _PARAM0_ on the database (store result state in _PARAM2_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -2145,7 +2149,7 @@ module.exports = {
         _(
           'Load database variable _PARAM0_ into _PARAM1_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -2179,7 +2183,7 @@ module.exports = {
         _(
           'Load field _PARAM1_ of database variable _PARAM0_ into _PARAM2_ (store result state in _PARAM3_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -2214,7 +2218,7 @@ module.exports = {
         _(
           'Check for existence of _PARAM0_ and store result in _PARAM1_ (store result state in _PARAM2_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )
@@ -2248,7 +2252,7 @@ module.exports = {
         _(
           'Check for existence of _PARAM1_ in database variable _PARAM0_ and store result in _PARAM2_ (store result state in _PARAM3_)'
         ),
-        _('Firebase/Realtime Database'),
+        _('Realtime Database'),
         'JsPlatform/Extensions/firebase.png',
         'JsPlatform/Extensions/firebase.png'
       )

Extensions/Inventory/Extension.cpp

@@ -13,12 +13,16 @@ This project is released under the MIT License.
 void DeclareInventoryExtension(gd::PlatformExtension& extension) {
   extension.SetExtensionInformation(
       "Inventory",
-      _("Inventory"),
+      _("Inventories"),
       _("Provides actions and conditions to add an inventory to your game, "
         "with items in memory."),
       "Florian Rival",
       "Open source (MIT License)")
-      .SetExtensionHelpPath("/all-features/inventory");
+      .SetExtensionHelpPath("/all-features/inventory")
+      .SetCategory("Advanced");
+    extension
+      .AddInstructionOrExpressionGroupMetadata(_("Inventories"))
+      .SetIcon("CppPlatform/Extensions/Inventoryicon.png");
 
 #if defined(GD_IDE_ONLY)
   extension
@@ -26,9 +30,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                  _("Add an item"),
                  _("Add an item in an inventory."),
                  _("Add a _PARAM2_ to inventory _PARAM1_"),
-                 _("Inventories"),
-                 "CppPlatform/Extensions/Inventoryicon24.png",
-                 "CppPlatform/Extensions/Inventoryicon16.png")
+                 "",
+                 "CppPlatform/Extensions/Inventoryicon.png",
+                 "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -41,9 +45,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                  _("Remove an item"),
                  _("Remove an item from an inventory."),
                  _("Remove a _PARAM2_ from inventory _PARAM1_"),
-                 _("Inventories"),
-                 "CppPlatform/Extensions/Inventoryicon24.png",
-                 "CppPlatform/Extensions/Inventoryicon16.png")
+                 "",
+                 "CppPlatform/Extensions/Inventoryicon.png",
+                 "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -56,9 +60,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                     _("Item count"),
                     _("Compare the number of an item in an inventory."),
                     _("the count of _PARAM2_ in _PARAM1_"),
-                    _("Inventories"),
-                    "CppPlatform/Extensions/Inventoryicon24.png",
-                    "CppPlatform/Extensions/Inventoryicon16.png")
+                    "",
+                    "CppPlatform/Extensions/Inventoryicon.png",
+                    "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -73,9 +77,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                     _("Check if at least one of the specified items is in the "
                       "inventory."),
                     _("Inventory _PARAM1_ contains a _PARAM2_"),
-                    _("Inventories"),
-                    "CppPlatform/Extensions/Inventoryicon24.png",
-                    "CppPlatform/Extensions/Inventoryicon16.png")
+                    "",
+                    "CppPlatform/Extensions/Inventoryicon.png",
+                    "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -91,9 +95,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                    "each item is unlimited."),
                  _("Set the maximum count for _PARAM2_ in inventory _PARAM1_ "
                    "to _PARAM3_"),
-                 _("Inventories"),
-                 "CppPlatform/Extensions/Inventoryicon24.png",
-                 "CppPlatform/Extensions/Inventoryicon16.png")
+                 "",
+                 "CppPlatform/Extensions/Inventoryicon.png",
+                 "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -109,9 +113,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                    "inventory. This is the case by default for each item."),
                  _("Allow an unlimited count of _PARAM2_ in inventory "
                    "_PARAM1_: _PARAM3_"),
-                 _("Inventories"),
-                 "CppPlatform/Extensions/Inventoryicon24.png",
-                 "CppPlatform/Extensions/Inventoryicon16.png")
+                 "",
+                 "CppPlatform/Extensions/Inventoryicon.png",
+                 "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -126,9 +130,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                     _("Check if an item has reached its maximum number allowed "
                       "in the inventory."),
                     _("Inventory _PARAM1_ is full of _PARAM2_"),
-                    _("Inventories"),
-                    "CppPlatform/Extensions/Inventoryicon24.png",
-                    "CppPlatform/Extensions/Inventoryicon16.png")
+                    "",
+                    "CppPlatform/Extensions/Inventoryicon.png",
+                    "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -142,9 +146,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                  _("Mark an item as being equipped. If the item count is 0, it "
                    "won't be marked as equipped."),
                  _("Set _PARAM2_ as equipped in inventory _PARAM1_: _PARAM3_"),
-                 _("Inventories"),
-                 "CppPlatform/Extensions/Inventoryicon24.png",
-                 "CppPlatform/Extensions/Inventoryicon16.png")
+                 "",
+                 "CppPlatform/Extensions/Inventoryicon.png",
+                 "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -158,9 +162,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                     _("Item equipped"),
                     _("Check if an item is equipped."),
                     _("_PARAM2_ is equipped in inventory _PARAM1_"),
-                    _("Inventories"),
-                    "CppPlatform/Extensions/Inventoryicon24.png",
-                    "CppPlatform/Extensions/Inventoryicon16.png")
+                    "",
+                    "CppPlatform/Extensions/Inventoryicon.png",
+                    "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -174,9 +178,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                  _("Save all the items of the inventory in a scene variable, so that "
                    "it can be restored later."),
                  _("Save inventory _PARAM1_ in variable _PARAM2_"),
-                 _("Inventories/Variables"),
-                 "CppPlatform/Extensions/Inventoryicon24.png",
-                 "CppPlatform/Extensions/Inventoryicon16.png")
+                 _("Variables"),
+                 "CppPlatform/Extensions/Inventoryicon.png",
+                 "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -189,9 +193,9 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
                  _("Load an inventory from a scene variable"),
                  _("Load the content of the inventory from a scene variable."),
                  _("Load inventory _PARAM1_ from variable _PARAM2_"),
-                 _("Inventories/Variables"),
-                 "CppPlatform/Extensions/Inventoryicon24.png",
-                 "CppPlatform/Extensions/Inventoryicon16.png")
+                 _("Variables"),
+                 "CppPlatform/Extensions/Inventoryicon.png",
+                 "CppPlatform/Extensions/Inventoryicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
@@ -203,8 +207,8 @@ void DeclareInventoryExtension(gd::PlatformExtension& extension) {
       .AddExpression("Count",
                      _("Item count"),
                      _("Get the number of an item in the inventory"),
-                     _("Inventory"),
-                     "CppPlatform/Extensions/Inventoryicon16.png")
+                     "",
+                     "CppPlatform/Extensions/Inventoryicon.png")
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Inventory name"))
       .AddParameter("string", _("Item name"))

Extensions/Lighting/JsExtension.js

@@ -59,7 +59,7 @@ module.exports = {
         _('Light Obstacle Behavior'),
         'LightObstacleBehavior',
         _(
-          'This behavior makes the object an obstacle to the light. The light emitted by light objects will be stopped by the object.'
+          'Flag objects as being obstacles to light. The light emitted by light objects will be stopped by the object.'
         ),
         '',
         'CppPlatform/Extensions/lightObstacleIcon32.png',
@@ -132,6 +132,7 @@ module.exports = {
               'When activated, display the lines used to render the light - useful to understand how the light is rendered on screen.'
             )
           )
+          .setGroup(_('Advanced'))
       );
 
       objectProperties
@@ -193,7 +194,8 @@ module.exports = {
       )
       .setIncludeFile('Extensions/Lighting/lightruntimeobject.js')
       .addIncludeFile('Extensions/Lighting/lightruntimeobject-pixi-renderer.js')
-      .addIncludeFile('Extensions/Lighting/lightobstacleruntimebehavior.js');
+      .addIncludeFile('Extensions/Lighting/lightobstacleruntimebehavior.js')
+      .setCategoryFullName(_('Lights'));
 
     object
       .addAction(
@@ -241,7 +243,7 @@ module.exports = {
     objectsEditorService.registerEditorConfiguration(
       'Lighting::LightObject',
       objectsEditorService.getDefaultObjectJsImplementationPropertiesEditor({
-        helpPagePath: '/objects/light',
+        helpPagePath: '/all-features/lighting/reference',
       })
     );
   },

Extensions/Lighting/lightobstacleruntimebehavior.ts

@@ -53,8 +53,8 @@ namespace gdjs {
     getAllObstaclesAround(
       object: gdjs.RuntimeObject,
       radius: number,
-      result: gdjs.BehaviorRBushAABB<gdjs.LightObstacleRuntimeBehavior>[]
-    ) {
+      result: gdjs.LightObstacleRuntimeBehavior[]
+    ): void {
       // TODO: This would better be done using the object AABB (getAABB), as (`getCenterX`;`getCenterY`) point
       // is not necessarily in the middle of the object (for sprites for example).
       const x = object.getX();
@@ -70,9 +70,13 @@ namespace gdjs {
       searchArea.maxX = x + radius;
       // @ts-ignore
       searchArea.maxY = y + radius;
-      const nearbyObstacles = this._obstacleRBush.search(searchArea);
+      const nearbyObstacles: gdjs.BehaviorRBushAABB<
+        gdjs.LightObstacleRuntimeBehavior
+      >[] = this._obstacleRBush.search(searchArea);
       result.length = 0;
-      result.push.apply(result, nearbyObstacles);
+      nearbyObstacles.forEach((nearbyObstacle) =>
+        result.push(nearbyObstacle.behavior)
+      );
     }
   }
 

Extensions/Lighting/lightruntimeobject-pixi-renderer.ts

@@ -369,9 +369,7 @@ namespace gdjs {
      * @returns the vertices of mesh.
      */
     _computeLightVertices(): Array<FloatPoint> {
-      const lightObstacles: gdjs.BehaviorRBushAABB<
-        LightObstacleRuntimeBehavior
-      >[] = [];
+      const lightObstacles: gdjs.LightObstacleRuntimeBehavior[] = [];
       if (this._manager) {
         this._manager.getAllObstaclesAround(
           this._object,
@@ -402,9 +400,7 @@ namespace gdjs {
       const obstaclePolygons: Array<gdjs.Polygon> = [];
       obstaclePolygons.push(this._lightBoundingPoly);
       for (let i = 0; i < lightObstacles.length; i++) {
-        const obstacleHitBoxes = lightObstacles[
-          i
-        ].behavior.owner.getHitBoxesAround(
+        const obstacleHitBoxes = lightObstacles[i].owner.getHitBoxesAround(
           searchAreaLeft,
           searchAreaTop,
           searchAreaRight,

Extensions/LinkedObjects/Extension.cpp

@@ -23,7 +23,10 @@ void DeclareLinkedObjectsExtension(gd::PlatformExtension& extension) {
           "that is more efficient than using variables.",
           "Florian Rival",
           "Open source (MIT License)")
-      .SetExtensionHelpPath("/all-features/linked-objects");
+      .SetExtensionHelpPath("/all-features/linked-objects")
+      .SetCategory("Advanced");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Linked objects"))
+      .SetIcon("CppPlatform/Extensions/LinkedObjectsicon24.png");
 
 #if defined(GD_IDE_ONLY)
 
@@ -33,9 +36,9 @@ void DeclareLinkedObjectsExtension(gd::PlatformExtension& extension) {
                  _("Link two objects together, so as to be able to get one "
                    "from the other."),
                  _("Link _PARAM1_ and _PARAM2_"),
-                 _("Linked objects"),
+                 "",
                  "CppPlatform/Extensions/LinkedObjectsicon24.png",
-                 "CppPlatform/Extensions/LinkedObjectsicon16.png")
+                 "CppPlatform/Extensions/LinkedObjectsicon24.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("objectPtr", _("Object 1"))
@@ -49,9 +52,9 @@ void DeclareLinkedObjectsExtension(gd::PlatformExtension& extension) {
                  _("Unlink two objects"),
                  _("Unlink two objects."),
                  _("Unlink _PARAM1_ and _PARAM2_"),
-                 _("Linked objects"),
+                 "",
                  "CppPlatform/Extensions/LinkedObjectsicon24.png",
-                 "CppPlatform/Extensions/LinkedObjectsicon16.png")
+                 "CppPlatform/Extensions/LinkedObjectsicon24.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("objectPtr", _("Object 1"))
@@ -65,9 +68,9 @@ void DeclareLinkedObjectsExtension(gd::PlatformExtension& extension) {
                  _("Unlink all objects from an object"),
                  _("Unlink all objects from an object."),
                  _("Unlink all objects from _PARAM1_"),
-                 _("Linked objects"),
+                 "",
                  "CppPlatform/Extensions/LinkedObjectsicon24.png",
-                 "CppPlatform/Extensions/LinkedObjectsicon16.png")
+                 "CppPlatform/Extensions/LinkedObjectsicon24.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("objectPtr", _("Object"))
@@ -82,9 +85,9 @@ void DeclareLinkedObjectsExtension(gd::PlatformExtension& extension) {
                       "next conditions and actions.\nThe condition will return "
                       "false if no object was taken into account."),
                     _("Take into account all \"_PARAM1_\" linked to _PARAM2_"),
-                    _("Linked objects"),
+                    "",
                     "CppPlatform/Extensions/LinkedObjectsicon24.png",
-                    "CppPlatform/Extensions/LinkedObjectsicon16.png")
+                    "CppPlatform/Extensions/LinkedObjectsicon24.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("objectList", _("Pick these objects..."))
@@ -100,9 +103,9 @@ void DeclareLinkedObjectsExtension(gd::PlatformExtension& extension) {
           _("Take into account linked objects"),
           _("Take objects linked to the object into account for next actions."),
           _("Take into account all \"_PARAM1_\" linked to _PARAM2_"),
-          _("Linked objects"),
+          "",
           "CppPlatform/Extensions/LinkedObjectsicon24.png",
-          "CppPlatform/Extensions/LinkedObjectsicon16.png")
+          "CppPlatform/Extensions/LinkedObjectsicon24.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("objectList", _("Pick these objects..."))

Extensions/P2P/B_p2ptools.ts

@@ -211,8 +211,7 @@ namespace gdjs {
       };
 
       /**
-       * Gets an event from {@link events}
-       * or creates it if it doesn't exist.
+       * Get an event or creates it if it doesn't exist.
        */
       export const getEvent = (name: string) => {
         if (!events.hasOwnProperty(name)) events[name] = new Event();

Extensions/P2P/JsExtension.js

@@ -28,12 +28,16 @@ module.exports = {
     extension
       .setExtensionInformation(
         'P2P',
-        _('Peer-to-Peer communication (experimental)'),
+        _('P2P (experimental)'),
         'Allow game instances to communicate remotely using messages sent via WebRTC (P2P).',
         'Arthur Pacaud (arthuro555)',
         'MIT'
       )
-      .setExtensionHelpPath('/all-features/p2p');
+      .setExtensionHelpPath('/all-features/p2p')
+      .setCategory('Network');
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('P2P (experimental)'))
+      .setIcon('JsPlatform/Extensions/p2picon.svg');
 
     extension
       .addCondition(
@@ -41,7 +45,7 @@ module.exports = {
         _('Event triggered by peer'),
         _('Triggers once when a connected client sends the event'),
         _('Event _PARAM0_ received from other client (data loss: _PARAM1_)'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -60,7 +64,7 @@ module.exports = {
           'True if the peer-to-peer extension initialized and is ready to use.'
         ),
         _('Is P2P ready?'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -79,7 +83,7 @@ module.exports = {
             'if you want to analyse it or display it to the user.'
         ),
         _('P2P error occurred'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -94,7 +98,7 @@ module.exports = {
         _('Peer disconnected'),
         _('Triggers once when a peer disconnects.'),
         _('P2P peer disconnected'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -109,7 +113,7 @@ module.exports = {
         _('Peer Connected'),
         _('Triggers once when a remote peer initiates a connection.'),
         _('P2P peer connected'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -124,7 +128,7 @@ module.exports = {
         _('Connect to another client'),
         _('Connects the current client to another client using its id.'),
         _('Connect to P2P client _PARAM0_'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -140,7 +144,7 @@ module.exports = {
         _('Connect to a broker server'),
         _('Connects the extension to a broker server.'),
         _('Connect to the broker server at http://_PARAM0_:_PARAM1_/'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -166,7 +170,7 @@ module.exports = {
             'This action needs to be called BEFORE connecting to the broker server.'
         ),
         _('Use ICE server _PARAM0_ (username: _PARAM1_, password: _PARAM2_)'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -184,7 +188,7 @@ module.exports = {
         _('Connect to the default broker server'),
         _('Connects to the default broker server.'),
         _('Connect to the default broker server'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -202,7 +206,7 @@ module.exports = {
             'Must be called BEFORE connecting to a broker.'
         ),
         _('Override the client ID with _PARAM0_'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -220,7 +224,7 @@ module.exports = {
         _(
           'Trigger event _PARAM0_ on all connected clients (extra data: _PARAM1_)'
         ),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -237,7 +241,7 @@ module.exports = {
         _('Trigger event on a specific client'),
         _('Triggers an event on a specific connected client'),
         _('Trigger event _PARAM1_ on client _PARAM0_ (extra data: _PARAM2_)'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -257,7 +261,7 @@ module.exports = {
         _(
           'Trigger event _PARAM0_ on all connected clients (extra data: _PARAM1_)'
         ),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -279,7 +283,7 @@ module.exports = {
         _('Trigger event on a specific client (variable)'),
         _('Triggers an event on a specific connected client'),
         _('Trigger event _PARAM1_ on client _PARAM0_ (extra data: _PARAM2_)'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -307,7 +311,7 @@ module.exports = {
         _(
           'Overwrite _PARAM1_ with variable sent with last trigger of _PARAM0_'
         ),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -329,7 +333,7 @@ module.exports = {
         _('Disconnect from a peer'),
         _('Disconnects this client from another client.'),
         _('Disconnect from client _PARAM0_'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -345,7 +349,7 @@ module.exports = {
         _('Disconnect from all peers'),
         _('Disconnects this client from all other clients.'),
         _('Disconnect from all clients'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -360,7 +364,7 @@ module.exports = {
         _('Disconnect from broker'),
         _('Disconnects the client from the broker server.'),
         _('Disconnect the client from the broker'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -377,7 +381,7 @@ module.exports = {
           'Disconnects the client from the broker server and all other clients.'
         ),
         _('Disconnect the client from the broker and other clients'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg',
         'JsPlatform/Extensions/p2picon.svg'
       )
@@ -393,7 +397,7 @@ module.exports = {
         _(
           'Returns the data received when the specified event was last triggered'
         ),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg'
       )
       .addParameter('string', _('Event name'), '', false)
@@ -407,7 +411,7 @@ module.exports = {
         'GetEventSender',
         _('Get event sender'),
         _('Returns the id of the peer that triggered the event'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg'
       )
       .addParameter('string', _('Event name'), '', false)
@@ -421,7 +425,7 @@ module.exports = {
         'GetID',
         _('Get client ID'),
         _('Gets the client ID of the current game instance'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg'
       )
       .getCodeExtraInformation()
@@ -434,7 +438,7 @@ module.exports = {
         'GetLastError',
         _('Get last error'),
         _('Gets the description of the last P2P error'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg'
       )
       .getCodeExtraInformation()
@@ -447,7 +451,7 @@ module.exports = {
         'GetLastDisconnectedPeer',
         _('Get last disconnected peer'),
         _('Gets the ID of the latest peer that has disconnected.'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg'
       )
       .getCodeExtraInformation()
@@ -460,7 +464,7 @@ module.exports = {
         'GetLastConnectedPeer',
         _('Get ID of the connected peer'),
         _('Gets the ID of the newly connected peer.'),
-        _('P2P (experimental)'),
+        '',
         'JsPlatform/Extensions/p2picon.svg'
       )
       .getCodeExtraInformation()

Extensions/PanelSpriteObject/Extension.cpp

@@ -25,12 +25,16 @@ void DeclarePanelSpriteObjectExtension(gd::PlatformExtension& extension) {
           "Open source (MIT License)")
       .SetExtensionHelpPath("/objects/panel_sprite");
 
-  gd::ObjectMetadata& obj = extension.AddObject<PanelSpriteObject>(
-      "PanelSprite",
-      _("Panel Sprite (\"9-patch\")"),
-      _("An image with edges and corners that are stretched separately from "
-        "the full image."),
-      "CppPlatform/Extensions/PanelSpriteIcon.png");
+  gd::ObjectMetadata& obj =
+      extension
+          .AddObject<PanelSpriteObject>(
+              "PanelSprite",
+              _("Panel Sprite (\"9-patch\")"),
+              _("An image with edges and corners that are stretched separately "
+                "from "
+                "the full image."),
+              "CppPlatform/Extensions/PanelSpriteIcon.png")
+          .SetCategoryFullName(_("General"));
 
 #if defined(GD_IDE_ONLY)
   obj.SetIncludeFile("PanelSpriteObject/PanelSpriteObject.h");

Extensions/ParticleSystem/Extension.cpp

@@ -11,8 +11,8 @@ This project is released under the MIT License.
 #include "ExtensionSubDeclaration2.h"
 #include "ExtensionSubDeclaration3.h"
 #include "GDCore/Extensions/PlatformExtension.h"
-#include "GDCore/Tools/Localization.h"
 #include "GDCore/Project/BehaviorsSharedData.h"
+#include "GDCore/Tools/Localization.h"
 #include "ParticleEmitterObject.h"
 
 void DeclareParticleSystemExtension(gd::PlatformExtension& extension) {
@@ -29,12 +29,15 @@ void DeclareParticleSystemExtension(gd::PlatformExtension& extension) {
 
   // Declaration of all objects available
   {
-    gd::ObjectMetadata& obj = extension.AddObject<ParticleEmitterObject>(
-        "ParticleEmitter",
-        _("Particles emitter"),
-        _("Displays a large number of small particles to create visual "
-          "effects."),
-        "CppPlatform/Extensions/particleSystemicon.png");
+    gd::ObjectMetadata& obj =
+        extension
+            .AddObject<ParticleEmitterObject>(
+                "ParticleEmitter",
+                _("Particles emitter"),
+                _("Displays a large number of small particles to create visual "
+                  "effects."),
+                "CppPlatform/Extensions/particleSystemicon.png")
+            .SetCategoryFullName(_("General"));
 
     obj.SetIncludeFile("ParticleSystem/ParticleEmitterObject.h");
 
@@ -44,4 +47,4 @@ void DeclareParticleSystemExtension(gd::PlatformExtension& extension) {
     ExtensionSubDeclaration2(obj);
     ExtensionSubDeclaration3(obj);
   }
-}
+}

Extensions/PathfindingBehavior/Extension.cpp

@@ -28,7 +28,7 @@ void DeclarePathfindingBehaviorExtension(gd::PlatformExtension& extension) {
         extension.AddBehavior("PathfindingBehavior",
                               _("Pathfinding"),
                               "Pathfinding",
-                              _("With this behavior, the object will move "
+                              _("Move objects to a target "
                                 "while avoiding all objects that are "
                                 "flagged as obstacles."),
                               "",
@@ -610,7 +610,7 @@ void DeclarePathfindingBehaviorExtension(gd::PlatformExtension& extension) {
         "PathfindingObstacleBehavior",
         _("Obstacle for pathfinding"),
         "PathfindingObstacle",
-        _("Flag the object as being an obstacle for pathfinding."),
+        _("Flag objects as being obstacles for pathfinding."),
         "",
         "CppPlatform/Extensions/pathfindingobstacleicon.png",
         "PathfindingObstacleBehavior",

Extensions/PathfindingBehavior/pathfindingobstacleruntimebehavior.ts

@@ -70,8 +70,8 @@ namespace gdjs {
       x: float,
       y: float,
       radius: float,
-      result: gdjs.BehaviorRBushAABB<gdjs.PathfindingObstacleRuntimeBehavior>[]
-    ): any {
+      result: gdjs.PathfindingObstacleRuntimeBehavior[]
+    ): void {
       const searchArea = gdjs.staticObject(
         PathfindingObstaclesManager.prototype.getAllObstaclesAround
       );
@@ -83,9 +83,13 @@ namespace gdjs {
       searchArea.maxX = x + radius;
       // @ts-ignore
       searchArea.maxY = y + radius;
-      const nearbyPlatforms = this._obstaclesRBush.search(searchArea);
+      const nearbyObstacles: gdjs.BehaviorRBushAABB<
+        gdjs.PathfindingObstacleRuntimeBehavior
+      >[] = this._obstaclesRBush.search(searchArea);
       result.length = 0;
-      result.push.apply(result, nearbyPlatforms);
+      nearbyObstacles.forEach((nearbyObstacle) =>
+        result.push(nearbyObstacle.behavior)
+      );
     }
   }
 

Extensions/PathfindingBehavior/pathfindingruntimebehavior.ts

@@ -544,9 +544,7 @@ namespace gdjs {
       //An array of nodes sorted by their estimate cost (First node = Lower estimate cost).
       _openNodes: Node[] = [];
       //Used by getNodes to temporarily store obstacles near a position.
-      _closeObstacles: gdjs.BehaviorRBushAABB<
-        PathfindingObstacleRuntimeBehavior
-      >[] = [];
+      _closeObstacles: gdjs.PathfindingObstacleRuntimeBehavior[] = [];
       //Old nodes constructed in a previous search are stored here to avoid temporary objects (see _freeAllNodes method).
       _nodeCache: Node[] = [];
 
@@ -787,7 +785,7 @@ namespace gdjs {
           this._closeObstacles
         );
         for (let k = 0; k < this._closeObstacles.length; ++k) {
-          const obj = this._closeObstacles[k].behavior.owner;
+          const obj = this._closeObstacles[k].owner;
           const topLeftCellX = Math.floor(
             (obj.getDrawableX() - this._rightBorder - this._gridOffsetX) /
               this._cellWidth
@@ -817,13 +815,13 @@ namespace gdjs {
             yPos < bottomRightCellY
           ) {
             objectsOnCell = true;
-            if (this._closeObstacles[k].behavior.isImpassable()) {
+            if (this._closeObstacles[k].isImpassable()) {
               //The cell is impassable, stop here.
               newNode.cost = -1;
               break;
             } else {
               //Superimpose obstacles
-              newNode.cost += this._closeObstacles[k].behavior.getCost();
+              newNode.cost += this._closeObstacles[k].getCost();
             }
           }
         }

Extensions/Physics2Behavior/JsExtension.js

@@ -33,7 +33,11 @@ module.exports = {
         'Florian Rival, Franco Maciel',
         'MIT'
       )
-      .setExtensionHelpPath('/behaviors/physics2');
+      .setExtensionHelpPath('/behaviors/physics2')
+      .setCategory('Advanced');
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('Physics Engine 2.0'))
+      .setIcon('res/physics32.png');
 
     var physics2Behavior = new gd.BehaviorJsImplementation();
     // $FlowExpectedError - ignore Flow warning as we're creating a behavior
@@ -406,7 +410,7 @@ module.exports = {
         _('Physics Engine 2.0'),
         'Physics2',
         _(
-          'Simulate realistic object physics, with gravity, forces, joints, etc.'
+          'Simulate realistic object physics with gravity, forces, joints, etc.'
         ),
         '',
         'res/physics32.png',
@@ -425,8 +429,8 @@ module.exports = {
         _('Compare the world gravity on X axis.'),
         _('the world gravity on X axis'),
         _('Global'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -440,7 +444,7 @@ module.exports = {
         _('World gravity on X axis'),
         _('World gravity on X axis'),
         _('Global'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -454,8 +458,8 @@ module.exports = {
         _('Compare the world gravity on Y axis.'),
         _('the world gravity on Y axis'),
         _('Global'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -469,7 +473,7 @@ module.exports = {
         _('World gravity on Y axis'),
         _('World gravity on Y axis'),
         _('Global'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -487,8 +491,8 @@ module.exports = {
           ),
         _('Set the world gravity of _PARAM0_ to _PARAM2_;_PARAM3_'),
         _('Global'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -504,8 +508,8 @@ module.exports = {
         _('Compare the world time scale.'),
         _('the world time scale'),
         _('Global'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -524,9 +528,9 @@ module.exports = {
             'While an object is needed, this will apply to all objects using the behavior.'
           ),
         _('Set the world time scale of _PARAM0_ to _PARAM2_'),
-        _('Global'),
-        'res/physics24.png',
-        'res/physics16.png'
+        '',
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('objectList', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -541,7 +545,7 @@ module.exports = {
         _('World time scale'),
         _('World time scale'),
         _('Global'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -556,8 +560,8 @@ module.exports = {
         _('Test if an object is dynamic.'),
         _('_PARAM0_ is dynamic'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -573,8 +577,8 @@ module.exports = {
         ),
         _('Set _PARAM0_ as dynamic'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -588,8 +592,8 @@ module.exports = {
         _('Test if an object is static.'),
         _('_PARAM0_ is static'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -605,8 +609,8 @@ module.exports = {
         ),
         _('Set _PARAM0_ as static'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -620,8 +624,8 @@ module.exports = {
         _('Test if an object is kinematic.'),
         _('_PARAM0_ is kinematic'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -637,8 +641,8 @@ module.exports = {
         ),
         _('Set _PARAM0_ as kinematic'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -652,8 +656,8 @@ module.exports = {
         _('Test if an object is being treat as a bullet.'),
         _('_PARAM0_ is bullet'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -669,8 +673,8 @@ module.exports = {
         ),
         _('Treat _PARAM0_ as bullet: _PARAM2_'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -686,8 +690,8 @@ module.exports = {
         _('Test if an object has fixed rotation.'),
         _('_PARAM0_ has fixed rotation'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -703,8 +707,8 @@ module.exports = {
         ),
         _('Set _PARAM0_ fixed rotation: _PARAM2_'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -720,8 +724,8 @@ module.exports = {
         _('Test if an object can sleep.'),
         _('_PARAM0_ can sleep'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -737,8 +741,8 @@ module.exports = {
         ),
         _('Allow _PARAM0_ to sleep: _PARAM2_'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -754,8 +758,8 @@ module.exports = {
         _('Test if an object is sleeping.'),
         _('_PARAM0_ is sleeping'),
         _('Dynamics'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -772,8 +776,8 @@ module.exports = {
         ),
         _('the shape scale'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -789,8 +793,8 @@ module.exports = {
         _('Test an object density.'),
         _('the _PARAM0_ density'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -807,8 +811,8 @@ module.exports = {
         ),
         _('the density'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -823,7 +827,7 @@ module.exports = {
         _('Density of the object'),
         _('Get the density of an object.'),
         _('Body settings'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -837,8 +841,8 @@ module.exports = {
         _('Test an object friction.'),
         _('the _PARAM0_ friction'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -855,8 +859,8 @@ module.exports = {
         ),
         _('the friction'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -871,7 +875,7 @@ module.exports = {
         _('Friction of the object'),
         _('Get the friction of an object.'),
         _('Body settings'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -885,8 +889,8 @@ module.exports = {
         _('Test an object restitution.'),
         _('the _PARAM0_ restitution'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -903,8 +907,8 @@ module.exports = {
         ),
         _('the restitution'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -919,7 +923,7 @@ module.exports = {
         _('Restitution of the object'),
         _('Get the restitution of an object.'),
         _('Body settings'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -933,8 +937,8 @@ module.exports = {
         _('Test an object linear damping.'),
         _('the _PARAM0_ linear damping'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -951,8 +955,8 @@ module.exports = {
         ),
         _('the linear damping'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -967,7 +971,7 @@ module.exports = {
         _('Linear damping of the object'),
         _('Get the linear damping of an object.'),
         _('Body settings'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -981,8 +985,8 @@ module.exports = {
         _('Test an object angular damping.'),
         _('the _PARAM0_ angular damping'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -999,8 +1003,8 @@ module.exports = {
         ),
         _('the angular damping'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1015,7 +1019,7 @@ module.exports = {
         _('Angular damping of the object'),
         _('Get the angular damping of an object.'),
         _('Body settings'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1029,8 +1033,8 @@ module.exports = {
         _('Test an object gravity scale.'),
         _('the _PARAM0_ gravity scale'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1047,8 +1051,8 @@ module.exports = {
         ),
         _('the gravity scale'),
         _('Body settings'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1063,7 +1067,7 @@ module.exports = {
         _('Gravity scale of the object'),
         _('Get the gravity scale of an object.'),
         _('Body settings'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1078,8 +1082,8 @@ module.exports = {
         _('Test if an object has a specific layer enabled.'),
         _('_PARAM0_ has layer _PARAM2_ enabled'),
         _('Filtering'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1096,8 +1100,8 @@ module.exports = {
         ),
         _('Enable layer _PARAM2_ for _PARAM0_: _PARAM3_'),
         _('Filtering'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1114,8 +1118,8 @@ module.exports = {
         _('Test if an object has a specific mask enabled.'),
         _('_PARAM0_ has mask _PARAM2_ enabled'),
         _('Filtering'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1132,8 +1136,8 @@ module.exports = {
         ),
         _('Enable mask _PARAM2_ for _PARAM0_: _PARAM3_'),
         _('Filtering'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1151,8 +1155,8 @@ module.exports = {
         _('Test an object linear velocity on X.'),
         _('the linear velocity on X'),
         _('Velocity'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1167,8 +1171,8 @@ module.exports = {
         _('Modify an object linear velocity on X.'),
         _('the linear velocity on X'),
         _('Velocity'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1183,7 +1187,7 @@ module.exports = {
         _('Linear velocity on X axis'),
         _('Get the linear velocity of an object on X axis.'),
         _('Velocity'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1197,8 +1201,8 @@ module.exports = {
         _('Test an object linear velocity on Y.'),
         _('the linear velocity on Y'),
         _('Velocity'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1213,8 +1217,8 @@ module.exports = {
         _('Modify an object linear velocity on Y.'),
         _('the linear velocity on Y'),
         _('Velocity'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1229,7 +1233,7 @@ module.exports = {
         _('Linear velocity on Y axis'),
         _('Get the linear velocity of an object on Y axis.'),
         _('Velocity'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1243,8 +1247,8 @@ module.exports = {
         _('Test an object linear velocity length.'),
         _('the linear velocity length'),
         _('Velocity'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1258,7 +1262,7 @@ module.exports = {
         _('Linear velocity'),
         _('Get the linear velocity of an object.'),
         _('Velocity'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1272,8 +1276,8 @@ module.exports = {
         _('Test an object angular velocity.'),
         _('the angular velocity'),
         _('Velocity'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1288,8 +1292,8 @@ module.exports = {
         _('Modify an object angular velocity.'),
         _('the angular velocity'),
         _('Velocity'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1304,7 +1308,7 @@ module.exports = {
         _('Angular velocity'),
         _('Get the angular velocity of an object.'),
         _('Velocity'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1321,8 +1325,8 @@ module.exports = {
         ),
         _('Apply to _PARAM0_ a force of _PARAM2_;_PARAM3_'),
         _('Forces & impulses'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1342,8 +1346,8 @@ module.exports = {
         ),
         _('Apply to _PARAM0_ a force of angle _PARAM2_ and length _PARAM3_'),
         _('Forces & impulses'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1365,8 +1369,8 @@ module.exports = {
           'Apply to _PARAM0_ a force of length _PARAM2_ towards _PARAM3_;_PARAM4_'
         ),
         _('Forces & impulses'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1387,8 +1391,8 @@ module.exports = {
         ),
         _('Apply to _PARAM0_ an impulse of _PARAM2_;_PARAM3_'),
         _('Forces & impulses'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1410,8 +1414,8 @@ module.exports = {
           'Apply to _PARAM0_ an impulse of angle _PARAM2_ and length _PARAM3_ (applied at _PARAM4_;_PARAM5_)'
         ),
         _('Forces & impulses'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1433,8 +1437,8 @@ module.exports = {
           'Apply to _PARAM0_ an impulse of length _PARAM2_ towards _PARAM3_;_PARAM4_ (applied at _PARAM5_;_PARAM6_)'
         ),
         _('Forces & impulses'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1455,8 +1459,8 @@ module.exports = {
         ),
         _('Apply to _PARAM0_ a torque of _PARAM2_'),
         _('Forces & impulses'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1473,8 +1477,8 @@ module.exports = {
         ),
         _('Apply to _PARAM0_ an angular impulse of _PARAM2_'),
         _('Forces & impulses'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1488,7 +1492,7 @@ module.exports = {
         _('Mass center X'),
         _('Mass center X'),
         '',
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1501,7 +1505,7 @@ module.exports = {
         _('Mass center Y'),
         _('Mass center Y'),
         '',
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1516,8 +1520,8 @@ module.exports = {
         _('Test if an object is the first object on a joint.'),
         _('_PARAM0_ is the first object for joint _PARAM2_'),
         _('Joints'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1532,8 +1536,8 @@ module.exports = {
         _('Test if an object is the second object on a joint.'),
         _('_PARAM0_ is the second object for joint _PARAM2_'),
         _('Joints'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1547,7 +1551,7 @@ module.exports = {
         _('Joint first anchor X'),
         _('Joint first anchor X'),
         _('Joints'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1561,7 +1565,7 @@ module.exports = {
         _('Joint first anchor Y'),
         _('Joint first anchor Y'),
         _('Joints'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1575,7 +1579,7 @@ module.exports = {
         _('Joint second anchor X'),
         _('Joint second anchor X'),
         _('Joints'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1589,7 +1593,7 @@ module.exports = {
         _('Joint second anchor Y'),
         _('Joint second anchor Y'),
         _('Joints'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1604,8 +1608,8 @@ module.exports = {
         _('Test a joint reaction force.'),
         _('the joint _PARAM2_ reaction force'),
         _('Joints'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1620,7 +1624,7 @@ module.exports = {
         _('Joint reaction force'),
         _('Joint reaction force'),
         _('Joints'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1635,8 +1639,8 @@ module.exports = {
         _('Test a joint reaction torque.'),
         _('the joint _PARAM2_ reaction torque'),
         _('Joints'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1651,7 +1655,7 @@ module.exports = {
         _('Joint reaction torque'),
         _('Joint reaction torque'),
         _('Joints'),
-        'res/physics16.png'
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -1666,8 +1670,8 @@ module.exports = {
         _('Remove a joint from the scene.'),
         _('Remove joint _PARAM2_'),
         _('Joints'),
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('object', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')
@@ -3731,8 +3735,8 @@ module.exports = {
         _('Test if two objects collide.'),
         _('_PARAM0_ is colliding with _PARAM2_'),
         '',
-        'res/physics24.png',
-        'res/physics16.png'
+        'res/physics32.png',
+        'res/physics32.png'
       )
       .addParameter('objectList', _('Object'), '', false)
       .addParameter('behavior', _('Behavior'), 'Physics2Behavior')

Extensions/PlatformBehavior/Extension.cpp

@@ -16,7 +16,7 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
   extension
       .SetExtensionInformation(
           "PlatformBehavior",
-          _("Platform Behavior"),
+          _("Platform behavior"),
           "The platformer engine allows to create controllable objects that "
           "can run and jump on other objects that are marked as platforms. It "
           "supports various features commonly found in platformers: "
@@ -28,13 +28,15 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
           "Florian Rival",
           "Open source (MIT License)")
       .SetExtensionHelpPath("/behaviors/platformer");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Platform behavior"))
+      .SetIcon("CppPlatform/Extensions/platformerobjecticon.png");
 
   {
     gd::BehaviorMetadata& aut = extension.AddBehavior(
         "PlatformerObjectBehavior",
         _("Platformer character"),
         "PlatformerObject",
-        _("Controllable character that can jump and run on platforms."),
+        _("Jump and run on platforms."),
         "",
         "CppPlatform/Extensions/platformerobjecticon.png",
         "PlatformerObjectBehavior",
@@ -47,8 +49,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                        "floor or in the air)."),
                      _("_PARAM0_ is moving"),
                      "",
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .MarkAsSimple()
@@ -59,8 +61,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                      _("Check if the object is on a platform."),
                      _("_PARAM0_ is on floor"),
                      "",
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .MarkAsSimple()
@@ -71,8 +73,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                      _("Check if the object is on a ladder."),
                      _("_PARAM0_ is on ladder"),
                      "",
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .MarkAsAdvanced()
@@ -83,8 +85,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                      _("Check if the object is jumping."),
                      _("_PARAM0_ is jumping"),
                      "",
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .MarkAsSimple()
@@ -98,8 +100,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
              "jump, the fall speed becomes higher than the jump speed."),
            _("_PARAM0_ is falling"),
            "",
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("IsFalling");
@@ -109,8 +111,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                      _("Check if the object is grabbing a platform ledge."),
                      _("_PARAM0_ is grabbing a platform ledge"),
                      "",
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("IsGrabbingPlatform");
@@ -121,8 +123,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                        "per second per second)."),
                      _("the gravity"),
                      _("Options"),
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -135,8 +137,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                     "second per second)."),
                   _("the gravity"),
                   _("Options"),
-                  "CppPlatform/Extensions/platformerobjecticon24.png",
-                  "CppPlatform/Extensions/platformerobjecticon16.png")
+                  "CppPlatform/Extensions/platformerobjecticon.png",
+                  "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardOperatorParameters("number")
@@ -151,8 +153,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
              "second)."),
            _("the maximum falling speed"),
            _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -166,11 +168,12 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
              "second)."),
            _("the maximum falling speed"),
            _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardOperatorParameters("number")
+        .AddParameter("yesorno", _("If jumping, try to preserve the current speed in the air"))
         .MarkAsAdvanced()
         .SetFunctionName("SetMaxFallingSpeed")
         .SetGetter("GetMaxFallingSpeed");
@@ -181,8 +184,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                        "second)."),
                      _("the ladder climbing speed"),
                      _("Options"),
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -195,8 +198,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                     "second)."),
                   _("the ladder climbing speed"),
                   _("Options"),
-                  "CppPlatform/Extensions/platformerobjecticon24.png",
-                  "CppPlatform/Extensions/platformerobjecticon16.png")
+                  "CppPlatform/Extensions/platformerobjecticon.png",
+                  "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardOperatorParameters("number")
@@ -206,12 +209,12 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
 
     aut.AddCondition("Acceleration",
                      _("Acceleration"),
-                     _("Compare the acceleration of the object (in pixels per "
+                     _("Compare the horizontal acceleration of the object (in pixels per "
                        "second per second)."),
-                     _("the acceleration"),
+                     _("the horizontal acceleration"),
                      _("Options"),
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -220,12 +223,12 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
 
     aut.AddAction("Acceleration",
                   _("Acceleration"),
-                  _("Change the acceleration of an object (in pixels per "
+                  _("Change the horizontal acceleration of an object (in pixels per "
                     "second per second)."),
-                  _("the acceleration"),
+                  _("the horizontal acceleration"),
                   _("Options"),
-                  "CppPlatform/Extensions/platformerobjecticon24.png",
-                  "CppPlatform/Extensions/platformerobjecticon16.png")
+                  "CppPlatform/Extensions/platformerobjecticon.png",
+                  "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardOperatorParameters("number")
@@ -235,12 +238,12 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
 
     aut.AddCondition("Deceleration",
                      _("Deceleration"),
-                     _("Compare the deceleration of the object (in pixels per "
+                     _("Compare the horizontal deceleration of the object (in pixels per "
                        "second per second)."),
-                     _("the deceleration"),
+                     _("the horizontal deceleration"),
                      _("Options"),
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -249,12 +252,12 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
 
     aut.AddAction("Deceleration",
                   _("Deceleration"),
-                  _("Change the deceleration of an object (in pixels per "
+                  _("Change the horizontal deceleration of an object (in pixels per "
                     "second per second)."),
-                  _("the deceleration"),
+                  _("the horizontal deceleration"),
                   _("Options"),
-                  "CppPlatform/Extensions/platformerobjecticon24.png",
-                  "CppPlatform/Extensions/platformerobjecticon16.png")
+                  "CppPlatform/Extensions/platformerobjecticon.png",
+                  "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardOperatorParameters("number")
@@ -264,12 +267,12 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
 
     aut.AddCondition(
            "MaxSpeed",
-           _("Maximum speed"),
-           _("Compare the maximum speed of the object (in pixels per second)."),
-           _("the maximum speed"),
+           _("Maximum horizontal speed"),
+           _("Compare the maximum horizontal speed of the object (in pixels per second)."),
+           _("the maximum horizontal speed"),
            _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -277,12 +280,12 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
 
     aut.AddAction(
            "MaxSpeed",
-           _("Maximum speed"),
-           _("Change the maximum speed of an object (in pixels per second)."),
-           _("the maximum speed"),
+           _("Maximum horizontal speed"),
+           _("Change the maximum horizontal speed of an object (in pixels per second)."),
+           _("the maximum horizontal speed"),
            _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardOperatorParameters("number")
@@ -293,11 +296,12 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
     aut.AddCondition(
            "JumpSpeed",
            _("Jump speed"),
-           _("Compare the jump speed of the object (in pixels per second)."),
+           _("Compare the jump speed of the object (in pixels per second)."
+             "Its value is always positive."),
            _("the jump speed"),
            _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -307,11 +311,12 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
     aut.AddAction(
            "JumpSpeed",
            _("Jump speed"),
-           _("Change the jump speed of an object (in pixels per second)."),
+           _("Change the jump speed of an object (in pixels per second). "
+             "Its value is always positive."),
            _("the jump speed"),
            _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardOperatorParameters("number")
@@ -321,11 +326,13 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
     aut.AddCondition(
            "JumpSustainTime",
            _("Jump sustain time"),
-           _("Compare the jump sustain time of the object (in seconds)."),
+           _("Compare the jump sustain time of the object (in seconds)."
+             "This is the time during which keeping the jump button held "
+             "allow the initial jump speed to be maintained."),
            _("the jump sustain time"),
            _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -333,11 +340,13 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
 
     aut.AddAction("JumpSustainTime",
                   _("Jump sustain time"),
-                  _("Change the jump sustain time of an object (in seconds)."),
+                  _("Change the jump sustain time of an object (in seconds). "
+                  "This is the time during which keeping the jump button held "
+                  "allow the initial jump speed to be maintained."),
                   _("the jump sustain time"),
                   _("Options"),
-                  "CppPlatform/Extensions/platformerobjecticon24.png",
-                  "CppPlatform/Extensions/platformerobjecticon16.png")
+                  "CppPlatform/Extensions/platformerobjecticon.png",
+                  "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardOperatorParameters("number");
@@ -351,9 +360,9 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
              "again this action everytime you want to allow the object to jump "
              "(apart if it's on the floor)."),
            _("Allow _PARAM0_ to jump again"),
-           _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           _(""),
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .MarkAsSimple()
@@ -366,9 +375,21 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
              "is made unable to jump while in mid air. This has no effect if "
              "the object is not in the air."),
            _("Forbid _PARAM0_ to air jump"),
-           _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           _(""),
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
+        .AddParameter("object", _("Object"))
+        .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior");
+
+    aut.AddScopedAction(
+           "AbortJump",
+           _("Abort jump"),
+           _("Abort the current jump and stop the object vertically. "
+             "This action doesn't have any effect when the character is not jumping."),
+           _("Abort the current jump of _PARAM0_"),
+           _(""),
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior");
 
@@ -377,8 +398,8 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                      _("Check if the object can jump."),
                      _("_PARAM0_ can jump"),
                      "",
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .MarkAsSimple()
@@ -504,7 +525,7 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                   _("Control pressed or simulated"),
                   _("A control was applied from a default control or a simulated by an action."),
                   _("_PARAM0_ has the _PARAM2_ key pressed or simulated"),
-                  _("Controls"),
+                  _(""),
                   "res/conditions/keyboard24.png",
                   "res/conditions/keyboard.png")
         .AddParameter("object", _("Object"))
@@ -519,7 +540,7 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                   _("De/activate the use of default controls.\nIf deactivated, "
                     "use the simulated actions to move the object."),
                   _("Ignore default controls for _PARAM0_: _PARAM2_"),
-                  _("Controls"),
+                  _("Options"),
                   "res/conditions/keyboard24.png",
                   "res/conditions/keyboard.png")
         .AddParameter("object", _("Object"))
@@ -533,7 +554,7 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                   _("Enable (or disable) the ability of the object to grab "
                     "platforms when falling near to one."),
                   _("Allow _PARAM0_ to grab platforms: _PARAM2_"),
-                  _("Controls"),
+                  _("Options"),
                   "res/conditions/keyboard24.png",
                   "res/conditions/keyboard.png")
         .AddParameter("object", _("Object"))
@@ -545,23 +566,38 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                      _("Can grab platforms"),
                      _("Check if the object can grab the platforms."),
                      _("_PARAM0_ can grab the platforms"),
-                     "",
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     "Options",
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .MarkAsSimple()
         .SetFunctionName("canGrabPlatforms");
 
+    aut.AddScopedAction(
+           "SetCurrentFallSpeed",
+           _("Current falling speed"),
+           _("Change the current falling speed of the object (in pixels per "
+             "second). This action doesn't have any effect when the character "
+             "is not falling or is in the first phase of a jump."),
+           _("the current falling speed"),
+           _(""),
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
+        .AddParameter("object", _("Object"))
+        .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
+        .UseStandardOperatorParameters("number")
+        .MarkAsAdvanced();
+
     aut.AddCondition(
            "CurrentFallSpeed",
            _("Current falling speed"),
            _("Compare the current falling speed of the object (in pixels per "
-             "second)."),
+             "second). Its value is always positive."),
            _("the current falling speed"),
-           _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           _(""),
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -572,25 +608,40 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
            "CurrentJumpSpeed",
            _("Current jump speed"),
            _("Compare the current jump speed of the object (in pixels per "
-             "second)."),
+             "second). Its value is always positive."),
            _("the current jump speed"),
-           _("Options"),
-           "CppPlatform/Extensions/platformerobjecticon24.png",
-           "CppPlatform/Extensions/platformerobjecticon16.png")
+           _(""),
+           "CppPlatform/Extensions/platformerobjecticon.png",
+           "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
         .MarkAsAdvanced()
         .SetFunctionName("GetCurrentJumpSpeed");
 
+    aut.AddScopedAction("SetCurrentSpeed",
+                     _("Current horizontal speed"),
+                     _("Change the current horizontal speed of the object "
+                     "(in pixels per second). The object moves to the left "
+                     "with negative values and to the right with positive ones"),
+                     _("the current horizontal speed"),
+                     _(""),
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
+        .AddParameter("object", _("Object"))
+        .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
+        .UseStandardOperatorParameters("number")
+        .MarkAsAdvanced();
+
     aut.AddCondition("CurrentSpeed",
-                     _("Current speed"),
-                     _("Compare the current speed of the object (in pixels per "
-                       "second)."),
-                     _("the current speed"),
-                     _("Options"),
-                     "CppPlatform/Extensions/platformerobjecticon24.png",
-                     "CppPlatform/Extensions/platformerobjecticon16.png")
+                     _("Current horizontal speed"),
+                     _("Compare the current horizontal speed of the object "
+                     "(in pixels per second). The object moves to the left "
+                     "with negative values and to the right with positive ones"),
+                     _("the current horizontal speed"),
+                     _(""),
+                     "CppPlatform/Extensions/platformerobjecticon.png",
+                     "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .UseStandardRelationalOperatorParameters("number")
@@ -599,99 +650,111 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
 
     aut.AddExpression("Gravity",
                       _("Gravity"),
-                      _("Get the gravity applied on the object"),
+                      _("Return the gravity applied on the object "
+                      "(in pixels per second per second)."),
                       _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetGravity");
 
     aut.AddExpression("MaxFallingSpeed",
                       _("Maximum falling speed"),
-                      _("Get the maximum falling speed"),
+                      _("Return the maximum falling speed of the object "
+                        "(in pixels per second)."),
                       _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetMaxFallingSpeed");
 
     aut.AddExpression("LadderClimbingSpeed",
                       _("Ladder climbing speed"),
-                      _("Get the ladder climbing speed"),
+                      _("Return the ladder climbing speed of the object "
+                        "(in pixels per second)."),
                       _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetLadderClimbingSpeed");
 
     aut.AddExpression("Acceleration",
                       _("Acceleration"),
-                      _("Acceleration"),
+                      _("Return the horizontal acceleration of the object "
+                      "(in pixels per second per second)."),
                       _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetAcceleration");
 
     aut.AddExpression("Deceleration",
                       _("Deceleration"),
-                      _("Deceleration"),
+                      _("Return the horizontal deceleration of the object "
+                      "(in pixels per second per second)."),
                       _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetDeceleration");
 
     aut.AddExpression("MaxSpeed",
-                      _("Maximum speed"),
-                      _("Maximum speed"),
+                      _("Maximum horizontal speed"),
+                      _("Return the maximum horizontal speed of the object "
+                        "(in pixels per second)."),
                       _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetMaxSpeed");
 
     aut.AddExpression("JumpSpeed",
                       _("Jump speed"),
-                      _("Jump speed"),
+                      _("Return the jump speed of the object "
+                        "(in pixels per second). Its value is always positive."),
                       _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetJumpSpeed");
 
     aut.AddExpression("JumpSustainTime",
                       _("Jump sustain time"),
-                      _("The time during which keeping the jump button held "
+                      _("Return the jump sustain time of the object (in seconds)."
+                        "This is the time during which keeping the jump button held "
                         "allow the initial jump speed to be maintained."),
                       _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior");
 
     aut.AddExpression("CurrentFallSpeed",
                       _("Current fall speed"),
-                      _("Current fall speed"),
-                      _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      _("Return the current fall speed of the object "
+                        "(in pixels per second). Its value is always positive."),
+                      _(""),
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetCurrentFallSpeed");
 
     aut.AddExpression("CurrentSpeed",
-                      _("Current speed"),
-                      _("Current speed"),
-                      _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      _("Current horizontal speed"),
+                      _("Return the current horizontal speed of the object "
+                     "(in pixels per second). The object moves to the left "
+                     "with negative values and to the right with positive ones"),
+                      _(""),
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetCurrentSpeed");
 
     aut.AddExpression("CurrentJumpSpeed",
+                      _("Return the current jump speed of the object "
+                        "(in pixels per second). Its value is always positive."),
                       _("Current jump speed"),
-                      _("Current jump speed"),
-                      _("Options"),
-                      "CppPlatform/Extensions/platformerobjecticon16.png")
+                      _(""),
+                      "CppPlatform/Extensions/platformerobjecticon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
         .SetFunctionName("GetCurrentJumpSpeed");
@@ -701,22 +764,21 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
         "PlatformBehavior",
         _("Platform"),
         "Platform",
-        _("Platform that Platformer characters can run on."),
+        _("Flag objects as being platforms where characters can run on."),
         "",
         "CppPlatform/Extensions/platformicon.png",
         "PlatformBehavior",
         std::make_shared<PlatformBehavior>(),
         std::make_shared<gd::BehaviorsSharedData>());
 
-
     aut.AddAction("ChangePlatformType",
                   _("Change platform type"),
                   _("Change the platform type of the object: Platform, "
                     "Jump-Through, or Ladder."),
                   _("Set platform type of _PARAM0_ to _PARAM2_"),
-                  _("Platforms"),
-                  "CppPlatform/Extensions/platformicon24.png",
-                  "CppPlatform/Extensions/platformicon16.png")
+                  "",
+                  "CppPlatform/Extensions/platformicon.png",
+                  "CppPlatform/Extensions/platformicon.png")
         .AddParameter("object", _("Object"))
         .AddParameter("behavior", _("Behavior"), "PlatformBehavior")
         .AddParameter(
@@ -730,9 +792,9 @@ void DeclarePlatformBehaviorExtension(gd::PlatformExtension& extension) {
                          _("Is object on given floor"),
                          _("Test if an object is on a given floor."),
                          _("_PARAM0_ is on floor _PARAM2_"),
-                         _("Platforms"),
-                         "CppPlatform/Extensions/platformicon24.png",
-                         "CppPlatform/Extensions/platformicon16.png")
+                         "",
+                         "CppPlatform/Extensions/platformicon.png",
+                         "CppPlatform/Extensions/platformicon.png")
            .AddParameter("objectList", _("Object"), "", false)
            .AddParameter("behavior", _("Behavior"), "PlatformerObjectBehavior")
            .AddParameter("objectList", _("Platforms"), "", false)

Extensions/PlatformBehavior/JsExtension.cpp

@@ -108,9 +108,15 @@ class PlatformBehaviorJsExtension : public gd::PlatformExtension {
           .SetFunctionName("setJumpSustainTime")
           .SetGetter("getJumpSustainTime");
       autExpressions["JumpSustainTime"].SetFunctionName("getJumpSustainTime");
+      autActions["PlatformBehavior::PlatformerObjectBehavior::SetCurrentFallSpeed"]
+          .SetFunctionName("setCurrentFallSpeed")
+          .SetGetter("getCurrentFallSpeed");
       autConditions["PlatformBehavior::CurrentFallSpeed"].SetFunctionName(
           "getCurrentFallSpeed");
       autExpressions["CurrentFallSpeed"].SetFunctionName("getCurrentFallSpeed");
+      autActions["PlatformBehavior::PlatformerObjectBehavior::SetCurrentSpeed"]
+          .SetFunctionName("setCurrentSpeed")
+          .SetGetter("getCurrentSpeed");
       autConditions["PlatformBehavior::CurrentSpeed"].SetFunctionName(
           "getCurrentSpeed");
       autExpressions["CurrentSpeed"].SetFunctionName("getCurrentSpeed");
@@ -124,6 +130,7 @@ class PlatformBehaviorJsExtension : public gd::PlatformExtension {
       autExpressions["CurrentJumpSpeed"].SetFunctionName("getCurrentJumpSpeed");
       autActions["PlatformBehavior::SetCanJump"].SetFunctionName("setCanJump");
       autActions["PlatformBehavior::PlatformerObjectBehavior::SetCanNotAirJump"].SetFunctionName("setCanNotAirJump");
+      autActions["PlatformBehavior::PlatformerObjectBehavior::AbortJump"].SetFunctionName("abortJump");
       autConditions["PlatformBehavior::CanJump"].SetFunctionName(
           "canJump");
       autActions["PlatformBehavior::SimulateLeftKey"].SetFunctionName(

Extensions/PlatformBehavior/PlatformerObjectBehavior.cpp

@@ -8,14 +8,14 @@ This project is released under the MIT License.
 #include "PlatformerObjectBehavior.h"
 
 #include <iostream>
-#include <memory>
 #include <map>
+#include <memory>
 
-#include "GDCore/Tools/Localization.h"
 #include "GDCore/CommonTools.h"
 #include "GDCore/Project/Layout.h"
-#include "GDCore/Serialization/SerializerElement.h"
 #include "GDCore/Project/PropertyDescriptor.h"
+#include "GDCore/Serialization/SerializerElement.h"
+#include "GDCore/Tools/Localization.h"
 #include "PlatformBehavior.h"
 
 void PlatformerObjectBehavior::InitializeContent(
@@ -31,9 +31,11 @@ void PlatformerObjectBehavior::InitializeContent(
   behaviorContent.SetAttribute("ignoreDefaultControls", false);
   behaviorContent.SetAttribute("slopeMaxAngle", 60);
   behaviorContent.SetAttribute("canGrabPlatforms", false);
+  behaviorContent.SetAttribute("canGrabWithoutMoving", true);
   behaviorContent.SetAttribute("yGrabOffset", 0);
   behaviorContent.SetAttribute("xGrabTolerance", 10);
   behaviorContent.SetAttribute("useLegacyTrajectory", false);
+  behaviorContent.SetAttribute("canGoDownFromJumpthru", true);
 }
 
 #if defined(GD_IDE_ONLY)
@@ -46,7 +48,8 @@ PlatformerObjectBehavior::GetProperties(
       gd::String::From(behaviorContent.GetDoubleAttribute("gravity")));
   properties[_("Jump speed")].SetGroup(_("Jump")).SetValue(
       gd::String::From(behaviorContent.GetDoubleAttribute("jumpSpeed")));
-  properties["jumpSustainTime"].SetGroup(_("Jump"))
+  properties["jumpSustainTime"]
+      .SetGroup(_("Jump"))
       .SetValue(gd::String::From(
           behaviorContent.GetDoubleAttribute("jumpSustainTime", 0)))
       .SetLabel(_("Jump sustain time"))
@@ -56,8 +59,10 @@ PlatformerObjectBehavior::GetProperties(
             "jumps."));
   properties[_("Max. falling speed")].SetGroup(_("Jump")).SetValue(
       gd::String::From(behaviorContent.GetDoubleAttribute("maxFallingSpeed")));
-  properties[_("Ladder climbing speed")].SetGroup(_("Ladder")).SetValue(gd::String::From(
-      behaviorContent.GetDoubleAttribute("ladderClimbingSpeed", 150)));
+  properties[_("Ladder climbing speed")]
+      .SetGroup(_("Ladder"))
+      .SetValue(gd::String::From(
+          behaviorContent.GetDoubleAttribute("ladderClimbingSpeed", 150)));
   properties[_("Acceleration")].SetGroup(_("Walk")).SetValue(
       gd::String::From(behaviorContent.GetDoubleAttribute("acceleration")));
   properties[_("Deceleration")].SetGroup(_("Walk")).SetValue(
@@ -77,16 +82,35 @@ PlatformerObjectBehavior::GetProperties(
                     ? "true"
                     : "false")
       .SetType("Boolean");
-  properties[_("Grab offset on Y axis")].SetGroup(_("Ledge")).SetValue(
-      gd::String::From(behaviorContent.GetDoubleAttribute("yGrabOffset")));
-  properties[_("Grab tolerance on X axis")].SetGroup(_("Ledge")).SetValue(gd::String::From(
-      behaviorContent.GetDoubleAttribute("xGrabTolerance", 10)));
-  properties[_("Use frame per second dependent trajectories (deprecated)")]
-      .SetGroup(_("Jump"))
+  properties[_("Automatically grab platform ledges without having to move "
+               "horizontally")]
+      .SetGroup(_("Ledge"))
+      .SetValue(behaviorContent.GetBoolAttribute("canGrabWithoutMoving", false)
+                    ? "true"
+                    : "false")
+      .SetType("Boolean");
+  properties[_("Grab offset on Y axis")]
+      .SetGroup(_("Ledge"))
+      .SetValue(
+          gd::String::From(behaviorContent.GetDoubleAttribute("yGrabOffset")));
+  properties[_("Grab tolerance on X axis")]
+      .SetGroup(_("Ledge"))
+      .SetValue(gd::String::From(
+          behaviorContent.GetDoubleAttribute("xGrabTolerance", 10)));
+  properties["useLegacyTrajectory"]
+      .SetLabel(_("Use frame rate dependent trajectories (deprecated, it's "
+                  "recommended to let this unchecked)"))
+      .SetGroup(_("Deprecated options (advanced)"))
       .SetValue(behaviorContent.GetBoolAttribute("useLegacyTrajectory", true)
                     ? "true"
                     : "false")
       .SetType("Boolean");
+  properties[_("Can go down from jumpthru platforms")]
+      .SetGroup(_("Walk"))
+      .SetValue(behaviorContent.GetBoolAttribute("canGoDownFromJumpthru", false)
+                    ? "true"
+                    : "false")
+      .SetType("Boolean");
   return properties;
 }
 
@@ -98,8 +122,13 @@ bool PlatformerObjectBehavior::UpdateProperty(
     behaviorContent.SetAttribute("ignoreDefaultControls", (value == "0"));
   else if (name == _("Can grab platform ledges"))
     behaviorContent.SetAttribute("canGrabPlatforms", (value == "1"));
-  else if (name == _("Use frame per second dependent trajectories (deprecated)"))
+  else if (name == _("Automatically grab platform ledges without having to "
+                     "move horizontally"))
+    behaviorContent.SetAttribute("canGrabWithoutMoving", (value == "1"));
+  else if (name == "useLegacyTrajectory")
     behaviorContent.SetAttribute("useLegacyTrajectory", (value == "1"));
+  else if (name == _("Can go down from jumpthru platforms"))
+    behaviorContent.SetAttribute("canGoDownFromJumpthru", (value == "1"));
   else if (name == _("Grab offset on Y axis"))
     behaviorContent.SetAttribute("yGrabOffset", value.To<double>());
   else {

Extensions/PlatformBehavior/README.md

@@ -44,7 +44,7 @@ There are also more obvious obstacles that cover the character in the middle and
 
 [![RequestedDeltaX](./diagrams/SlopeFollowingResult.png)](./diagrams/SlopeFollowingResult.svgz)
 
-Obstacles can eventually encompass the character. So platforms edges don't have any collision with character.
+Obstacles can eventually encompass the character. So, platforms edges don't have any collision with character.
 To detect such cases, 2 flags are used:
 
 - `foundOverHead` when an edge is over `headMaxY`
@@ -55,3 +55,261 @@ To detect such cases, 2 flags are used:
 For further details on the implementation, please take a look at the comments in:
 - the function `gdjs.PlatformerObjectRuntimeBehavior._findHighestFloorAndMoveOnTop`
 - the class `gdjs.PlatformerObjectRuntimeBehavior.FollowConstraintContext`
+
+## Jump trajectory
+
+### Sequential calculus of the engine
+
+The engine uses the previous speeds and positions to evaluate the new ones (with Verlet integrations). This is fast for sequential access and it's a good fit for what the engine does.
+
+The model doesn't follow the laws of physics and this is fine because more realism doesn't mean more fun. Internally, it uses 2 independent speeds:
+- the current jumping speed `currentJumpSpeed`
+- the current falling speed `currentFallSpeed`
+
+Note that in the engine `currentJumpSpeed` is actually an absolute speed but it's easier to visualize as a negative value as it is subtracted to `currentFallSpeed`.
+
+The jump speed stays at its initial value while the jump is sustained. Then, it decreases (in absolute) according to the gravity until it reaches 0 and stays constant until the end.
+The falling speed starts at 0 and increase according to the gravity, as soon as the jump start. Until, it reaches the maximum falling speed and stays constant until the end too.
+
+[![Jump speed](./diagrams/JumpSpeed.png)](./diagrams/JumpSpeed.svgz) [![Falling speed](./diagrams/FallingSpeed.png)](./diagrams/FallingSpeed.svgz)
+
+### Requests solving and random access
+
+#### Why a continuous model?
+
+A function allows to get a position for any given time without calculating every previous positions.
+
+#### Polynomial piece-wise function
+
+The character trajectory during a jump looks like a quadratic function, but it's actually a piece-wise function.
+
+On this first trajectory example, the curve almost follows the quadratic function in white, but it actually follows the grey ones at the start and the end of the jump. There is also an affine part at the end of the jump. It's not shown on this plot because it happens later on.
+
+![Trajectory with default settings](./diagrams/DefaultSettings.png)
+
+This example of trajectory shows the 4 functions. It has an affine part in the middle instead of a quadratic one like in the previous example. In practice, this jump trajectory will seem off, but a tiny affine part can happen in some configurations.
+
+![Trajectory with an affine part](./diagrams/WithAffine.png)
+
+The piece-wise function has 3 borders:
+- at the end of the jump sustaining (jumpSustainTime)
+- when the maximum falling speed is reached (maxFallingTime)
+- when the jump speed reach 0 (jumpEndTime)
+
+Depending on the when the maximum falling speed is reached, there can be 3 piece-wise functions:
+- after the jump end
+  - sustain case
+  - common case
+  - free fall case
+  - gliding case
+- before the jump end and after the sustaining
+  - sustain case
+  - common case
+  - max falling case
+  - gliding case
+- during the sustaining
+  - sustain case
+  - affine case
+  - max falling case
+  - gliding case
+
+[![Jump cases](./diagrams/JumpCases.png)](./diagrams/JumpCases.svgz)
+
+#### SageMath model
+
+The following model is written for [SageMath](https://www.sagemath.org/), an open-source mathematics software system.
+
+```Python
+# First define the jump and falling functions #
+
+currentFallingSpeed(t, gravity) = gravity * t
+fallingX(t, gravity) = integral(currentFallingSpeed(t, gravity), t)
+maxFallingTime(gravity, maxFallingSpeed) = solve([currentFallingSpeed(t, gravity)==maxFallingSpeed],t)[0].rhs()
+fallEndedX(t, gravity) = fallingX(maxFallingTime(gravity, maxFallingSpeed), gravity) + maxFallingSpeed * (t - maxFallingTime(gravity, maxFallingSpeed))
+
+currentJumpSpeed(t, gravity, jumpSpeed, jumpSustainTime) = -jumpSpeed + gravity * (t - jumpSustainTime)
+sustainedX(t, jumpSpeed) = -jumpSpeed * t
+jumpingX(t, gravity, jumpSpeed, jumpSustainTime) = sustainedX(jumpSustainTime, jumpSpeed) + integral(currentJumpSpeed(t, gravity, jumpSpeed, jumpSustainTime), t, jumpSustainTime, t)
+jumpEndTime(gravity, jumpSpeed, jumpSustainTime) = jumpSustainTime + jumpSpeed / gravity
+jumpEndedX(t, gravity, jumpSpeed, jumpSustainTime) = jumpingX(jumpEndTime(gravity, jumpSpeed, jumpSustainTime), gravity, jumpSpeed, jumpSustainTime)
+
+
+# t < jumpSustainTime && t < maxFallingTime #
+
+sustainCaseSpeed(t, gravity, jumpSpeed) = -jumpSpeed + currentFallingSpeed(t, gravity)
+sustainCaseHeight(t, gravity, jumpSpeed) = sustainedX(t, jumpSpeed) + fallingX(t, gravity)
+sustainCasePeakTime(gravity, jumpSpeed, jumpSustainTime) = solve([sustainCaseSpeed(t, gravity, jumpSpeed)==0], t)[0].rhs()
+sustainCasePeakHeight(gravity, jumpSpeed, jumpSustainTime) = sustainCaseHeight(sustainCasePeakTime(gravity, jumpSpeed, jumpSustainTime), gravity, jumpSpeed, jumpSustainTime)
+
+
+# jumpSustainTime < t && t < maxFallingTime && t < jumpEndTime #
+
+commonCaseSpeed(t, gravity, jumpSpeed, jumpSustainTime) = currentJumpSpeed(t, gravity, jumpSpeed, jumpSustainTime) + currentFallingSpeed(t, gravity)
+commonCaseHeight(t, gravity, jumpSpeed, jumpSustainTime) = jumpingX(t, gravity, jumpSpeed, jumpSustainTime) + fallingX(t, gravity)
+commonCasePeakTime(gravity, jumpSpeed, jumpSustainTime) = solve([commonCaseSpeed(t, gravity, jumpSpeed, jumpSustainTime)==0], t)[0].rhs()
+commonCasePeakHeight(gravity, jumpSpeed, jumpSustainTime) = commonCaseHeight(commonCasePeakTime(gravity, jumpSpeed, jumpSustainTime), gravity, jumpSpeed, jumpSustainTime)
+
+
+# jumpSustainTime < t && maxFallingTime < t && t < jumpEndTime #
+
+maxFallingCaseSpeed(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = currentJumpSpeed(t, gravity, jumpSpeed, jumpSustainTime) + maxFallingSpeed
+maxFallingCaseHeight(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = jumpingX(t, gravity, jumpSpeed, jumpSustainTime) + fallEndedX(t, gravity)
+maxFallingCasePeakTime(gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = solve([maxFallingCaseSpeed(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed)==0], t)[0].rhs()
+maxFallingCasePeakHeight(gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = maxFallingCaseHeight(maxFallingCasePeakTime(gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed), gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed)
+
+# maxFallingTime < t && t < jumpSustainTime #
+# in this case the speed is constant (-jumpSpeed + maxFallingSpeed) there is no strict maximum. #
+
+affineCaseSpeed(t, jumpSpeed, maxFallingSpeed) = -jumpSpeed + maxFallingSpeed
+affineCaseHeight(t, gravity, jumpSpeed, maxFallingSpeed) = sustainedX(t, jumpSpeed) + fallEndedX(t, gravity)
+
+
+# jumpEndTime < t && maxFallingTime < t #
+# This is a strictly descending phase, the peak can't happen here #
+
+glidingCaseSpeed(t, maxFallingSpeed) = maxFallingSpeed
+glidingCaseHeight(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = jumpEndedX(t, gravity, jumpSpeed, jumpSustainTime) + fallEndedX(t, gravity)
+
+
+# jumpEndTime < t && t < maxFallingTime #
+# This is a strictly descending phase, the peak can't happen here #
+
+freeFallCaseSpeed(t, gravity) = currentFallingSpeed(t, gravity)
+freeFallCaseHeight(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = jumpEndedX(t, gravity, jumpSpeed, jumpSustainTime) + fallingX(t, gravity)
+```
+
+#### Find the initial jump speed for a given jump height
+
+The great thing about quadratic functions is that it's easy to find solutions to a constraint. For instance, to find which initial jump speed to choose to jump a given height, the formula can be extracted like this:
+
+```Python
+var('givenHeight')
+solve([sustainCasePeakHeight(gravity, jumpSpeed, jumpSustainTime)==givenHeight], jumpSpeed)[1].rhs()
+solve([commonCasePeakHeight(gravity, jumpSpeed, jumpSustainTime)==givenHeight], jumpSpeed)[1].rhs()
+solve([maxFallingCasePeakHeight(gravity, jumpSpeed, jumpSustainTime)==givenHeight], jumpSpeed)[1].rhs()
+```
+
+The program will have to determine which formula to use. As the initial jump speed is unknown, it's not possible to know where the peak will happen, but jump speed solutions of each formula can be used to check if the peak actually happens during the right interval of time.
+
+```JavaScript
+if (maxFallingSpeedReachedTime > jumpSustainTime) {
+    // common case
+    jumpSpeed = commonCaseJumpSpeed(jumpHeight);
+    peakTime = commonCasePeakTime(jumpSpeed);
+
+    if (peakTime < jumpSustainTime) {
+        // sustain case
+        jumpSpeed = sustainCaseJumpSpeed(jumpHeight);
+    }
+    else if (peakTime > maxFallingSpeedReachedTime) {
+        // max falling case
+        jumpSpeed = maxFallingCaseJumpSpeed(jumpHeight);
+    }
+}
+else {
+    // affine case can't have a maximum
+
+    // sustain case
+    jumpSpeed = sustainCaseJumpSpeed(jumpHeight);
+    peakTime = jumpSpeed / gravity;
+
+    if (peakTime > maxFallingSpeedReachedTime) {
+        // max falling case
+        jumpSpeed = maxFallingCaseJumpSpeed(jumpHeight);
+    }
+}
+```
+
+#### Find the time for a given Y displacement
+
+The same kind of logic from the previous section can be used to evaluate at which time a character will be at a given ordinate when going up or going down.
+
+```Python
+sustainCaseUpTime(y, gravity, jumpSpeed) = solve([sustainCaseHeight(t, gravity, jumpSpeed)==y], t)[0].rhs()
+commonCaseUpTime(y, gravity, jumpSpeed, jumpSustainTime) = solve([height(t, gravity, jumpSpeed, jumpSustainTime)==y], t)[0].rhs()
+maxFallingCaseCaseUpTime(y, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = solve([maxFallingCaseHeight(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed)==y], t)[0].rhs()
+
+sustainCaseDownTime(y, gravity, jumpSpeed) = solve([sustainCaseHeight(t, gravity, jumpSpeed)==y], t)[1].rhs()
+commonCaseDownTime(y, gravity, jumpSpeed, jumpSustainTime) = solve([height(t, gravity, jumpSpeed, jumpSustainTime)==y], t)[1].rhs()
+maxFallingCaseCaseDownTime(y, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = solve([maxFallingCaseHeight(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed)==y], t)[1].rhs()
+glidingCaseDownTime(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = solve([glidingCaseHeight(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed)==y], t)[0].rhs() # only one solution (it's affine) #
+freeFallCaseDownTime(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed) = solve([freeFallCaseHeight(t, gravity, jumpSpeed, jumpSustainTime, maxFallingSpeed)==y], t)[1].rhs()
+
+affineCaseTime(y, jumpSpeed, maxFallingSpeed) = solve([affineCaseHeight(t, jumpSpeed, maxFallingSpeed)==y], t)[0].rhs()
+```
+
+The root conditions are the 3 piece-wise functions described at the end of the [Polynomial piece-wise function](#polynomial-piece-wise-function) section.
+Note that quadratic functions have a maximum or a minimum value which means there won't always be a solution. That's why there are "not a number" checks.
+
+```JavaScript
+if (maxFallingSpeedReachedTime > jumpEndTime) {
+    time = sustainCase(y);
+    if (time > jumpSustainTime || Number.isNaN(time)) {
+        time = commonCase(y);
+        if (time > jumpEndTime || Number.isNaN(time)) {
+            time = freeFallCase(y);
+            if (time > maxFallingSpeedReachedTime || Number.isNaN(time)) {
+                time = glidingCase(y);
+            }
+        }
+    }
+}
+else if (maxFallingSpeedReachedTime > jumpSustainTime) {
+    time = sustainCase(y);
+    if (time > jumpSustainTime || Number.isNaN(time)) {
+        time = commonCase(y);
+        if (time > maxFallingSpeedReachedTime || Number.isNaN(time)) {
+            time = maxFallingCase(y);
+            if (time > jumpEndTime || Number.isNaN(time)) {
+                time = glidingCase(y);
+            }
+        }
+    }
+}
+else {
+    time = sustainCase(y);
+    if (time > maxFallingSpeedReachedTime || Number.isNaN(time)) {
+        time = maxFallingSpeed >= jumpSpeed ? affineCase(y) : time = Number.MAX_VALUE;
+        if (time > jumpSustainTime || Number.isNaN(time)) {
+            time = maxFallingCase(y);
+            if (time > jumpEndTime || Number.isNaN(time)) {
+                time = glidingCase(y);
+            }
+        }
+    }
+}
+```
+
+#### Plotting trajectories
+
+This is the code used to plot the first graphic of the [Polynomial piece-wise function](#polynomial-piece-wise-function) section.
+
+```Python
+# The trajectory of the default jump settings
+#
+# gravity: 1000
+# maxFallingSpeed: 700
+# jumpSustainTime: 0.2
+# jumpSpeed: 600
+#
+# n(maxFallingTime(1000, 700))
+# 0.7
+
+(
+  plot(-sustainCaseHeight(t, 1000, 600), 0, 0.8, ymin=0, color='grey')
++ plot(-commonCaseHeight(t, 1000, 600, 0.2), 0, 0.8, ymin=0, color='black')
++ plot(-maxFallingCaseHeight(t, 1000, 600, 0.2, 700), 0, 0.8, ymin=0, color='grey')
++ plot(-piecewise([
+    ((0, 0.2), sustainCaseHeight(t, 1000, 600)),
+    ((0.2, maxFallingTime(1000, 700)), commonCaseHeight(t, 1000, 600, 0.2)),
+    ((maxFallingTime(1000, 700), 2), maxFallingCaseHeight(t, 1000, 600, 0.2, 700))
+  ]), 0, 0.8, ymin=0, color='cyan')
+)
+```
+
+
+
+
+
+
+

Extensions/PlatformBehavior/platformerobjectruntimebehavior.ts

@@ -53,11 +53,14 @@ namespace gdjs {
     _ladderClimbingSpeed: float;
 
     _canGrabPlatforms: boolean;
+    _canGrabWithoutMoving: boolean;
     private _yGrabOffset: any;
     private _xGrabTolerance: any;
 
     _useLegacyTrajectory: boolean = true;
 
+    _canGoDownFromJumpthru: boolean = false;
+
     // Behavior state
 
     _currentSpeed: float = 0;
@@ -66,6 +69,7 @@ namespace gdjs {
     _lastDeltaY: float = 0;
     _currentFallSpeed: float = 0;
     _canJump: boolean = false;
+    _lastDirectionIsLeft: boolean = false;
 
     private _ignoreDefaultControls: boolean;
     private _leftKey: boolean = false;
@@ -97,14 +101,10 @@ namespace gdjs {
     _onLadder: OnLadder;
 
     /** Platforms near the object, updated with `_updatePotentialCollidingObjects`. */
-    _potentialCollidingObjects: Array<
-      gdjs.BehaviorRBushAABB<gdjs.PlatformRuntimeBehavior>
-    >;
+    _potentialCollidingObjects: Array<gdjs.PlatformRuntimeBehavior>;
 
     /** Overlapped jump-thru platforms, updated with `_updateOverlappedJumpThru`. */
-    private _overlappedJumpThru: Array<
-      gdjs.BehaviorRBushAABB<gdjs.PlatformRuntimeBehavior>
-    >;
+    _overlappedJumpThru: Array<gdjs.PlatformRuntimeBehavior>;
 
     private _hasReallyMoved: boolean = false;
     private _manager: gdjs.PlatformObjectsManager;
@@ -123,11 +123,13 @@ namespace gdjs {
       this._maxSpeed = behaviorData.maxSpeed;
       this._jumpSpeed = behaviorData.jumpSpeed;
       this._canGrabPlatforms = behaviorData.canGrabPlatforms || false;
+      this._canGrabWithoutMoving = behaviorData.canGrabWithoutMoving;
       this._yGrabOffset = behaviorData.yGrabOffset || 0;
       this._xGrabTolerance = behaviorData.xGrabTolerance || 10;
       this._jumpSustainTime = behaviorData.jumpSustainTime || 0;
       this._ignoreDefaultControls = behaviorData.ignoreDefaultControls;
       this._useLegacyTrajectory = behaviorData.useLegacyTrajectory;
+      this._canGoDownFromJumpthru = behaviorData.canGoDownFromJumpthru;
       this._slopeMaxAngle = 0;
       this.setSlopeMaxAngle(behaviorData.slopeMaxAngle);
 
@@ -168,6 +170,12 @@ namespace gdjs {
       ) {
         this.setCanGrabPlatforms(newBehaviorData.canGrabPlatforms);
       }
+      if (
+        oldBehaviorData.canGrabWithoutMoving !==
+        newBehaviorData.canGrabWithoutMoving
+      ) {
+        this._canGrabWithoutMoving = newBehaviorData.canGrabWithoutMoving;
+      }
       if (oldBehaviorData.yGrabOffset !== newBehaviorData.yGrabOffset) {
         this._yGrabOffset = newBehaviorData.yGrabOffset;
       }
@@ -183,6 +191,12 @@ namespace gdjs {
       ) {
         this._useLegacyTrajectory = newBehaviorData.useLegacyTrajectory;
       }
+      if (
+        oldBehaviorData.canGoDownFromJumpthru !==
+        newBehaviorData.canGoDownFromJumpthru
+      ) {
+        this._canGoDownFromJumpthru = newBehaviorData.canGoDownFromJumpthru;
+      }
       return true;
     }
 
@@ -233,6 +247,10 @@ namespace gdjs {
 
       this._requestedDeltaX += this._updateSpeed(timeDelta);
 
+      if (this._leftKey !== this._rightKey) {
+        this._lastDirectionIsLeft = this._leftKey;
+      }
+
       //0.2) Track changes in object size
       this._state.beforeUpdatingObstacles(timeDelta);
       this._onFloor._oldHeight = object.getHeight();
@@ -453,11 +471,12 @@ namespace gdjs {
 
     _setFalling() {
       this._state.leave();
+      const from = this._state;
       this._state = this._falling;
-      this._falling.enter();
+      this._falling.enter(from);
     }
 
-    _setOnFloor(collidingPlatform: PlatformRuntimeBehavior) {
+    _setOnFloor(collidingPlatform: gdjs.PlatformRuntimeBehavior) {
       this._state.leave();
       this._state = this._onFloor;
       this._onFloor.enter(collidingPlatform);
@@ -470,7 +489,9 @@ namespace gdjs {
       this._jumping.enter(from);
     }
 
-    private _setGrabbingPlatform(grabbedPlatform: PlatformRuntimeBehavior) {
+    private _setGrabbingPlatform(
+      grabbedPlatform: gdjs.PlatformRuntimeBehavior
+    ) {
       this._state.leave();
       this._state = this._grabbingPlatform;
       this._grabbingPlatform.enter(grabbedPlatform);
@@ -500,20 +521,18 @@ namespace gdjs {
       let oldX = object.getX();
       object.setX(
         object.getX() +
-          (this._requestedDeltaX > 0
-            ? this._xGrabTolerance
-            : -this._xGrabTolerance)
+          (this._requestedDeltaX < 0 ||
+          (this._requestedDeltaX === 0 && this._lastDirectionIsLeft)
+            ? -this._xGrabTolerance
+            : this._xGrabTolerance)
       );
-      const collidingPlatforms: PlatformRuntimeBehavior[] = gdjs.staticArray(
+      const collidingPlatforms: gdjs.PlatformRuntimeBehavior[] = gdjs.staticArray(
         PlatformerObjectRuntimeBehavior.prototype._checkGrabPlatform
       );
       collidingPlatforms.length = 0;
       for (const platform of this._potentialCollidingObjects) {
-        if (
-          this._isCollidingWith(platform.behavior) &&
-          this._canGrab(platform.behavior)
-        ) {
-          collidingPlatforms.push(platform.behavior);
+        if (this._isCollidingWith(platform) && this._canGrab(platform)) {
+          collidingPlatforms.push(platform);
         }
       }
       object.setX(oldX);
@@ -645,7 +664,7 @@ namespace gdjs {
      * @returns true if the object was moved
      */
     private _separateFromPlatforms(
-      candidates: gdjs.BehaviorRBushAABB<gdjs.PlatformRuntimeBehavior>[],
+      candidates: gdjs.PlatformRuntimeBehavior[],
       excludeJumpThrus: boolean
     ) {
       excludeJumpThrus = !!excludeJumpThrus;
@@ -656,19 +675,17 @@ namespace gdjs {
       for (let i = 0; i < candidates.length; ++i) {
         const platform = candidates[i];
         if (
-          platform.behavior.getPlatformType() ===
-          gdjs.PlatformRuntimeBehavior.LADDER
+          platform.getPlatformType() === gdjs.PlatformRuntimeBehavior.LADDER
         ) {
           continue;
         }
         if (
           excludeJumpThrus &&
-          platform.behavior.getPlatformType() ===
-            gdjs.PlatformRuntimeBehavior.JUMPTHRU
+          platform.getPlatformType() === gdjs.PlatformRuntimeBehavior.JUMPTHRU
         ) {
           continue;
         }
-        objects.push(platform.behavior.owner);
+        objects.push(platform.owner);
       }
       return this.owner.separateFromObjects(objects, this._ignoreTouchingEdges);
     }
@@ -682,33 +699,31 @@ namespace gdjs {
      * @returns true if the object collides any platform
      */
     _isCollidingWithOneOf(
-      candidates: gdjs.BehaviorRBushAABB<gdjs.PlatformRuntimeBehavior>[],
+      candidates: gdjs.PlatformRuntimeBehavior[],
       exceptThisOne?: number | null,
       excludeJumpThrus?: boolean
     ) {
       excludeJumpThrus = !!excludeJumpThrus;
       for (let i = 0; i < candidates.length; ++i) {
         const platform = candidates[i];
-        if (platform.behavior.owner.id === exceptThisOne) {
+        if (platform.owner.id === exceptThisOne) {
           continue;
         }
         if (
-          platform.behavior.getPlatformType() ===
-          gdjs.PlatformRuntimeBehavior.LADDER
+          platform.getPlatformType() === gdjs.PlatformRuntimeBehavior.LADDER
         ) {
           continue;
         }
         if (
           excludeJumpThrus &&
-          platform.behavior.getPlatformType() ===
-            gdjs.PlatformRuntimeBehavior.JUMPTHRU
+          platform.getPlatformType() === gdjs.PlatformRuntimeBehavior.JUMPTHRU
         ) {
           continue;
         }
         if (
           gdjs.RuntimeObject.collisionTest(
             this.owner,
-            platform.behavior.owner,
+            platform.owner,
             this._ignoreTouchingEdges
           )
         ) {
@@ -729,7 +744,7 @@ namespace gdjs {
      * @returns the platform where to walk or if an obstacle was found
      */
     _findHighestFloorAndMoveOnTop(
-      candidates: gdjs.BehaviorRBushAABB<gdjs.PlatformRuntimeBehavior>[],
+      candidates: gdjs.PlatformRuntimeBehavior[],
       upwardDeltaY: float,
       downwardDeltaY: float
     ): PlatformSearchResult {
@@ -741,23 +756,19 @@ namespace gdjs {
       let isCollidingAnyPlatform = false;
       for (const platform of candidates) {
         if (
-          platform.behavior.getPlatformType() ===
-            gdjs.PlatformRuntimeBehavior.LADDER ||
+          platform.getPlatformType() === gdjs.PlatformRuntimeBehavior.LADDER ||
           // Jump through platforms are obstacles only when the character comes from the top.
-          (platform.behavior.getPlatformType() ===
+          (platform.getPlatformType() ===
             gdjs.PlatformRuntimeBehavior.JUMPTHRU &&
             // When following the floor, jumpthrus that are higher than the character are ignored.
             // If we only look above the character bottom, every jumpthrus can be discarded
             // without doing any collision check.
             ((this._state === this._onFloor &&
-              platform.behavior !== this._onFloor.getFloorPlatform() &&
+              platform !== this._onFloor.getFloorPlatform() &&
               downwardDeltaY < 0) ||
               // When trying to land on a platform, exclude jumpthrus that were already overlapped.
               (this._state !== this._onFloor &&
-                this._isIn(
-                  this._overlappedJumpThru,
-                  platform.behavior.owner.id
-                ))))
+                this._isIn(this._overlappedJumpThru, platform.owner.id))))
         ) {
           continue;
         }
@@ -769,8 +780,8 @@ namespace gdjs {
         if (
           // When following the floor, ignore jumpthrus that are higher than the character bottom.
           this._state === this._onFloor &&
-          platform.behavior !== this._onFloor.getFloorPlatform() &&
-          platform.behavior.getPlatformType() ===
+          platform !== this._onFloor.getFloorPlatform() &&
+          platform.getPlatformType() ===
             gdjs.PlatformRuntimeBehavior.JUMPTHRU &&
           highestRelativeY < 0
         ) {
@@ -796,7 +807,7 @@ namespace gdjs {
           highestRelativeY < totalHighestY
         ) {
           totalHighestY = highestRelativeY;
-          highestGround = platform.behavior;
+          highestGround = platform;
         }
       }
       if (highestGround) {
@@ -818,10 +829,10 @@ namespace gdjs {
      * @return the search context
      */
     private _findPlatformHighestRelativeYUnderObject(
-      platform: gdjs.BehaviorRBushAABB<gdjs.PlatformRuntimeBehavior>,
+      platform: gdjs.PlatformRuntimeBehavior,
       context: FollowConstraintContext
     ): FollowConstraintContext {
-      const platformObject = platform.behavior.owner;
+      const platformObject = platform.owner;
       const platformAABB = platformObject.getAABB();
       if (
         platformAABB.max[0] <= context.ownerMinX ||
@@ -924,27 +935,23 @@ namespace gdjs {
      * @param exceptTheseOnes The platforms to be excluded from the test
      */
     private _isCollidingWithOneOfExcluding(
-      candidates: gdjs.BehaviorRBushAABB<gdjs.PlatformRuntimeBehavior>[],
-      exceptTheseOnes: gdjs.BehaviorRBushAABB<gdjs.PlatformRuntimeBehavior>[]
+      candidates: gdjs.PlatformRuntimeBehavior[],
+      exceptTheseOnes: gdjs.PlatformRuntimeBehavior[]
     ) {
       for (let i = 0; i < candidates.length; ++i) {
         const platform = candidates[i];
-        if (
-          exceptTheseOnes &&
-          this._isIn(exceptTheseOnes, platform.behavior.owner.id)
-        ) {
+        if (exceptTheseOnes && this._isIn(exceptTheseOnes, platform.owner.id)) {
           continue;
         }
         if (
-          platform.behavior.getPlatformType() ===
-          gdjs.PlatformRuntimeBehavior.LADDER
+          platform.getPlatformType() === gdjs.PlatformRuntimeBehavior.LADDER
         ) {
           continue;
         }
         if (
           gdjs.RuntimeObject.collisionTest(
             this.owner,
-            platform.behavior.owner,
+            platform.owner,
             this._ignoreTouchingEdges
           )
         ) {
@@ -981,11 +988,11 @@ namespace gdjs {
       for (let i = 0; i < this._potentialCollidingObjects.length; ++i) {
         const platform = this._potentialCollidingObjects[i];
         if (
-          platform.behavior.getPlatformType() ===
+          platform.getPlatformType() ===
             gdjs.PlatformRuntimeBehavior.JUMPTHRU &&
           gdjs.RuntimeObject.collisionTest(
             this.owner,
-            platform.behavior.owner,
+            platform.owner,
             this._ignoreTouchingEdges
           )
         ) {
@@ -1002,15 +1009,14 @@ namespace gdjs {
       for (let i = 0; i < this._potentialCollidingObjects.length; ++i) {
         const platform = this._potentialCollidingObjects[i];
         if (
-          platform.behavior.getPlatformType() !==
-          gdjs.PlatformRuntimeBehavior.LADDER
+          platform.getPlatformType() !== gdjs.PlatformRuntimeBehavior.LADDER
         ) {
           continue;
         }
         if (
           gdjs.RuntimeObject.collisionTest(
             this.owner,
-            platform.behavior.owner,
+            platform.owner,
             this._ignoreTouchingEdges
           )
         ) {
@@ -1020,12 +1026,9 @@ namespace gdjs {
       return false;
     }
 
-    _isIn(
-      platformArray: gdjs.BehaviorRBushAABB<gdjs.PlatformRuntimeBehavior>[],
-      id: integer
-    ) {
+    _isIn(platformArray: gdjs.PlatformRuntimeBehavior[], id: integer) {
       for (let i = 0; i < platformArray.length; ++i) {
-        if (platformArray[i].behavior.owner.id === id) {
+        if (platformArray[i].owner.id === id) {
           return true;
         }
       }
@@ -1048,7 +1051,7 @@ namespace gdjs {
       // is not considered as colliding with itself, in the case that it also has the
       // platform behavior.
       for (let i = 0; i < this._potentialCollidingObjects.length; ) {
-        if (this._potentialCollidingObjects[i].behavior.owner === object) {
+        if (this._potentialCollidingObjects[i].owner === object) {
           this._potentialCollidingObjects.splice(i, 1);
         } else {
           i++;
@@ -1192,6 +1195,18 @@ namespace gdjs {
       return this._currentSpeed;
     }
 
+    /**
+     * Set the current speed of the Platformer Object.
+     * @param currentSpeed The current speed.
+     */
+    setCurrentSpeed(currentSpeed: float): void {
+      this._currentSpeed = gdjs.evtTools.common.clamp(
+        currentSpeed,
+        -this._maxSpeed,
+        this._maxSpeed
+      );
+    }
+
     /**
      * Get the current jump speed of the Platformer Object.
      * @returns The current jump speed.
@@ -1227,8 +1242,26 @@ namespace gdjs {
     /**
      * Set the maximum falling speed of the Platformer Object.
      * @param maxFallingSpeed The maximum falling speed.
+     * @param tryToPreserveAirSpeed If true and if jumping, tune the current jump speed to preserve the overall speed in the air.
      */
-    setMaxFallingSpeed(maxFallingSpeed: float): void {
+    setMaxFallingSpeed(
+      maxFallingSpeed: float,
+      tryToPreserveAirSpeed: boolean = false
+    ): void {
+      if (tryToPreserveAirSpeed && this._state === this._jumping) {
+        // If the falling speed is too high compared to the new max falling speed,
+        // reduce it and adapt the jump speed to preserve the overall vertical speed.
+        const fallingSpeedOverflow = this._currentFallSpeed - maxFallingSpeed;
+        if (fallingSpeedOverflow > 0) {
+          this._currentFallSpeed -= fallingSpeedOverflow;
+          this._jumping.setCurrentJumpSpeed(
+            Math.max(
+              0,
+              this._jumping.getCurrentJumpSpeed() - fallingSpeedOverflow
+            )
+          );
+        }
+      }
       this._maxFallingSpeed = maxFallingSpeed;
     }
 
@@ -1325,6 +1358,33 @@ namespace gdjs {
       }
     }
 
+    /**
+     * Abort the current jump.
+     *
+     * When the character is not in the jumping state this method has no effect.
+     */
+    abortJump(): void {
+      if (this._state === this._jumping) {
+        this._currentFallSpeed = 0;
+        this._setFalling();
+      }
+    }
+
+    /**
+     * Set the current fall speed.
+     *
+     * When the character is not in the falling state this method has no effect.
+     */
+    setCurrentFallSpeed(currentFallSpeed: float) {
+      if (this._state === this._falling) {
+        this._currentFallSpeed = gdjs.evtTools.common.clamp(
+          currentFallSpeed,
+          0,
+          this._maxFallingSpeed
+        );
+      }
+    }
+
     /**
      * Set if the Platformer Object can grab platforms.
      * @param enable Enable / Disable grabbing of platforms.
@@ -1530,7 +1590,7 @@ namespace gdjs {
    */
   class OnFloor implements State {
     private _behavior: PlatformerObjectRuntimeBehavior;
-    private _floorPlatform: PlatformRuntimeBehavior | null = null;
+    private _floorPlatform: gdjs.PlatformRuntimeBehavior | null = null;
     private _floorLastX: float = 0;
     private _floorLastY: float = 0;
     _oldHeight: float = 0;
@@ -1543,7 +1603,7 @@ namespace gdjs {
       return this._floorPlatform;
     }
 
-    enter(floorPlatform: PlatformRuntimeBehavior) {
+    enter(floorPlatform: gdjs.PlatformRuntimeBehavior) {
       this._floorPlatform = floorPlatform;
       this.updateFloorPosition();
       this._behavior._canJump = true;
@@ -1600,7 +1660,7 @@ namespace gdjs {
 
     checkTransitionBeforeX() {
       const behavior = this._behavior;
-      //Check that the floor object still exists and is near the object.
+      // Check that the floor object still exists and is near the object.
       if (
         !behavior._isIn(
           behavior._potentialCollidingObjects,
@@ -1608,6 +1668,14 @@ namespace gdjs {
         )
       ) {
         behavior._setFalling();
+      } else if (
+        this._behavior._downKey &&
+        this._floorPlatform!._platformType ===
+          gdjs.PlatformRuntimeBehavior.JUMPTHRU &&
+        behavior._canGoDownFromJumpthru
+      ) {
+        behavior._overlappedJumpThru.push(this._floorPlatform!);
+        behavior._setFalling();
       }
     }
 
@@ -1797,8 +1865,17 @@ namespace gdjs {
       this._behavior = behavior;
     }
 
-    enter() {
-      this._behavior._canJump = false;
+    enter(from: State) {
+      // Only forbid jumping when starting to fall from a platform,
+      // not when falling during a jump. This is because the Jumping
+      // state has already set `_canJump` to false and we don't want to reset
+      // it again because it could have been set back to `true` to allow
+      // for an "air jump".
+      // Transition from Falling to Falling state should not happen,
+      // but don't change anything if this ever happen.
+      if (from !== this._behavior._jumping && from !== this) {
+        this._behavior._canJump = false;
+      }
     }
 
     leave() {}
@@ -1811,13 +1888,16 @@ namespace gdjs {
 
     checkTransitionBeforeY(timeDelta: float) {
       const behavior = this._behavior;
-      //Go on a ladder
+      // Go on a ladder
       behavior._checkTransitionOnLadder();
-      //Jumping
+      // Jumping
       behavior._checkTransitionJumping();
 
-      //Grabbing a platform
-      if (behavior._canGrabPlatforms && behavior._requestedDeltaX !== 0) {
+      // Grabbing a platform
+      if (
+        behavior._canGrabPlatforms &&
+        (behavior._requestedDeltaX !== 0 || behavior._canGrabWithoutMoving)
+      ) {
         behavior._checkGrabPlatform();
       }
     }
@@ -1851,6 +1931,10 @@ namespace gdjs {
       return this._currentJumpSpeed;
     }
 
+    setCurrentJumpSpeed(currentJumpSpeed: number) {
+      this._currentJumpSpeed = currentJumpSpeed;
+    }
+
     enter(from: State) {
       const behavior = this._behavior;
       this._timeSinceCurrentJumpStart = 0;
@@ -1877,15 +1961,15 @@ namespace gdjs {
 
     checkTransitionBeforeY(timeDelta: float) {
       const behavior = this._behavior;
-      //Go on a ladder
+      // Go on a ladder
       behavior._checkTransitionOnLadder();
-      //Jumping
+      // Jumping
       behavior._checkTransitionJumping();
 
-      //Grabbing a platform
+      // Grabbing a platform
       if (
         behavior._canGrabPlatforms &&
-        behavior._requestedDeltaX !== 0 &&
+        (behavior._requestedDeltaX !== 0 || behavior._canGrabWithoutMoving) &&
         behavior._lastDeltaY >= 0
       ) {
         behavior._checkGrabPlatform();
@@ -1954,7 +2038,7 @@ namespace gdjs {
       this._behavior = behavior;
     }
 
-    enter(grabbedPlatform: PlatformRuntimeBehavior) {
+    enter(grabbedPlatform: gdjs.PlatformRuntimeBehavior) {
       this._grabbedPlatform = grabbedPlatform;
       this._behavior._canJump = true;
       this._behavior._currentFallSpeed = 0;

Extensions/PlatformBehavior/platformruntimebehavior.ts

@@ -67,7 +67,7 @@ namespace gdjs {
     getAllPlatformsAround(
       object: gdjs.RuntimeObject,
       maxMovementLength: number,
-      result: gdjs.BehaviorRBushAABB<PlatformRuntimeBehavior>[]
+      result: PlatformRuntimeBehavior[]
     ): any {
       // TODO: This would better be done using the object AABB (getAABB), as (`getCenterX`;`getCenterY`) point
       // is not necessarily in the middle of the object (for sprites for example).
@@ -92,8 +92,8 @@ namespace gdjs {
       // TODO: PR https://github.com/4ian/GDevelop/pull/2602 should remove the need
       // for this extra check once merged.
       for (let i = 0; i < nearbyPlatforms.length; i++) {
-        const platform = nearbyPlatforms[i];
-        const platformAABB = platform.behavior.owner.getAABB();
+        const platform = nearbyPlatforms[i].behavior;
+        const platformAABB = platform.owner.getAABB();
         const platformIsStillAround =
           platformAABB.min[0] <= searchArea.maxX &&
           platformAABB.min[1] <= searchArea.maxY &&

Extensions/PlatformBehavior/tests/JumpAndFallingPlatformer.spec.js

@@ -727,7 +727,7 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
       expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(true);
     });
 
-    it('can be allowed to jump in mid air', function () {
+    it('can be allowed to jump in mid air after falling from a platform', function () {
       // Ensure the object falls on the platform
       for (let i = 0; i < 10; ++i) {
         runtimeScene.renderAndStep(1000 / 60);
@@ -774,6 +774,56 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
       expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(true);
     });
 
+    it('can still be allowed to jump in mid air after its jump speed reached 0', function () {
+      // Ensure the object falls on the platform
+      for (let i = 0; i < 10; ++i) {
+        runtimeScene.renderAndStep(1000 / 60);
+      }
+
+      // Check the object is on the platform
+      expect(object.getY()).to.be(-30); // -30 = -10 (platform y) + -20 (object height)
+      expect(object.getBehavior('auto1').isFalling()).to.be(false);
+      expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+        false
+      );
+      expect(object.getBehavior('auto1').isMoving()).to.be(false);
+
+      // Jump
+      object.getBehavior('auto1').simulateJumpKey();
+      runtimeScene.renderAndStep(1000 / 60);
+      expect(object.getBehavior('auto1').isJumping()).to.be(true);
+      expect(object.getBehavior('auto1').isFalling()).to.be(false);
+      expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+        false
+      );
+      expect(object.getBehavior('auto1').canJump()).to.be(false);
+
+      // Allow to jump again
+      object.getBehavior('auto1').setCanJump();
+
+      // Is jumping
+      for (let i = 0; i < 40; ++i) {
+        object.getBehavior('auto1').simulateLeftKey();
+        runtimeScene.renderAndStep(1000 / 60);
+        // Can still jump...
+        expect(object.getBehavior('auto1').canJump()).to.be(true);
+      }
+      // ...even when after the jump ended.
+      expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(true);
+      expect(object.getBehavior('auto1').isFalling()).to.be(true);
+      expect(object.getBehavior('auto1').isJumping()).to.be(false);
+
+      // Jump again
+      object.getBehavior('auto1').simulateJumpKey();
+      runtimeScene.renderAndStep(1000 / 60);
+      expect(object.getBehavior('auto1').isJumping()).to.be(true);
+      expect(object.getBehavior('auto1').isFalling()).to.be(false);
+      expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+        false
+      );
+      expect(object.getBehavior('auto1').canJump()).to.be(false);
+    });
+
     it('can allow coyote time', function () {
       // Ensure the object falls on the platform
       for (let i = 0; i < 10; ++i) {
@@ -943,6 +993,107 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
       // Check that the object didn't grabbed the platform
       expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(false);
     });
+
+    const goToJumpPeak = () => {
+      // Ensure the object falls on the platform
+      for (let i = 0; i < 60 / 6; ++i) {
+        runtimeScene.renderAndStep(1000 / 60);
+      }
+
+      //Check the object is on the platform
+      expect(object.getY()).to.be(-30); // -30 = -10 (platform y) + -20 (object height)
+      expect(object.getBehavior('auto1').isFalling()).to.be(false);
+      expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+        false
+      );
+      expect(object.getBehavior('auto1').isMoving()).to.be(false);
+
+      // Jump with sustaining 1/10 of second
+      // A jump will at least sustain one frame,
+      // because the jump key is pressed.
+      // To have the same sustain time for each fps,
+      // we use their greatest common divisor: 10.
+      for (let i = 0; i < 60 / 10; ++i) {
+        object.getBehavior('auto1').simulateJumpKey();
+        runtimeScene.renderAndStep(1000 / 60);
+      }
+      expect(object.getY()).to.be.within(-112.5 - epsilon, -112.5 + epsilon);
+
+      // Jump without sustaining
+      for (let i = 0; i < 60 / 4 - 1; ++i) {
+        runtimeScene.renderAndStep(1000 / 60);
+        expect(object.getBehavior('auto1').isJumping()).to.be(true);
+        expect(object.getBehavior('auto1').isFalling()).to.be(false);
+        expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+          false
+        );
+      }
+
+      // Check that we reached the maximum height
+      expect(object.getY()).to.be.above(-206.25);
+      runtimeScene.renderAndStep(1000 / 60);
+      expect(object.getY()).to.be.within(-206.25 - epsilon, -206.25 + epsilon);
+      runtimeScene.renderAndStep(1000 / 60);
+      expect(object.getY()).to.be.above(-206.25);
+    };
+
+    it('can change the maximum falling speed without changing the vertical speed', function () {
+      goToJumpPeak();
+
+      // Change the maximum falling speed from 550 to 200 (for instance, for a gliding mode)
+      const previousFallSpeed = object
+        .getBehavior('auto1')
+        .getCurrentFallSpeed();
+      const previousJumpSpeed = object
+        .getBehavior('auto1')
+        .getCurrentJumpSpeed();
+      object.getBehavior('auto1').setMaxFallingSpeed(200, true);
+      runtimeScene.renderAndStep(1000 / 60);
+      // The character speed stays the same (25 is the acceleration).
+      // The jump speed is reduced as much as the falling speed.
+      expect(object.getBehavior('auto1').getCurrentFallSpeed()).to.be(
+        previousFallSpeed - 350
+      );
+      expect(object.getBehavior('auto1').getCurrentJumpSpeed()).to.be(
+        previousJumpSpeed - 350 - 25
+      );
+    });
+
+    it('can change the maximum falling speed and avoid changing the vertical speed too much', function () {
+      goToJumpPeak();
+      // Then let the object fall a bit
+      for (let i = 0; i < 15; ++i) {
+        runtimeScene.renderAndStep(1000 / 60);
+        expect(object.getBehavior('auto1').isJumping()).to.be(true);
+        expect(object.getBehavior('auto1').isFalling()).to.be(true);
+        expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+          false
+        );
+      }
+
+      // Change the maximum falling speed from 550 to 200 (for instance, for a gliding mode)
+      expect(object.getBehavior('auto1').getCurrentFallSpeed()).to.be(925);
+      expect(object.getBehavior('auto1').getCurrentJumpSpeed()).to.be(125);
+      object.getBehavior('auto1').setMaxFallingSpeed(200, true);
+      runtimeScene.renderAndStep(1000 / 60);
+      // The character jump speed is set to 0 to reduce the speed gap.
+      expect(object.getBehavior('auto1').getCurrentFallSpeed()).to.be(200);
+      expect(object.getBehavior('auto1').getCurrentJumpSpeed()).to.be(0);
+    });
+
+    it('can abort a jump', function () {
+      goToJumpPeak();
+
+      // Abort the jump
+      object.getBehavior('auto1').abortJump();
+      runtimeScene.renderAndStep(1000 / 60);
+      // jump and fall speeds are reset (25 is the acceleration).
+      expect(object.getBehavior('auto1').getCurrentFallSpeed()).to.be(25);
+      expect(object.getBehavior('auto1').getCurrentJumpSpeed()).to.be(0);
+      expect(object.getBehavior('auto1').isJumping()).to.be(false);
+      expect(object.getBehavior('auto1').isFalling()).to.be(true);
+      expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(true);
+    });
   });
 
   describe('(jumpthru)', function () {
@@ -971,6 +1122,7 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
             canGrabPlatforms: true,
             ignoreDefaultControls: true,
             slopeMaxAngle: 60,
+            canGoDownFromJumpthru: true,
           },
         ],
         effects: [],
@@ -1057,6 +1209,30 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
       expect(object.getBehavior('auto1').isFalling()).to.be(false);
     });
 
+    it('can go down from a jump through', function () {
+      object.setPosition(0, -55);
+      jumpthru.setPosition(0, -32);
+      // The character lands on the jumpthru.
+      for (let i = 0; i < 5; ++i) {
+        runtimeScene.renderAndStep(1000 / 60);
+      }
+      expect(object.getY()).to.be(-52); // -52 = -32 (jumpthru y) + -20 (object height)
+      expect(object.getBehavior('auto1').isFalling()).to.be(false);
+      expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+        false
+      );
+
+      // The character goes down from the jumpthru.
+      object.getBehavior('auto1').simulateDownKey();
+      runtimeScene.renderAndStep(1000 / 60);
+      for (let i = 0; i < 10; ++i) {
+        const previousY = object.getY();
+        runtimeScene.renderAndStep(1000 / 60);
+        expect(object.getBehavior('auto1').isFalling()).to.be(true);
+        expect(object.getY()).to.be.greaterThan(previousY);
+      }
+    });
+
     it('can jump right under a jumpthru without landing', function () {
       // A big one because the object jump to the right.
       jumpthru.setCustomWidthAndHeight(600, 20);
@@ -1152,12 +1328,11 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
     });
 
     it('can fall through the jumpthru from the left side', function () {
-      jumpthru.setPosition(0, -33);
       object.setPosition(0, -100);
       jumpthru.setPosition(12, -90);
       jumpthru.setCustomWidthAndHeight(60, 100);
 
-      // Check the jumpthru let the platformer object go through.
+      // The jumpthru lets the character go through.
       for (let i = 0; i < 10; ++i) {
         object.getBehavior('auto1').simulateRightKey();
         runtimeScene.renderAndStep(1000 / 60);
@@ -1167,9 +1342,50 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
         );
         expect(object.getBehavior('auto1').isMoving()).to.be(true);
       }
-      // Overlapping the jumpthru
-      expect(object.getX()).to.above(5);
-      expect(object.getY()).to.be.within(-100, -80);
+      // The character is overlapping the jumpthru.
+      expect(object.getX()).to.above(jumpthru.getX() - object.getWidth() + 3);
+      expect(object.getY()).to.be.within(
+        jumpthru.getY() - object.getHeight() + 10,
+        jumpthru.getY() + jumpthru.getHeight() - 10
+      );
+    });
+
+    it('can fall through a jumpthru from the left side and land on another jumpthru', function () {
+      object.setPosition(0, -100);
+      jumpthru.setPosition(1, -90);
+      jumpthru.setCustomWidthAndHeight(60, 20);
+
+      // Add another jumpthu under with a 10 pixels interleave (less than object height).
+      bottomJumpthru = addJumpThroughPlatformObject(runtimeScene);
+      bottomJumpthru.setPosition(1, -70);
+      bottomJumpthru.setCustomWidthAndHeight(60, 20);
+
+      // The jumpthru lets the character go through.
+      for (let i = 0; i < 7; ++i) {
+        object.getBehavior('auto1').simulateRightKey();
+        runtimeScene.renderAndStep(1000 / 60);
+        expect(object.getBehavior('auto1').isFalling()).to.be(true);
+        expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+          true
+        );
+        expect(object.getBehavior('auto1').isMoving()).to.be(true);
+      }
+      // The character is overlapping the jumpthru.
+      expect(object.getX()).to.above(jumpthru.getX() - object.getWidth() + 3);
+      expect(object.getY()).to.be.within(
+        jumpthru.getY() - object.getHeight() + 1,
+        jumpthru.getY() + jumpthru.getHeight() - 1
+      );
+
+      // The character lands on the other jumpthru
+      // while still overlapping the other one.
+      for (let i = 0; i < 5; ++i) {
+        runtimeScene.renderAndStep(1000 / 60);
+      }
+      expect(object.getBehavior('auto1').isOnFloor()).to.be(true);
+      expect(object.getBehavior('auto1').isFalling()).to.be(false);
+      expect(object.getBehavior('auto1').isMoving()).to.be(false);
+      expect(object.getY()).to.be(bottomJumpthru.getY() - object.getHeight());
     });
   });
 

Extensions/PlatformBehavior/tests/LadderAndCliffPlatformer.spec.js

@@ -1,5 +1,212 @@
 describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
-  describe('(grab platforms)', function () {
+  [true, false].forEach((canGrabWithoutMoving) => {
+    describe(`(grab platforms, canGrabWithoutMoving: ${canGrabWithoutMoving})`, function () {
+      let runtimeScene;
+      let object;
+
+      beforeEach(function () {
+        runtimeScene = makePlatformerTestRuntimeScene();
+
+        // Put a platformer object in the air.
+        object = new gdjs.TestRuntimeObject(runtimeScene, {
+          name: 'obj1',
+          type: '',
+          behaviors: [
+            {
+              type: 'PlatformBehavior::PlatformerObjectBehavior',
+              name: 'auto1',
+              gravity: 900,
+              maxFallingSpeed: 1500,
+              acceleration: 500,
+              deceleration: 1500,
+              maxSpeed: 500,
+              jumpSpeed: 1500,
+              canGrabPlatforms: true,
+              ignoreDefaultControls: true,
+              slopeMaxAngle: 60,
+              canGrabWithoutMoving: canGrabWithoutMoving,
+            },
+          ],
+          effects: [],
+        });
+        object.setCustomWidthAndHeight(10, 20);
+        runtimeScene.addObject(object);
+        object.setPosition(0, -100);
+      });
+
+      it('can grab and release the right ledge of a platform', function () {
+        // Put a platform.
+        const platform = addPlatformObject(runtimeScene);
+        platform.setPosition(0, -10);
+        runtimeScene.renderAndStep(1000 / 60);
+
+        // Put the character near the right ledge of the platform.
+        object.setPosition(
+          platform.getX() + platform.getWidth() + 2,
+          platform.getY() - 10
+        );
+
+        for (let i = 0; i < 10; ++i) {
+          object.getBehavior('auto1').simulateLeftKey();
+          runtimeScene.renderAndStep(1000 / 60);
+        }
+
+        // The character grabs the platform.
+        expect(object.getX()).to.be.within(
+          platform.getX() + platform.getWidth() + 0,
+          platform.getX() + platform.getWidth() + 1
+        );
+        expect(object.getY()).to.be(platform.getY());
+        expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
+
+        // The character releases the platform.
+        object.getBehavior('auto1').simulateReleasePlatformKey();
+        // The character falls.
+        for (let i = 0; i < 10; ++i) {
+          runtimeScene.renderAndStep(1000 / 60);
+          expect(object.getBehavior('auto1').isFalling()).to.be(true);
+          expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+            true
+          );
+        }
+        expect(object.getY()).to.be.above(0);
+      });
+
+      it('can grab and release the left ledge of a platform', function () {
+        // Put a platform.
+        const platform = addPlatformObject(runtimeScene);
+        platform.setPosition(0, -10);
+        runtimeScene.renderAndStep(1000 / 60);
+
+        // Put the character near the right ledge of the platform.
+        object.setPosition(
+          platform.getX() - object.getWidth() - 2,
+          platform.getY() - 10
+        );
+
+        for (let i = 0; i < 10; ++i) {
+          object.getBehavior('auto1').simulateRightKey();
+          runtimeScene.renderAndStep(1000 / 60);
+        }
+
+        // The character grabs the platform.
+        expect(object.getX()).to.be.within(
+          platform.getX() - object.getWidth() - 1,
+          platform.getX() - object.getWidth() - 0
+        );
+        expect(object.getY()).to.be(platform.getY());
+        expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
+
+        // The character releases the platform.
+        object.getBehavior('auto1').simulateReleasePlatformKey();
+        // The character falls.
+        for (let i = 0; i < 10; ++i) {
+          runtimeScene.renderAndStep(1000 / 60);
+          expect(object.getBehavior('auto1').isFalling()).to.be(true);
+          expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+            true
+          );
+        }
+        expect(object.getY()).to.be.above(0);
+      });
+
+      [true, false].forEach((addTopPlatformFirst) => {
+        it('can grab every platform when colliding 2', function () {
+          // The 2 platforms will be simultaneously in collision
+          // with the object when it grabs one.
+          let upperPlatform, lowerPlatform;
+          if (addTopPlatformFirst) {
+            upperPlatform = addPlatformObject(runtimeScene);
+            upperPlatform.setPosition(0, -10);
+            upperPlatform.setCustomWidthAndHeight(60, 10);
+
+            lowerPlatform = addPlatformObject(runtimeScene);
+            lowerPlatform.setPosition(0, 0);
+            lowerPlatform.setCustomWidthAndHeight(60, 10);
+          } else {
+            lowerPlatform = addPlatformObject(runtimeScene);
+            lowerPlatform.setPosition(0, 0);
+            lowerPlatform.setCustomWidthAndHeight(60, 10);
+
+            upperPlatform = addPlatformObject(runtimeScene);
+            upperPlatform.setPosition(0, -10);
+            upperPlatform.setCustomWidthAndHeight(60, 10);
+          }
+
+          // Put the object near the right ledge of the platform.
+          object.setPosition(
+            upperPlatform.getX() + upperPlatform.getWidth() + 2,
+            upperPlatform.getY() - 10
+          );
+          runtimeScene.renderAndStep(1000 / 60);
+
+          for (let i = 0; i < 10; ++i) {
+            object.getBehavior('auto1').simulateLeftKey();
+            runtimeScene.renderAndStep(1000 / 60);
+          }
+
+          // Check that the object grabbed the upper platform
+          expect(object.getX()).to.be.within(
+            upperPlatform.getX() + upperPlatform.getWidth() + 0,
+            upperPlatform.getX() + upperPlatform.getWidth() + 1
+          );
+          expect(object.getY()).to.be(upperPlatform.getY());
+          expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
+
+          // Release upper platform
+          object.getBehavior('auto1').simulateReleasePlatformKey();
+          for (let i = 0; i < 10; ++i) {
+            object.getBehavior('auto1').simulateLeftKey();
+            runtimeScene.renderAndStep(1000 / 60);
+          }
+
+          // Check that the object grabbed the lower platform
+          expect(object.getX()).to.be.within(
+            lowerPlatform.getX() + lowerPlatform.getWidth() + 0,
+            lowerPlatform.getX() + lowerPlatform.getWidth() + 1
+          );
+          expect(object.getY()).to.be(lowerPlatform.getY());
+          expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
+        });
+      });
+
+      it('can grab a platform and jump', function () {
+        // Put a platform.
+        platform = addPlatformObject(runtimeScene);
+        platform.setPosition(0, -10);
+        runtimeScene.renderAndStep(1000 / 60);
+
+        //Put the object near the right ledge of the platform.
+        object.setPosition(
+          platform.getX() + platform.getWidth() + 2,
+          platform.getY() - 10
+        );
+
+        for (let i = 0; i < 10; ++i) {
+          object.getBehavior('auto1').simulateLeftKey();
+          runtimeScene.renderAndStep(1000 / 60);
+        }
+
+        //Check that the object grabbed the platform
+        expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
+        expect(object.getX()).to.be.within(
+          platform.getX() + platform.getWidth() + 0,
+          platform.getX() + platform.getWidth() + 1
+        );
+        expect(object.getY()).to.be(platform.getY());
+
+        object.getBehavior('auto1').simulateJumpKey();
+        //Check that the object is jumping
+        for (let i = 0; i < 10; ++i) {
+          runtimeScene.renderAndStep(1000 / 60);
+          expect(object.getBehavior('auto1').isJumping()).to.be(true);
+        }
+        expect(object.getY()).to.be.below(platform.getY());
+      });
+    });
+  });
+
+  describe('(grab platforms, canGrabWithoutMoving: true)', function () {
     let runtimeScene;
     let object;
 
@@ -23,6 +230,7 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
             canGrabPlatforms: true,
             ignoreDefaultControls: true,
             slopeMaxAngle: 60,
+            canGrabWithoutMoving: true,
           },
         ],
         effects: [],
@@ -32,7 +240,7 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
       object.setPosition(0, -100);
     });
 
-    it('can grab, and release, a platform', function () {
+    it('can grab without moving and release the right ledge of a platform', function () {
       // Put a platform.
       const platform = addPlatformObject(runtimeScene);
       platform.setPosition(0, -10);
@@ -44,17 +252,20 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
         platform.getY() - 10
       );
 
-      for (let i = 0; i < 35; ++i) {
-        object.getBehavior('auto1').simulateLeftKey();
+      // The character faces the platform
+      object.getBehavior('auto1').simulateLeftKey();
+      runtimeScene.renderAndStep(1000 / 60);
+      expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(false);
+      for (let i = 0; i < 10; ++i) {
         runtimeScene.renderAndStep(1000 / 60);
       }
-
       // The character grabs the platform.
       expect(object.getX()).to.be.within(
         platform.getX() + platform.getWidth() + 0,
-        platform.getX() + platform.getWidth() + 1
+        platform.getX() + platform.getWidth() + 2
       );
       expect(object.getY()).to.be(platform.getY());
+      expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
 
       // The character releases the platform.
       object.getBehavior('auto1').simulateReleasePlatformKey();
@@ -69,98 +280,92 @@ describe('gdjs.PlatformerObjectRuntimeBehavior', function () {
       expect(object.getY()).to.be.above(0);
     });
 
-    [true, false].forEach((addTopPlatformFirst) => {
-      it('can grab every platform when colliding 2', function () {
-        // The 2 platforms will be simultaneously in collision
-        // with the object when it grabs one.
-        let upperPlatform, lowerPlatform;
-        if (addTopPlatformFirst) {
-          upperPlatform = addPlatformObject(runtimeScene);
-          upperPlatform.setPosition(0, -10);
-          upperPlatform.setCustomWidthAndHeight(60, 10);
-
-          lowerPlatform = addPlatformObject(runtimeScene);
-          lowerPlatform.setPosition(0, 0);
-          lowerPlatform.setCustomWidthAndHeight(60, 10);
-        } else {
-          lowerPlatform = addPlatformObject(runtimeScene);
-          lowerPlatform.setPosition(0, 0);
-          lowerPlatform.setCustomWidthAndHeight(60, 10);
-
-          upperPlatform = addPlatformObject(runtimeScene);
-          upperPlatform.setPosition(0, -10);
-          upperPlatform.setCustomWidthAndHeight(60, 10);
-        }
-
-        // Put the object near the right ledge of the platform.
-        object.setPosition(
-          upperPlatform.getX() + upperPlatform.getWidth() + 2,
-          upperPlatform.getY() - 10
-        );
-        runtimeScene.renderAndStep(1000 / 60);
-
-        for (let i = 0; i < 35; ++i) {
-          object.getBehavior('auto1').simulateLeftKey();
-          runtimeScene.renderAndStep(1000 / 60);
-        }
-
-        // Check that the object grabbed the upper platform
-        expect(object.getX()).to.be.within(
-          upperPlatform.getX() + upperPlatform.getWidth() + 0,
-          upperPlatform.getX() + upperPlatform.getWidth() + 1
-        );
-        expect(object.getY()).to.be(upperPlatform.getY());
-        expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
-
-        // Release upper platform
-        object.getBehavior('auto1').simulateReleasePlatformKey();
-        for (let i = 0; i < 35; ++i) {
-          object.getBehavior('auto1').simulateLeftKey();
-          runtimeScene.renderAndStep(1000 / 60);
-        }
-
-        // Check that the object grabbed the lower platform
-        expect(object.getX()).to.be.within(
-          lowerPlatform.getX() + lowerPlatform.getWidth() + 0,
-          lowerPlatform.getX() + lowerPlatform.getWidth() + 1
-        );
-        expect(object.getY()).to.be(lowerPlatform.getY());
-        expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
-      });
-    });
-
-    it('can grab a platform and jump', function () {
+    it('can grab without moving and release the left ledge of a platform', function () {
       // Put a platform.
-      platform = addPlatformObject(runtimeScene);
+      const platform = addPlatformObject(runtimeScene);
       platform.setPosition(0, -10);
       runtimeScene.renderAndStep(1000 / 60);
 
-      //Put the object near the right ledge of the platform.
+      // Put the character near the left ledge of the platform.
+      object.setPosition(
+        platform.getX() - object.getWidth() - 2,
+        platform.getY() - 10
+      );
+
+      // The character faces the platform
+      object.getBehavior('auto1').simulateRightKey();
+      for (let i = 0; i < 10; ++i) {
+        runtimeScene.renderAndStep(1000 / 60);
+      }
+      // The character grabs the platform.
+      expect(object.getX()).to.be.within(
+        platform.getX() - object.getWidth() - 2,
+        platform.getX() - object.getWidth() - 0
+      );
+      expect(object.getY()).to.be(platform.getY());
+      expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
+
+      // The character releases the platform.
+      object.getBehavior('auto1').simulateReleasePlatformKey();
+      // The character falls.
+      for (let i = 0; i < 10; ++i) {
+        runtimeScene.renderAndStep(1000 / 60);
+        expect(object.getBehavior('auto1').isFalling()).to.be(true);
+        expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(
+          true
+        );
+      }
+      expect(object.getY()).to.be.above(0);
+    });
+
+    it('must not grab automatically the right ledge of a platform when facing back', function () {
+      // Put a platform.
+      const platform = addPlatformObject(runtimeScene);
+      platform.setPosition(0, -10);
+      runtimeScene.renderAndStep(1000 / 60);
+
+      // Put the character near the right ledge of the platform.
       object.setPosition(
         platform.getX() + platform.getWidth() + 2,
         platform.getY() - 10
       );
 
-      for (let i = 0; i < 35; ++i) {
-        object.getBehavior('auto1').simulateLeftKey();
-        runtimeScene.renderAndStep(1000 / 60);
-      }
-
-      //Check that the object grabbed the platform
-      expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(true);
-      expect(object.getX()).to.be.within(
-        platform.getX() + platform.getWidth() + 0,
-        platform.getX() + platform.getWidth() + 1
-      );
-      expect(object.getY()).to.be(platform.getY());
-
-      object.getBehavior('auto1').simulateJumpKey();
-      //Check that the object is jumping
+      // The character faces the wrong way
+      object.getBehavior('auto1').simulateRightKey();
+      runtimeScene.renderAndStep(1000 / 60);
+      expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(false);
       for (let i = 0; i < 10; ++i) {
         runtimeScene.renderAndStep(1000 / 60);
-        expect(object.getBehavior('auto1').isJumping()).to.be(true);
       }
-      expect(object.getY()).to.be.below(platform.getY());
+      // The character couldn't grab the platform.
+      expect(object.getBehavior('auto1').isFalling()).to.be(true);
+      expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(true);
+      expect(object.getY()).to.be.greaterThan(platform.getY() + 5);
+    });
+
+    it('must not grab automatically the left ledge of a platform when facing back', function () {
+      // Put a platform.
+      const platform = addPlatformObject(runtimeScene);
+      platform.setPosition(0, -10);
+      runtimeScene.renderAndStep(1000 / 60);
+
+      // Put the character near the left ledge of the platform.
+      object.setPosition(
+        platform.getX() - object.getWidth() - 2,
+        platform.getY() - 10
+      );
+
+      // The character faces the wrong way
+      object.getBehavior('auto1').simulateLeftKey();
+      runtimeScene.renderAndStep(1000 / 60);
+      expect(object.getBehavior('auto1').isGrabbingPlatform()).to.be(false);
+      for (let i = 0; i < 10; ++i) {
+        runtimeScene.renderAndStep(1000 / 60);
+      }
+      // The character couldn't grab the platform.
+      expect(object.getBehavior('auto1').isFalling()).to.be(true);
+      expect(object.getBehavior('auto1').isFallingWithoutJumping()).to.be(true);
+      expect(object.getY()).to.be.greaterThan(platform.getY() + 5);
     });
   });
 

Extensions/PlatformBehavior/tests/findHighestFloorAndMoveOnTop.spec.js

@@ -95,7 +95,7 @@ describe(`gdjs.PlatformerObjectRuntimeBehavior.findHighestFloorAndMoveOnTop`, fu
     downwardDeltaY
   ) => {
     const result = characterBehavior._findHighestFloorAndMoveOnTop(
-      [platformBehavior.currentRBushAABB],
+      [platformBehavior],
       upwardDeltaY,
       downwardDeltaY
     );
@@ -110,7 +110,7 @@ describe(`gdjs.PlatformerObjectRuntimeBehavior.findHighestFloorAndMoveOnTop`, fu
   ) => {
     const oldY = characterBehavior.owner.getY();
     const result = characterBehavior._findHighestFloorAndMoveOnTop(
-      [platformBehavior.currentRBushAABB],
+      [platformBehavior],
       upwardDeltaY,
       downwardDeltaY
     );
@@ -127,7 +127,7 @@ describe(`gdjs.PlatformerObjectRuntimeBehavior.findHighestFloorAndMoveOnTop`, fu
   ) => {
     const oldY = characterBehavior.owner.getY();
     const result = characterBehavior._findHighestFloorAndMoveOnTop(
-      [platformBehavior.currentRBushAABB],
+      [platformBehavior],
       upwardDeltaY,
       downwardDeltaY
     );

Extensions/PrimitiveDrawing/Extension.cpp

@@ -21,11 +21,14 @@ void DeclarePrimitiveDrawingExtension(gd::PlatformExtension& extension) {
           "Open source (MIT License)")
       .SetExtensionHelpPath("/objects/shape_painter");
 
-  gd::ObjectMetadata& obj = extension.AddObject<ShapePainterObject>(
-      "Drawer",  //"Drawer" is kept for compatibility with GD<=3.6.76
-      _("Shape painter"),
-      _("Allows you to draw simple shapes on the screen"),
-      "CppPlatform/Extensions/primitivedrawingicon.png");
+  gd::ObjectMetadata& obj =
+      extension
+          .AddObject<ShapePainterObject>(
+              "Drawer",  //"Drawer" is kept for compatibility with GD<=3.6.76
+              _("Shape painter"),
+              _("Allows you to draw simple shapes on the screen"),
+              "CppPlatform/Extensions/primitivedrawingicon.png")
+          .SetCategoryFullName(_("General"));
 
 #if defined(GD_IDE_ONLY)
   obj.SetIncludeFile("PrimitiveDrawing/ShapePainterObject.h");
@@ -377,14 +380,14 @@ void DeclarePrimitiveDrawingExtension(gd::PlatformExtension& extension) {
       .SetFunctionName("closePath")
       .SetIncludeFile("PrimitiveDrawing/ShapePainterObject.h");
 
-  obj.AddScopedAction(
-         "ClearShapes",
-         _("Clear shapes"),
-         _("Clear the rendered shape(s). Useful if not set to be done automatically."),
-         _("Clear the rendered image of _PARAM0_"),
-         _("Advanced"),
-         "res/actions/visibilite24.png",
-         "res/actions/visibilite.png")
+  obj.AddScopedAction("ClearShapes",
+                      _("Clear shapes"),
+                      _("Clear the rendered shape(s). Useful if not set to be "
+                        "done automatically."),
+                      _("Clear the rendered image of _PARAM0_"),
+                      _("Advanced"),
+                      "res/actions/visibilite24.png",
+                      "res/actions/visibilite.png")
       .AddParameter("object", _("Shape Painter object"), "Drawer");
 
   obj.AddAction(
@@ -645,23 +648,23 @@ void DeclarePrimitiveDrawingExtension(gd::PlatformExtension& extension) {
       .MarkAsAdvanced();
 
   obj.AddExpressionAndConditionAndAction("number",
-                "ScaleX",
-                _("Scale on X axis"),
-                _("the width's scale of an object"),
-                _("the width's scale"),
-                _("Size"),
-                "res/actions/scaleWidth24.png")
+                                         "ScaleX",
+                                         _("Scale on X axis"),
+                                         _("the width's scale of an object"),
+                                         _("the width's scale"),
+                                         _("Size"),
+                                         "res/actions/scaleWidth24.png")
       .AddParameter("object", _("Object"), "Drawer")
       .UseStandardParameters("number")
       .MarkAsAdvanced();
 
   obj.AddExpressionAndConditionAndAction("number",
-                "ScaleY",
-                _("Scale on Y axis"),
-                _("the height's scale of an object"),
-                _("the height's scale"),
-                _("Size"),
-                "res/actions/scaleHeight24.png")
+                                         "ScaleY",
+                                         _("Scale on Y axis"),
+                                         _("the height's scale of an object"),
+                                         _("the height's scale"),
+                                         _("Size"),
+                                         "res/actions/scaleHeight24.png")
       .AddParameter("object", _("Object"), "Drawer")
       .UseStandardParameters("number")
       .MarkAsAdvanced();
@@ -728,13 +731,15 @@ void DeclarePrimitiveDrawingExtension(gd::PlatformExtension& extension) {
       .UseStandardOperatorParameters("number")
       .MarkAsAdvanced();
 
-  obj.AddAction("SetRotationCenter",
-                _("Center of rotation"),
-                _("Change the center of rotation of an object relatively to the object origin."),
-                _("Change the center of rotation of _PARAM0_: _PARAM1_; _PARAM2_"),
-                _("Angle"),
-                "res/actions/position24.png",
-                "res/actions/position.png")
+  obj.AddAction(
+         "SetRotationCenter",
+         _("Center of rotation"),
+         _("Change the center of rotation of an object relatively to the "
+           "object origin."),
+         _("Change the center of rotation of _PARAM0_: _PARAM1_; _PARAM2_"),
+         _("Angle"),
+         "res/actions/position24.png",
+         "res/actions/position.png")
       .AddParameter("object", _("Object"), "Drawer")
       .AddParameter("expression", _("X position"))
       .AddParameter("expression", _("Y position"))
@@ -742,8 +747,10 @@ void DeclarePrimitiveDrawingExtension(gd::PlatformExtension& extension) {
 
   obj.AddAction("SetRectangularCollisionMask",
                 _("Collision Mask"),
-                _("Change the collision mask of an object to a rectangle relatively to the object origin."),
-                _("Change the collision mask of _PARAM0_ to a rectangle from _PARAM1_; _PARAM2_ to _PARAM3_; _PARAM4_"),
+                _("Change the collision mask of an object to a rectangle "
+                  "relatively to the object origin."),
+                _("Change the collision mask of _PARAM0_ to a rectangle from "
+                  "_PARAM1_; _PARAM2_ to _PARAM3_; _PARAM4_"),
                 _("Position"),
                 "res/actions/position24.png",
                 "res/actions/position.png")

Extensions/Screenshot/JsExtension.js

@@ -33,7 +33,11 @@ module.exports = {
         'Matthias Meike',
         'Open source (MIT License)'
       )
-      .setExtensionHelpPath('/all-features/screenshot');
+      .setExtensionHelpPath('/all-features/screenshot')
+      .setCategory('Device');
+    extension
+      .addInstructionOrExpressionGroupMetadata(_('Screenshot'))
+      .setIcon('JsPlatform/Extensions/take_screenshot32.png');
 
     extension
       .addAction(
@@ -43,8 +47,8 @@ module.exports = {
           'Take a screenshot of the game, and save it to a png file (supported only when running on Windows/Linux/macOS).'
         ),
         _('Take a screenshot and save at _PARAM1_'),
-        _('Screenshot'),
-        'JsPlatform/Extensions/take_screenshot24.png',
+        '',
+        'JsPlatform/Extensions/take_screenshot32.png',
         'JsPlatform/Extensions/take_screenshot32.png'
       )
       .addCodeOnlyParameter('currentScene', '')

Extensions/Shopify/JsExtension.cpp

@@ -16,7 +16,10 @@ void DeclareShopifyExtension(gd::PlatformExtension& extension) {
         "Shopify shop."),
       "Florian Rival",
       "Open source (MIT License)")
-      .SetExtensionHelpPath("/all-features/shopify");
+      .SetExtensionHelpPath("/all-features/shopify")
+      .SetCategory("Third-party");
+  extension.AddInstructionOrExpressionGroupMetadata(_("Shopify"))
+      .SetIcon("JsPlatform/Extensions/shopifyicon.png");
 
 #if defined(GD_IDE_ONLY)
   extension
@@ -27,9 +30,9 @@ void DeclareShopifyExtension(gd::PlatformExtension& extension) {
             "and then use the shop name in the other actions to interact with "
             "products."),
           _("Initialize shop _PARAM1_ (domain: _PARAM2_, appId: _PARAM3_)"),
-          _("Shopify"),
-          "JsPlatform/Extensions/shopifyicon24.png",
-          "JsPlatform/Extensions/shopifyicon16.png")
+          "",
+          "JsPlatform/Extensions/shopifyicon.png",
+          "JsPlatform/Extensions/shopifyicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter("string", _("Shop name"))
@@ -47,9 +50,9 @@ void DeclareShopifyExtension(gd::PlatformExtension& extension) {
           _("Get the URL for product #_PARAM2_ (quantity: _PARAM3_, variant: "
             "_PARAM4_) from shop _PARAM1_, and store it in _PARAM5_ (or "
             "_PARAM6_ in case of error)"),
-          _("Shopify"),
-          "JsPlatform/Extensions/shopifyicon24.png",
-          "JsPlatform/Extensions/shopifyicon16.png")
+          "",
+          "JsPlatform/Extensions/shopifyicon.png",
+          "JsPlatform/Extensions/shopifyicon.png")
 
       .AddCodeOnlyParameter("currentScene", "")
       .AddParameter(