func_instance
func_instance | |
---|---|
![]() | |
Type | Internal Entidad de punto |
Motor | ![]() |
Availability | In all games |
func_instance
es un entidad de punto interno 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.
![Warning.png](/w/images/thumb/c/cb/Warning.png/10px-Warning.png)
![](/w/images/thumb/2/2e/Confirm.png/10px-Confirm.png)
![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
GameData
a gameinfo.txt, apuntando al archivo FGD del juego.![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
GameData
. Si alguna entidad personalizada se está colocando incorrectamente, esta es la causa más probable.![Tip.png](/w/images/thumb/4/45/Tip.png/9px-Tip.png)
{{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
- Define un Fix Up Name.
- Define un valor para el input o output que deseas usar (si hay uno).
- 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 > - El archivo VMF que se insertará como instancia. Relativo a la ubicación del mapa actual.
![PlacementTip.png](/w/images/thumb/c/cc/PlacementTip.png/14px-PlacementTip.png)
- 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
ymaps/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 > - 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
oAutoInstanceX
, donde X es un número que se incrementa con cada instancia.
![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
@
, 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 > - Este es un parámetro de reemplazo. Cualquier uso de
$variable
dentro de la instancia será reemplazado porvalor
. Reemplaza<string $variable> <string value>
. Ejemplo: $color 255 0 0.
![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
- Pitch Yaw Roll (Y Z X)
(angles)
<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
- 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.