cmd

Команды чата, серверной консоли и rcon. Одна регистрация покрывает чат (!name, /name), консоль и rcon.

cmd.add

Регистрирует команду.

cmd.add(name, fn[, opts])

Аргументы

#	имя	тип
1	`name`	string	имя без префикса
2	`fn`	function	получает `ctx`
3	`opts`	table \| nil	см. Опции

Возвращает

Ничего.

Опции

поле	тип
`source`	string \| table	`console`, `chat`, `chat_team`; список или ничего — везде
`perm`	string	нода прав, проверяется до вызова обработчика
`target`	number	номер аргумента с именем игрока → `ctx.target`
`immunity`	boolean	`false` отключает проверку иммунитета при `target`

Пример

cmd.add("heal", function(ctx)
	local p = ctx.player
	if p then p:health(p:health() + 25) end
	ctx.reply("healed")
end)

cmd.add("kick",  fn, { source = "console" })
cmd.add("plant", fn, { source = "chat_team" })
cmd.add("slay",  fn, { perm = "admin.slay", target = 1 })

ctx

поле	тип
`ctx.player`	player \| nil	`nil` для консоли и rcon
`ctx.args`	table	слова после имени команды
`ctx.name`	string	имя команды
`ctx.source`	string	`console`, `chat`, `chat_team`
`ctx.reply(text)`	function	ответ туда, откуда пришла команда
`ctx.target`	player	игрок из аргумента при `opts.target`
`ctx.can(node)`	function	проверить право вызвавшего

Распознанная чат-команда в общий чат не попадает. С target роутер сам находит игрока по слоту, #userid или части ника и отказывает, если у цели иммунитет не ниже.

У консоли и rcon прав нет — им разрешено всё. ctx.player там nil, и perm с immunity не проверяются.

Имя команды регистрируется в движке навсегда. lua_reload меняет только Lua-обработчик: если плагин не объявил команду заново, она становится пустышкой.

Смотри также

cmd.remove

Снимает команду.

cmd.remove(name)

Аргументы

#	имя	тип
1	`name`	string	имя команды

Возвращает

тип
`boolean`	`true`, если команда была

cmd.list

Возвращает имена зарегистрированных команд.

cmd.list()

Возвращает

тип
`table`	отсортированный массив строк

Документация

Справочник API

cmd

cmd

cmd.add

Аргументы

Возвращает

Опции

Пример

ctx

Смотри также

cmd.remove

Аргументы

Возвращает

cmd.list

Возвращает

​cmd

​cmd.add

​Аргументы

​Возвращает

​Опции

​Пример

​ctx

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

​cmd.remove

​Аргументы

​Возвращает

​cmd.list

​Возвращает

cmd

cmd.add

Аргументы

Возвращает

Опции

Пример

ctx

Смотри также

cmd.remove

Аргументы

Возвращает

cmd.list

Возвращает