env_instructor_hint

env_instructor_hint是一个点实体(en)，可在所有的 起源 游戏，自从 求生之路2 以来中使用。 (也存在于 之中)

env_instructor_hint
类型	点实体
引擎	起源
可用性	求生之路2

用于指示/提示玩家做一些事情，例如不要攻击队友！

一个传送门2的例子。

例：绑定按键提示图标，Bound Command 为"jump" (没引号) 并且 Caption设置为 "Bet you can't jump over me!" (没引号).

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

图标

图标名称	图标	图标名称	图标
icon_tip		icon_interact
icon_info		icon_button
icon_shield		icon_door
icon_alert		icon_arrow_plain
icon_alert_red		icon_arrow_plain_white_dn
icon_tip (again)		icon_arrow_plain_white_up
icon_skull		icon_arrow_up
icon_no		icon_arrow_right

注意：该实体并不限于上面列出的图标, 参见 scripts/mod_textures.txt 定义于 pak01_dir.vpk文件夹，查看更多支持图标。

键值

Target Entity (hint_target) <目标实体名称(en)>

显示此实体提示的目标实体。 此实体必须是在客户端上复制的实体否则提示永远不会显示。实体info_target_instructor_hint 是专门用于解决此问题的，允许放在空处或者绑定到其他实体上，以至于在此实体的方位上显示提示。

注意：如果一个info_target实体被使用， 必须检查标签always transmit to the client是否被勾选。

Positioning (hint_static) <choices>

要么将提示显示在Target Entity位置, 要么显示在HUD(en) 位置（玩家屏幕上）：

• 0: Follow the Target Entity./显示在 Target Entity
• 1: Show on the HUD/显示在HUD上.

Allow invisible target (hint_allow_nodraw_target) <choices>

是否允许提示跟随设置了nodraw的实体？

证实:EF_NODRAW?

（非nodraw贴图指的是一种效果属性，可以阻止服务器向客户端传递此实体的任何数据，但不会删除此实体，也就代表客户端无法接受此实体的信息）

• 0: End immediately on nodraw/当目标实体被nodraw则不跟随
• 1: Yes/跟随

Caption (hint_caption) <字符串(en)>

提示的文本，最多100个字符。不支持中文。如果您需要中文，需要通过vscript脚本实现，请看下方的中文支持条目。

Caption Color (hint_color) <color255(en)>

提示文本的颜色。

Activator Caption (hint_activator_caption) <color255(en)> (存在于自 以来)

提示文本的颜色，由!activator看见的。（在异形从群之后的游戏。）

Force caption (hint_forcecaption) <choices>

被墙体盖住是否还显示提示？（是否可以无视墙体显示提示？）

• 0: No/不显示
• 1: Show when occluded/无视墙体显示

Onscreen Icon (hint_icon_onscreen) <choices>

提示的图标。

Offscreen Icon (hint_icon_offscreen) <choices>

玩家视野之外采用的图标。

Show offscreen (hint_nooffscreen) <choices>

当图标在视野之外，是否还显示图标和箭头？

• 0: Show/显示
• 1: Don't show/不显示

Bound Command (hint_binding) <字符串(en)>

如果使用了 show key bindings 设置，那么Onscreen Icon or Offscreen Icon, 则显示你想要显示的按键图标， 参见key_listboundkeys 查看支持的按键。

Icon Height Offset (hint_icon_offset) <浮点型(en)>

以Target Entity'坐标为原点，设置高度偏移的值，那么提示会显示在坐标点+偏移的高度位置。

Size Pulsing (hint_pulseoption) <choices>

图标效果，图标收缩的速度。

• 0: No Pulse/无
• 1: Slow Pulse/缓慢
• 2: Fast Pulse/快速
• 3: Urgent Pulse/非常快，紧急！

Alpha Pulsing (hint_alphaoption) <choices>

图标会变透明和可见的速度。

• 0: No Pulse/无
• 1: Slow Pulse/缓慢
• 2: Fast Pulse/快速
• 3: Urgent Pulse/非常快，紧急！

Shaking (hint_shakeoption) <choices>

图标会抖动。

• 0: No Shaking/不抖动
• 1: Narrow Shake/较窄的抖动
• 2: Wide Shake/较宽的抖动

Timeout (hint_timeout) <整数型(en)>

提示持续时间/秒，如果为0则代表无限，需要通过EndHint输入来关闭提示。

Display Range (hint_range) <浮点型(en)>

图标显示范围，0代表任何地方都显示。

Show on First Sight (hint_auto_start) <布尔型(en)>

当玩家的LOS(en)（视线）第一次看见时，会自动显示给所有人。 (仅存在于 之中)

Lesson Name (hint_name) <字符串(en)>

Hints with the same lesson name use a common base and are treated as instances the same lesson type. (仅存在于 之中)

Display Limit (hint_display_limit) <整数型(en)>

可以看到提示的次数。0代表无限次。 (仅存在于 之中)

Instance Type (hint_instance_type) <choices>

How many instances of a single lesson type can be open or active at the same time. (仅存在于 之中)

• 0: Multiple
• 1: Single Open (Prevents new hints from opening.)
• 2: Fixed Replace (Ends other hints when a new one is shown.)
• 3: Single Active (Hides other hints when a new one is shown.)

Suppress rest before moving (hint_suppress_rest) <choices>

关闭图标？ (仅存在于 之中).

• 0: No/没有
• 1: Yes/是

Only Local Player (hint_local_player_only) <布尔型(en)> (存在于自 以来)

