Func instance: Difference between revisions
Jump to navigation
Jump to search
Example:
mNo edit summary |
SirYodaJedi (talk | contribs) mNo edit summary |
||
| Line 13: | Line 13: | ||
Instances allow you to edit the vmf of the instance and have every used instance on your main map be changed as well. But unfortunately many instances will lag hammer quite a lot. | Instances allow you to edit the vmf of the instance and have every used instance on your main map be changed as well. But unfortunately many instances will lag hammer quite a lot. | ||
{{ModernWarning|Self recursive instances (i.e. instances which include themselves) will crash Hammer.}} | {{ModernWarning|Self recursive instances (i.e. instances which include themselves) will crash Hammer.{{modernConfirm|How about the compile tools?}} }} | ||
{{ModernNote|Instances are disabled by default in pre-[[Left 4 Dead 2]] games (except Team Fortress 2). To enable them, add a <code>GameData</code> key to [[gameinfo.txt]], pointing to the game's FGD file.}} | {{ModernNote|Instances are disabled by default in pre-[[Left 4 Dead 2]] games (except Team Fortress 2). To enable them, add a <code>GameData</code> key to [[gameinfo.txt]], pointing to the game's FGD file.}} | ||
Revision as of 19:38, 25 December 2023
| func_instance | |
|---|---|
 | |
| Type | Internal Point entity |
| Engine |  Source |
| Availability | In all games |
Template:Entity 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, though this can be disabled in Instancing > View Instances.
Instances allow you to edit the vmf of the instance and have every used instance on your main map be changed as well. But unfortunately many instances will lag hammer quite a lot.
Template:ModernNote Template:ModernNote
Template:ModernBug Template:ModernBug Template:ModernBug Template:ModernBug Template:ModernBug
Input through an instance
- Define a Fix Up Name.
- Define a value for the input or output you want to use (if there is one).
- 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 (file) <string>
- The VMF file to insert as an instance. Relative to the current map's location.
Example:- If map.vmf and the instance.vmf are in the same folder, the filename field would be
instance.vmf - If the instance.vmf is in a subfolder of where the map.vmf is, the filename field would be
subfoldername/instance.vmf - If the instance.vmf and your map.vmf are neither in the same folder, nor in a subfolder of eachother, (Like
maps/instances/instance.vmfandmaps/project/map.vmf) you can use../to "pop" a folder out, in order to enter a new one. As such:../Instances/instance.vmf
- Fix Up Name (propagate_fixup) <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,
InstanceAutoXorAutoInstanceXwill be used, where X is a number that is incremented with each instance.
- Entity Name Fix Up (fixup_style) <choices>
- How to apply the fix up name.
- 0: Prefix (Default)
- 1: Postfix
- 2: None
- Replace (replace01) <instance_variable>
- This is a replacement parameter. Any usage of
$variableinside the instance will be replaced withvalue. Replace<string $variable> <string value>. Example: $color 255 0 0.
- Pitch Yaw Roll (Y Z X) (angles) <QAngle>
- 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
- func_instance_parms - Entity to control parameters within instances.
- func_instance_io_proxy - Entity that is used as a proxy for entity I/O within instances.
- func_instance_origin - Helper entity that defines the center point of an instance.
- L4D2 Level Design/VMF Instances - A tutorial on how to use this entity in Left 4 Dead 2.