feat: add actions to set max and min FPS at runtime

This adds two new event actions under the Time category that allow
developers to change the game's maximum and minimum FPS during runtime.

These values are applied directly to the RuntimeGame instance and
affect the rendering loop's frame rate capping behavior.

Note: No validation is currently performed. Negative values or setting
minFPS greater than maxFPS may lead to undefined behavior or visual
issues. Future improvements could include IDE-level validation or
runtime warnings.

Author: ArturKrys

Core/GDCore/Extensions/Builtin/TimeExtension.cpp

@@ -151,6 +151,28 @@ void GD_CORE_API BuiltinExtensionsImplementer::ImplementsTimeExtension(
       .AddParameter("expression",
                     _("Scale (1: Default, 2: 2x faster, 0.5: 2x slower...)"));
 
+  extension
+      .AddAction("SetMaximumFPS",
+                _("Maximum FPS"),
+                _("Change the maximum frames per second at runtime."),
+                _("Set maximum FPS to _PARAM1_"),
+                _("Rendering"),
+                "res/actions/fps_max24.png",
+                "res/actions/fps_max.png")
+      .AddCodeOnlyParameter("currentScene", "")
+      .AddParameter("expression", _("Maximum FPS"));
+
+  extension
+      .AddAction("SetMinimumFPS",
+                _("Minimum FPS"),
+                _("Change the minimum frames per second at runtime."),
+                _("Set minimum FPS to _PARAM1_"),
+                _("Rendering"),
+                "res/actions/fps_min24.png",
+                "res/actions/fps_min.png")
+      .AddCodeOnlyParameter("currentScene", "")
+      .AddParameter("expression", _("Minimum FPS"));
+
   extension
       .AddAction("Wait",
                  _("Wait X seconds"),

GDJS/GDJS/Extensions/Builtin/TimeExtension.cpp

@@ -34,6 +34,10 @@ TimeExtension::TimeExtension() {
       "gdjs.evtTools.runtimeScene.getTimeScale");
   GetAllActions()["ChangeTimeScale"].SetFunctionName(
       "gdjs.evtTools.runtimeScene.setTimeScale");
+  GetAllActions()["SetMaximumFPS"].SetFunctionName(
+      "gdjs.evtTools.runtimeScene.setMaximumFPS");
+  GetAllActions()["SetMinimumFPS"].SetFunctionName(
+      "gdjs.evtTools.runtimeScene.setMinimumFPS");
 
   GetAllExpressions()["TimeDelta"].SetFunctionName(
       "gdjs.evtTools.runtimeScene.getElapsedTimeInSeconds");

GDJS/Runtime/events-tools/runtimescenetools.ts

@@ -52,6 +52,20 @@ namespace gdjs {
         return runtimeScene.getScene().getTimeManager().setTimeScale(timeScale);
       };
 
+      export const setMaximumFPS = function(
+        runtimeScene: gdjs.RuntimeScene,
+        fps: float
+      ) {
+        runtimeScene.getGame()._maxFPS = fps;
+      };
+
+      export const setMinimumFPS = function(
+        runtimeScene: gdjs.RuntimeScene,
+        fps: float
+      ) {
+        runtimeScene.getGame()._minFPS = fps;
+      };
+
       export const getTimeScale = function (runtimeScene: gdjs.RuntimeScene) {
         return runtimeScene.getScene().getTimeManager().getTimeScale();
       };