Function: Calc Array Characteristics With Guild And Trait Mods

Arco Function

Name	Calc Array Characteristics With Guild And Trait Mods
Class	Arco Game Instance
Script Path	/Script/ProjectArco.ArcoGameInstance::CalcArrayCharacteristicsWithGuildAndTraitMods
Blueprint Node	Calc Array Characteristics With Guild And Trait Mods
Purpose	Takes an array of base Struct: Agent Characteristics and returns a new array with guild and trait modifiers applied.
Parameters	Context (Object), characteristics (Array<Struct: Agent Characteristics>, const ref)
Returns	Array<Struct: Agent Characteristics>

Function: Calc Array Characteristics With Guild And Trait Mods

Function: Calc Array Characteristics With Guild And Trait Mods is a helper function on the ArcoGameInstance class within the Project Arco framework. It takes an array of base Struct: Agent Characteristics and produces a new array where guild and trait modifiers have been applied to the agents’ stats.

In Blueprints, this appears as an impure function node named Calc Array Characteristics With Guild And Trait Mods with Exec pins, a Context input, a const reference array input, and an array output.

Overview

This function is used when you have a set of base agent definitions and want to calculate their final characteristics after:

• Traits (from the traits field in Struct: Agent Characteristics)
• Guild-related progress / targets
• Other internal Arco modifiers

have been taken into account.

Rather than modifying the original array in place, the function:

• Reads from a const reference array (characteristics)
• Returns a separate array (ReturnValue) containing the calculated / modified characteristics

This makes it safe to reuse the base data while also working with fully processed values.

Script Definition

The function is defined in:

/Script/ProjectArco.ArcoGameInstance::CalcArrayCharacteristicsWithGuildAndTraitMods

Blueprint-reflected signature (from the node dump):

• **Target:** Arco Game Instance
• **Member Name:** CalcArrayCharacteristicsWithGuildAndTraitMods
• **Impure function:** Yes (has execute / then pins)

Parameters

Pin / Parameter	Type	Description
Context	Object Reference	Generic context UObject. In typical usage this can be set to Self (the calling Blueprint), or another valid object associated with the current world.
characteristics	Array<Struct: Agent Characteristics> (const ref)	Input array of base agent characteristics. Passed by const reference; the original array is not modified by the function. Used as the source data for calculating final, modified characteristics.

The self / Target pin is automatically bound to Default__ArcoGameInstance and normally does not need to be changed.

Return Value

Return	Type	Description
ReturnValue	Array<Struct: Agent Characteristics>	New array of agent characteristics with guild and trait modifiers applied. This is the array you should use for further logic, display, or spawning.

Usage in Blueprints

A typical pattern for using this function:

1. Build or retrieve an array of Struct: Agent Characteristics representing base agents.
2. Call Calc Array Characteristics With Guild And Trait Mods:
   • Context → connect Self (or another valid context object).
   • characteristics → connect your base array.
3. Use the ReturnValue array as the processed, “final” characteristics.

Conceptual flow:

BaseCharacteristics (Array<AgentCharacteristics>)
    ↓
Calc Array Characteristics With Guild And Trait Mods
    ↓
ModifiedCharacteristics (Array<AgentCharacteristics>)

You can then:

• Feed ModifiedCharacteristics into spawning functions
• Use it for UI previews of final stats
• Log or debug how traits and guilds impact productivity, speed, expectations, etc.

Notes

• The input characteristics array is marked as **const reference**, implying that the function reads but does not mutate the original array.
• The returned array is a separate collection which may reflect:
  • Trait deviations/bonuses
  • Guild progress or target effects
  • Other internal Project Arco modifiers
• Exact numeric formulas are internal to Project Arco and not exposed in the Mod SDK, but this function provides a safe, high-level way to obtain “fully processed” agent stats.

Related

• Struct: Agent Characteristics
• Function: Set New Map Starting Agents
• Function: Arco Verb To Action
• Arco Game Instance

Arco Functions

Function
Function: Set New Map Starting Agents