Party Component
ACFPartyComponent
ACFPartyComponent manages the player's party in ACF J. It spawns all party characters at game start, splits them between an Active list (characters who fight in battle) and a Reserve list (benched characters), and handles appearance and equipment transfer to the overworld pawn. Add it to your PlayerController Blueprint.
Party config (ACF | Party)
MaxParty— maximum number of active characters (default 3). Characters beyond the cap are automatically moved to Reserve.
Preset (ACF | Party | Preset)
DefaultPartyConfig— one entry per character to spawn. Each entry has three fields:AIClassBP(the Character Blueprint class),AILevel(starting level), andAIConfig(optionalACFCharacterDataAssetfor stats and appearance). The firstMaxPartyentries become Active; the rest go to Reserve.PresetSpawnTransform— world location where characters are initially spawned. The Battle Zone repositions them at combat start, so any out-of-the-way location works.bApplyPresetOnBeginPlay(default true) — spawns the party automatically at game start.bHideSpawnedOnPreset(default true) — characters start hidden and frozen until the Battle Zone places them.bApplyFirstMemberAppearanceOnLoad— if enabled, the overworld pawn automatically takes the appearance of the first active party member right after loading.
Preview Stage (ACF | Party | Preview)
PreviewCharactersSphereClass— assign anACFCharacterPreviewStageBlueprint to enable in-menu character previews (inventory, stats, equipment). Leave empty if not needed.SphereRadius— radius of the preview sphere (default 50).PreviewCharacterSpacingMultiplier— spacing multiplier between characters on the sphere.
Waiting for the party to load
Characters are loaded asynchronously. Do not access party members immediately in BeginPlay.
IsPartyReady(bRequirePreviewStage)— returns true only when all characters are loaded and valid. Call this before opening any party-related widget. PassbRequirePreviewStage = falseif the widget does not depend on the preview stage.OnPartyChanged— alternatively, bind to this event; it fires as soon as loading is complete.
Blueprint-callable functions
GetActiveParty— returns the current active character array.GetReserve— returns the reserve character array.IsPartyMember(Character)— returns true if the character is in the active list (not reserve).MoveToParty(Character)— moves a character from Reserve to Active. Returns false if the party is already full.MoveToReserve(Character)— moves a character from Active to Reserve.SetPartyVisibility(bool)— shows or hides all characters at once. Called automatically by the Battle Manager; rarely needed manually.ApplyPreset— re-spawns the full party fromDefaultPartyConfig. Use after loading a save or to reset the roster.ApplyPartyMemberAppearanceToPossessedPawn(Character)— copies the skeletal mesh, materials, and equipped items of a party member onto the currently possessed overworld pawn. The pawn keeps its own AnimBP so player controls are unaffected.CycleThroughPartyMembers(bActivePartyOnly)— steps to the next party member in a circular list and applies their appearance to the possessed pawn. Passfalseto include reserve members in the cycle. Bind to an input event to implement a character selection screen.MoveCharactersToPreviewSphere— refreshes party member positions on the preview stage after any roster change.
Events
OnPartyChanged(Active[], Reserve[])— fires whenever the Active or Reserve list changes. Bind party HUD and character selection widgets here.OnReserveChanged(Reserve[])— fires only when the Reserve list changes. Use for UI elements that track the bench independently.