by Kaylakaze
--------------------------
I've completed a drop-in set of 1 token and a campaign macro file to import. When you first add the Control Unit to a map, make sure you activate the "onCampaignLoad" macro on it. To put it simply, select the units you want to make a group and then hit the "Create Group" campaign macro. The group will be created with the formatin facing left ie: if you're in a rentangular formation, the first rank will be to the left, and the final rank will be the one on the right. Once a group is made, any unit can be used to move and rotate the group. Simply move the token where you want it to be and rotate it how you want, then hit the "Fall In" campaign macro. Make sure snap to grid is turned off or they won't form up properly (probably). Units with state "Dead" will be left behind, but will still be part of the group. They won't move with the group so you can move them wherever you wish. If they become no longer dead, they will rejoin the group in their previous location. To remove units from a group, select them and hit the "Remove Unit From Group" campaign macro. This will remove the unit from the formation, however a hole will be left where it was (no real way to fix that). Groups persist on campaign reload. The "Disband Group" macro will ungroup all the units in a selected unit's group.
Variables required for use:
The Control Unit uses Strength and Constitution to store sine and cosine tables.
Grouped units use Elevation to store their unit serial number and Description to store the list of group members.
Using serial numbers is a lot slower than using token IDs, but token IDs don't persist. The serial number is made up of 7 1d1000 rolls, so the chances of having a duplicate are extremely low. But, if it happens, just remove one unit from it's group and regroup them. This will create a new serial number.
Any formation positioning issues are likely to be caused by snap to grid, either with it left on after grouping, or tokens not reporting their proper position due to it during group creation.
We did have an issue during testing where certain units weren't reporting their facing to MapTool. We have no idea why. This was a MT issue (as the setFacing and getFacing commands just plain didn't work) and not an issue with the grouping but caused grouping to not work completely correctly. If it comes up that way for you, try using a different unit in the group to move the group. Other than that, I don't know what to tell you.
This is GREAT for playing Warhammer Fantasy. If you do play WH, invite me to watch
EDIT: Oh, I forgot to mention. If you add a "Fall In" speech variable to a unit, when that unit is used to make the group move, there's a 1:4 chance that it'll "say" that speech text. Obviously, you can change this chance pretty easily if you want it to be more or less frequent.
Changelog:
v1.12: - added error checking so that if a token in a group no longer exists (for whatever reason), the group commands still work.
v1.11: - fixed bug from having left defunct code in the token's macro
v1.1: - No more brackets, just select units for creating group
- Added Disband Group functionality
- Added Readme File
v1.0: - Initial release
