In PolypopLive an Action Sequence is a way to organize a series of actions to fire simultaneously or one after the other.

When creating an alert or a hotkey, an Action Sequence will help you organize the order of the action, and if needed, place a pause between them.

If you want to create a hotkey or an alert that triggers more than one action, we highly recommend using an Action Sequence. This will not only help you keep track of what you’re doing, but it will also make your UI cleaner and easier to navigate.

First, you will need to add a Source Alert

Let’s create a source with an alert. In this case, we’ll create a simple Hotkey.

  1. First off, create a new Hotkey source by clicking the + button under the Source Library list and selecting Hotkey from the menu that appears.

  2. Next, from the Hotkey’s properties at the bottom of the Source Library, click the “[Unassigned]” item to the right of the “Hotkey” property.

  3. Finally, press the Spacebar on your keyboard to assign it as the hotkey.

Adding an Actionable Object

Next, let’s create an object with an action we’ll trigger when a set amount of time elapses after we press our hotkey.

  1. From the Scene Layout panel, click the + button. The prefab browser should now open.

  2. On the categories list, select the “3D Objects” category.

  3. Select any object from the list of objects that appears.

  4. At the bottom of the window, click “Add As” and choose the 3D Object Emitter option.

    A 3D object emitter will be added to your Scene Layout panel.

Creating the Action Sequence

Finally, let’s create the action sequence that will run whenever we press our hotkey.

  1. Ensure the Hotkey source is selected from the Source Library.

  2. Now, click and drag your mouse from the “onPress” alert socket to pull out a wire.

  3. Next, attach the wire to the Action Sequence socket that should now be visible on the top center of the user interface.

The Action Sequence panel should now fully expand. This panel allows us to add steps that execute in order from top to bottom when our connected alert fires. Let’s add a couple of steps.

  1. On the Action Sequence panel, click the + button.

  2. From the menu that appears, click the “Wait” item.

  3. The Wait step should now appear on the list. Adjust its wait time to 3 seconds by clicking and dragging on its roller.

  4. Next, let’s add another step. From the Action Sequence panel, click the + button.

  5. From the menu that appears, click the “Emit Alert” item. The “Emit Alert” step will emit its alert when the action sequence reaches it, which in this case will occur after the time we set in the preceding Wait step.

Let’s now connect the “Emit Alert” to the 3D Object Emitter’s “Emit Burst” action.

  1. Ensure the 3D Object Emitter is selected from the Scene Layout list.

  2. Click and drag your mouse from the “Emit Alert” socket on the Action Sequence panel and connect the wire to the 3D Object Emitter’s “Emit Burst” action socket.

Now let’s see what happens when we press our Hotkey.

  1. Press Spacebar

The Action Sequence will now run in response to the “onPress” action that triggers when we press Spacebar. The sequence will wait 3 seconds then emit an alert that will, in turn, emit a burst of objects from our 3D Object Emitter.

You can close the Action Sequence panel via the “X” button at the top right of the panel when you are done editing its steps. You can re-access it by hovering your mouse over the hotkey’s “onPress” socket and clicking the Action Sequence link that appears.