Getting started with VMX Pulsar’s New User Music->Event Group System
The article below mirrors the video contents plus lists the commands relating to navigating around groups with the new Music->Event Group system. For assigning music to events and and placing them in to different groups, read the next article https://darknebula.cloud/2021/05/22/assigning-user-music-to-events-using-event-group-system-for-vmx-pulsar/
Enter, Event Groups!
Now that we know what Music to Event assignments are, let’s delve into Event Groups! Event Groups are as the name suggests, individual groups of Music to Event assignments. So in each group (1-6) you have a list of possible in game events to assign music to, such as ‘combat’, ‘on foot’, ‘docking’, ‘exploration’ etc. The full list of events is in the next article entitled “Assigning and removing event assignments with groups”. Every group contains the same list of in game events, but each group can hold entirely different music assignments to those events. So for example in ‘my group 1’ (the default group name for group#1) you could have playlists, audio files etc assigned to ‘combat’, ‘on foot’ etc, but in my group 2, you can assign entirely different playlists, audio files etc to the same events ‘combat’, ‘on foot’ and so forth. The purpose of this is to allow you to set different music styles to events in each group, they can vary based on music genre, music mood, or whatever you like! So for example ‘my group 1’ could contain film music assignments, ‘my group 2’ could contain ambient music assignments and so on!
You can of course name your groups almost anything you wish, so long as it’s not so long winded that VoiceAttack may have difficulty picking it up. We’ll discuss group naming further on in this article.
Setting and Listing Groups:
Navigating through groups and choosing how to sort and view groups is easy as pie, yet very flexible.
Setting and Listing groups have two different effects.
To set a group means you are SETTING it, that is, it is being defined as the event group for context mode to actively use whilst you are in game. In game events will trigger only the music assigned in the currently set group i.e mygroup1. Setting a group will also list the contents of the set group to VA’s log.
Set a a group with the following command “Set Group <group name>” i.e “Set Group my group 1”
LISTING a group. Listing a group purely does that, it shows you the contents of the group you wish to list, but it does NOT set it. So let’s say your currently set group is ‘my group 1’ and you call ‘list my group 2’, you will see a list from ‘my group 2’, but ‘my group 2’ will NOT be the currently set group, it will still be ‘my group 1’. This has 2 effects, first ‘my group 1’ will still be the group which context mode actively triggers for in game events, secondly, ‘my group 1’ still being set means that when you call the ‘list current group’ command, it will list the contents of ‘my group 1’. So listing a group is for glancing at different groups. “List group <groupname” is the spoken command name, where <groupname> is the name of the group you wish to view i.e “List group my group 1”.
Which takes us nicely on to “List current group” command. This command is the recommended way to view the currently set group. It will always display the contents of the currently set group.
“List active events” is a great command. This command will take a look through all of your groups and will display a list of events from any group which have music assigned to them, so for example if in ‘my group 1’ only ‘combat’ event has a playlist assigned to it, but in ‘my group 6’ ‘exploration’ event has some audio assigned to it “list active events” will display both of those events, but nothing else, all empty event assignments will be excluded, but all groups will be included in the display listing. Great way to get a full view of what is assigned to where without cluttering up the VA log.
Naming your groups:
Finally, for this section we discuss naming groups with your own selected names. This is very quick and easy to do, it does require a tiny bit of command editing in VoiceAttack, but even if you are not so comfortable doing that normally, this is quick and painless. No, really.
The following is demonstrated nicely in the above video if you wish to see it done in more detail, however the steps are:
- Within the VMX profile, locate the category “Context Mode Event List Manager V2” and expand that category to reveal the commands contained within it. Look for the command containing “[Set group; list group] [my group 1;] [my group 2;]” the command also has a Description marking saying “Users may edit group names with this command!”.
- Double click the above command for editing “Edit a Command” dialogue will open.
- You will notice in the command list next to ‘When I say:’ there is a list of default group names. They look mighty familiar 🙂 [my group 1;] [my group 2;] [my group 3;] all the way to [my group 6;].
- You may edit the group name contained within the [ ] square brackets where you see the default my group 1-6 names. DO NOT EVER edit the prefix portion of the command where [Set group; list group] is contained, doing so will break the group name system and you may have to re-import the VMX profile afresh to fix it.
- You must always leave in the semi-colon ; at the end of your event group names, so let’s say I changed [my group 1;] and wanted to call it ‘film music’ then I would change it to [film music;]. The square brackets must always enclose your group name and your group name must always end with ; Note that it doesn’t matter if you leave a space between your group name and the ; or not. [film music ;] and [film music;] are fine.
- Once you have changed the group name(s) to whatever you wish, you need to click OK, followed by Apply to save the changes to the VMX profile. You also need to restart VoiceAttack whenever you make group name adjustments as first load up of VMX is when the group names are read in. Note that you may change all the group names at once if you wish, you don’t need to change one at a time, but you can if you wish.
From now on, whenever you call “List group <group name>” and “Set group <group name>” you will use your custom group name instead. For instance “Set group film music” or “List group film music” would work for my custom name of ‘film music’ as shown above.
That’s it. This is how you navigate between groups, view and name them. The companion article shows you how to assign music to events in different groups, how to do multi assigns, deletion etc. You can find that article here: https://darknebula.cloud/2021/05/22/assigning-user-music-to-events-using-event-group-system-for-vmx-pulsar/