Пространство имён

ents.create

Создаёт сущность по classname.

ents.create(classname)

Аргументы

#	имя	тип
1	`classname`	string	`info_target`, `func_door`, …

Возвращает

тип
`entity \| nil`	новая сущность
`string`	причина, если игра не знает classname

Пример

hook.add("round:start", "drops.spawn", function()
	local e = ents.create("info_target")
	e:model("models/w_ak47.mdl")
	e:origin(x, y, z)
	e:spawn()
end)

Возвращает голый edict: игра ещё не превратила его ни во что. Сначала модель и позиция, потом e:spawn() — Spawn читает уже выставленные поля. В обратном порядке получится сущность, которую игра игнорирует. Модель обязана быть предкэширована через res.model, а это делается в теле плагина.

Пока карта не загружена, сущностей не существует. Тело плагина выполняется задолго до неё, и здесь это ошибка. Создавай сущности из события: round_start, player_spawn, таймер, команда.

ents.find

Находит все сущности с заданным classname.

ents.find(classname)

Аргументы

#	имя	тип
1	`classname`	string	что искать

Возвращает

тип
`table`	массив сущностей, пустой если ничего нет

ents.in_sphere

Находит все сущности в радиусе от точки.

ents.in_sphere(x, y, z, radius)

Аргументы

#	имя	тип
1	`x, y, z`	number	центр
2	`radius`	number	радиус в юнитах

Возвращает

тип
`table`	массив сущностей, порядок произвольный

Из этого делается зона: объём без собственной сущности-триггера.

ents.trace_line

Пускает луч между двумя произвольными точками.

ents.trace_line(a, b[, opts])

Аргументы

#	имя	тип
1	`a`	table	точка старта, `{x, y, z}`
2	`b`	table	точка конца, `{x, y, z}`
3	`opts`	table \| nil	см. Опции ниже

Возвращает

тип
`table`	что попалось — тот же формат, что у p:trace

Опции

поле	тип
`skip`	entity \| player \| nil	луч эту сущность игнорирует
`ignore_monsters`	boolean	`true` — луч летит сквозь монстров/ботов

Пример

local a = { 0, 0, 0 }
local b = { 100, 0, 0 }
local t = ents.trace_line(a, b)
if t.kind ~= "none" then
	print(t.classname, t.distance)
end

В отличие от p:trace — который стреляет из глаз игрока — здесь оба конца луча произвольные: ничьи глаза не нужны. Годится для эффектов, самодельных снарядов, проверки прямой видимости между двумя сущностями.

Смотри также

ents.trace_hull

То же самое, что ents.trace_line, но толкает объём, а не бесконечно тонкий луч.

ents.trace_hull(a, b[, opts])

Аргументы

#	имя	тип
1	`a`	table	точка старта, `{x, y, z}`
2	`b`	table	точка конца, `{x, y, z}`
3	`opts`	table \| nil	опции `ents.trace_line`, плюс `hull`

Возвращает

тип
`table`	что попалось — тот же формат, что у p:trace

Опция hull

поле	тип
`0`	number	точка — то же самое, что `trace_line`
`1`	number	стоящий игрок (по умолчанию)
`2`	number	крупный объём
`3`	number	голова, для приседа

Пример

local t = ents.trace_hull({ 0, 0, 0 }, { 0, 0, -100 }, { hull = 1 })

Тем же движковым вызовом (TRACE_HULL) пользуется sv.hull_free — только там объём нулевой длины и результат сведён к да/нет; здесь — полный трейс вдоль пути.

Смотри также

ents.trace_line

Документация

Справочник API

ents — Пространство имён

Пространство имён

ents.create

Аргументы

Возвращает

Пример

ents.find

Аргументы

Возвращает

ents.in_sphere

Аргументы

Возвращает

ents.trace_line

Аргументы

Возвращает

Опции

Пример

Смотри также

ents.trace_hull

Аргументы

Возвращает

Опция hull

Пример

Смотри также

​Пространство имён

​ents.create

​Аргументы

​Возвращает

​Пример

​ents.find

​Аргументы

​Возвращает

​ents.in_sphere

​Аргументы

​Возвращает

​ents.trace_line

​Аргументы

​Возвращает

​Опции

​Пример

​Смотри также

​ents.trace_hull

​Аргументы

​Возвращает

​Опция hull

​Пример

​Смотри также

Пространство имён

ents.create

Аргументы

Возвращает

Пример

ents.find

Аргументы

Возвращает

ents.in_sphere

Аргументы

Возвращает

ents.trace_line

Аргументы

Возвращает

Опции

Пример

Смотри также

ents.trace_hull

Аргументы

Возвращает

Опция hull

Пример

Смотри также