Entity

Entity — общая основа объектов игрового мира. На этой странице описаны летящие гранаты и активные объекты взрывов. Все свойства доступны только для чтения.

Как устроен путь данных

Игровой мир создаёт и удаляет сетевые сущности: снаряды при броске, области взрыва при срабатывании и установленный BridgeCharge после plant. Глобальные API ThrownProjectiles, Explosions и PlantedBridgeCharges запрашивают текущий реестр и оборачивают найденные объекты для Lua.

Обёртка не создаёт сущность и не продлевает её жизнь. После взрыва или despawn сохранённый объект может стать недоступным; для актуального списка снова вызывайте GetAll() или профильный метод. На клиенте значения также проходят правила командной видимости, а сервер читает состояние симуляции напрямую.

Быстрый пример

local projectiles = ThrownProjectiles:GetAll()

for i = 1, projectiles.Length do
    local projectile = projectiles[i]
    print(projectile.Name .. ": " .. tostring(projectile.Position))
end

EMPGrenadeExplosion

Взрыв от EMP гранаты.

Base: Explosion

Entity

Базовый объект всех сущностей в мире.

Свойства

Свойство	Тип	Доступ	Описание
`ID`	int	`get`	Уникальный ID сущности.
`IsVisible`	bool	`get`	true, если сущность видима для локальной команды. Когда сущность не видна, все её члены, кроме Name и ID, возвращают неопределённые значения.
`Name`	string	`get`	Имя сущности.
`Position`	Vector3	`get`	Позиция сущности в мире.
`TicksSinceLastVisible`	int	`get`	Только client Количество тиков с момента, когда сущность была видна в последний раз.

Explosion

Базовый объект взрыва с общими параметрами времени жизни.

Здесь «взрыв» означает активную игровую сущность эффекта — мгновенный frag, область огня, sonar или защитный купол. Урон и другие эффекты обрабатывает игровая система; чтение объекта только наблюдает уже созданное состояние.

Base: Entity

Свойства

Свойство	Тип	Доступ	Описание
`AsEMPGrenadeExplosion`	EMPGrenadeExplosion	`get`	Возвращает взрыв как EMPGrenadeExplosion или nil, если это взрыв другого типа.
`AsFragGrenadeExplosion`	FragGrenadeExplosion	`get`	Возвращает взрыв как FragGrenadeExplosion или nil, если это взрыв другого типа.
`AsIncendiaryExplosion`	IncendiaryExplosion	`get`	Возвращает взрыв как IncendiaryExplosion или nil, если это взрыв другого типа.
`AsPowerShellExplosion`	PowerShellExplosion	`get`	Возвращает взрыв как PowerShellExplosion или nil, если это взрыв другого типа.
`AsSonarExplosion`	SonarExplosion	`get`	Возвращает взрыв как SonarExplosion или nil, если это взрыв другого типа.
`Instigator`	Agent	`get`	Агент, который инициировал Explosion.
`IsEMPGrenadeExplosion`	bool	`get`	true, если является взрывом от EMP гранаты.
`IsFragGrenadeExplosion`	bool	`get`	true, если является взрывом от Frag гранаты.
`IsIncendiaryExplosion`	bool	`get`	true, если взрыв является областью огня от зажигательной гранаты.
`IsPowerShellExplosion`	bool	`get`	true, если взрыв является куполом щита.
`IsSonarExplosion`	bool	`get`	true, если взрыв является сонаром.
`ThrowableConfig`	ConfigItemThrowable	`get`	Конфигурация метательного предмета которым был создан этот Explosion. Возвращает nil, если конфигурация недоступна.
`ToDespawnTicks`	int	`get`	Оставшееся количество тиков до удаления взрыва.

Explosions

Глобальный API для листинга взрывов.

Методы

GetAll

Explosions:GetAll(): Array<Explosion>

Возвращает все активные взрывы от гранат на карте.

Возвращает: Array<Explosion>

GetEMPGrenadeExplosions

Explosions:GetEMPGrenadeExplosions(): Array<EMPGrenadeExplosion>

