game_counter

Modified

12-Jul-2023

This is a logic entity which will trigger its target after being triggered a specified amount of times. Toggle-trigger and on-trigger will cause it to count up by 1. Off-trigger will cause it to count down by 1. An equivalent of this entity can be created through the usage of trigger_condition and trigger_changevalue.

Keyvalues

OnDestroy Function ondestroyfn : Name of the function to use from already parsed .as script files when entity is destroyed (killed) in any way. If the function belongs to namespace, you must use prefix with the namespace name (e.g. mynamespace::MyFunction) for the keyvalue.

Name targetname : Set name of game_counter so other entities can trigger it to increase or decrease counter. Depending on trigger use-type: 'On' or 'Toggle'- increase counter by one, 'Off'- decrease counter by one. Can be kill-targeted.

Target target : Entity to trigger when counter hits it's limit value, or goes above this limit when 'Fire if over limit' flag is selected. Trigger use-type is 'Toggle'.

Delay Before Trigger delay : Delay before trigger entity specified in "Target".

Kill Target killtarget : Entity to remove when counter hits it's limit value.

Master master : Name of the multisource entity that (temporary) locks this game_counter. If master is specified the game_counter will be disabled and it will not count up/down when triggered. When multisource entity is triggered/being triggering by all possible inputs, the game_counter will be unlocked. When multisource lost at least one input signal, the entities becomes locked again.

Initial Value frags : Starting value of entity. It's also current value when accessing it through other entities like trigger_copyvalue.

Limit Value health : Required value to trigger target.

Flags

  • 1 : Remove On fire : Remove entity after firing.

  • 2 : Reset On fire : Reset entity Initial value after triggered.

  • 4 : Fire if over limit : Trigger a target when initial value is higher than limit value.

When target is set to ambient_generic, the game_counter need to receive twice more inputs than normal, unless "Fire if over limit" spawnflag is selected.