Merge any group of tokens into a single leader token and split them back apart with one click. Perfect for traveling parties, NPC squads, escort missions, or any set of tokens that should move as one.

• Unlimited groups, up to 25 members each
• One-click group / ungroup from the Token HUD
• Animated movement with A* pathfinding (respects walls)
• Save & Load Formations so your party always lines up the way you want
• Scene Transfer — move an entire group to another scene, preserving HP, items, and effects
• Built for Foundry VTT V13+

1. Select 2 or more tokens on the canvas.
2. Right-click any of them and click the Group Tokens icon in the Token HUD (right column).
3. Click Create Group.
4. Pick which token will be the leader — it stays visible when the group is collapsed; every other token hides behind it.

Right-click the leader token → Group Tokens icon → Toggle Group.

• Group (Crunch) — members fly into the leader and disappear.
• Ungroup (Explode) — members reappear around the leader in a spiral pattern.

The module auto-detects the current state, so you only need one button.

After ungrouping, members may be scattered across the map. Right-click the leader → Get Over Here! to call them back. They walk toward the leader using A* pathfinding that respects walls.

Right-click the leader → Get in Position! to spread members into a circle formation around the leader. The radius is configurable in Actions & Sounds settings (default: 30 grid cells).

Once your members are arranged exactly where you want them:

1. Right-click the leader → Save Formation — stores each member's position relative to the leader.
2. Later, right-click the leader → Load Formation — members walk back to their saved spots using the same animated pathfinding as Get Over Here.

The Load Formation button only appears after a formation has been saved. Formations persist across sessions.

• Add: right-click an ungrouped token → Group Tokens icon → Add to Group #N.
• Remove: select one or more tokens → right-click → Group Tokens icon → Remove from Group.

Open the Dashboard from the Token HUD (every context menu has an Open Dashboard button) or from Module Settings → Configure Groups.

From the Dashboard you can:

• Toggle any group (group/ungroup)
• Find a group (select and pan to its tokens)
• Transfer a group to another scene
• Expand a group to see its members
• Promote a member to leader
• Remove individual members
• Clear (delete) a group entirely
• Copy Group ID for use in macros

Groups can be moved between scenes in two ways:

1. Copy / Paste — copy the leader token and paste it into another scene. The module intercepts the action, shows a confirmation dialog, and transfers all members automatically.
2. Dashboard — click the Transfer button next to any group and pick a destination scene.

All token data (HP, items, active effects on unlinked tokens) is fully preserved. Tokens are removed from the origin scene after a successful transfer. Groups arrive in collapsed (crunched) state — ungroup at the destination to spread members out.

Send group members to attack GM-targeted enemy tokens directly from the canvas:

1. With the group ungrouped, target one or more enemy tokens as the GM.
2. Right-click the leader → Group Tokens icon → Kill them All!
3. A slider dialog opens — choose how many members to send (1 to all visible members).
4. Members animate toward the targets using the same pathfinding as Get Over Here.
   • 1 target — all selected members cluster around it.
   • Multiple targets — members are distributed round-robin across each target.

The button only appears when the group is ungrouped and at least one GM target is set.

Open Module Settings → Actions & Sounds to configure:

The module draws small badges and colored borders on group tokens so you can tell at a glance who belongs to which group:

• Leader tokens get a red border and a crown badge.
• Member tokens get a blue border and a pawn badge.

These markers are visible to the GM only and update automatically as tokens are added, removed, or moved.