VisualShaderNodeParticleConeVelocity in Godot – Complete Guide

Creating dynamic and visually impressive particle effects is a crucial aspect of modern game development, offering a path to bring games to life with realistic explosions, weather phenomena, or magical effects. In Godot 4, a powerful engine for game creators, managing particles is made intuitive with the use of visual shader nodes. Today, we dive into a specialized class, the VisualShaderNodeParticleConeVelocity, and discover how you can harness its power to make your particles move in an engaging, cone-shaped pattern right from the start. Join us as we explore the capabilities of this class and illustrate how you can integrate it into your Godot projects to add that extra spark to your game environments.

What Is VisualShaderNodeParticleConeVelocity?

VisualShaderNodeParticleConeVelocity is a component of Godot’s robust visual shader system, designed to grant developers control over the behavior of particle systems. Particle systems are an aggregate of many small particles that create a visual impression when combined, such as smoke, rain, or fire. By using this visual shader node, we can set particles to burst out in a cone formation, giving you artistic control over the initial velocity and direction, which can be vital for creating compelling visual effects.

What Is It Used For?

VisualShaderNodeParticleConeVelocity is particularly useful when trying to simulate effects that naturally follow a conical distribution, such as a flamethrower’s fiery exhaust or a fountain’s water spray. It can imbue your scene with a more dynamic and realistic feel, where particles don’t just move linearly but can be artistically directed to create a more natural effect.

Why Should I Learn It?

Learning to manipulate particle velocities through the VisualShaderNodeParticleConeVelocity brings two significant advantages to any game developer’s toolkit:

– **Enhanced Visuals**: Particle effects can transform the aesthetic of any game, making environments and actions more immersive.
– **Creative Control**: Having mastery over particle motion allows for customized effects that fit precisely with the game’s design and storyline.

Furthermore, knowing how to work with such shader nodes will deepen your understanding of visual programming in Godot, a valuable skill in today’s game development landscape. Let’s get started with some practical applications in the next section of our tutorial!

CTA Small Image

Setting Up a Basic Particle System in Godot 4

Let’s start by setting up a basic particle system in Godot 4. First, we need to create a Particle Node. This will be the container for our particle effects. With the node selected, we can proceed to define the properties like the amount, lifetime, and pre-process time. Here’s a simple set up:

var particle =
particle.amount = 100
particle.lifetime = 1.0
particle.preprocess = 0.5

This code creates a particle system with 100 particles that have a lifetime of one second. The ‘preprocess’ property allows the particles to be emitted before the scene starts, making the effect appear in full swing right from the get-go.

Integrating the VisualShaderNodeParticleConeVelocity

Now that we have our basic particles system, it’s time to integrate VisualShaderNodeParticleConeVelocity. For this, we’ll need to create a new ShaderMaterial for our particles. Followed by creating a new Shader and assigning it to the material:

var material =
var shader =
material.shader = shader

Next, we insert the VisualShaderNodeParticleConeVelocity node into our shader. We can do this programmatically by creating a VisualShader and adding the node:

var visual_shader =
var cone_velocity_node =

visual_shader.add_node(VisualShader.TYPE_PARTICLES, cone_velocity_node, Vector2(0, 0))
material.set_shader_param("shader", visual_shader)

This creates the cone velocity node within our visual shader and sets it to the ShaderMaterial of the Particle Node, ready to customize.

Customizing Cone Parameters

For the particle cone velocity to have the desired effect, we’ll have to customize it by setting its angle and velocity parameters. A smaller angle means a narrower cone, while a larger angle will give a wider cone shape. Here’s an example of setting the angles:

cone_velocity_node.set_angle(deg2rad(30))  // 30 degrees in radians

Next up is the velocity. It determines how fast the particles will move:

cone_velocity_node.set_velocity(5)  // Units per second

We have now set up a cone velocity with a 30-degree spread and a constant velocity of 5 units per second. Let’s move the particles in a specific axis direction:

cone_velocity_node.set_direction(Vector3(0, 1, 0))  // Upwards

By pointing the direction vector to `(0, 1, 0)`, we’ve set our particles to move upward. Adjusting the direction vector lets you control the exact orientation you want for the cone-shaped particle movement.

