Функции скрипта a_player.inc

AllowPlayerTeleport

Включает/выключает возможность игроку телепортироваться в любую точку мира отметкой на карте.

(playerid, allow)

playerid	ID игрока.
allow	1 - включить, 0 - выключить.

AllowPlayerTeleport(playerid,1);

DisablePlayerCheckpoint

Отключить инициализированнные контрольные точки для игрока, в одно и тоже время игор может иметь тольку одну контрольную точку.

(playerid)

playerid

ID игрока, для которого отключить текущую конотрольную точку.

DisablePlayerCheckpoint(playerid);

DisablePlayerRaceCheckpoint

Отключить гоночный чекпойнт для игрока.

(playerid)

playerid

ID игрока, для которого отключить текущую конотрольную точку.

DisablePlayerRaceCheckpoint(playerid);

GetPlayerAmmo

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

(playerid)

playerid	ID игрока.
Возвращает	Количество патронов.

new ammo = GetPlayerAmmo(playerid);

GetPlayerArmour

Узнает количество брони игрока и записывает его в переменнную armour.

(playerid,&Float:armour)

playerid	ID игрока.
&Float:armour	Переменная, в которую нужно записать количество брони.

GetPlayerArmour(playerid, armour);

GetPlayerColor

Эта функция возвращает текущий цвет игрока.

(playerid)

playerid	ID игрока, цвет которого вы хотите знать.
Возвращает	Цвет игрока в виде целого числа.

new playerColor = GetPlayerColor(playerid);

GetPlayerFacingAngle

Получает угол поворота текущего вида игрока. Это удобно, например, когда вы создаете систему наблюдения за игроком.

(playerid,&Float:ang)

playerid	ID игрока, угол которого вы хотите знать.
&Float:ang	Переданная по ссылке переменная, в которую записывается угол.

GetPlayerFacingAngle(playerid, angle);

GetPlayerHealth

Получает текущее здоровье игрока. Это может прекрасно использоваться, например, для обнаружения читов.

(playerid,&Float:health)

playerid	ID игрока, здоровье которого вы хотите знать.
&Float:health	Переданная по ссылке переменная, в которую записывается здоровье игрока.

GetPlayerHealth(playerid, health);

GetPlayerInterior

Узнает ID интериора, в котором находится игрок.

(playerid)

playerid	ID игрока.
Возвращает	ID интериора, в котором находится игрок.

new interior = GetPlayerInterior(playerid);

GetPlayerIp

Узнает IP-адрес игрока и записывает его в строку.

(playerid, name[], len)

playerid	ID игрока.
name[]	Строка, в которую необходимо записать IP игрока.

len	Длина этой строки.

GetPlayerIp(playerid, playerip, sizeof(playerip));

GetPlayerMoney

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

(playerid)

playerid	ID игрока, количество денег которого вы хотите знать.
Возвращает	Количество денег, которыми обладает игрок на данный момент.

new playerMoney = GetPlayerMoney(playerid);

GetPlayerName

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

(playerid,const name[],len)

playerid	ID игрока.
const name[]	Переданная по ссылке переменная, в которую записывается имя.

len	Число ячеек, которое будет присвоено переменной.

GetPlayerName(playerid, playername, MAX_PLAYER_NAME);

GetPlayerPing

Узнает пинг игрока.

(playerid)

playerid	ID игрока.
Возвращает	Пинг игрока.

new ping = GetPlayerPing(playerid);

GetPlayerPos

Получает текущую позицию игрока и сохранить ее в переменных, указанный в трех последующих аргументах.

(playerid,&Float:x,&Float:y,&Float:z)

playerid	ID игрока.
&Float:x	Переданная по ссылке переменная, в которую записывается x-координата.

&Float:y	Переданная по ссылке переменная, в которую записывается y-координата.
&Float:z	Переданная по ссылке переменная, в которую записывается z-координата.

GetPlayerPos(playerid, x, y, z);

GetPlayerScore

Получает счет (число очков), которые имеются у игрока на данным момент, которые могут быть заданы функцией SetPlayerScore().

(playerid)

playerid	ID игрока.
Возвращает	Текущий счет игрока.

new playerScore = GetPlayerScore(playerid);

GetPlayerSkin

Узнает, ID скина, который сейчас использует игрок.

(playerid)

playerid	ID игрока.
Возвращает	ID скина.

new playerskin = GetPlayerSkin(playerid);

GetPlayerState

Получает текущее состояние игрока, для проверки, управляет ли он транспортом, или идет пешком, или все еще помещается в стартовую позицию, и т.д.

(playerid)

playerid	ID игрока, состояние которого выясняется.
Возвращает	Текущее состояние игрока.

new playerState = GetPlayerState(playerid);

GetPlayerTeam

Получает ID команды, в которой состоит игрок на данный момент. Используется, например, для балансирования команд.

(playerid)

playerid	ID игрока.
Возвращает	Текущая команда игрока.

new playerTeam = GetPlayerTeam(playerid);

GetPlayerTime

Узнает игровое время игрока (в правом верхнем углу экрана).

(playerid, &hour, &minute)

playerid	ID игрока.
&hour	Записывается время (часы).

&minute

Записывается время (минуты).

GetPlayerTime(playerid, hr, min);

GetPlayerVehicleID

Получает ID транспорта, которым управляет игрок в данный момент. Она не возвращает ID модели транспорта.

(playerid)

playerid	ID игрока.
Возвращает	ID транспорта, которым управляет игрок в данный момент.

new playerVehicle = GetPlayerVehicleID(playerid);

GetPlayerVirtualWorld

Узнает ID виртуального мира, в котором находится игрок с данным ID.

(playerid)

playerid	ID игрока.
Возвращает	ID мира, в котором находится игрок.

GetPlayerWantedLevel

Узнает уровень разыскиваемости игрока (звездочки на экране).

(playerid)

playerid	ID игрока.
Возвращает	Уровень розыска (кол-во звезд).

new level = GetPlayerWantedLevel(playerid);

GetPlayerWeapon

Узнает ID оружия, которое игрок сейчас держит в руках.

(playerid)

playerid	ID игрока.
Возвращает	ID оружия.

new weapon = GetPlayerWeapon(playerid);

GetPlayerWeaponData

Узнает информацию об оружие и количестве патронов в конкретном слоте игрока брони игрока.

(playerid, slot, &weapons, &ammo)

playerid	ID игрока.
slot	Слот оружия, информацию о котором нужно получить (0-12).

&weapons	Переменная, в которую нужно записать ID оружия в данном слоте.
&ammo	Переменная, в которую нужно записать количество патронов в данном слоте.

GetPlayerWeaponData(playerid, 7, weapons, ammo);