Legacy:Counter

From Unreal Wiki, The Unreal Engine Documentation Site
Jump to navigation Jump to search
UT :: Actor (UT) >> Triggers (UT) >> Counter (Package: Engine)
UT2003 :: Actor >> Triggers (UT2003) >> Counter (Package: Gameplay)

Note: In UT200x, you should use a ScriptedTrigger with ScriptedActions instead.

A counter will need to be triggered n times before it will trigger an event.

Examples of using a counter:

  • several buttons must be pressed before a door opens
  • a monster appears once a player has picked up a particular number of items in a room
  • the secret door in UT's DM-Codex

Because the Counter simply counts how many times it's been triggered, the order in which things trigger it has no relevance – there's no way for the Counter to know. In particular, if the Triggers are set as repeatable, the same Trigger n times will also do it (the door in DM-Codex can be opened by shooting just one light four times).

To avoid this, set Triggers to non-repeatable or with a long delay For something where the order matters, use a CodeMaster system.

Properties

Main

byte NumToCount 
Number to count down from.
bool bShowMessage 
Will show CountMessage.
string CountMessage (localized) 
What message needs to be showed each time its triggered. For example: "Only %i more to go..."
string CompleteMessage (localized) 
What message needs to be showed when the count is completed. For example: "Completed!"

Hidden

byte OriginalNum 
Number to count at startup time.

Functions

BeginPlay() 
Init for play. Sets OriginalNum = NumToCount.
Reset() 
Reset actor to initial state - used when restarting level without reloading. Sets NumToCount = OriginalNum.
Trigger( Actor Other, Pawn EventInstigator ) 
Counter was triggered. If NumToCount is more than zero, decrements NumToCount. If NumToCount is zero, Triggers all matching actors. Else, if bShowMessage, displays ClientMessage of CountMessage and replaces %i with "one", "two", etc. up to "six". (More than that, it will display the string equivalent of NumToCount. i.e., "7".)

Related Topics