Основные ключ-параметры, входы и выходы

Ниже приведены общие ключ-параметры, входы и выходы, доступные для всех объектов. Они не обязательно присутствуют в FGD-файле(en) каждой игры/объекта, но существуют у каждого объекта, поскольку наследуются из класса CBaseEntity(en). Если они отсутствуют в FGD-файле для объекта, это может быть связано с тем, что их использование для этого объекта не предусмотрено или может работать некорректно (например, наследование prop_physics), и такие случаи придётся тестировать и описывать на странице соответствующего объекта. Некоторые объекты могут переопределять функциональность указанных ключей/входов/выходов, и такие случаи также будут описаны на странице данного объекта.

Примечание:Здесь перечислены не все ключ-параметры, так как многие из них редко применяются или имеют очень специфическое применение.

Ключ-параметры

Name(en) (targetname) <строка(en)>

Имя объекта, по которому другие объекты могут ссылаться на этот объект, через Входы/Выходы(en) или другие ключ-параметры(en) (например parentname(en) или target).
Оно отображается на 2D-видах в Hammer и Отчёте об объектах (Entity Report)(en).

Class(en) (classname) <строка(en)>

Определяет свойства объекта до его появления в игровом процессе.

Совет:Изменение этого параметра во время выполнения имеет некоторые преимущества, но его следует применять с осторожностью, поскольку некоторые объекты ожидают, что у необходимых объектов будут определенные имена классов. Например, использование имени класса, определенного в белом списке S_PreserveEnts(en), приведет к восстановлению объекта в новых раундах.

Global Entity Name(en) (globalname) <строка(en)>

При передаче объекта на другую карту, содержащую объект с таким же внешним именем (и именем класса), свойства этого объекта (цвет, точка отсчёта, углы и т.д.) будут скопированы в этот объект (если только данное свойство не помечено как не подлежащее передаче, например, модель).

Важно:Предназначено для использования в одиночных играх в стиле

с передачей между картами (

не является таковой)

Model (model) <строка(en)>: Визуальное представление отображаемого объекта. Для объёмных объектов(en) это ссылка на ненулевой индекс [[Ru/Bmodel|]](en) в текущем BSP-файле. Для точечных объектов(en) это путь к MDL-файлу(en) трёхмерной модели(en) или VMT-файлу(en) спрайта(en) относительно корневого каталога игры. Не все объекты будут отображать модель, некоторые объекты будут отображать только предварительно кэшированную(en) определенную здесь модель (без предварительного кэширования она отображаться не будет).

Origin(en) (X Y Z) (origin) <координаты(en)>

Положение точки отсчёта (origin) этого объекта в пространстве мира. Вращающиеся объекты обычно вращаются вокруг своей точки отсчёта.

Баг:Редактирование вручную в Hammer не приводит к соответствующему перемещению точечных объектов в редакторе.

Примечание:Объёмные объекты с этим ключ-параметром учитываются при проверке пространства карты на утечки(en), а при его отсутствии не учитываются. Это связано с тем, что при отсутсвии этого ключ-параметра применяется значение по умолчанию 0 0 0, которое всегда игнорируется при проверке на утечки.

Pitch Yaw Roll (Y Z X) (angles) <углы(en)>: Ориентация этого объекта в мире. Тангаж (pitch) - поворот по оси Y, рысканье (yaw) - поворот по Z и крен(roll) - поворот по X.

Примечание:Это работает для большинства объёмных объектов, хотя Hammer не показывает новые углы.

Flags(en) (spawnflags) <flags(en)>

Переключает специфические возможности объекта, конечное числовое значение определется комбинацией включенных признаков. В Hammer на соответствующей вкладке свойств объекта называемой 'Flags (Признаки)(en)'

Damage Filter (damagefilter) <фильтр(en)>: Имя фильтра урона, определяющего, какие объекты могут наносить урон этому объекту (обычно filter_damage_type).

Наследование

Parent(en) (parentname) <имя объекта(en)>

Поддерживает заданное смещение относительно точки отсчёта другого объекта. Также можно использовать точку крепления, указав её после запятой в конце (parentname [targetname],[attachment]).

Совет:Объекты передаются на следующую карту вместе с родительскими объектами (нет в

)

Обходной приём:Можно использовать phys_constraint, если наследование не работает.

Сценарии

Entity Scripts (vscripts) <список сценариев(en)> (Во всех играх начиная с ) (также в ): Список файлов сценариев VScript(en), разделенных пробелами (без расширения файла), которые выполняются после создания всех объектов. Все сценарии выполняются в едином потоке расчёта, и последующие сценарии перезаписывают все идентичные переменные и функции. Сценарии, выполняемые для объекта мира(en), будут выполняться в корневом потоке расчёта.

