Multi-Subject on GS_Play Gameplay Framework

Group Targets

Mon, 01 Jan 0001 00:00:00 +0000

A Group Target is an entity whose world transform is the weighted centroid of a runtime-editable subject set. Phantom Cameras with CamTargetMode::GroupTarget point at it like any other target. The Cam Manager hosts a global name → entity registry so stages can resolve a group entity by string name without holding a direct reference.

Typical use cases:

Two-player co-op — a group target tracks both players; the cam follows the group target.
“Move when group is contained” cinematic cams — frame all subjects, ignore individual wandering.
Combat encounters with multiple participants — track the weighted centroid of all combatants.
Collapse-to-single-view in multi-channel projects — pair with a shared TrueUnique cam to detect when all channels converge.

Group Target Configurations

Mon, 01 Jan 0001 00:00:00 +0000

A Group Target is an entity whose world transform is the weighted centroid of a runtime-editable subject list. You point a camera at it like any other target, and the cam frames “where the group is” rather than chasing any single subject.

For the concept, centroid modes, subject-management API, and pitfalls, see The Basics: Group Targets. For the full per-field reference and the registry bus, see Group Targets (Framework API).

Recipe: Two-Player Party Cam
Recipe: Combat Encounter Frame
Recipe: Collapse to Single View
See Also

Recipe: Two-Player Party Cam

A single cam that frames both players, sliding smoothly as they spread apart and converge.

Group Targets

Mon, 01 Jan 0001 00:00:00 +0000

A Group Target is an entity whose world transform is the weighted centroid of a runtime-editable subject list. You point a camera at it like any other target, and the cam frames “where the group is” rather than chasing any single subject. The Cam Manager hosts a name-based registry so cameras can reference a group by string name without holding a direct entity reference.

For step-by-step composition recipes (two-player party cam, combat encounter frame, collapse to single view), see the recipes collection.

Multi-Subject on GS_Play Gameplay Framework

Group Targets

Group Target Configurations

Contents

Recipe: Two-Player Party Cam

Group Targets