From e29dbd2deb3bc53c09a8933c503e47da253224b3 Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Fri, 7 Aug 2026 00:10:01 +0200 Subject: [PATCH 1/4] Clarify lack of physics interpolation support with GPUParticles2D in 2D particle systems - Mention that physics interpolation is different from the Interpolate property available on GPUParticles2D. --- tutorials/2d/particle_systems_2d.rst | 28 +++++++++++++++++++++++++--- 1 file changed, 25 insertions(+), 3 deletions(-) diff --git a/tutorials/2d/particle_systems_2d.rst b/tutorials/2d/particle_systems_2d.rst index 643c918db..3f4637ac6 100644 --- a/tutorials/2d/particle_systems_2d.rst +++ b/tutorials/2d/particle_systems_2d.rst @@ -207,11 +207,33 @@ This setting can be used to set the particle system to render at a fixed FPS. For instance, changing the value to ``2`` will make the particles render at 2 frames per second. Note this does not slow down the particle system itself. +Set this to ``0`` to make particles simulate every rendered frame. This can +increase GPU requirements for complex particle setups, but ensures the particle +simulation is as smooth as possible. For particles with collision enabled, this +can also improve collision reliability. + +Interpolate +~~~~~~~~~~~ + +When enabled, the particle system will interpolate the position of particles +between each fixed FPS tick (see above). This results in smoother visuals. Only +particle motion is interpolated; scale and color curves are currently not +interpolated. + +This property has no effect if **Fixed FPS** is ``0``, as particles will be +simulated every rendered frame. + .. note:: - Godot 4.3 does not currently support physics interpolation for 2D particles. - As a workaround, disable physics interpolation for the particles node by setting - **Node > Physics Interpolation > Mode** at the bottom of the inspector. + Godot currently does not support + :ref:`physics interpolation ` + for GPUParticles2D. Note that physics interpolation should not be confused + with the **Interpolate** property on GPUParticles2D. + + As a workaround, disable physics interpolation for the particles node by + setting **Node > Physics Interpolation > Mode** at the bottom of the + inspector, or convert the node to CPUParticles2D which supports + physics interpolation. Fract Delta ~~~~~~~~~~~ From 7543d4d2bd1faa96ec45de6be4bffcf8cc3486c7 Mon Sep 17 00:00:00 2001 From: Matthew Date: Sun, 23 Aug 2026 10:38:19 -0400 Subject: [PATCH 2/4] Update tutorials/2d/particle_systems_2d.rst --- tutorials/2d/particle_systems_2d.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/2d/particle_systems_2d.rst b/tutorials/2d/particle_systems_2d.rst index 3f4637ac6..57524cd55 100644 --- a/tutorials/2d/particle_systems_2d.rst +++ b/tutorials/2d/particle_systems_2d.rst @@ -231,7 +231,7 @@ simulated every rendered frame. with the **Interpolate** property on GPUParticles2D. As a workaround, disable physics interpolation for the particles node by - setting **Node > Physics Interpolation > Mode** at the bottom of the + setting :menu:`Node > Physics Interpolation > Mode` at the bottom of the inspector, or convert the node to CPUParticles2D which supports physics interpolation. From da410aa8ddbcdc31dbfca50de60b06e3fa0e5831 Mon Sep 17 00:00:00 2001 From: Matthew Date: Sun, 23 Aug 2026 10:38:26 -0400 Subject: [PATCH 3/4] Update tutorials/2d/particle_systems_2d.rst --- tutorials/2d/particle_systems_2d.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/2d/particle_systems_2d.rst b/tutorials/2d/particle_systems_2d.rst index 57524cd55..eb677bddd 100644 --- a/tutorials/2d/particle_systems_2d.rst +++ b/tutorials/2d/particle_systems_2d.rst @@ -228,7 +228,7 @@ simulated every rendered frame. Godot currently does not support :ref:`physics interpolation ` for GPUParticles2D. Note that physics interpolation should not be confused - with the **Interpolate** property on GPUParticles2D. + with the :inspector:`Interpolate` property on GPUParticles2D. As a workaround, disable physics interpolation for the particles node by setting :menu:`Node > Physics Interpolation > Mode` at the bottom of the From 1015279813d3268b8f795948152454c67d2925a3 Mon Sep 17 00:00:00 2001 From: Matthew Date: Sun, 23 Aug 2026 10:38:33 -0400 Subject: [PATCH 4/4] Update tutorials/2d/particle_systems_2d.rst --- tutorials/2d/particle_systems_2d.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/2d/particle_systems_2d.rst b/tutorials/2d/particle_systems_2d.rst index eb677bddd..60989ef69 100644 --- a/tutorials/2d/particle_systems_2d.rst +++ b/tutorials/2d/particle_systems_2d.rst @@ -220,7 +220,7 @@ between each fixed FPS tick (see above). This results in smoother visuals. Only particle motion is interpolated; scale and color curves are currently not interpolated. -This property has no effect if **Fixed FPS** is ``0``, as particles will be +This property has no effect if :inspector:`Fixed FPS` is ``0``, as particles will be simulated every rendered frame. .. note::