View source for Function: Arco Verb To Action

[[Category:Arco_Functions]]

{{Arco_Function_Infobox
 | name    = Arco Verb To Action
 | class   = [[Arco Game Instance]]
 | path    = /Script/ProjectArco.ArcoGameInstance::ArcoVerbToAction
 | bpnode  = Arco Verb To Action
 | purpose = Converts an '''EArco_PlayerVerb''' value (a player intent) into a corresponding '''EArco_PlayerAction''' value.
 | params  = <code>verb</code> ([[Enum: EArco Player Verb|EArco_PlayerVerb]])
 | returns = [[Enum: EArco Player Action|EArco_PlayerAction]]
}}

= Function: Arco Verb To Action =

''Function: Arco Verb To Action'' is a pure helper function provided by the '''ArcoGameInstance''' class within the Project Arco framework.  
It maps a player '''verb''' (intent-level enum) to a player '''action''' (gameplay-level enum).

This function appears in Blueprints as a pure node named '''Arco Verb To Action'''.

__TOC__

== Overview ==
The Arco Framework separates input or intent concepts ("verbs") from the actual gameplay operations ("actions").  
<code>Arco Verb To Action</code> performs the conversion from:

* [[Enum: EArco Player Verb|EArco_PlayerVerb]] → [[Enum: EArco Player Action|EArco_PlayerAction]]

Since it is marked as a **pure Blueprint function**, it:

* Has no execution pins  
* Produces a value directly  
* Is side-effect free  
* Can be used inline in logic or expressions  

== Script Definition ==
The function is defined in:

<pre>/Script/ProjectArco.ArcoGameInstance::ArcoVerbToAction</pre>

The Blueprint-reflected signature:

* **Target:** <code>Arco Game Instance</code>  
* **Member Name:** <code>ArcoVerbToAction</code>  
* **Pure Function:** Yes ( <code>bDefaultsToPureFunc=True</code> )  

== Parameters ==
{| class="wikitable"
! Parameter !! Type !! Description
|-
| <code>verb</code> || [[Enum: EArco Player Verb|EArco_PlayerVerb]] || The input verb representing high-level player intent. The default enum value shown in Blueprint is <code>BACK</code>.
|}

== Return Value ==
{| class="wikitable"
! Return !! Type !! Description
|-
| <code>ReturnValue</code> || [[Enum: EArco Player Action|EArco_PlayerAction]] || The resulting gameplay action associated with the input verb. The default Blueprint fallback shown is <code>BAD_ACTION</code>.
|}

== Usage in Blueprints ==

This function is typically used in control or logic systems that must translate a user verb or input action into a specific gameplay operation.

Example usage:

<pre>
EArco_PlayerVerb  →  Arco Verb To Action  →  EArco_PlayerAction
</pre>

A typical flow might:

# Obtain a value of [[Enum: EArco Player Verb|EArco_PlayerVerb]] from player input or UI.
# Pass it into <code>Arco Verb To Action</code>.
# Use the resulting [[Enum: EArco Player Action|EArco_PlayerAction]] in a Switch or behavior handler.

Because it is pure, you can drop it inside any expression or decision graph without needing Exec pins.

== Notes ==
* If a verb does not map to a known action, the output may be <code>BAD_ACTION</code>.
* Mapping rules are internal to Project Arco and not exposed directly in the Mod SDK.
* This function centralizes verb-to-action translation logic so downstream code does not need to hardcode mappings.

== Related ==
* [[Arco Game Instance]]
* [[Function: Set New Map Starting Agents]]
* [[Enum: EArco Player Verb]]
* [[Enum: EArco Player Action]]

{{Arco_Functions_Modding}}