Trigger once: Difference between revisions
Jump to navigation
Jump to search
Important:If the trigger_once is enabled while multiple entities that can trigger it are touching it each output will have different outcomes. OnStartTouch will fire for each !activator. Meanwhile OnTrigger will only trigger once.
Note: The refire amount will decide how many times your OnStartTouch will fire.
TroceLleto (talk | contribs) No edit summary |
|||
| (44 intermediate revisions by 27 users not shown) | |||
| Line 1: | Line 1: | ||
{{LanguageBar}} | |||
{{TabsBar}} | |||
{{CD|CTriggerOnce|file1=triggers.cpp}} | |||
{{This is a|brush entity|name=trigger_once}} It is a trigger volume that removes itself after it has been triggered (touched by a qualifying entity) once. A [[trigger]] uses [[outputs]] to activate an [[event]] in another [[entity]]. | |||
{{sensor brush}} | |||
==Keyvalues== | == Keyvalues == | ||
{{KV Targetname}} | |||
{{KV BaseTrigger}} | |||
==Flags== | == Flags == | ||
{{Fl BaseTrigger}} | |||
==Inputs== | == Inputs == | ||
{{I|Toggle|Toggles this trigger between enabled and disabled states.}} | |||
{{I|Enable|Enable trigger}} | |||
{{I|Disable|Disable trigger}} | |||
{{I|StartTouch|Behave as if the {{ent|!caller}} entity had just entered the trigger volume. Accepts non-physical entities.|since={{Src07}}|nofgd=1}} | |||
::{{note|Will trigger OnStartTouch output and the trigger won't be removed.}} | |||
::{{warning|If !caller doesn't exist game will crash}} | |||
==Outputs== | == Outputs == | ||
{{O|OnStartTouch}} | |||
{{O|OnTrigger|activator = entity that touched the trigger|Fired when an entity starts touching this trigger. The touching entity must pass this trigger's filters to cause this output to fire.}} | |||
{{Important|If the [[trigger_once]] is enabled while multiple entities that can trigger it are touching it each output will have different outcomes. OnStartTouch will fire for '''each''' [[!activator]]. Meanwhile OnTrigger will only trigger '''once'''.{{Note| The refire amount will decide how many times your OnStartTouch will fire.}}}} | |||
==See | == See also == | ||
* [[trigger_multiple]] | * [[trigger_multiple]] | ||
* [[Inputs and Outputs]] | * [[Inputs and Outputs]] | ||
[[Category:IO System]] | |||
[[Category: | |||
Latest revision as of 08:22, 23 April 2025
 Class hierarchy
|
|---|
| CTriggerOnce |
| triggers.cpp
|
trigger_once is a brush entity available in all 
Source games. It is a trigger volume that removes itself after it has been triggered (touched by a qualifying entity) once. A trigger uses outputs to activate an event in another entity.
Keyvalues
- Name (targetname) <string>[ Edit ]
- The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g.
parentnameortarget).
Also displayed in Hammer's 2D views and Entity Report.See also: Generic Keyvalues, Inputs and Outputs available to all entities
|
Flags
|
Inputs
- Toggle
- Toggles this trigger between enabled and disabled states.
- Enable
- Enable trigger
- Disable
- Disable trigger
- StartTouch (in all games since
) !FGD - Behave as if the !caller entity had just entered the trigger volume. Accepts non-physical entities.
- Note:Will trigger OnStartTouch output and the trigger won't be removed.
Warning:If !caller doesn't exist game will crash
Outputs
- OnStartTouch
- OnTrigger
- !activator = entity that touched the trigger
!caller = this entity
Fired when an entity starts touching this trigger. The touching entity must pass this trigger's filters to cause this output to fire.
Important:If the trigger_once is enabled while multiple entities that can trigger it are touching it each output will have different outcomes. OnStartTouch will fire for each !activator. Meanwhile OnTrigger will only trigger once.Note: The refire amount will decide how many times your OnStartTouch will fire.