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

Поиск игроков, рассылка и объект игрока

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

players.get

Возвращает игрока по номеру слота.

players.get(id)

Аргументы

#	имя	тип
1	id	number	номер слота, 1..32

Возвращает

тип
player | nil	nil, если слот пуст

players.list

Возвращает массив подключённых игроков.

players.list([filter])

Аргументы

#	имя	тип
1	filter	table | nil	см. Фильтр

Возвращает

тип
table	массив объектов игроков

Фильтр

поле	тип
alive	boolean	только живые или только мёртвые
team	string	CT, T, SPEC
bot	boolean	серверные боты (FL_FAKECLIENT) или только люди
hltv	boolean	HLTV-прокси (FL_PROXY) или без них
name	string	подстрока ника, регистр не важен

Пример

for _, p in ipairs(players.list{ alive = true, team = "CT" }) do
	p:chat("живой контр")
end

-- люди, не боты, с «kot» в нике
for _, p in ipairs(players.list{ bot = false, name = "kot" }) do
	print(p:name())
end

alive и team читают живое CS-состояние и требуют ReGameDLL. bot, hltv и name работают и на ванильном mp.dll. Без любого фильтра метод работает везде.

Права и группы (p:can, p:group) живут в core-слое, не в native. Их удобнее дописать в Lua:

for _, p in ipairs(players.list{ alive = true }) do
	if p:can("admin.slay") and not p:group("vip") then
		-- ...
	end
end

players.find

Ищет игрока по слоту, userid или части ника.

players.find(token)

Аргументы

#	имя	тип
1	token	string	см. Форматы

Возвращает

тип
player | nil	найденный игрок
string	причина, если не найден

Форматы

поле	тип
"3"	string	номер слота
"#12"	string	userid
"kotya"	string	часть ника, регистр не важен; совпадение должно быть одно

Пример

local target, why = players.find(ctx.args[1])
if not target then
	return ctx.reply(why)
end

Тот же поиск делает opts.target в cmd.add.

players.broadcast

Приёмник «всем сразу»: только отправка сообщений.

players.broadcast:chat(text[, opts])

Пример

players.broadcast:chat("{green}[Server]{default} раунд начался")
players.broadcast:play_sound("items/9mmclip1.wav")

Понимает те же методы отправки, что и обычный игрок: chat, console, center, hud, dhud, play_sound.

play_sound тут — один EMIT_SOUND от первого подключённого игрока, а не цикл по всем: EMIT_SOUND и так слышен всем, у кого PAS накрывает точку излучения, повторять его на каждого — значит дать части слушателей услышать один и тот же клип по два-три раза подряд.

Состояния у него нет: players.broadcast:alive() бросает ошибку с объяснением. Для чтения и записи состояния перебирай players.list().

players.method

Добавляет свой метод всем объектам игроков.

players.method(name, fn)

Аргументы

#	имя	тип
1	name	string	имя метода
2	fn	function	получает (self, ...)

Возвращает

Ничего.

Пример

players.method("playtime", function(self)
	return sessions[self.id] and sessions[self.id]:seconds() or 0
end)

Занятое имя переопределить нельзя — это то, что не даёт одному плагину подменить p:health() для всех остальных.