Available shortcuts
- Last UpdatedSep 03, 2025
- 3 minute read
Shortcuts
This topic discusses special template instancing statements that can be used to invoke Graphic Context behaviors.
Shortcut types
The template description file supports many placeholder tags with different scopes. Some of the tags are used to compose node field attribute values with the instance name, some are used to position the node in the scene, while others are references to project and XR Studio folders.
Syntax
Shortcuts must be enclosed by % (Example: %T_NAME%) and be all upper case.
The only exception is the param attribute of the item_template node.
Available shortcuts
These are the available shortcuts.
|
Tag |
Description |
|---|---|
|
T_NAME |
The occurrences of this tag are replaced by the name assigned to the instance. |
|
T_TEMPLATENAME |
Name of the template. |
|
T_TEMPLATETYPE |
Name of the parent folder of the template. |
|
T_TEMPLATEDIR |
Points to the template directory of XR Studio. |
|
T_PROJECTDIR |
Points to the project directory. |
|
T_USER_MODELS_DIR |
Points to the models directory within the project. |
|
T_USER_TEXTURES_DIR |
Points to the textures directory within the project. |
|
T_USER_MENUTEXTURES_DIR |
Points to the menu texture directory within the project [gamedata\menutextures]. |
|
T_USER_LOGIC_DIR |
Points to the user script logic directory within the project [gamedata\logic\user]. |
|
T_USER_SHADERS_DIR |
Points to the user shaders directory within the project [gamedata\shaders\user]. |
|
T_IN_FRONT_OF_CAMERA_POSITION |
Is equal to a 3D position right in front of the camera at one meter of distance. |
|
T_IN_FRONT_OF_CAMERA_POSITION_2 |
Is equal to a 3D position right in front of the camera at two meters of distance. |
|
T_IN_FRONT_OF_CAMERA_POSITION_3 |
Is equal to a 3D position right in front of the camera at three meters of distance. |
|
T_IN_FRONT_OF_CAMERA_POSITION_4 |
Is equal to a 3D position right in front of the camera at four meters of distance. |
|
T_IN_FRONT_OF_CAMERA_POSITION_5 |
Is equal to a 3D position right in front of the camera at five meters of distance. |
|
T_IN_FRONT_OF_CAMERA_POSITION_SHIFT_X_1 |
Is equal to a 3D position right in front of the camera at one meter of distance and one meter on World X axis. |
|
T_IN_FRONT_OF_CAMERA_POSITION_2_SHIFT_X_1 |
Is equal to a 3D position right in front of the camera at two meters of distance and one meter on World X axis. |
|
T_IN_FRONT_OF_CAMERA_POSITION_SHIFT_Y_1 |
Is equal to a 3D position right in front of the camera at one meter of distance and one meter on World Y axis. |
|
T_IN_FRONT_OF_CAMERA_POSITION_2_SHIFT_Y_1 |
Is equal to a 3D position right in front of the camera at two meters of distance and one meter on World Y axis. |
|
T_IN_FRONT_OF_CAMERA_POSITION_SHIFT_Z_1 |
Is equal to a 3D position right in front of the camera at one meter of distance and one meter on World Z axis. |
|
T_IN_FRONT_OF_CAMERA_POSITION_2_SHIFT_Z_1 |
Is equal to a 3D position right in front of the camera at two meters of distance and one meter on World Z axis. |
|
T_IN_FRONT_OF_CAMERA_ORIENTATION_0 |
Allows rotation alignment to camera orientation. |
|
T_IN_FRONT_OF_CAMERA_ORIENTATION_90 |
Allows rotation alignment to camera orientation with 90 degree yaw offset. |
|
T_IN_FRONT_OF_CAMERA_ORIENTATION_180 |
Allows rotation alignment to camera orientation with 180 degree yaw offset. |
|
T_IN_FRONT_OF_CAMERA_ORIENTATION_270 |
Allows rotation alignment to camera orientation with 180 degree yaw offset. |
|
T_IN_FRONT_OF_CAMERA_ROTATION |
Allows rotation alignment to camera rotation. |
|
T_IN_FRONT_OF_CAMERA_ROTATION_X_90 |
Allows rotation alignment to camera rotation adding a 90 degrees rotation around local X axis. |
|
T_IN_FRONT_OF_CAMERA_ROTATION_X_180 |
Allows rotation alignment to camera rotation adding a 180 degrees rotation around local X axis. |
|
T_IN_FRONT_OF_CAMERA_ROTATION_X_270 |
Allows rotation alignment to camera rotation adding a 270 degrees rotation around local X axis. |
|
T_IN_FRONT_OF_CAMERA_ROTATION_Y_90 |
Allows rotation alignment to camera rotation adding a 90 degrees rotation around local Y axis. |
|
T_IN_FRONT_OF_CAMERA_ROTATION_Y_180 |
Allows rotation alignment to camera rotation adding a 180 degrees rotation around local Y axis. |
|
T_IN_FRONT_OF_CAMERA_ROTATION_Y_270 |
Allows rotation alignment to camera rotation adding a 270 degrees rotation around local Y axis. |
|
T_IN_FRONT_OF_CAMERA_ROTATION_Z_90 |
Allows rotation alignment to camera rotation adding a 90 degrees rotation around local Z axis. |
|
T_IN_FRONT_OF_CAMERA_ROTATION_Z_180 |
Allows rotation alignment to camera rotation adding a 180 degrees rotation around local Z axis. |
|
T_IN_FRONT_OF_CAMERA_ROTATION_Z_270 |
Allows rotation alignment to camera rotation adding a 270 degrees rotation around local Z axis. |
|
T_CAMERA_POSITION |
Position of the camera. |
|
T_CAMERA_TARGET |
Position of camera target. |
|
T_CAMERA_NEAR |
Value of camera Near. |
|
T_CAMERA_FAR |
Value of camera Far. |
|
T_CAMERA_FOV |
Value of camera Fov. |
|
T_PX_SCENE |
Name of the Graphic Context PhysX scene. This is used when instancing particle systems. |
|
T_ZERO_POSITION |
Is equal to a 3D position in "0 0 0" |
Offset
Shortcuts related to a 3D position can have an offset applied.
To do so, follow the shortcut by |, followed by WORLD or CAMERA depending on the chosen reference system, followed by | and then a vector3 representing the value of the offset and all enclosed by %.
For example: %T_IN_FRONT_OF_CAMERA_POSITION|CAMERA|0 0 1.5% will have the value of %T_IN_FRONT_OF_CAMERA_POSITION% with an offset in camera coordinates of 0 0 1.5.