func_instance

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

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

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

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

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

 Ошибка:  Вложенные экземпляры с относительными именами файлов некорректно работают в Alien Swarm, потому что они по-разному обрабатываются в Hammer и VBSP. Необходимо сделать: проверить gameinfo.txt. Проблема может быть в неправильной настройке

 Ошибка:  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) <string>

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

Fix Up Name (propagate_fixup) <string>

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

 Примечание: Имена энтити, начинающиеся с символа @, например @exit_door, не будут изменены при исправлении имени образца. Необходимо сделать: подтверждено только для 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.

 Примечание: 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 - Вспомогательная сущность, определяющая центральную точку образца.
• L4D2 Level Design/VMF Instances - Учебник о том, как пользоваться этой энтити в Left 4 Dead 2.