View source for Instance

{{otherlang2

|ru=Примеры:ru

}}

{{stub}}
An '''instance''' is a [[VMF|map (.vmf) file]] referenced inside another map through a [[func_instance]], possibly aided by a [[func_instance_parms]] and/or [[func_instance_io_proxy]].

{{note|In order for instances to be compiled into maps, a <code>GameData</code> key must be present in [[gameinfo.txt]] pointing to the game's [[FGD]] file. Only {{l4d2}}[[Left 4 Dead 2]], {{as}}[[Alien Swarm]], {{portal2}}[[Portal 2]], {{tf2}}[[Team Fortress 2]], {{csgo}}[[Counter-Strike: Global Offensive]], and Source 2013 include this by default. Instances can be enabled in other games by adding it, or using a pre-compiler as described below. {{todo|Only tested in {{portal}}Portal, see if this works elsewhere}}}}

{{note|In pre-{{l4d2}}[[Left 4 Dead 2]] branches, instances have some broken or missing functionality: instance I/O system is unsupported, instances cannot be nested, displacements within an instance may not compile properly and any env_cubemaps inside of an instance will not be compiled into the final map.}}

Instances are helpful in many ways:

* They provide a more dynamic alternative to [[prefabs]], as any changes to the instanced map will be reflected in all instances of it.
* They provide an alternative to [[visgroups]], as they can be used to divide a large, unwieldy map into several smaller, manageable ones (that can even be worked on by multiple authors simultaneously).
* They provide a simple way to edit portions of a map that needs to be at a non-orthogonal angle. (Build the map on-grid inside a separate map, and then instance it into another map through a [[func_instance]] rotated at the correct angle.
* They provide a way for maps to work on multiple platforms, such as [[Left 4 Dead]] and [[Left 4 Dead 2]] versions of the same map.

== Instance I/O ==
In {{l4d2}}[[Left 4 Dead 2]] and later, instances can send and receive inputs and outputs. To use this functionality, a {{ent|func_instance_io_proxy}} entity named <code>proxy</code> must be present and properly configured in the instance. To send an input to an entity within the instance, the following output would be used:
::{| class=standard-table
!   || My Output || Target Entity || Target Input || Parameter || Delay || Only Once
|-
| [[Image:Io11.png]] || <output> || <instance> || instance:<entity>;<input> || <none> || 0.00 || No
|}

To receive an output from an entity in the instance, this output would be used on the {{ent|func_instance}}:

::{| class=standard-table
!   || My Output || Target Entity || Target Input || Parameter || Delay || Only Once
|-
| [[Image:Io11.png]] || instance:<entity>;<output> || <other entity> || <input> || <none> || 0.00 || No
|}

{{note|Hammer should auto-complete these inputs and outputs. They may also appear as invalid, but will work fine in-game.}}

=== In older branches ===
Pre-L4D2 engine branches do not support the instance I/O system, so workarounds are needed to send and receive inputs and outputs in instances. For inputs, the fixed up entity name can be referenced directly.

::{| class=standard-table
!   || My Output || Target Entity || Target Input || Parameter || Delay || Only Once
|-
| [[Image:Io11.png]] || <output> || <instance>-<entity> || <input> || <none> || 0.00 || No
|}

{{note|The target entity name will vary depending on the Entity Name Fix Up set on the instance.}}

== Manifests ==
{{todo|}}

== Precompiler == 

[http://steamcommunity.com/id/metapyziks Metapyziks] wrote a program that merges instances into the main VMF before each compile. This was originally created to enable instance support in older engine branches, but the <code>GameData</code> method has since rendered it mostly obsolete. However, it would theoretically be possible for someone to fork the program to add additional functionality, such as instance I/O support or the ability to toggle [[VisGroups]] with a fixup variable.
* [https://github.com/Metapyziks/VMFInstanceInserter Set up tutorial and source code]
* [https://github.com/Metapyziks/VMFInstanceInserter/releases VMFII releases]

== Also see ==
* [[L4D2 Level Design/VMF Instances]] - A Valve tutorial on how to use instances in Left 4 Dead 2.
* [[Working with instances]] - A tutorial on how to use instances in Portal 2.

== External links ==
* [http://www.youtube.com/watch?v=YvSZ2NEX1Y0 Source SDK Tutorial - Manifest Tool (YouTube)]
* [http://tf2maps.net/threads/mapping-collaboration-or-using-manifest-and-version-control.24787/ Manifests and Version Control Tutorial (TF2Maps.net)]

[[Category:Glossary]]
[[Category:Level Design]]
[[Category:Left 4 Dead 2]]
[[Category:Alien Swarm]]
[[Category:Portal 2]]
[[Category:Instances|*]]