Kick

Описание:

Удаляет игрока с сервера. Им придется выйти из игры и повторно подключиться, если они хотят продолжить игру.

Параметры:

(playerid)

playerid

ID игрока, которого нужно выкинуть.

Возвращаемые значения:

1 - эта функция всегда возвращает 1, даже если функция не была выполнена (указанный игрок не существует).

Баг SA-MP 0.3x

Любые действия, предпринятые непосредственно перед Kick() (например, отправка сообщения с помощью SendClientMessage), не будут применены к игроку. Для отсрочки бана необходимо использовать таймер с задержкой 200-1000 миллисекунд.

Пример использования:

public OnPlayerCommandText(playerid, cmdtext[])
{
	if(!strcmp(cmdtext, "/kickme", true))
	{
		// Кикает игрока, выполнившего эту команду
		Kick(playerid);
		return 1;
	}
	return 0;
}

// Чтобы отобразить сообщение (например, причину) для игрока перед закрытием соединения 
// вы должны использовать таймер для создания задержки. Эта задержка должна составлять всего несколько миллисекунд, 
// но в этом примере на всякий случай используется полная секунда.
public OnPlayerCommandText(playerid, cmdtext[])
{
	if(!strcmp(cmdtext, "/kickme", true)) // Кикает игрока, выполнившего эту команду
	{
		// Сначала отправьте ему сообщение
		SendClientMessage(playerid, 0xFF0000FF, "Вы были кикнуты!");
		// Таймер может быть с любым временем, рекомендуется от 200 мс.
		SetTimerEx("DelayedKick", 200, false, "i", playerid);
		return 1;
	}
	return 0;
}
forward DelayedKick(playerid);
public DelayedKick(playerid) return Kick(playerid);

Связанные функции

Следующие функции также могут быть полезны, поскольку они так или иначе связаны с рассматриваемой функцией.

Ban - забанить игрока на сервере.
BanEx - забанить игрока по индивидуальной причине.