Basic Usage

Basic Usage

This guide will walk you through creating a simple river sound using the Audio Ribbon Editor.

1. Create a Ribbon

  1. Open the Audio Ribbon Editor from the Tools menu.
  2. Click the Add New Ribbon button (plus icon) in the top toolbar.
  3. Draw the Path: Click on the map to place nodes along your desired path (e.g., following a riverbed).
    • The tool allows you to draw the ribbon by placing nodes.
    • Place nodes roughly down the center of the feature you are sounding.

2. Adjust Placement & Shape

  1. Edit Nodes: If the path isn’t perfect, ensure Lock Shape is off, then click and drag individual nodes to refine the curve.
  2. Conform: Click the Conform to Surface button.
    • The tool will automatically snap the ribbon nodes to the river surface or terrain below.
    • Tip: If you have a River object, this ensures the sound emitter sits exactly on the water surface.
  3. Set Depth: Use the Depth slider.
    • For a river, a depth of 1-2m is usually sufficient.
    • For a 3D wind tunnel, you might want a larger depth (e.g., 10m).

3. Configure Audio

  1. Select Emitter Type:
    • For a river, toggle to Quad Mode. This gives the most realistic result as the water sound changes depending on your viewing angle.
  2. Assign Events: Enter your FMOD event paths in the Event Paths section.
    • Example: event:>Ambient>Water>River_Flow_Fast
    • Note: You can use the same event for all 4 channels if you just want volumetric sound, or different variations for Front/Rear if your audio bank supports it.

4. Verification & Tuning

  1. Test the Spatial Audio:
    • Move your camera close to the ribbon.
    • Use the Mute buttons to isolate the Front channel.
    • Rotate your camera. You should hear the sound primarily when looking upstream (or downstream, depending on your event setup).
  2. Adjust Speed:
    • Use the Speed slider to match the audio pitch/speed to the visual flow of the water.
  3. Finalize:
    • Once satisfied, you can Lock Shape to prevent accidental node movement.
    • The ribbon data is saved automatically with your level.

Audio Ribbon Editor in Action Audio Ribbon Editor in Action

Last modified: December 3, 2025

Any further questions?

Join our discord
Our documentation is currently incomplete and undergoing active development. If you have any questions or feedback, please visit this forum thread.