Zh/Func instance

func_instance
类型	内部 点实体
引擎	起源
可用性	存在于所有的游戏中

func_instance是一个内部的(en)点实体(en)，可在所有的 起源 游戏中使用。 它将另一个 VMF 文件的实例(en)插入到当前文件中。您可以在不破坏任何内容或创建离网编辑噩梦的情况下平移和旋转实例。(You can translate and rotate the instance without breaking anything or creating an off-grid editing nightmare. )默认情况下，实例在 Hammer 中绘制为橙色，但可以在Instancing > View Instances中禁用此功能。

警告:自递归实例（即包含自身的实例）将使 Hammer 崩溃。

注意:在求生之路2(en)之前的游戏中，实例默认是禁用的（军团要塞 2 除外）。要启用它们，请将GameData键添加到 gameinfo.txt(en)，指向游戏的 FGD 文件。

注意:VBSP 只会转换它从GameData键加载的 FGD(en) 文件中的实体。如果任何自定义实体被放错了位置，这就是最可能的原因。

提示:gameinfo.txt(en) 有一个 InstancePath 参数，用于定义实例的存储位置。如果您尝试引用不在此文件夹中的文件，则必须手动输入实例的 .vmf 的文件名（文件路径相对于父 .vmf）。

错误: 具有相对文件名的嵌套实例在 Alien Swarm 中无法正常工作，因为它们在 Hammer 和 VBSP 中的处理方式不同。 （验证？可能是因为 gameinfo.txt 设置不正确）  [todo tested in ?]

错误:light_spot(en) 当实例的一部分改变了灯光的角度时，其行为将不可预测。这是通过折叠实例或使用灯光的“实体指向”键值来解决的。  [todo tested in ?]

错误: func_instance 在 Source 2009 Engine Branch 中无法正常工作。建议您使用 Prefab(en) 代替。  [todo tested in ?]

错误:func_viscluster(en) 放置在实例内时没有作用。  [todo tested in ?]

错误:如果实例将其推到画笔限制之上（即隐藏所有实例将使地图保持在画笔限制之下的情况），VBSP 将毫无错误地崩溃。使用 -verbose 编译将显示导致 VBSP 失败的特定实例。  [todo tested in ?]

通过实例输入

1. 定义修复名称。
2. 为要使用的输入或输出定义一个值（如果有）。
3. 将输入发送到目标名称(en)“fixupname-value”，例如 MyInstance-Start。 Hammer 的 UI 无法识别该名称，但别担心。

键值

VMF Filename (file) <字符串(en)>

要作为实例插入的 VMF 文件。

Fix Up Name (propagate_fixup) <字符串(en)>

本质上是实例的名称。其中的所有实体都将根据修复样式将此字符串添加到它们中。如果未提供名称，则将使用InstanceAutoX或AutoInstanceX，其中 X 是随每个实例递增的数字。

注意:以@符号开头的实体名称，例如 @exit_door 不会因实例名称修复而改变。

待完善: 仅确认传送门2(en)。

Entity Name Fix Up (fixup_style) <choices>

如何应用修复名称。

• 0: Prefix (Default) | 前缀（默认）
• 1: Postfix | 后缀
• 2: None | 无

Replace (replace01) <instance_variable(en)>

这是一个替换参数。实例中任何$variable的使用都将被替换为value。替换<string $variable><string value>。 示例：$color 255 0 0。

注意:有 10 个 Replace 键值对，其名称为 replace{number} 后面的键：replace01、replace02、...、replace10

角度:

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

这个实体在世界的方向。Pitch是围绕Y轴旋转，Yaw是围绕Z轴的旋转，Roll是围绕X轴的旋转。

另请参阅

• func_instance_parms(en) - 控制实例内参数的实体。
• func_instance_io_proxy(en) - 用作实例内实体 I/O 代理的实体。
• func_instance_origin(en) - 定义实例中心点的辅助实体。
• 求生之路2关卡设计/VMF 实例(en) - 关于如何在求生之路2中使用此实体的教程。