func_instance

From Valve Developer Community
Revision as of 02:55, 31 July 2021 by 1416006136 (talk | contribs)
Jump to: navigation, search
English Русский 简体中文

本简体中文界面由大康翻译。

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

Warning.png 警告: 自递归实例(即包含自身的实例)将使 Hammer 崩溃。
Note.png 注意: 求生之路2之前的游戏中,实例默认是禁用的(军团要塞 2 除外)。要启用它们,请将GameData键添加到 gameinfo.txt,指向游戏的 FGD 文件。
Note.png 注意: VBSP 只会转换它从GameData键加载的 FGD 文件中的实体。如果任何自定义实体被放错了位置,这就是最可能的原因。
Tip.png 小技巧: gameinfo.txt 有一个 InstancePath 参数,用于定义实例的存储位置。如果您尝试引用不在此文件夹中的文件,则必须手动输入实例的 .vmf 的文件名(文件路径相对于父 .vmf)。
Bug.png Bug: Alien Swarm 具有相对文件名的嵌套实例在 Alien Swarm 中无法正常工作,因为它们在 Hammer 和 VBSP 中的处理方式不同。 (验证?可能是因为 gameinfo.txt 设置不正确)
Bug.png Bug: light_spot 当实例的一部分改变了灯光的角度时,其行为将不可预测。这是通过折叠实例或使用灯光的“实体指向”键值来解决的。
Bug.png Bug: Alien Swarm func_instance 在 Source 2009 Engine Branch 中无法正常工作。建议您使用 Prefab 代替。
Bug.png Bug: func_viscluster 放置在实例内时没有作用。
Bug.png Bug: 如果实例将其推到画笔限制之上(即隐藏所有实例将使地图保持在画笔限制之下的情况),VBSP 将毫无错误地崩溃。使用 -verbose 编译将显示导致 VBSP 失败的特定实例。

通过实例输入

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

键值

VMF Filename (file) <string>
要作为实例插入的 VMF 文件。
Fix Up Name (propagate_fixup) <string>
本质上是实例的名称。其中的所有实体都将根据修复样式将此字符串添加到它们中。如果未提供名称,则将使用InstanceAutoXAutoInstanceX,其中 X 是随每个实例递增的数字。
Note.png 注意: @符号开头的实体名称,例如 @exit_door 不会因实例名称修复而改变。去做: 仅确认传送门2
Entity Name Fix Up (fixup_style) <choices>
如何应用修复名称。
  • 0: Prefix (Default) | 前缀(默认)
  • 1: Postfix | 后缀
  • 2: None | 无
Replace (replace01) <instance_variable>
这是一个替换参数。实例中任何$variable的使用都将被替换为value。替换<string $variable><string value>示例:$color 255 0 0。
Note.png 注意: 有 10 个 Replace 键值对,其名称为 replace{number} 后面的键:replace01replace02...replace10


角度:

Pitch Yaw Roll (Y Z X) <angle>
这个实体在世界的方向。Pitch是围绕Y轴旋转,Yaw是围绕Z轴的旋转,Roll是围绕X轴的旋转。

另请参阅