只显示给第一个加入服务器或者创建服务器的玩家。（异形从群之后的游戏。）

注意：不存在于hammer属性键值，但确实有。请手动添加，并且0代表no，1代表yes。

Gamepad Bound Command (hint_gamepad_binding) <字符串(en)> (存在于自 以来)

If using the show key bindings setting for the Onscreen Icon or Offscreen Icon, this field should be the command we want to show bindings for, when the user is using a console/non-keyboard controller of some kind (or PS3/X360).

Base:

Name (targetname) <string(en)>

其他实体用来指代该实体的名称。

Parent (parentname) <targetname(en)>

实体的父级实体，该实体可以与父实体保持移动偏移。名称后面可以添加一个附属点，以逗号隔开。 （parentname [targetname],[attachment]）

提示:转换至下一张地图的实体关系会依然存在。

提示:一些不适合做父实体的实体可能难以运行，利用phys_constraint可以解决。

Origin (X Y Z) (origin) <coordinates(en)>

实体处于世界中的位置，旋转实体会以实体坐标原点旋转。

注意：Hammer 不会仅在编辑器中相应地移动实体。

Pitch Yaw Roll (Y Z X) (angles) <angle(en)>

实体在世界中的方位，Pitch围绕X轴旋转，可以称为俯仰角。Yaw围绕Z轴旋转，可以称为偏航角，roll围绕Y轴旋转。

注意：尽管 Hammer 不显示新角度，但其仍然适用于固实体。

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

确定实体之前它生成的特征。

提示:使用AddOutput输入更改 Classname 仍然会影响游戏的代码，例如使类名与 S_PreserveEnts 列表中的一个元素匹配将使实体在新一轮中持续存在！

Spawnflags (spawnflags) <flags(en)> 不存在于FGD！

实体所具有的标志/标签，依实体所具有而定。

Effects (effects) <flags(en)> 不存在于FGD！

要使用的效果标志的组合。

Entity Scripts (vscripts) <scriptlist(en)> (存在于自 以来) (也存在于 之中)

在所有实体生成后执行的 VScript 文件（无文件扩展名）的空格分隔列表。这些脚本都在同一个脚本范围内执行，以后的脚本会覆盖任何相同的变量和函数。在 worldspawn 实体上执行的脚本将放置在根作用域中。

Think function (thinkfunction) <string(en)> (存在于自 以来) (也存在于 之中)

此实体脚本中的函数名称，该函数将在脚本持续时间内每 100 毫秒（每秒 10 次）自动调用一次。它可用于创建计时器或模拟自主行为。返回值（如果存在）将设置下一次调用之前的时间。尽量避免在此函数中进行昂贵的操作，因为它可能会导致性能问题。

Lag Compensation (LagCompensate) <boolean(en)> (存在于自 以来) 不存在于FGD！

设置为是以延迟补偿此实体。应该非常谨慎地使用！

Is Automatic-Aim Target (is_autoaim_target) <boolean(en)> (存在于自 以来) 不存在于FGD！

如果设置为 1，当实体位于十字准线下方时，该实体将减慢控制台和操纵杆控制器的瞄准移动速度。

输入

ShowHint <targetname(en)>

开始显示提示. 如果参数填写了一个实体的名称，则只向此实体显示提示。

错误:在 中,此输出仅对!activator可见。  [todo tested in?]

注意：In ,无法同时显示多个提示.

EndHint

停止显示提示。

CBaseEntity:

AddContext <string(en)>

将此实体添加到响应上下文列表中。参见 上下文。

AddOutput(en) <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 to FireUser4

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

Kill

从世界中移除此实体及任何附属于它的实体。

KillHierarchy

功能与Kill相同，但此实体和任何附属于它的实体在同一帧内被击杀，比Kill输入稍快。

RemoveContext <string(en)>

从此实体的列表中移除一个上下文。名称应与现有上下文的键匹配。

SetParent <string(en)>

与此实体一起移动。参见 Entity Hierarchy (parenting)。

SetParentAttachment <string(en)>

将此实体更改为附加到其父级上的特定attachment点。实体将被传送，以便其根bone的位置与附件的位置匹配。实体必须在发送此输入之前被附加。

SetParentAttachmentMaintainOffset <string(en)>

如上所述，但不进行传送。实体保留相对于附件的当前位置。

Use  不存在于FGD！

与玩家调用+use相同；在大多数情况下没有效果。

SetTeam <integer(en)> 不存在于FGD！

更改此实体的团队。

TeamNum <integer(en)> 不存在于FGD！

此输入更改TeamNum属性的值。

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

向实体分发响应。参见 Response 和 Concept。

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

从实体的原点分发特殊效果；另见 List of Client Effects。自以来被particle系统取代。

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

从磁盘执行VScript文件，无需文件扩展名。脚本内容与接收实体的脚本作用域合并。

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

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

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

调用在接收实体的作用域中定义的VScript函数。

TerminateScriptScope  (仅存在于 之中) 不存在于FGD！

销毁接收实体的脚本作用域。

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

将此实体发送到地图中的某个位置。如果实体附属于某个东西，它将相对于父级偏移此量。

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

设置此实体的角度。

输出

基础:

OnUser1 to OnUser4

这些输出分别在相应编号的 FireUser1 到 FireUser4 输入触发时触发；参见 用户输入和输出(en)。

中文支持

百度网盘：https://pan.baidu.com/s/1q8ndRsErtm_fy0bIFZFo4g 提取码: hcit，大小：10.3KB

参见

• L4D2 Level Design/Instructor Hints(en)