func_instance
... 
| func_instance | |
|---|---|
 | |
| Тип | Внутренняя точечная сущность |
| Движок |  Source |
| Доступность | Во всех играх |
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:
Вложенные экземпляры с относительными именами файлов некорректно работают в Alien Swarm, потому что они по-разному обрабатываются в Hammer и VBSP. Доделать: проверить gameinfo.txt. Проблема может быть в неправильной настройке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Доделать: перевести это предложение, да так перевести, чтобы хоть что-то было понятно
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.
