func_instance

func_instance
Type	Internal Entidad de punto
Motor	Source
Availability	In all games

func_instance es un entidad de punto(en) interno(en) disponible en todos los juegos de Source.
Inserta una instancia de otro archivo VMF en el actual. Puedes traducir y rotar la instancia sin romper nada ni crear una pesadilla de edición fuera de la cuadrícula (aunque QPhysics puede romperse sutilmente, como hacer superficies en ángulo no surfeables).
Por defecto, las instancias se dibujan en Hammer con un tono naranja, aunque esto se puede desactivar en Instancing > View Instances.
Las instancias te permiten editar el VMF de la instancia y que cada instancia utilizada en tu mapa principal también se cambie. Pero, desafortunadamente, muchas instancias ralentizarán Hammer considerablemente. Hammer++ no sufre de este problema.

Ejemplos de uso:

• Una configuración elaborada de ventana con vidrio rompible, prop de ventana, brushes de clip, areaportal_window y su brush de ventana, luego usándolo en toda una casa.
• Un remolque camper que tiene trabajo de brushes y props en su interior, que luego se coloca en ángulos extraños que dificultarían la creación de areaportals.
• Vehículos con una asignación de color aleatoria, esparcidos por el mapa.

Una imagen que muestra una instancia de ventana utilizada varias veces en una casa.

Aviso:Las instancias recursivas (instancias que se incluyen a sí mismas) harán que Hammer se bloquee.

Confirmar:¿Qué pasa con las herramientas de compilación?

Nota:Las instancias están desactivadas por defecto en juegos anteriores a Left 4 Dead 2 (excepto Team Fortress 2). Para habilitarlas, agrega una clave GameData a gameinfo.txt, apuntando al archivo FGD del juego.

Nota:VBSP solo transformará las entidades en el archivo FGD que carga desde la clave GameData. Si alguna entidad personalizada se está colocando incorrectamente, esta es la causa más probable.

Consejo: gameinfo.txt tiene un parámetro InstancePath que define dónde se almacenan las instancias. Si intentas referenciar archivos que no están en esta carpeta, tendrás que escribir manualmente el nombre del archivo .vmf de tu instancia (la ruta del archivo es relativa al .vmf principal).

{{bug|

• En Alien Swarm, las instancias anidadas con nombres de archivos relativos no funcionan correctamente, porque se manejan de manera diferente en Hammer y VBSP. ^[confirmar] (Tal vez porque el archivo gameinfo.txt está configurado incorrectamente).
• light_spot se comportará de manera impredecible cuando sea parte de una instancia que altera el pitch de la luz. Esto se soluciona colapsando la instancia o usando la clave "Entity to point at" de la luz.
• No funcionará correctamente en Source 2009. Se recomienda usar un Prefab en su lugar.
• func_viscluster no funciona cuando se coloca dentro de una instancia.
• VBSP se bloqueará sin mostrar error si una instancia supera el límite de brushes (es decir, una situación donde ocultar todas las instancias mantendría el mapa por debajo del límite de brushes). Compilar con -verbose revelará la instancia específica que causa que VBSP falle.

Entrada a través de una instancia

1. Define un Fix Up Name.
2. Define un valor para el input o output que deseas usar (si hay uno).
3. Envía un input al targetname "fixupname-valor", por ejemplo, MyInstance-Start. La interfaz de usuario de Hammer no reconocerá el nombre, pero no te preocupes.

KeyValues

Nombre del archivo VMF (file) <string(en)>

El archivo VMF que se insertará como instancia. Relativo a la ubicación del mapa actual.

Ejemplo:

• Si map.vmf e instance.vmf están en la misma carpeta, el campo de nombre de archivo sería instance.vmf
• Si instance.vmf está en una subcarpeta de donde está map.vmf, el campo de nombre de archivo sería subfoldername/instance.vmf
• Si instance.vmf y tu map.vmf no están en la misma carpeta, ni en una subcarpeta entre sí, (como maps/instances/instance.vmf y maps/project/map.vmf) puedes usar ../ para subir un directorio y entrar en uno nuevo. Así: ../Instances/instance.vmf

Nombre de Fix Up (propagate_fixup) <string(en)>

Esencialmente el nombre de la instancia. Todas las entidades dentro de ella tendrán esta cadena añadida según el estilo de fix up. Si no se proporciona un nombre, se utilizará InstanceAutoX o AutoInstanceX, donde X es un número que se incrementa con cada instancia.

Nota:Los nombres de las entidades que comienzan con el símbolo @, por ejemplo, @exit_door, no serán cambiados por el nombre del fix up de la instancia.

Estilo de Fix Up de Nombre de Entidad (fixup_style) <choices>

Cómo aplicar el nombre del fix up.

• 0: Prefijo (Predeterminado)
• 1: Sufijo
• 2: Ninguno

Reemplazar (replace01) <instance_variable(en)>

Este es un parámetro de reemplazo. Cualquier uso de $variable dentro de la instancia será reemplazado por valor. Reemplaza <string $variable> <string value>. Ejemplo: $color 255 0 0.

Nota:Hay 10 pares clave-valor de Reemplazo con las claves siguiendo replace{número} para nombres: replace01, replace02, ..., replace10

Pitch Yaw Roll (Y Z X) (angles) <angle(en)>

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.