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.

==How to==
In Portal 2 to give input to an entity within a instance use this:
::{| 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
|}

Or, alternatively, you can do this:
::{| class=standard-table
!   || My Output || Target Entity || Target Input || Parameter || Delay || Only Once
|-
| [[Image:Io11.png]] || <Output> || <Instance>-<entity> || <input> || <none> || 0.00 || No
|}

== Manifests ==
{{todo|}}

== Workaround for any Source game == 

To use instances in unsupported Engine versions, [http://steamcommunity.com/id/metapyziks Metapyziks] wrote a program that merges used instances with the main VMF.
* [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|*]]