Ru/Func instance

func_instance
Тип	Внутренний Точечный объект мира
Платформа	Source
Доступность	Во всех играх

func_instance - это int point, доступно для всех игр на движке Source. Данная сущность вставляет образец другого VMF файла в текущий. Вы можете перемещать и вращать ваш образец без поломки чего-либо или без кошмарного редактирования вне сетки.

По умолчанию, образец VMF отображается в Hammer окрашенным в оранжевый, но вы можете отключить это в верхней панели редактора, нажав Instancing > View Instances.

Предупреждение:Саморекурсивный образец (т.е. образец, в который включен он сам) может вызвать вылет Hammer.

Примечание:Образцы по умолчанию отключены в играх до Left 4 Dead 2 (кроме Team Fortress 2). Чтобы включить их, добавьте ключ GameData в gameinfo.txt, указывая на FGD файл нужной игры.

Примечание:VBSP преобразует только сущности в FGD файле, который загружается из ключа GameData. Если какие-либо пользовательские сущности потеряны, то это наиболее вероятная причина.

Совет:gameinfo.txt имеет параметр InstancePath, которых указывает расположение образцов. Если вы пытаетесь обратиться к файлам, которых нет в этой папке, вам придётся вручную вводить имя вашего .vmf образца (путь к файлу относительно родительского .vmf)

Баг: Вложенные экземпляры с относительными именами файлов некорректно работают в Alien Swarm, потому что они по-разному обрабатываются в Hammer и VBSP. Template:Todo:ru  [нужно проверить в ?]

Баг: light_spot будет вести себя непредсказуемо, когда часть образца будет изменять ключ-значение Pitch. Решается путём свёртывания [collapsing] образца, или при помощи ключа-значения "Entity to point at".  [нужно проверить в ?]

Баг: func_instance некорректно работает в Source 2009 Engine Branch. Вместо этого рекомендуется использовать Префаб.  [нужно проверить в ?]

Баг: func_viscluster не работает при размещении внутри образца.  [нужно проверить в ?]

Баг:VBSP произойдет сбой без ошибок, если образец превысит лимит брашей (т.е. ситуация, когда скрытие всех экземпляров приведет к тому, что карта не будет превышать лимиты на браши). Компиляция с -verbose покажет конкретный экземпляр, вызывающий сбой VBSP.  [нужно проверить в ?]

Ввод через образец

1. Задайте Fix Up Name. Для примера будет задано имя "MyInstance"
2. Определите значение для ввода (input) или выхода (output), которое вы хотите использовать (если он есть).
3. Отправьте ввод в targetname "fixupname-значение", например MyInstance-Start. Интерфейс Hammer не распознает имя, но не волнуйтесь.

KeyValues

VMF Filename (file) <строка(en)>

Имя VMF файла для использования в образце.

Fix Up Name (propagate_fixup) <строка(en)>

По сути, это название образца. Эта строка будет добавлена ко всем объектам в нём на основе стиля исправления. Если имя не указано, то будет использовано InstanceAutoX или AutoInstanceX, где X - число, которое будет увеличиваться с каждым новым образцом.

Примечание:Имена энтити, начинающиеся с символа @, например @exit_door, не будут изменены при исправлении имени образца.

Нужно сделать: подтверждено только для Portal 2

Entity Name Fix Up (fixup_style) <варианты выбора>

Как применять Fix Up Name.

• 0: Prefix (По умолчанию)
• 1: Postfix
• 2: None

Replace (replace01) <instance_variable(en)>

Это параметр замены. Любое использование $variable внутри экземпляра будет заменено на value. Заменить <string $variable> <string value>. Пример: $color 255 0 0.

Примечание:There are 10 Replace key-value pairs with the keys following replace{number} for names: replace01, replace02, ..., replace10
Template:Todo:ru

Углы:

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

Ориентация этого объекта в мире. Тангаж (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.