Возвращает все взрывы от EMP гранаты (EMPGrenadeExplosion) на карте.

Возвращает: Array<EMPGrenadeExplosion>

GetFragGrenadeExplosions

Explosions:GetFragGrenadeExplosions(): Array<FragGrenadeExplosion>

Возвращает все взрывы от Frag гранаты (FragGrenadeExplosion) на карте.

Возвращает: Array<FragGrenadeExplosion>

GetIncendiaryExplosions

Explosions:GetIncendiaryExplosions(): Array<IncendiaryExplosion>

Возвращает все активные области огня (IncendiaryExplosion) на карте.

Возвращает: Array<IncendiaryExplosion>

GetPowerShellExplosions

Explosions:GetPowerShellExplosions(): Array<PowerShellExplosion>

Возвращает все активные купола защиты (PowerShellExplosion) на карте.

Возвращает: Array<PowerShellExplosion>

GetSonarExplosions

Explosions:GetSonarExplosions(): Array<SonarExplosion>

Возвращает все активные сонары (SonarExplosion) на карте.

Возвращает: Array<SonarExplosion>

FragGrenadeExplosion

Взрыв от Frag гранаты.

Base: Explosion

IncendiaryExplosion

Огонь от зажигательной граната.

Base: Explosion

PlantedBridgeCharge

Установленный BridgeCharge в игровом мире.

Объект появляется после завершения установки предмета BridgeChargeItem и удаляется после завершения соответствующего состояния раунда. Он не предоставляет Lua-команд plant/defuse.

Base: Entity

Помимо свойств Entity, объект предоставляет иконку заряда.

Свойства

Свойство	Тип	Доступ	Описание
`Icon`	Texture	`get`	Иконка установленного BridgeCharge.

PlantedBridgeCharges

Глобальный API для работы с PlantedBridgeCharge.

Методы

GetPlanted

PlantedBridgeCharges:GetPlanted(): Array<PlantedBridgeCharge>

Возвращает все установленные BridgeCharge. До установки или после удаления заряда массив может быть пустым.

Возвращает: Array<PlantedBridgeCharge>

PowerShellExplosion

Купол PowerShell в мире.

Base: Explosion

Свойства

Свойство	Тип	Доступ	Описание
`ShellDurability`	number	`get`	Текущая прочность купола.
`ShellMaxDurability`	number	`get`	Максимальная прочность купола.

SonarExplosion

Сонар как объект в мире.

Base: Explosion

ThrownProjectile

Брошенный предмет (например, граната) в полете.

Позицию и скорость обновляет физика летящего предмета. Lua только читает сетевую сущность; SimulateTrajectory() рассчитывает отдельный набор точек и не вмешивается в настоящий полёт.

Base: Entity

Свойства

Свойство	Тип	Доступ	Описание
`IsExploded`	bool	`get`	true, если предмет уже взорвался или больше не активен.
`ThrowableConfig`	ConfigItemThrowable	`get`	Конфигурация метательного предмета. Возвращает nil, если конфигурация недоступна.
`ThrownAtTick`	int	`get`	Тик, в который предмет был брошен.
`ThrownBy`	Agent	`get`	Агент, который бросил предмет.
`Velocity`	Vector3	`get`	Текущая скорость полета.

Методы

SimulateTrajectory

ThrownProjectile:SimulateTrajectory(): Array<Vector3>

Только client Возвращает рассчитанную траекторию полета.

Метод ничего не перемещает и не рисует. Он возвращает снимок рассчитанных точек; для линии в мире передайте их в LineRenderer:SetPositions().

Возвращает: Array

ThrownProjectiles

Глобальный API для работы с предметами в полете.

Методы

GetAll

ThrownProjectiles:GetAll(): Array<ThrownProjectile>

Возвращает все активные брошенные предметы (например, гранаты), которые еще не взорвались. На клиенте также возвращает гранаты, которые сейчас не видны, но были видны ранее и продолжают предсказываться по траектории.

Возвращает: Array<ThrownProjectile>

Связанные типы: Array и Vector3.