func_instance
func_instance | |
---|---|
Type | Internal Point entity |
Engine | Source |
Availability | In all games |
func_instance
is a internal point entity available in all Source games. Данная сущность вставляет образец другого VMF файла в текущий. Вы можете перемещать и вращать ваш образец без поломки чего-либо или без кошмарного редактирования вне сетки.
По умолчанию, образец VMF отображается в Hammer окрашенным в оранжевый, но вы можете отключить это в верхней панели редактора, нажав Instancing
> View Instances
.
Warning:Саморекурсивный образец (т.е. образец, в который включен он сам) может вызвать вылет Hammer.
Note:Образцы по умолчанию отключены в играх до Left 4 Dead 2 (кроме Team Fortress 2). Чтобы включить их, добавьте ключ
GameData
в gameinfo.txt, указывая на FGD файл нужной игры.Note:VBSP преобразует только сущности в FGD файле, который загружается из ключа
GameData
. Если какие-либо пользовательские сущности потеряны, то это наиболее вероятная причина.Tip:gameinfo.txt имеет параметр InstancePath, которых указывает расположение образцов. Если вы пытаетесь обратиться к файлам, которых нет в этой папке, вам придётся вручную вводить имя вашего .vmf образца (путь к файлу относительно родительского .vmf)
Bug:
light_spot
будет вести себя непредсказуемо, когда часть образца будет изменять ключ-значение Pitch
. Решается путём свёртывания [collapsing] образца, или при помощи ключа-значения "Entity to point at".Bug: func_instance некорректно работает в Source 2009 Engine Branch. Вместо этого рекомендуется использовать Префаб.
Bug:
func_viscluster
не работает при размещении внутри образца.Bug:VBSP произойдет сбой без ошибок, если образец превысит лимит брашей (т.е. ситуация, когда скрытие всех экземпляров приведет к тому, что карта не будет превышать лимиты на браши). Компиляция с -verbose покажет конкретный экземпляр, вызывающий сбой VBSP.
Ввод через образец
- Задайте Fix Up Name. Для примера будет задано имя "MyInstance"
- Определите значение для ввода (input) или выхода (output), которое вы хотите использовать (если он есть).
- Отправьте ввод в targetname "fixupname-значение", например MyInstance-Start. Интерфейс Hammer не распознает имя, но не волнуйтесь.
KeyValues
- VMF Filename
(file)
<string> - Имя VMF файла для использования в образце.
- Fix Up Name
(propagate_fixup)
<string> - По сути, это название образца. Эта строка будет добавлена ко всем объектам в нём на основе стиля исправления. Если имя не указано, то будет использовано
InstanceAutoX
илиAutoInstanceX
, где X - число, которое будет увеличиваться с каждым новым образцом.
Note:Имена энтити, начинающиеся с символа
@
, например @exit_door, не будут изменены при исправлении имени образца. Todo: подтверждено только для Portal 2
- Entity Name Fix Up
(fixup_style)
<choices> - Как применять Fix Up Name.
- 0: Prefix (По умолчанию)
- 1: Postfix
- 2: None
- Replace
(replace01)
<instance_variable> - Это параметр замены. Любое использование
$variable
внутри экземпляра будет заменено наvalue
. Заменить<string $variable> <string value>
. Пример: $color 255 0 0.
Note:There are 10 Replace key-value pairs with the keys following replace{number} for names: replace01, replace02, ..., replace10
Todo: перевести это предложение, да так перевести, чтобы хоть что-то было понятно
Angles:
- Pitch Yaw Roll (Y Z X)
<угловое значение>
- Ориентация этой энтити в мире. Pitch - поворот по оси Y, yaw - поворот по Z и roll - поворот по X.
Также смотрите
func_instance_parms
- Сущность для управления параметрами в образцах.func_instance_io_proxy
- Энтити, которая в образцах используется в качестве прокси для entity I/O (input/output).func_instance_origin func_instance_origin
- Вспомогательная сущность, определяющая центральную точку образца.- L4D2 Level Design/VMF Instances - Учебник о том, как пользоваться этой энтити в Left 4 Dead 2.