Unreal Engine 5 Documentation has been moved to the Epic Developer Community

Create a Ribbon Effect in Niagara

This document describes how you can create a ribbon visual effect using Niagara.

Choose your operating system:

Windows

macOS

Linux

Prerequisite Topics

In order to understand and use the content on this page, make sure you are familiar with the following topics:

Prerequisite Step: This How-To uses the DefaultRibbonMaterial, which is included in the content for the Niagara plugin. However, you can use the M_Balloon material used in the Create a Mesh Particle Effect How-To if you have already completed that tutorial.

Simulating natural phenomena is challenging, especially when using sprite or mesh-based particles to simulate smoke or vapor trails. Ribbon Emitters are an excellent solution for simulating these objects. In the following how-to, you will learn how to set up a Niagara Emitter to emit a continuous ribbon-style particle effect into the world.

Create System and Emitter

Unlike in Cascade, Niagara emitters and systems are independent. The current recommended workflow is to create a system from existing emitters or emitter templates.

  1. First, create a Niagara System by right-clicking in the Content Browser, and selecting FX > Niagara System . The Niagara Emitter wizard displays.

    Create System Menu

    Click image for full size.

  2. Select New system from selected emitters . Then click Next .

    System Wizard New from Selected

    Click image for full size.

  3. Under Templates , select Simple Sprite Burst .

    Using a template will place an emitter instance in your new system, and that emitter instance will have no inheritance.

    Select Template

    Click image for full size.

  4. Click the Plus sign icon ( + ) to add the selected emitter to the list of emitters to add to the system. Then click Finish .

    Add Selected Emitter and Finish

    Click image for full size.

  5. Name the new system RibbonSystem . Double-click to open it in the Niagara Editor.

    Name New System

  6. The emitter instance in your new system has the default name of SimpleSpriteBurst , but you can rename it. Click the name of the emitter instance in the System Overview , and the field will become editable. Name the emitter FX_Ribbon .

    Rename Emitter

    Click image for full size.

Change Renderer

The Render group is last in the stack, but you need to change some things so that the effect displays the way it is supposed to. The original template used a Sprite Renderer, but this effect needs a Ribbon Renderer.

  1. In the System Overview , click Render to open it in the Selection panel.

    Open Render Group

    Click image for full size.

  2. To make a ribbon effect, you need a Ribbon Renderer module. But the template has a Sprite Renderer module. Click the Trashcan icon to delete the Sprite Renderer.

    Remove Sprite Renderer

    Click image for full size.

  3. Click the Plus sign icon ( + ) for Render and select Ribbon Renderer .

    Add Ribbon Renderer

    Click image for full size.

  4. The material you want is not displayed by default. Click the dropdown for Material , and click View Options to open a list of options. Check the boxes for Show Engine Content and Show Plugin Content . Now you will be able to see the material.

    Set View Options

    Click image for full size.

  5. Click the dropdown for Material and select DefaultRibbonMaterial .

    If you completed the Create a Mesh Particle Effect how-to, you can select the M_Balloon material instead. This will give you an opaque ribbon, rather than the translucent one created by the DefaultRibbonMaterial.

    Select Material

    Click image for full size.

  6. Drag the RibbonSystem into your Level.

    When you make a particle effect, it is always a good idea to drag your system into a Level. This gives you a chance to see every change and edit in context. Any changes you make to the system automatically propagate to the instance of the system in your Level.

Edit the Emitter Update Group Settings

First, you will edit the modules in the Emitter Update group. These are behaviors that apply to the emitter, and that update each frame.

Even after adding a Ribbon Renderer and editing the settings in the Emitter Update group, you will not see a ribbon appear. This is normal! When you get to the Particle Spawn section of this document, you will start to see the actual ribbon.

  1. In the System Overview , click the Emitter Update group to open it in the Selection panel.

    Open Emitter Update Group

    Click image for full size.

  2. Expand the Emitter State module. This module controls time and scalability for this emitter. Because you used the Simple Sprite Burst template, the Life Cycle Mode is set to Self . Normally this is used for complete customization of emitter life cycle logic for this specific emitter, but it is not needed for this effect. Click the dropdown and set the Life Cycle Mode to System . This enables your system to calculate life cycle settings, which usually optimizes performance. By default, the system loops infinitely on a 5 second interval.

    Set Life Cycle Mode

    Click image for full size.

  3. The Spawn Rate module creates a continuous stream of particles while the emitter is active. Add the Spawn Rate module by clicking the Plus sign icon ( + ) for Emitter Update and selecting Spawning > Spawn Rate .

    Add the Spawn Rate Module

    Click image for full size.

  4. Set the Spawn Rate to 100 .

    Set Spawn Rate

    Click image for full size.

