Automating Encounter Prep with Mods

This video shows how to spawn monsters onto the map and automatically create an encounter in Encounter Helper. Note that a Pro account is required in order to do this.

💥My Patreon:   / nickolivo  
🎲My Upcoming Games: https://www.startplaying.games/gm/nic...
📗My Books: https://us.amazon.com/stores/Nicholas...

Get 5% off VoiceMod voicechanger (https://link.xsolla.com/vhF53pwM) with code NICKOLIVO5

The macro from the video
!{{
!Spawn --name|?{Which Monster|Goblin|Orc|Werewolf} --qty|?{How Many} --placement|surround --tokenName|?{Encounter Name}
(^)!eh add ?{Encounter Name} {^&select ?{Encounter Name}*}{^&delay .3}
(^)!forselected token-mod --set name|?{Which Monster|Goblin|Orc|Werewolf} {^& select ?{Encounter Name}*}
}}

Documentation re: Spawn Default Token https://app.roll20.net/forum/post/964... (Refer to the Caveats/Known Issues section for information about images)

Note, if you're getting an error message to the effect of "cannot read the properties of undefined (reading 'who') ", then run this command: !smconfig +who +playerid

Several people have asked about using these mods with the TokenNameNumber mod - the amazing Timmaugh has provided this answer:
You can add the %%NUMBERED%% syntax to the name, then run a TokenNameNumber command line as another batched line within the ZeroFrame batch... however there is another option. The forselected handle actually produces individualized results for each token it iterates over, and it offers you another syntax token to represent the index of the token for this run of iterated tokens:
{&i}

If you have three tokens you are iterating over, the first would see that {&i} tag resolve to 0, the second would resolve to 1, and the third to 2. In fact, the tag takes simple offsets, so you could have a lower bound of 1 (instead of 0) simply by adding 1 to the tag:
{&i+1}

So when you are renaming the tokens with TokenMod, just include that tag to have them already numbered as you wish:
(^)!forselected token-mod --set name|?{Which Monster|Goblin|Orc|Werewolf}{&i+1} {^&select ?{Encounter Name}*}

(Remember if you include a space in the name you will need to enclose the name in quotation marks so TokenMod recognizes all of it as part of the name.)

If you were going to use a simple offset like this, you will end up with duplicate numbers between one Spawned encounter and the next (each starting at 1), so perhaps you would want to include a "squad" component of the name just to be able to differentiate them (perhaps breaking the Encounter name into 2 queries and using one as a squad identifier). This is what Nick was trying to avoid though, going through the process of renaming the tokens, so to keep with Nick's aesthetic of keeping a cleaner Turn Order, you could put a simple query for the offset into the {&i} tag. The idea is you would simply supply the number of creatures-of-the-chosen-type you had already added to the map:
{&i + ?{How many already exist?|0}}

So if you Spawn 3 Orcs... the first time you would say 0, and you'd get Orc0, Orc1, and Orc2. Then next time you Spawn 4 Orcs, you'd answer that there were 3 Orcs already on the map, and you would get Orc3, Orc4, Orc5, and Orc6. The next time you'd answer that there were 7 Orcs, etc.