players — Состояние

Пишется в entvars_t напрямую, ReGameDLL не нужен

Состояние

Пишется в entvars_t напрямую, ReGameDLL не нужен.

p:model

Моделька игрока.

p:model([path])

Аргументы

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

Возвращает

тип
number	текущую модельку при чтении; при записи ничего

Пример

p:model("models/player/urban/urban.mdl")

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

p:health

Здоровье игрока.

p:health([value])

Аргументы

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

Возвращает

тип
number	текущее значение при чтении; при записи ничего

Пример

p:health(p:health() + 25)

Обращение к состоянию отключённого игрока бросает ошибку. В таймерах и отложенных коллбэках проверяй p:connected().

p:armor

Броня игрока.

p:armor([value])

Аргументы

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

Возвращает

тип
number	текущее значение при чтении; при записи ничего

p:frags

Счётчик фрагов.

p:frags([value])

Аргументы

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

Возвращает

тип
number	текущее значение при чтении; при записи ничего

p:gravity

Множитель гравитации.

p:gravity([value])

Аргументы

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

Возвращает

тип
number	текущее значение при чтении; при записи ничего

1.0 — обычная, 0.5 — вдвое слабее.

Спавн сбрасывает значение. Ставь его в player_spawn, снимай в plugin.on_unload.

p:maxspeed

Максимальная скорость движения.

p:maxspeed([value])

Аргументы

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

Возвращает

тип
number	текущее значение при чтении; при записи ничего

p:origin

Позиция игрока в мире.

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

Аргументы

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

Возвращает

тип
number, number, number	три компоненты вектора

Запись телепортирует: проверки столкновений нет, игрока можно засунуть в стену.

p:angles

Поворот модели игрока.

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

Аргументы

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

Возвращает

тип
number, number, number	три компоненты вектора

p:velocity

Скорость игрока.

p:velocity([x, y, z])

Аргументы

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

Возвращает

тип
number, number, number	три компоненты вектора

p:aim

Направление взгляда, только чтение.

p:aim()

Возвращает

тип
number, number, number	три компоненты вектора

p:alive

Жив ли игрок.

p:alive()

Возвращает

тип
boolean	жив ли игрок

p:on_ground

Стоит ли игрок на земле.

p:on_ground()

Возвращает

тип
boolean	стоит ли игрок на земле

p:ducking

Сидит ли игрок.

p:ducking()

Возвращает

тип
boolean	сидит ли игрок

p:freeze

Заморозка движения (FL_FROZEN).

p:freeze([value])

Аргументы

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

Возвращает

тип
boolean	текущее значение при чтении; при записи ничего

Движковая заморозка. Обычный обходной путь p:maxspeed(1) оставляет клиент предсказывать движение, которого сервер не даёт — отсюда рывки.

p:godmode

Неуязвимость.

p:godmode([value])

Аргументы

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

Возвращает

тип
boolean	текущее значение при чтении; при записи ничего

p:noclip

Полёт сквозь стены.

p:noclip([value])

Аргументы

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

Возвращает

тип
boolean	текущее значение при чтении; при записи ничего

p:pev

Читает или задаёт произвольное поле entvars_t по имени — то же, что e:pev у сущностей, только на игроке.

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

Аргументы

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

Возвращает

тип
...	зависит от типа поля — см. e:pev

Пример

p:pev("iuser1", 1)                 -- своё поле под нужды плагина
local x, y, z = p:pev("v_angle")   -- то же, что p:aim()

Тот же список полей и та же диспетчеризация по типу, что у e:pev — оба метода читают ровно один и тот же entvars_t.

Обращение к состоянию отключённого игрока бросает ошибку. В таймерах и отложенных коллбэках проверяй p:connected().

Смотри также

• e:pev

p:trace

Пускает луч из глаз игрока туда, куда он смотрит.

p:trace([distance])

Аргументы

#	имя	тип
1	distance	number | nil	длина луча в юнитах, по умолчанию 8192

Возвращает

тип
table	что попалось, см. Результат

Результат

поле	тип
kind	string	player, entity, world, none
player	player	только при kind == "player"
classname	string	classname цели; нет при none
x, y, z	number	точка попадания; при none — конец луча
distance	number	юнитов от глаз до точки
hitgroup	number	1 — голова, 0 — тело

Пример

local t = p:trace()
if t.kind == "player" then
	p:chat(("%s, %d hp, %d юнитов"):format(t.player:name(), t.player:health(), t.distance))
end

p:trace_to

Пускает луч из глаз игрока прямо к другому игроку.

p:trace_to(other)

Аргументы

#	имя	тип
1	other	player	до кого трассировать

Возвращает

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

Пример

local t = p:trace_to(victim)
if t.kind == "player" and t.player.id == victim.id then
	-- прямая видимость есть, между ними ничего твёрдого
end

p:trace() отвечает «куда сейчас смотрит p»; этот — «есть ли что-то твёрдое между p и other». Разница важна там, где важна не текущая наводка, а сам факт видимости: разброс дроби или отдача уводят прицел в сторону от точки, куда реально попала пуля, так что трассировка по прицелу в момент попадания может соврать — трассировка прямо на цель нет.

Смотри также

• p:trace