Skip to content

Status Effects

Status Effects are temporary ailments that affect a character.

Most RPG games use the same Status Effects, such as Poison, which drains the character's health for a period of time. However, you can create your own and completely customize the affliction.

Creating a Status Effect

To create a Status Effect asset, right click on the Project panel folder where you want to create it and select Create → Game Creator → Stats → Status Effect.

Status Effects

A Status Effect has an ID which is used to uniquely identify it among all other afflictions. It is very important to keep this value unique across the whole project.

The Type field determines whether this effect is positive, negative or neutral for the targeted character. This is useful when using the instruction Clear Status Effects Type, where you can choose to remove only those that have a negative impact.

Max Stack determines how many of the same Status Effect can be active at a given time on a target.

By default, most Status Effects will have a stack of 1, and adding subsequent effects refresh the duration. When the maximum is reached, adding a new one replaces the oldest. However, it is entirely possible to stack multiple (for example) Poison afflictions, increasing their health drain.

The Is Hidden toggle determines whether the Status Effect is hidden from the Status Effect List UI (unless the list is set to show hidden effects).

The Save toggle determines whether the Status Effect persists after saving and loading back the game. Saving a Status Effect keeps track of the remaining time.

Has Duration allows the Status Effect to run for a certain amount of time (specified in the Duration field, in seconds).

If this field is unticked (the default), the Status Effect will continue until it's manually removed, using the appropriate visual scripting instruction, such as Remove Status Effect.

Status Effects UI section

The UI section allows the user to define any information displayable to the player, such as the name, a description of what the ailment does, its color and even an icon.

Status Effects Start End and While Active sections

Inside the On Start, On End and While Active sections is where the logic of the Status Effect goes and it uses Game Creator's visual scripting tools.

  • On Start: A list of instructions executed as soon as the Status Effect is added onto a target.
  • On End: A list of instructions executed when the Status Effect stops taking effect on a target.
  • While Active: A list of instructions that runs every frame, as long as the Status Effect is active.

Poison

For example, a Poison status effect could start spawning a particle effect onto the targeted character using the On Start instruction list. To damage the player, it would use the While Active instruction list and subtract a bit of the Target's health every few seconds (remember that this list runs every frame, so it should include a wait between each damage tick).

Adding a Status Effect

To add a Status Effect onto a target you can use the visual scripting instruction Add Status Effect.

Add a Status Effect

All that needs to be done is to select the targeted character, which must have a Traits component, and specify the type of Status Effect.