With our direction set, we also want to vary our particle speeds to make the effect look more natural. We can achieve this variance by setting the randomness value. A randomness factor of `1` means completely random velocity within the cone, while a value of `0` ensures all particles have the same velocity.

cone_velocity_node.set_randomness(0.5)  // Half random velocity

This means our particles’ velocities will vary somewhat, but not too drastically. It’s perfect for simulating things like a gentle breeze or a chaotic fountain spray.

Furthermore, we can animate our shader parameters over time for dynamic effects. To animate the velocity over the particle’s lifetime, we’ll add a VisualShaderNodeInput node to link the ‘time’ input parameter:

var time_input_node =
time_input_node.input_name = "time"
visual_shader.add_node(VisualShader.TYPE_PARTICLES, time_input_node, Vector2(-200, 0))

visual_shader.node_connect(time_input_node.shader_node, "output", cone_velocity_node.shader_node, "velocity")

This will ensure particles’ velocities are adjusted over time, allowing for effects like a firework explosion that slows down as it expands.

To control the spread of the cone over time, we can add a scalar uniform node and animate it within the Godot animation editor:

var spread_uniform_node =
spread_uniform_node.uniform_name = "angle"
visual_shader.add_node(VisualShader.TYPE_PARTICLES, spread_uniform_node, Vector2(-400, 0))

visual_shader.node_connect(spread_uniform_node.shader_node, "output", cone_velocity_node.shader_node, "angle")

Now you can animate the ‘angle’ uniform and the cone’s spread will change dynamically, perhaps to simulate a jet engine powering up or down.

Let’s also consider adding some color variation to our particles. We can create a VisualShaderNodeParticleRandomness node and use it to alter colors over the particle’s lifetime:

var color_randomness_node =
visual_shader.add_node(VisualShader.TYPE_PARTICLES, color_randomness_node, Vector2(200, 0))

var color_node =
color_node.uniform_name = "color_variation"
visual_shader.add_node(VisualShader.TYPE_PARTICLES, color_node, Vector2(400, 0))

visual_shader.node_connect(color_randomness_node.shader_node, "output", color_node.shader_node, "vector")

Here, the randomness is applied to the color, providing a variation in particle colors that can make effects like fire or sparkling magic come alive with a range of hues.

Finally, to see our particle effect in action, we need to assign our ShaderMaterial to the Particle System:

particle.process_material = material

After all these steps, you should see your very own particle cone effect in motion, complete with velocity variance and animated parameters. By mastering these techniques, you will be able to create complex and captivating visual effects that can significantly elevate the quality of your Godot game.

And remember, the key to great visual effects is not just in the technical setup, but also in the refinement and iteration of your designs. Experiment with different values, animate multiple parameters, and combine nodes creatively to produce some truly stunning visuals for your game.

At Zenva, we pride ourselves on producing the highest quality content to help you on your coding and game creation journey. Whether you’re just starting or looking to expand your skills further, we’re here to support you every step of the way. Happy coding!

Building on our cone velocity setup, let’s delve deeper into customizing our particle system to create more complex effects. We’ll start by adding a gravity effect to influence the particle motion over time, giving it a more natural fall-off like rain or sparks from a fire.

To create a gravity effect, we will add a VisualShaderNodeVec3Uniform node to represent our gravity vector:

var gravity_node =
gravity_node.uniform_name = "gravity"
visual_shader.add_node(VisualShader.TYPE_PARTICLES, gravity_node, Vector2(-200, 200))

visual_shader.node_connect(gravity_node.shader_node, "output", cone_velocity_node.shader_node, "gravity")

With the gravity node connected to our cone_velocity_node, we can now set the gravity in our material:

material.set_shader_param("gravity", Vector3(0, -9.8, 0))

Particles will now accelerate downwards, simulating the effect of gravity. Adjust the Vector3 values to simulate different environments or artistic styles.

Besides gravity, we might want our particles to start small and grow bigger as they move away from the origin, or vice versa. To achieve this, we can use a VisualShaderNodeScale to affect the particle size over time:

var scale_node =
scale_node.uniform_name = "scale"
visual_shader.add_node(VisualShader.TYPE_PARTICLES, scale_node, Vector2(-400, 200))

