> For the complete documentation index, see [llms.txt](https://docs.shadersource.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shadersource.io/assets-and-plugins/waterfall-tool-2/how-to-use/waterfall-tool-2-editor-mode.md).

# Waterfall Tool 2 Editor Mode

The **SHADERSOURCE: Waterfall Tool 2 Mode** is a custom editor mode used to create and modify waterfall data for SHADERSOURCE Waterfall 2 actors in a level.

<details>

<summary>Accessing the Waterfall Tool 2 Editor Mode</summary>

The Waterfall Tool 2 Editor Mode can be accessed either via the Editor Modes dropdown or the SHADERSOURCE menu.

Editor Modes dropdown:

<img src="https://2855220899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk51ACJUA5E3mZvLb9h%2Fuploads%2FKTGi2HxGGyCGR2p79Zyn%2FWaterfallTool4.png?alt=media&amp;token=b7fd5bdf-db9d-41e3-9265-a183a33a44b7" alt="" data-size="original">

SHADERSOURCE menu (Level Editor Toolbar):

![](https://2855220899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk51ACJUA5E3mZvLb9h%2Fuploads%2FfkfGhl7M2k5cZbacRlyk%2FWaterfallTool5.png?alt=media\&token=88aec51c-2b4c-46df-8dec-293286e0de18)

SHADERSOURCE menu (Window menu):

![](https://2855220899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk51ACJUA5E3mZvLb9h%2Fuploads%2F3xVA23fMRhv5mTxoYSNM%2FWaterfallTool6.png?alt=media\&token=16e96415-27f9-41b5-b44a-7d6328496b3b)

</details>

<details>

<summary>Waterfall Tool 2 Editor Mode Header Content</summary>

![](https://2855220899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk51ACJUA5E3mZvLb9h%2Fuploads%2F18cXSFopfNMbb3Jbljdc%2FWaterfallTool9.png?alt=media\&token=d4f3038c-2038-4feb-a5a7-abae33679dc6)

1. **SHADERSOURCE Modes Menu**: Finds and creates buttons to easily switch between SHADERSOURCE Editor Modes.
2. **Documentation button**: Opens the tool's documentation page in your default browser.
3. **Store Page button**: Opens the tool's Fab store page in your default browser.
4. **Version number**: Show's the tool's current version number so that it can be compared to the latest version.

</details>

<details>

<summary>UI (without a waterfall selected)</summary>

![](https://2855220899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk51ACJUA5E3mZvLb9h%2Fuploads%2FF1FHYNEjXHL8yOxiAetv%2FWaterfallTool10.png?alt=media\&token=3a74bd00-0067-4724-89c8-85ad56d701f6)

1. A search bar to easily search for waterfalls or settings.
2. Drag and drop to create a new SHADERSOURCE Waterfall 2 actor.
3. **Auto Focus Waterfall**: If ticked on, when selecting a waterfall either here or in the menu in the waterfall selected UI, the editor will automatically focus the newly selected waterfall (like pressing 'F' in the viewport).
4. A list of all the waterfall actors in the level. Click on one of them to create or edit waterfall data for the actor.

</details>

<details>

<summary>UI (with a waterfall selected)</summary>

**Creating or Editing a Waterfall**

With a waterfall selected, the Waterfall Tool 2 Editor Mode is split into three tabs:

* [Simple](/assets-and-plugins/waterfall-tool-2/how-to-use/waterfall-tool-2-editor-mode/simple-tab.md): A simplified version of the tool with less options to generate a waterfall quickly.
* [Advanced](/assets-and-plugins/waterfall-tool-2/how-to-use/waterfall-tool-2-editor-mode/advanced-tab.md): A more complex version of the tool with many more options to tweak minor parts of a waterfall.
* [Debug](/assets-and-plugins/waterfall-tool-2/how-to-use/waterfall-tool-2-editor-mode/debug-tab.md): A handful of functions to show debugging data.

<img src="https://2855220899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk51ACJUA5E3mZvLb9h%2Fuploads%2FYCrrBJgkx0crrbGMRACh%2FWaterfallTool8.png?alt=media&amp;token=d3909a73-0a39-40c0-8132-c956d99a9109" alt="" data-size="original">

**Waterfall Selection**

There is also a dropdown menu as a quick way to select other waterfall actors in the open level, or to create a new waterfall actor.

![](https://2855220899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk51ACJUA5E3mZvLb9h%2Fuploads%2FSBLDuL6ufKThtGAxsN7O%2FWaterfallTool7.png?alt=media\&token=75c7bb79-3a24-42bf-9502-d5bbce46584c)

</details>