Dynamic Water

Easily create a realistic liquid surface simulation.

Authors and contributors to this experimental extension: Alios.

Warning

This is an extension made by a community member and it only got through a light review by the GDevelop extension team. As such, we can't guarantee it meets all the quality standards of fully reviewed extensions.

FEATURES

Fully customizable: by adjusting the liquid properties (tension, damping, spreading), you can simulate different types of liquids such as: water, jelly, lava, etc.
Can obtain the height of the surface at any point
Allows you to have full control over visual properties such as: color opacity, effects, etc.
Can create a force at any point on the surface.
Works on all platforms.

Tip

Learn how to install new extensions by following a step-by-step guide.

Dynamic Water Body

Easily create a realistic liquid surface simulation.

Behavior properties

**Auto waves ** (🔘 Boolean). Default value is false.
BodyColor (🎨 Color). Default value is 74;144;226.
Body opacity (🔢 Number). Default value is 100.
ColorOfColumns (🎨 Color). Default value is 255;255;255.
**The number of columns (springs) extended on the water surface ** (🔢 Number). Default value is 50.
The Damping value. Controls how fast the springs will return to their original position (🔢 Number). Default value is 0.025.
Show the spring columns (🔘 Boolean). Default value is false.
The Spread value will dictacte how much a wave oscilliation wil pass onto their neighboors. BEWARE, super high values may make the water oscilliate forever ! (🔢 Number). Default value is 0.1.
SufaceOpacity (🔢 Number). Default value is 100.
SurfaceColor (🎨 Color). Default value is 107;165;233.
SurfaceSize (🔢 Number). Default value is 1.
The water spring constant. Grater values will pull the water with greater force. (🔢 Number). Default value is 0.025.
Thickness of the surface collision (🔢 Number). Default value is 8.
WaveDirection (Choice, one of: "Right", "Left"). Default value is Right.
Wave length, the smaller the value, the longer the wave (🔢 Number). Default value is 0.5.
Wave magnitude, in pixels (🔢 Number). Default value is 16.
Wave period. between 0 and 1 (🔢 Number). Default value is 0.1.

See internal technical details

**Auto waves ** is stored as AutoWave (Boolean). Default value is false.
BodyColor is stored as BodyColor (Color). Default value is 74;144;226.
Body opacity is stored as BodyOpacity (Number). Default value is 100.
ColorOfColumns is stored as ColorOfColumns (Color). Default value is 255;255;255.
**The number of columns (springs) extended on the water surface ** is stored as Columns (Number). Default value is 50.
The Damping value. Controls how fast the springs will return to their original position is stored as Dampening (Number). Default value is 0.025.
Show the spring columns is stored as ShowColumns (Boolean). Default value is false.
The Spread value will dictacte how much a wave oscilliation wil pass onto their neighboors. BEWARE, super high values may make the water oscilliate forever ! is stored as Spread (Number). Default value is 0.1.
SufaceOpacity is stored as SufaceOpacity (Number). Default value is 100.
SurfaceColor is stored as SurfaceColor (Color). Default value is 107;165;233.
SurfaceSize is stored as SurfaceSize (Number). Default value is 1.
The water spring constant. Grater values will pull the water with greater force. is stored as Tension (Number). Default value is 0.025.
Thickness of the surface collision is stored as Thickness (Number). Default value is 8.
WaveDirection is stored as WaveDirection (Choice). Default value is Right.
Wave length, the smaller the value, the longer the wave is stored as WaveLength (Number). Default value is 0.5.
Wave magnitude, in pixels is stored as WaveMagnitude (Number). Default value is 16.
Wave period. between 0 and 1 is stored as WavePeriod (Number). Default value is 0.1.

Behavior actions

Force application
Apply a force when an object collides with its surface.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔢 Number): Apply force
Parameter 3 (👾 Object): Surface collision of the fluid

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::AddForce.

Auto Wave
Enable automatic waves.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (❓ Yes or No): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetAutoWave.

Show Columns
Show the different Column .

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (❓ Yes or No): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetColumn.

Springs Number
The number of springs controls the distance between the joints and the number of springs. (between 0 and the object width).
PS: Change the quality of the waves, the more columns the more they use the performance.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔢 Number): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetColumnNumber.

Damping(d)
The spring dampenig value. (between 0 and 0.1).

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔢 Number): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetDamping.

Change Period
Change Period.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔢 Number): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetPeriod.

Spread
The Spread value will dictate how much a wave oscillation will pass pnto their neighboors.(Between 0 and 0.1).

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔢 Number): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetSpread.

Surface Size
Change the size of the surface edge.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔢 Number): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetSurfaceSize.

Tension(k)
Greater values will pull the water with greater force. (between 0 and 0.1).

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔢 Number): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetTension.

Wave horizontal direction
Change the direction of the waves.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔤 String): The water spring constant (one of: "Right", "Left")

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetWaveDirection.

Wave Length
Change the length of the waves.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔢 Number): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetWaveLength.

Wave magnitude
Change the wave magnitude.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (🔢 Number): The water spring constant

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::SetWaveMagnitude.

Components
Component additions (Visual and Surface Collision).

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (👾 Object): Body display
Parameter 3 (👾 Object): Object that will be used to detect the collision on the surface

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::WaterBodyAndCollision.

Behavior conditions

Surface collision
Test the collision between the object and the fluid surface.

See parameters & details

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2 (👾 Object): Define the (physical) object that can interact with the fluid
Parameter 3 (👾 Object): Surface collision of the fluid

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is DynamicWater::DynamicWaterBody::CheckSurfaceCollisions.

Behavior expressions

Expression	Description
`Object.DynamicWaterBody::ColumnNumber()`	Number of columns.
`Object.DynamicWaterBody::Damping()`	Damping.
`Object.DynamicWaterBody::Spread()`	Spread.
`Object.DynamicWaterBody::SurfaceSize()`	Size of the edge of the surface.
`Object.DynamicWaterBody::Tension()`	Tension.

This page is an auto-generated reference page about the Dynamic Water extension for GDevelop, the open-source, AI-powered, cross-platform game engine designed for everyone. Learn more about all GDevelop extensions here.