var output_node =
visual_shader.add_node(VisualShader.TYPE_PARTICLES, output_node, Vector2(400, 200))

visual_shader.node_connect(scale_node.shader_node, "output", output_node.shader_node, "scale")

Now let’s animate the scale parameter using the Godot animation system:

// Assuming you've set up an AnimationPlayer named 'anim_player'
var animation =
animation.length = 1.0  // 1 second long
animation.loop = true

animation.track_insert_key(0, 0.0, 1.0)  // At time 0, scale is 1
animation.track_insert_key(0, 1.0, 3.0)  // At time 1, scale is 3

var anim_player =
anim_player.add_animation("scale_anim", animation)"scale_anim")

This will make particle sizes increase from their initial value to 3 times larger over the span of one second, looping back to the start.

Additionally, to give particles different starting rotations which can be useful for simulating swirling effects, we can inject randomness into our initial rotation setting:

var rotation_randomness_node =
visual_shader.add_node(VisualShader.TYPE_PARTICLES, rotation_randomness_node, Vector2(600, 0))

visual_shader.node_connect(rotation_randomness_node.shader_node, "output", output_node.shader_node, "rotation")

With this setup, particles will have a random rotation applied at emission. Our particle system is now quite elaborate, capable of producing varied, natural-looking effects that can greatly enhance the atmosphere in your game.

Lastly, let’s ensure our particle system responds to the environment’s lighting to integrate seamlessly into our scenes. For this, we need to add visual shader nodes that factor in the lighting and shadow information:

var lighting_node =
visual_shader.add_node(VisualShader.TYPE_PARTICLES, lighting_node, Vector2(-600, 400))

visual_shader.node_connect(lighting_node.shader_node, "output", output_node.shader_node, "emission")

Now your particles will react to the world’s light, making them look like they are truly part of the scene. Shadows and highlights will shift depending on your game’s lighting configuration, adding depth and realism.

By incorporating these techniques, your particle effects can transition from simple decorative elements to complex features that elevate the player’s experience. Remember, practice and experimentation are key to mastering game development skills, so don’t hesitate to try new ideas and push the boundaries of what you can create with Godot.

We at Zenva are committed to providing you with informative tutorials so that learning to code and create games is both straightforward and enjoyable. Visit us for more insights and tutorials designed to help you become a proficient developer and game creator. Keep coding, and let your creativity run wild!

Where to Go Next with Your Godot Journey

Empowering your quest for game development mastery doesn’t have to end here. If you’ve enjoyed taking your first steps in particle systems and visual shaders with Godot 4, there’s a whole universe of knowledge waiting to be discovered. We encourage you to deepen your understanding and expand your game development repertoire with our Godot Game Development Mini-Degree. Dive into a comprehensive curriculum designed to take students through the ins and outs of creating cross-platform games utilizing the powerful features of Godot 4.

Whether you’re a beginner eager to build your first game or an experienced developer looking to refine your skills, our Mini-Degree has something for everyone. The courses cover a range of essential topics, from mastering 2D and 3D assets to scripting complex gameplay mechanics. Don’t miss the opportunity to learn in-demand skills and join a community of creators passionate about bringing their game ideas to life.

For those looking to explore a broader collection of resources, make sure to check out our full suite of Godot courses. Each course is accessible 24/7, allowing you to learn at your own pace and on your own schedule. Continue your journey with us at Zenva and gain the knowledge to turn your game development dreams into reality.


Unlocking the full potential of particle systems with Godot 4’s VisualShaderNodeParticleConeVelocity is just the beginning of what you can achieve in this versatile game engine. With the ability to create stunning visual effects, you’ll imbue your games with a level of polish and dynamism that captures players’ imaginations. Remember that each new skill you learn and each challenge you overcome brings you closer to realizing your vision for captivating interactive experiences.

Continue your game development journey with our Godot Game Development Mini-Degree, where you’ll find a treasure trove of knowledge to help you build, refine, and enhance your games. At Zenva, our goal is to make your learning experience rewarding and enjoyable because we believe that creating games should be as fun as playing them. Join us, and let’s shape the future of game development together!

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.