Cheat Arguments (Blueprint)
Typed inputs your cheat declares in Named Expected Arguments — declaration, per-type fields, and the value-reading nodes.
Cheat arguments are the typed inputs your cheat declares in Named
Expected Arguments. The map key is the argument's name (used to look
it up inside Execute); the value is one of the argument classes
listed below.
Declaring arguments
- Open your
BPCheat_*asset. - In Class Defaults, expand Named Expected Arguments.
- Click + to add an entry. The map key is the argument's name —
this is what you'll look it up by inside
Execute. - For the value, click the dropdown and pick the argument class — one
of:
- Blueprint Cheat Bool Argument
- Blueprint Cheat Int Argument
- Blueprint Cheat Float Argument
- Blueprint Cheat Double Argument
- Blueprint Cheat String Argument
- Blueprint Cheat Enum Argument
- Each entry expands inline. Fill in the per-type fields below.
- Use distinct Position values (
0,1,2…) to control both console parsing order and menu sort order.
Universal fields
These appear on every argument:
| Field | Notes |
|---|---|
| Display Name | Label shown in the menu and used in error text. Falls back to the argument name. |
| Position | 0-based positional index. Drives console parsing order and menu sort order. |
| Optional | When on, parsing succeeds even if the player omits this token (and any later ones). |
Per-type fields
Bool argument
| Field | Notes |
|---|---|
| Default Value | Optional. Applied when the console token is missing. |
Accepted console spellings: true/false, 1/0, yes/no.
Int argument
| Field | Notes |
|---|---|
| Default Value | Optional. |
| Min Value | Optional inclusive lower bound. |
| Max Value | Optional inclusive upper bound. |
When both Min and Max are set, the menu spinner clamps to that range.
Float argument
| Field | Notes |
|---|---|
| Default Value | Optional. |
| Min Value | Optional inclusive lower bound. |
| Max Value | Optional inclusive upper bound. |
Double argument
Same fields as Float, with double precision.
String argument
| Field | Notes |
|---|---|
| Default Value | Optional. |
| Min String Length | Inclusive minimum length. Default 0. |
| Max String Length | Inclusive maximum length. Default 9999. |
Enum argument
| Field | Notes |
|---|---|
| Enum Type | Picks the enum asset this argument represents. Drives parsing and menu drop-down. |
| Default Value | Default enum entry, or None for no default. |
The console accepts either the entry's display name or its raw name. The menu surfaces a drop-down populated with the enum's display names.
Reading values inside Execute
The Execute event hands you a Map<Name, BlueprintCheatArgument>
keyed by the names you set above. Look the entry up with Find, then
convert with the matching getter.
Execute(Controller, CheatArguments, OutcomeMessage)
├─ Find(CheatArguments, "Multiplier") ──► Argument
├─ Get Cheat Argument As Float (Argument) ──► Multiplier (float), bSuccess
└─ Branch on bSuccess
├─ true → use Multiplier, set OutcomeMessage = "OK", Return true
└─ false → set OutcomeMessage = "Multiplier missing", Return falseValue-reading nodes
| Argument type | Node |
|---|---|
| Bool | Get Cheat Argument As Bool |
| Int | Get Cheat Argument As Int |
| Float | Get Cheat Argument As Float |
| Double | Get Cheat Argument As Double |
| String | Get Cheat Argument As String |
| Enum | Get Cheat Argument As Enum (typed K2 node) |
Each returns bSuccess. A false result means the argument was
missing, the type didn't match, or the player skipped an optional
argument. Use that bool to gate your logic and set OutcomeMessage.
For raw enum access there is also Get Cheat Argument As Enum Value,
which returns a generic int32 — but the typed Get Cheat Argument As
Enum node is almost always preferable.
Default-value nodes
When you want to read the configured default rather than the runtime value (useful inside custom argument widgets):
- Get Cheat Argument Default Bool Value
- Get Cheat Argument Default Int Value
- Get Cheat Argument Default Float Value
- Get Cheat Argument Default Double Value
- Get Cheat Argument Default String Value
- Get Cheat Argument Enum Default Value Display Name
Clamp / metadata nodes
| Node | Returns |
|---|---|
| Get Cheat Argument Int Min Max | Min/max for an int argument. |
| Get Cheat Argument Float Min Max | Min/max for a float argument. |
| Get Cheat Argument Double Min Max | Min/max for a double argument. |
| Get Cheat Argument String Length Min Max | Min/max length for a string argument. |
| Get Cheat Argument Enum Display Names | Display names of all the enum options. |
These are what custom argument widgets call from On Expected Argument Set to configure their controls.
Setter nodes
For custom argument widgets that push their edited value back into the argument before the cheat executes:
- Set Cheat Argument Boolean Value
- Set Cheat Argument Int Value
- Set Cheat Argument Float Value
- Set Cheat Argument Double Value
- Set Cheat Argument String Value
The default menu row already calls these via each widget's Commit Value event — only call setters yourself in custom widgets.