Creating and using scenes

As described in the introduction, scenes consist of multiple recordings and/or other scenes with optional playback modifiers. They provide a simple way of mixing multiple recordings with different player names, skins, delays or other applied modifiers.

To create new scene use /mocap scenes add [scene name]. To add recording to a scene use /mocap scenes add_to [scene name] [recording name]. You can add multiple recordings to a single scene. To start playback of a scene /mocap playback start [scene name].

Note that scene names start with a dot, but when using /mocap scenes commands you may often omit it (unless you want to add scene to another scene which is also possible).

If you want to assign specific player name and skin to scene element use optional argument of "scenes add_to" command - /mocap scenes add_to [scene name] [recording name] [player name]. This will make this particular element of a scene always start with this name, ignoring your name or one specified in "playback start" command.

Listing scene elements and its IDs

You can list scene elements with /mocap scenes list [scene name] command. Each scene element has unique ID which is just a number 1, 2, 3 and so on - "scenes list" command lists these elements with their IDs, name of a recording/scene which this element starts and player name if assigned.

Managing scene elements

To remove element from a scene use /mocap scene remove_from [scene name] [element ID]. Element ID can simply be a number like 1 or 2 (use previous command to list them) or can be one of IDs suggested by mod. These are also valid element IDs, but they have trailing zeroes to make them sort in proper order and are suffixed by recording/scene name corresponding to scene element. This suffix can help you find element you want to remove and provides protection from accidentally removing wrong element, in case two or more players would concurrently remove element from a single recording, by validating if prefix actually matches recording/scene name.

To modify scene element use /mocap scene modify [scene name] [element ID] [parameter]. Parameter is either name of playback modifier or subscene_name which will modify name of a recording/scene corresponding to given scene element.