ents — Объект сущности

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

Объект сущности

e.index

Индекс edict’а.

e.index

Возвращает

тип
number	индекс в таблице edict’ов

Поле, а не метод. Годится ключом в своих таблицах.

e:origin

Читает или задаёт позицию сущности.

e:origin([x, y, z])

Аргументы

#	имя	тип
1	x, y, z	number	новая позиция; без них метод читает

Возвращает

тип
number, number, number	координаты

Запись идёт через движок и перелинковывает сущность в мире; присваивание pev->origin напрямую оставило бы её сталкиваться там, где она была.

Объект от удалённой сущности — или переживший changelevel — бросает entity #N is gone. Проверяй e:valid().

e:angles

Читает или задаёт поворот сущности.

e:angles([x, y, z])

Аргументы

#	имя	тип
1	x, y, z	number	новые углы; без них метод читает

Возвращает

тип
number, number, number	углы

Объект от удалённой сущности — или переживший changelevel — бросает entity #N is gone. Проверяй e:valid().

e:model

Читает или задаёт модель сущности.

e:model([path])

Аргументы

#	имя	тип
1	path	string | nil	путь к модели; без него метод читает

Возвращает

тип
string	текущая модель

Модель обязана быть предкэширована через res.model. Не предкэшированная стоит серверу ошибки, а сущность рисуется ничем.

Объект от удалённой сущности — или переживший changelevel — бросает entity #N is gone. Проверяй e:valid().

e:classname

Classname сущности.

e:classname()

Возвращает

тип
string	classname

Объект от удалённой сущности — или переживший changelevel — бросает entity #N is gone. Проверяй e:valid().

e:valid

Жива ли сущность.

e:valid()

Возвращает

тип
boolean	false, если сущность удалена или осталась с прошлой карты

Пример

if e:valid() then
	e:remove()
end

Единственный метод, который отвечает, а не бросает ошибку. Всё, что переживает раунд или смену карты, проверяй им.

e:spawn

Запускает Spawn сущности.

e:spawn()

Возвращает

Ничего.

Именно это превращает голый edict в объект с хитбоксом и think-функцией. Вызывать после того, как выставлены модель и позиция.

Объект от удалённой сущности — или переживший changelevel — бросает entity #N is gone. Проверяй e:valid().

e:remove

Убирает сущность из мира.

e:remove()

Возвращает

Ничего.

На уже удалённой сущности ошибкой не является и ничего не делает.

e:detonate_on_touch

Следующее касание сразу запускает think сущности.

e:detonate_on_touch()

Возвращает

Ничего.

Пример

hook.add("grenade:thrown", "myplugin.instant", function(e)
	if e.entity then
		e.entity:detonate_on_touch()
	end
end)

Одноразово: при первом касании чего угодно — стены, пола, игрока — движок на следующем кадре сам вызовет think сущности, вместо того чтобы ждать её обычный таймер. Для брошенной гранаты это и есть «взрыв при попадании»: ExplodeHeGrenade/ExplodeSmokeGrenade — это и есть её think, только случившийся сразу, а не через несколько секунд.

Не колбэк: Lua не узнаёт, что было касание, и не может решить, стоило ли его ловить — только форсирует то, что сущность и так должна была сделать рано или поздно. Для гранаты это ровно то, что нужно; для чего-то с другим think эффект будет другим.

Объект от удалённой сущности — или переживший changelevel — бросает entity #N is gone. Проверяй e:valid().

Смотри также

• grenade:thrown
• grenade:explode

e:keyvalue

Задаёт keyvalue — то же, что делает карта.

e:keyvalue(key, value)

Аргументы

#	имя	тип
1	key	string	имя, например targetname
2	value	string	значение

Возвращает

тип
boolean	приняла ли игра это поле

Пример

e:keyvalue("targetname", "door1")

Всё, что дизайнер уровня выставляет на сущности в редакторе, доступно отсюда.

Только до e:spawn(): значения читает именно Spawn.

e:solid

Читает или задаёт тип столкновений.

e:solid([value])

Аргументы

#	имя	тип
1	value	number | nil	без него метод читает

Возвращает

тип
number	текущее значение

Значения

поле	тип
0	number	не сталкивается ни с чем
1	number	триггер: срабатывает на касание, но не мешает
2	number	ограничивающий параллелепипед
3	number	skid box, как у игрока
4	number	brush-модель из карты

e:spawn() может выставить своё значение: у многих classname Spawn задаёт solid сам. Ставь после спавна, если важно.

e:movetype

Читает или задаёт, как движок двигает сущность.

e:movetype([value])

Аргументы

#	имя	тип
1	value	number | nil	без него метод читает

Возвращает

тип
number	текущее значение

Частые значения