Edit the Particle Spawn Group Settings

Next, you will edit the modules in the Particle Spawn group. These are behaviors that apply to particles when they first spawn.

  1. In the System Overview , click the Particle Spawn group to open it in the Selection panel.

    Open Particle Spawn Group

    Click image for full size.

  2. Expand the Initialize Particle module. Click the Trashcan icon to delete it. You do not need this module, because there is a different module for initializing ribbons.

    Remove Initialize Particle Module

    Click image for full size.

  3. The Initialize Ribbon module performs a similar function to Initialize Particle, in that it collects several parameters into one module. Click the Plus sign icon ( + ) for Particle Spawn and select Initialize > Initialize Ribbon .

    Add Initialize Ribbon Module

    Click image for full size.

  4. Under Point Attributes , locate the Lifetime parameter. This parameter determines how long particles will display before they disappear. Set the Lifetime to 5 .

    Set Ribbon Lifetime

    Click image for full size.

  5. Set the Mass parameter to 10 . This will affect how the ribbon spreads outward, as well as how quickly it falls.

    Set Mass

    Click image for full size.

  6. For the Color parameter, set the R (Red) value to 1 . Leave the other values at 0 . You can change the color later, if you choose.

    Set Color

    Click image for full size.

  7. Under Ribbon Attributes , set the Ribbon Width to 10 .

    Set Ribbon Width

    Click image for full size.

  8. To make the ribbon spin in a spiral, you can add a Torus Location module. Location modules affect the shape of the location where the particles spawn. Click the Plus sign icon ( + ) for Particle Spawn and select Location > Torus Location .

    Add Torus Location Module

    Click image for full size.

  9. Under Shape , click the dropdown for Torus Mode and select Ring .

    Set Torus Mode

    Click image for full size.

  10. Set the Large Radius to 50 . The Large Radius determines how large the primary ring shape is.

    Set Large Radius

    Click image for full size.

  11. Under Distribution , click the dropdown for Torus Distribution Mode and select Direct .

    Set Distribution Mode

    Click image for full size.

  12. The U Position parameter sets the position on the ring shape. Expand the Emitter Attributes section of the Parameters panel. Drag the Emitter.Age parameter over to the Selection panel; you will see green dotted lines around the fields where you can use that parameter. Drop the Emitter.Age parameter on the U Position value. Your ribbon will look like it is spinning in a static ring, but you will change that in the next step!

    Set UPosition to Emitter.Age

    Click image for full size.

  13. Now you will add some velocity to the ribbon. Click the Plus sign icon ( + ) for Particle Spawn and select Velocity > Add Velocity From Point .

    Add the Add Velocity From Point Module

    Click image for full size.

  14. Set the Velocity Strength to 50 . Now you will see the ribbon start to spiral! This happens because as the position is moving around the Large Radius, the velocity pushes the ribbon outward from the original ring.

    Set Velocity Strength

    Click image for full size.

Edit the Particle Update Group Settings

Now you will edit the modules in the Particle Update group. These behaviors apply to an emitter's particles and update each frame.

  1. In the System Overview , click the Particle Update group to open it in the Selection panel.

    Open Particle Update Group

    Click image for full size.

  2. This effect has a single color, so the Scale Color module is not needed. Click the Trashcan icon to delete it.

    Remove Scale Color Module

    Click image for full size.

  3. Add the Acceleration Force module. This is what makes the spiraling ribbon fall down, simulating gravity. Click the Plus sign icon ( + ) for Particle Update and select Forces > Acceleration Force .

    Add the Acceleration Force Module

    Click image for full size.

  4. Because Niagara adds new modules to the bottom of the group's stack, you will get an error stating "The module has unmet dependencies." That is because the Acceleration Force module was placed after the Solve Forces and Velocity module. Click the Fix Issue button to reposition the module and resolve the error.

    Resolve Position Error

    Click image for full size.

  5. Set the Z value of the Acceleration to -200 . A positive Z value would make the ribbon spiral upwards; using a negative value makes it drop downward in a parabolic shape.

    Set Acceleration

    Click image for full size.

End Result

Congratulations! You have created a Niagara ribbon effect. In the video below, you can see the ribbon effect with the DefaultRibbonMaterial on the left, and the same ribbon effect with the M_Balloon texture on the right.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Dismiss