This PR adds two new actions under Game scene (Events) in GDevelop that allow developers to dynamically configure the game's maximum and minimum frames per second (FPS) during runtime.

These settings are useful for:

Reducing FPS during non-interactive scenes (e.g., cutscenes).
Exposing FPS settings in a game’s graphics or performance menu.

Implementation Details

Actions are declared in TimeExtension.cpp using .AddAction(...).
Mapped to new JS runtime functions:
- gdjs.evtTools.runtimeScene.setMaximumFPS
- gdjs.evtTools.runtimeScene.setMinimumFPS
FPS values are applied to RuntimeGame._maxFPS and _minFPS, which affect the main game loop behavior.

Demo

2025-08-01.03-20-27.mp4

Related issue

Closes#5362

ArturKrys requested a review from4ian as acode owner

August 1, 2025 02:26

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

42e57a2

This adds two new event actions under the Time category that allowdevelopers to change the game's maximum and minimum FPS during runtime.These values are applied directly to the RuntimeGame instance andaffect the rendering loop's frame rate capping behavior.Note: No validation is currently performed. Negative values or settingminFPS greater than maxFPS may lead to undefined behavior or visualissues. Future improvements could include IDE-level validation orruntime warnings.

ArturKrys force-pushed thefeature-max-min-fps branch from9bcdb31 to42e57a2Compare

August 3, 2025 20:33

Copy link

Owner

4ian commentedAug 3, 2025

Hi! Thanks for this PR :)
I think it would be nice to add:

methods to runtimeGame to avoid modifying a "private" property (starting with underscores) (this will be helpful in the future if changing these values imply other operations to be done)
validation in these new functions of the value (basically: not negative. 0 is considered unlimited already for maximum FPS).