Difference between revisions of "Func instance"

From Valve Developer Community
Jump to: navigation, search
(Entity description: added bug)
(added bug, tip. one particular bug may need verification (as it may have been the symptom of the tip added))
Line 9: Line 9:
  
 
{{tip|Instances can be used with pre-L4D2 games by collapsing them before each compile.}}
 
{{tip|Instances can be used with pre-L4D2 games by collapsing them before each compile.}}
 +
{{tip| [[gameinfo.txt]] has an InstancePath parameter that defines where instances are stored. If you try to reference files that aren't in this folder, you will have to manually type in the filename of your instance's .vmf (file path is relative to the parent .vmf)}}
  
{{bug|{{as}} Nested instances with relative file names don't work correctly in Alien Swarm, because they are handled differently in Hammer and VBSP.}}
+
{{bug|{{as}} Nested instances with relative file names don't work correctly in Alien Swarm, because they are handled differently in Hammer and VBSP. (verify? may be because of incorrectly set up gameinfo.txt)}}
 +
{{bug| [[light_spot]] does not appear to adjust its pitch value when it is part of a rotated instance.}}
 
{{bug|{{as}} The func_instance does not work correctly in the Source 2009 Engine Branch. It is recommended you use a [[Prefab]] instead.}}
 
{{bug|{{as}} The func_instance does not work correctly in the Source 2009 Engine Branch. It is recommended you use a [[Prefab]] instead.}}
 
{{bug| [[func_viscluster]] does not function when placed inside of an instance.}}
 
{{bug| [[func_viscluster]] does not function when placed inside of an instance.}}

Revision as of 14:45, 16 March 2016

func_instance is an internal point entity available in all Source games since <Left 4 Dead 2> Left 4 Dead 2.

Entity description

It inserts an instance of another VMF file into the current one. You can translate and rotate the instance without breaking anything or creating an off-grid editing nightmare. By default, instances are drawn in Hammer with an orange tint.

Warning: Self recursive instances (i.e. instances which includes themselves) will crash Hammer.

Note:VBSP will only transform entities in the FGD it loads from gameinfo.txt's GameData key. If your custom entities are being misplaced, this is the most likely cause.
Tip:Instances can be used with pre-L4D2 games by collapsing them before each compile.
Tip: gameinfo.txt has an InstancePath parameter that defines where instances are stored. If you try to reference files that aren't in this folder, you will have to manually type in the filename of your instance's .vmf (file path is relative to the parent .vmf)
Bug: <Alien Swarm> Nested instances with relative file names don't work correctly in Alien Swarm, because they are handled differently in Hammer and VBSP. (verify? may be because of incorrectly set up gameinfo.txt)
Bug:  light_spot does not appear to adjust its pitch value when it is part of a rotated instance.
Bug: <Alien Swarm> The func_instance does not work correctly in the Source 2009 Engine Branch. It is recommended you use a Prefab instead.
Bug:  func_viscluster does not function when placed inside of an instance.

Input through an instance

  1. Define a Fix Up Name.
  2. Define a value for the input or output you want to use (if there is one).
  3. Send an input to the targetname "fixupname-value", e.g. MyInstance-Start. Hammer's UI won't recognise the name, but don't worry.

KeyValues

VMF Filename <string>
The VMF file to insert as an instance.
Fix Up Name <string>
Essentially the name of the instance. All entities within it will have this string added to them based upon the fix up style. If no name is provided, InstanceAutoX or AutoInstanceX will be used, where X is a number that is incremented with each instance.
Note:Entity names that start with the @ symbol e.g. @exit_door will not be changed by the instance name fix up. To do: only confirmed for Portal 2
Entity Name Fix Up <choices>
How to apply the fix up name.
  • Prefix (Default)
  • Postfix
  • None
Replace <string $variable> <string value>
This is a replacement parameter. Any usage of $variable inside the instance will be replaced with value.
Example: $color 255 0 0

Angles:

Pitch Yaw Roll (Y Z X) <angle>
This entity's orientation in the world. Pitch is rotation around the Y axis, yaw is the rotation around the Z axis, roll is the rotation around the X axis.

See also