trigger_teleport
class hierarchy |
---|
CTriggerTeleport defined in triggers.cpp
|
trigger_teleport
is a brush entity available in all Source games.
It is a trigger that teleports entities that touch its volume. Entities are teleported to the Remote Destination, and have their angles set to that of the Remote Destination's angles. If a Local Destination Landmark is specified, teleported entities are offset from the target by their initial offset from the landmark, and their angles are left alone.
Tip:You can use
env_fade
to smoothen the player's perspective while teleporting (0.6 seconds is a good duration to start with). If you're intending to teleport players in multiplayer, remember to set the triggering player only flag!Contents
Keyvalues
- Remote Destination
(target)
<targetname> - The entity specifying the point to which entities should be teleported. Usually either a info_teleport_destination or info_target.
Note:Any entity can be used as the teleport destination, including players.
Tip:This can be changed if necessary by using
AddOutput
.- Local Destination Landmark
(landmark)
<targetname> - If specified, then teleported entities are offset from the target by their initial offset from the landmark.
Click to enlarge if GIF does not play |
Targetname:
- Name
(targetname)
<string> - The targetname that other entities refer to this entity by.
BaseTrigger:
- Filter Name
(filtername)
<filter> - A filter entity to test potential activators against.
- Start Disabled
(StartDisabled)
<boolean> - Stay dormant until activated (with the
Enable
input).
Flags
BaseTrigger:
- [
4
] : func_pushable
- [
8
] : Physics Objects
- [
16
] : Only player ally NPCs
- [
32
] : Only clients in vehicles
- [
64
] : Everything (not including physics debris)
- [
512
] : Only clients *not* in vehicles
- [
1024
] : Physics debris
- [
2048
] : Only NPCs in vehicles (respects player ally flag)
- [
4096
] : Disallow Bots
Note:Some SDK versions list trigger_teleport flag 32 as "Preserve angles even when a local landmark is not specified" but may actually behave according the newer flags above. To achieve the angle-preserving behavior, you can instead specify !activator for the landmark property.
Inputs
BaseTrigger:
Toggle
- Toggles this trigger between enabled and disabled states.
Enable
- Enable trigger
Disable
- Disable trigger
TouchTest
(in all games since )- Triggers either the OnTouching or OnNotTouching outputs for whether anything is touching this entity.
StartTouch
(in all games since ) !FGD- Behave as if the
!caller
entity had just entered the trigger volume. Accepts non-physical entities.
EndTouch
(in all games since ) !FGD- Behave as if !caller had just exited the trigger volume.
Outputs
BaseTrigger:
OnStartTouch
- Fired when a valid entity starts touching this trigger.
!activator
is whatever touches the trigger.
OnStartTouchAll
- Fired when a valid entity starts touching this trigger, and no other entities are touching it. If there are any other entities touching the trigger when a new one begins to touch, only
OnStartTouch
will fire.
OnEndTouch
- Fired when a valid entity stops touching this trigger.
Warning:This includes entities which are deleted while inside the trigger. In this case !activator will be invalid.
OnEndTouchAll
- Fired when all valid entities stop touching this trigger.
OnTouching
(in all games since )- Fired if something is currently touching this trigger when
TouchTest
is fired.
OnNotTouching
(in all games since )- Fired if nothing is currently touching this trigger when
TouchTest
is fired.