Trigger teleport

实体描述

它是一个可以传送接触它体积的实体(en)的触发器(en)。实体被传送到远程目的地，并将其角度设置为远程目的地的角度。如果指定了本地目标地标，则传送实体与目标之间的偏移量为它们与地标之间的初始偏移量，且它们的角度不受影响。

待完善: This template is currently using deprecated suf or {{Lang}}-based translations. Please use the main {{Code class}} instead, which uses {{Autolang}}.

在源代码中，它由 class CTriggerTeleport 代表，定义于 triggers.cpp。

键值

Remote Destination ([todo internal name (i)]) <targetname(en)>

指定实体应该被传送到哪个点的实体。通常为info_teleport_destination(en)或info_target(en)。

注意：任何实体都可以作为传送目的地，包括玩家。

警告: 传送到一个被杀死的传送目的地实体会使你的客户端/服务器崩溃。

提示:你可以用!self(en)作为地标来使用这个实体的源。

本地目的地地标使用-玩家相对于绿色圆圈的位置（传送时）被转移到目的地。绿色的X表示偏移位置。

TriggerOnce:

Filter Name (filtername) <filter(en)>

要针对激活者进行测试的过滤器实体的名称。

Template:KV BaseEntity:zh-cn EnableDisable/启动禁用:

Start Disabled (StartDisabled) <boolean(en)>

保持休眠状态，直到被唤醒。(利用Enable输入)。

标志

TriggerOnce:

•  [1] : Clients

•  [2] : NPCs

•  [4] : Pushables

•  [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

•  [4096] : Correctly account for object mass (trigger_push used to assume 100Kg) and multiple component physics objects (car, blob...) (存在于自 以来)

注意：在 中，标志4096“Correctly account for object mass”是trigger_push仅有。^[证实]

注意：一些SDK版本将trigger_teleport标志32列为“即使本地地标没有指定，也要保持角度（Preserve angles even when a local landmark is not specified）”，但实际上可能会根据上面的新标志进行操作。要实现角度保持行为，你可以为landmark属性指定!activator(en)。

输入

TriggerOnce:

Toggle

在启用和禁用状态之间切换此触发器。

Base:

AddContext<string(en)>

添加到实体的 Response Contexts/响应上下文列表。格式是<key>:<value>。

AddOutput<string(en)>

在此实体上分配新的键值/输出。对于键值，有些依赖于额外的必要代码来运行，如果它只是通过这个输入改变就行不通。必须遵循严格的格式：

语法:

// 更改键值的格式： "AddOutput [键] [值]"
//// 原始文本：
"OnUser1" "!self,AddOutput,targetname new_name"

// 添加输出的格式： "AddOutput {目标名称}:{输入名称}:{参数}:{延迟}:{最大触发次数，-1 代表无限}"
//// 原始文本：
"OnUser1" "!self,AddOutput,OnUser1:SetParent:!activator:0.0:-1"
// 参数可以留空，但仍应包含空的空白。
//// 原始文本：
"OnUser1" "!self,AddOutput,OnUser1:ClearParent::0.0:-1"

ClearContext

从此实体的列表中删除所有上下文。

ClearParent

从移动层次结构中删除该实体，使其可以自由移动。

FireUser1到FireUser4

触发相应的OnUser输出；详见 User Inputs and Outputs。

Kill

从这个世界中删除此实体。

KillHierarchy

功能类似Kill，尽管此实体与其父实体都被删除了，但比Kill快一点。

RemoveContext

从实体列表删除一个上下文。名字应与现有上下文进行匹配。

SetParent<string(en)>

跟随此实体移动，详见 实体层级（依赖关系)。

SetParentAttachment<string(en)>

更改此实体到其父级上的特定附属点。实体将传送，以至于其骨骼方位与附属匹配。在使用此输入前必须设置好实体的父实体。

SetParentAttachmentMaintainOffset<string(en)>

同上，但没有传送。在接收到输入时，实体保持其相对于附件的位置。

Use 不存在于FGD！

与调用 +use 的玩家相同［玩家按 +use（使用，默认E按钮)]；大多数情况下没有影响。

DispatchResponse<string(en)> 不存在于FGD！

向实体发送一个上下文。 详见 Response 和 Concept.

DispatchEffect<string(en)> (自从 被移除) 不存在于FGD！

在实体的原点坐标设置一个特定效果；参见 List of Client Effects。自从 求生之路后由粒子系统取代。

RunScriptFile<script(en)> (存在于自 以来)

从硬盘执行一个 VScript 脚本文件，不带文件后缀名。会合并接收实体的脚本域。

RunScriptCode<string(en)> (存在于自 以来)

在接收输入的实体范围内执行一串 VScript 源代码。通过控制台触发时可能需要字符串引用。

错误:在 Hammer 中，使用带有字符串的参数会破坏 VMF 文件的结构，使下一个 Hammer 会话无法查看该文件。  [todo tested in?]

修复:使用文本编辑器手动删除带有字符串的参数。

CallScriptFunction<string(en)> (存在于自 以来) 不存在于FGD！

在接受实体脚本域上执行一段 VScript 函数。

SetLocalOrigin<coordinates(en)> (存在于自 以来) 不存在于FGD！

将此实体设置到地图中的某个位置。如果此实体是某实体父级，那么它的子级也会随着移动。

SetLocalAngles<angles(en)> (存在于自 以来) 不存在于FGD！

设置该实体的角度。

EnableDisable/启动禁用:

Enable

Disable

启动/禁用此实体所具备的效果。同样会使实体消失。

输出

TriggerOnce:

OnStartTouch

当实体开始接触此触发器时触发。触碰的实体必须通过此触发器的过滤器才能触发此输出。（!activator是toucher）

OnTrigger

当实体在此触发器的体积中时，会延迟重复触发。延迟由 Delay Before Reset 键值定义。

拓展阅读

• Teleporters(en)
• point_teleport(en)
• info_teleport_destination(en)
• trigger_teleport_relative(en)