Components/Locomotion/Formation.md

@@ -2,7 +2,9 @@ On this site, you get more insight on how to set up agent formations in combinat
 
 ## Setting up Formations
 
-In the Details panel of a VH select the *VHMovement* component. Under the header *Group Movement* you can see three parameters:
+In order to set up a formation you need a couple of VH in the scene that shall walk together in formation. You only need to set up one VH that will be the parent of the group.
+
+In the Details panel of the parent VH select the *VHMovement* component. Under the header *Group Movement* you can see three parameters:
 
 | Name | Details |
 |------|---------|
@@ -10,13 +12,20 @@ In the Details panel of a VH select the *VHMovement* component. Under the header
 | Group Formation | Currently only 2 formations are supported. Walking in line and abreast |
 | Draw Debug Spheres | toggle to show debug spheres|
 
+For every VH that should walk alongside the parent, provide an entry in the *Child VH* Map. As key you provide other VHs that should walk alongside the parent and as value an offset that specifies the distance the child will have from the parent. Depending on the selected formation the offset will change its behavior. E.g. if you select *InLine* a positive offset will be behind the parent and a negative offset will be in front of the parent. If you select *Abreast* a positive offset will be to the left of the parent and a negative to the right.
+
+Don't forget to set up the Waypoint system (selecting a Waypoint Group and order). You only need to set up the parent, as all settings (Waypoint and Group Movement) will be forwarded to the childs (all VHs specified in the *Child VH* Map) when the game starts.
+
 ![groupMovementDetails](uploads/3d4c2f3850df0e6c835a479bad992bcd/groupMovementDetails.jpg)
 
+
+
 -- 
 
 
 Next steps:
 - [ ] arbitrary formations given x- and y-offset
+- [ ] automatically spawn child VHs
 - [ ] automatic changes of formations based on environment-awareness
 - [ ] ...