поле	тип
0	number	не двигается
4	number	летит, гравитации нет
5	number	падает и лежит — дроп предмета
6	number	толкает, как дверь
8	number	отскакивает, как граната
10	number	следует за другой сущностью

e:size

Читает или задаёт ограничивающий объём.

e:size([minx, miny, minz, maxx, maxy, maxz])

Аргументы

#	имя	тип
1	minx..maxz	number	углы объёма; без них метод читает

Возвращает

тип
number × 6	два угла

Пример

e:size(-16, -16, 0, 16, 16, 72)

Из этого и e:solid(1) получается зона-триггер. Запись идёт через движок и перелинковывает сущность: присваивание напрямую оставило бы её со старым объёмом.

e:render

Читает или задаёт прозрачность и свечение.

e:render([opts])

Аргументы

#	имя	тип
1	opts	table | nil	без него метод читает

Возвращает

тип
table	{ mode =, amount =, color =, fx = }

Опции

поле	тип
mode	number	0 обычно, 2 прозрачность по amount, 5 аддитивно
amount	number	0..255, насколько видно
color	table	{ r, g, b }
fx	number	эффект: пульсация, мерцание

Пример

e:render({ mode = 2, amount = 128, color = { 255, 0, 0 } })

Таблица опций, а не пять чисел подряд: который из них renderfx, никто не помнит.

e:render_for

То же самое, что e:render(), но только для одного игрока — остальные видят сущность как обычно.

e:render_for(player[, opts])

Аргументы

#	имя	тип
1	player	player | number	кому
2	opts	table | nil	без него метод читает

Возвращает

тип
table | nil	{ mode =, amount =, color =, fx = }, nil — нет override для этого игрока

Опции

поле	тип
mode	number	как у e:render()
amount	number	0..255
color	table	{ r, g, b }
fx	number	эффект

Пример

-- невидим для конкретного зрителя, для остальных — как обычно
e:render_for(hunter, { mode = 4, amount = 0 })

Поле, которого нет в opts, остаётся тем, что уже было в этом override — а при первой установке берётся из обычного e:render() сущности. Работает только через pfnAddToFullPack — движок собирает копию сущности отдельно на каждого клиента, и только тут возможна разница между зрителями. Обычные entvars (то, что меняет e:render()) — одно значение на сущность, разлетается всем одинаково.

Смотри также

• e:render
• e:clear_render_for
• e:visible_to

e:clear_render_for

Убирает override, поставленный e:render_for()/e:visible_to().

e:clear_render_for(player)

Аргументы

#	имя	тип
1	player	player | number	кому

Возвращает

Ничего.

Игрок снова видит сущность как обычно.

Смотри также

• e:render_for

e:visible_to

Делает сущность видимой или невидимой для одного игрока.

e:visible_to(player, visible)

Аргументы

#	имя	тип
1	player	player | number	кому
2	visible	boolean	false — спрятать

Возвращает

Ничего.

Пример

hook.add("round:start", "furrien.hide", function()
	for _, hunter in ipairs(players.list{ team = "ct" }) do
		for _, prey in ipairs(players.list{ team = "t" }) do
			-- hunter не видит prey, все остальные видят как обычно
			prey:visible_to(hunter, false)
		end
	end
end)

Частый случай e:render_for(): visible_to(p, false) то же самое, что render_for(p, { mode = 4, amount = 0 }); visible_to(p, true) то же самое, что clear_render_for(p).

Смотри также

• e:render_for

e:pev

Читает или задаёт произвольное поле entvars_t по имени — то, для чего нет готового метода вроде e:origin() или e:solid().

e:pev(name[, v...])

Аргументы

#	имя	тип
1	name	string	имя поля, как в entvars_t: health, v_angle, iuser1, …
2	v...	number | string | entity | nil	новое значение; без него метод читает

Возвращает

тип
число (int/float)	одно число
вектор	три числа x, y, z
строка	строка
сущность (owner, aiment, enemy, …)	entity | nil

Пример

e:pev("health", 1)                -- то же, что и любой другой setter
local x, y, z = e:pev("origin")   -- то же, что e:origin()
e:pev("owner", other_entity)
e:pev("owner", nil)               -- снимает владельца

Имена — буквально из entvars_t (progdefs.h), без переименований: плагин, портируемый с fakemeta, не требует таблицы соответствий. Полей нет для controller/blending (байтовые массивы) — если понадобятся, это будет отдельным методом.

Неизвестное имя поля бросает ошибку, а не возвращает nil — опечатка в имени поля ловится сразу, а не где-то в логике плагина.

Объект от удалённой сущности — или переживший changelevel — бросает entity #N is gone. Проверяй e:valid().

Смотри также

• p:pev