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

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().

Смотри также

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: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

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

​e.index

​Возвращает

​e:origin

​Аргументы

​Возвращает

​e:angles

​Аргументы

​Возвращает

​e:model

​Аргументы

​Возвращает

​e:classname

​Возвращает

​e:valid

​Возвращает

​Пример

​e:spawn

​Возвращает

​e:remove

​Возвращает

​e:detonate_on_touch

​Возвращает

​Пример

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

​e:keyvalue

​Аргументы

​Возвращает

​Пример

​e:solid

​Аргументы

​Возвращает

​Значения

​e:movetype

​Аргументы

​Возвращает

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

​e:size

​Аргументы

​Возвращает

​Пример

​e:render

​Аргументы

​Возвращает

​Опции

​Пример

​e:render_for

​Аргументы

​Возвращает

​Опции

​Пример

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

​e:clear_render_for

​Аргументы

​Возвращает

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

​e:visible_to

​Аргументы

​Возвращает

​Пример

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

​e:pev

​Аргументы

​Возвращает

​Пример

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

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

e.index

Возвращает

e:origin

Аргументы

Возвращает

e:angles

Аргументы

Возвращает

e:model

Аргументы

Возвращает

e:classname

Возвращает

e:valid

Возвращает

Пример

e:spawn

Возвращает

e:remove

Возвращает

e:detonate_on_touch

Возвращает

Пример

Смотри также

e:keyvalue

Аргументы

Возвращает

Пример

e:solid

Аргументы

Возвращает

Значения

e:movetype

Аргументы

Возвращает

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

e:size

Аргументы

Возвращает

Пример

e:render

Аргументы

Возвращает

Опции

Пример

e:render_for

Аргументы

Возвращает

Опции

Пример

Смотри также

e:clear_render_for

Аргументы

Возвращает

Смотри также

e:visible_to

Аргументы

Возвращает

Пример

Смотри также

e:pev

Аргументы

Возвращает

Пример

Смотри также