Zh/Func instance

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

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

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

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

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

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

通过实例输入

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

键值

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

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

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

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

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

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