Overview
A Game Token is a script object or variable that is used for storing values. These tokens can be used for performing simple logic manipulations, and checking a value in the game scripting language.
Possible token functions include states (squad mate = dead or alive), characters, information (research tool results), sequential logic (an event has taken place, in if/then sequences), or objects (for example, weapons, vehicles).
These are represented within various flow nodes with different functions, inputs, outputs, and checks.
In the database, all the defined values are stored in libraries. By loading or not loading the same library for every level, tokens can be set to be active only within one level, across multiple levels, or only in part of one level.
Toolbar
Game Tokens tab uses the default DataBase View toolbar set. For all the toolbar options and their functionalities, please refer to the DataBase View page.
Creating Tokens
In order to create a new game token, click Add New Item on Game Token Tasks list and give the token a name. After you have created a token, you can choose from the following types: Bool, Int, Float, String, or Vec3.
Depending on the chosen type, the token will get the following values:
Value | Description |
|---|---|
Bool | True or False states. |
Int | Any whole number. |
Float | Any floating point number. |
String | Any sequence of characters. |
Vec3 | Any 3 dimensional positional coordinate (x,y,y) - for example, 290,200,180. |
Don't forget to add a description in the Description field, you may find it come in handy later on when you have many tokens in the library.
Saving Tokens across Levels
There are 2 specific Flow Graph nodes related to the storing of information across levels.
- Mission:GameTokensLevelToLevelStore - Trigger this at the end of the level, and it will save the values specified in the listed game tokens.
- Mission:GameTokensLevelToLevelRestore - Trigger this at the beginning of the next level to retrieve the values from the previous level.
Debugging
To investigate which game tokens are active or being modified during a session, you can enable a few CVars to track the recent changes.
New items get added to the bottom of the list and are colored red. They will fade to white over time & as new ones get added to the bottom of the list.
- gt_Show - 1=screen and log, 2=screen only, 3=log only . Displays a log of the recently changed tokens in the top left (default) of the screen.
- gt_showFilter - In the historic list only shows game tokens that include the filter string.
- gt_showLines - How many lines is used by the historic list.
- gt_showPosX - Defines the starting column in screen for game tokens debug info.
- gt_showPosY - Defines the starting row in screen for game tokens debug info.