Function: Calc Characteristics With Guild And Trait Mods

Arco Function

Name	Calc Characteristics With Guild And Trait Mods
Class	Arco Game Instance
Script Path	/Script/ProjectArco.ArcoGameInstance::CalcCharacteristicsWithGuildAndTraitMods
Blueprint Node	Calc Characteristics With Guild And Trait Mods
Purpose	Takes a single Struct: Agent Characteristics value and returns a new copy with guild and trait modifiers applied.
Parameters	Context (Object), characteristics (Struct: Agent Characteristics, const ref)
Returns	Struct: Agent Characteristics

Function: Calc Characteristics With Guild And Trait Mods

Function: Calc Characteristics With Guild And Trait Mods is a helper function on the ArcoGameInstance class within the Project Arco framework. It takes a single base Struct: Agent Characteristics value and produces a new struct with guild and trait modifiers applied to the agent’s stats.

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

Overview

This function is the single-struct counterpart to Function: Calc Array Characteristics With Guild And Trait Mods.

It is used when you want to:

• Start from a base Struct: Agent Characteristics definition
• Apply internal Arco logic for traits, guilds, and related modifiers
• Receive a new struct representing the final, modified characteristics for that one agent

Because it operates on a single struct rather than an array, it is convenient for:

• Inspecting or previewing one agent’s final stats
• Debugging trait/guild effects on a particular configuration
• Modifying or displaying a single agent’s characteristics without managing arrays

Script Definition

The function is defined in:

/Script/ProjectArco.ArcoGameInstance::CalcCharacteristicsWithGuildAndTraitMods

Blueprint-reflected signature (from the node dump):

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

Parameters

Pin / Parameter	Type	Description
Context	Object Reference	Generic context UObject. In most cases this can be set to Self (the calling Blueprint) or another object associated with the current world.
characteristics	Struct: Agent Characteristics (const ref)	Input base characteristics for a single agent. Passed by const reference and not modified in place; used as the source for calculating the 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	Struct: Agent Characteristics	A new struct representing the agent’s characteristics after guild and trait modifiers have been applied. This is the version you should use for further logic, display, or spawning.

Usage in Blueprints

Typical usage pattern:

1. Create or obtain a base Struct: Agent Characteristics value (for example, from a Data Table or a Make Agent Characteristics node).
2. Call Calc Characteristics With Guild And Trait Mods:
   • Context → connect Self (or another valid context object).
   • characteristics → connect your base characteristics struct.
3. Use the ReturnValue as the processed, final characteristics.

Conceptual flow:

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

You can then:

• Feed ModifiedCharacteristics into spawning logic
• Display the final, modified stats in UI
• Compare base vs. modified values for debugging trait/guild effects

Notes

• The characteristics input is marked as **const reference**, indicating it is used as read-only input.
• This function is ideal when working with a single agent; use Function: Calc Array Characteristics With Guild And Trait Mods when processing many agents at once.
• Internal formulas for applying trait and guild effects are handled by Project Arco and are not exposed directly in the Mod SDK.

Related

• Struct: Agent Characteristics
• Function: Calc Array Characteristics With Guild And Trait Mods
• Function: Set New Map Starting Agents
• Arco Game Instance

Arco Functions

Function
Function: Set New Map Starting Agents