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

Сущности: дропы, точки интереса, зоны, маркеры

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

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	массив сущностей, пустой если ничего нет

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

ents.in_sphere

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

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

Аргументы

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

Возвращает

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

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

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

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 — который стреляет из глаз игрока — здесь оба конца луча произвольные: ничьи глаза не нужны. Годится для эффектов, самодельных снарядов, проверки прямой видимости между двумя сущностями.

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

Смотри также

• ents.trace_hull
• p:trace
• p:trace_to

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 — только там объём нулевой длины и результат сведён к да/нет; здесь — полный трейс вдоль пути.

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

Смотри также

• ents.trace_line