Think function(en) (thinkfunction) <строка(en)> (Во всех играх начиная с

) (также в

)

Имя функции в сценарии объекта, которая будет вызываться автоматически каждые 100 миллисекунд или с заданным пользователем интервалом, если функция возвращает число. Должен быть указан до появления объекта, установка этого ключ-параметра позже (например, через AddOutput) не будет работать. Избегайте ресурсоёмких(en) операций в этой функции, так как это может привести к проблемам с производительностью.

Отображение

RenderFields:

Render Mode (rendermode) <байт(en) выбор>

Устанавливает нестандартный режим отображения этого объекта.

Режимы отображения
0: Нормально 1: Цвет 2: Текстура 3: Свечение 4: Цельный/Тест прозрачности 5: Наложение 6: Удалён, ничего не делает 7: Промежуточные кадры 8: Добавление прозрачности 9: Масштабируемое свечение 10: Не отображать

Render FX(en) (renderfx) <байт(en) выбор>

Various somewhat legacy alpha effects. See render effects.

Render Amount / Transparency (renderamt) <байт(en)>: Transparency amount, requires a Render Mode other than Normal. 0 is invisible, 255 is fully visible.

Render Color (R G B) (rendercolor) <цвет КЗС(en)>: Color tint.

Тени:

Disable Shadows (disableshadows) <булева переменная(en)>: Отключить создание объектом простых текстурных теней, или теней в виде световой карты, если объект является prop_static. Не влияет на карты теней.

Shadow Cast Distance (shadowcastdist) <целое число(en)> Отсутствует в FGD!: Установить максимальную дальность применения динамических теней от объекта. 0 обозначает дистанцию, заданную по умолчанию в объекте shadow_control.

Примечание:Ключ-параметры, относящиеся к текстурным теням, не влияют на большинство объёмных объектов, поскольку они запрограммированы в C_BaseEntity, чтобы не отбрасывать текстурные тени. Некоторые объекты переопределяют это поведение, например объект func_physbox.

Disable Receiving Shadows (disablereceiveshadows) <булева переменная(en)>: Отключить отображение динамических теней на объекте.

Disable Shadow Depth (disableshadowdepth) <булева переменная(en)> (Во всех играх начиная с ): Отключение отображения глубины теней (для проецируемых текстур) на этом объекте.

Disable flashlight (disableflashlight) <булева переменная(en)> (Во всех играх начиная с ): Отключение проецируемого текстурного освещения и теней на этом объекте.

Projected Texture Cache (shadowdepthnocache) <целое число(en) выбор> (Во всех играх начиная с )

Указывает системе проецируемых текстур кэшировать размер тени этого объекта вместо принудительно покадрового расчёта отображения.

Варианты
0 : По умолчанию 1 : Без кэша - обрабатывать покадрово 2 : Кэшировать - обрабатывать однократно

Прочие


<dl id="Effects(en)" style="margin-block:.4em 1em"> Effects(en) `(effects)` `<flags(en)>` Отсутствует в FGD! Набор признаков эффектов для использования. <dl id="Lag Compensation(en)" style="margin-block:.4em 1em"> Lag Compensation(en) `(LagCompensate)` `<булева переменная(en)>` Отсутствует в FGD! (Во всех играх начиная с ) Установите значение Yes, чтобы компенсировать задержки этого объекта. Следует использовать в исключительных случаях! Is Automatic-Aim Target `(is_autoaim_target)` `<булева переменная(en)>` Отсутствует в FGD! (Во всех играх начиная с ) Если установлено значение 1, этот объект будет замедлять движение прицеливания на игровых приставках и джойстиков, когда объект находится под перекрестием прицела.

Входы

AddOutput(en) <строка(en)>

Присваивает этому объекту новый выход или ключ-параметр. Для некоторых ключ-параметров необходимо выполнение дополнительного кода, и они не будут работать, если их просто изменить через этот вход.
Формат:

<имя> <целевой объект>:[имя входа]:[параметр]:[задержка]:[количество срабатываний, -1 - бесконечно]

Формат: <ключ> <значение>

Kill(en)

Удаляет из игрового процесса этот объект и всех связанных потомков этого объекта.

FireUser1 to FireUser4 <строка(en)>

Срабатывает соответствующие выходы OnUser. Смотрите раздел Пользовательские входы и выходы(en).

Предупреждение:Can take string parameter and doesn't do anything with it. This can cause an issue if this input is fired from outputs that can send a value. Make sure to specify dummy string in such cases other-wise the output will use its value as parameter causing the input to fail with "bad input/output link" error in console.

SetDamageFilter <имя объекта(en)>: Устанавливает фильтр(en), определяющий урон, получаемый данным объектом.