Skip to main content
A Multi Route is a collection of routes grouped under one name. When a macro runs a Multi Route, it randomly picks one of the sub-routes each time execution starts. This adds variety to your automation path, making movement less predictable.

​
Creating a Multi Route

A Multi Route is a folder named <group_name>.route inside your routes folder. Every route JSON file in that folder is one variant.
This creates a Multi Route called mining_loop with three variants. The easiest way to build one is to create each variant with the folder in its name, since a route name with slashes is saved into matching subfolders:
After saving the first variant, run /nebula routes reload (or press the reload button in the Routes screen) — the group itself only appears once the folder exists on disk.

​
How Multi Routes Behave

  • One sub-route is chosen at random each time the route is started.
  • All sub-routes should share the same general start and end points, since macros expect consistent behavior.
  • The group itself cannot be edited in the route builder or the GUI editor. Sub-routes are also loaded individually under their own names, so edit them one at a time.
  • Multi Routes are displayed with a pink Multi · <count> chip in the GUI, and the details panel lists their sub-routes.
  • Exporting includes sub-routes individually, listed as <group>/<sub-route>.
  • Deleting a Multi Route removes the whole folder.

​
Which Settings Accept Multi Routes

Route settings only offer routes they can actually run, so a Multi Route does not appear in every picker: Where a Multi Route is accepted, you reference it by name exactly like any other route.