Функции скрипта 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);

GivePlayerMoney

Эта функция позволяет Вам либо дать, либо отнять у игрока деньги. Если игроку дать отрицательное число денег, то количество его денег уменьшиться.

(playerid,money)

playerid	ID игрока.
money	Число денег, которые вы хотите дать/отнять.

GivePlayerMoney(playerid, 10000);

GivePlayerWeapon

Дает игроку указанное оружие, вы можете указать, какое оружие и сколько аммуниции должен получить игрок.

(playerid,weaponid,ammo)

playerid	ID игрока.
weaponid	ID оружия, даваемого игроку.

ammo	Количестов аммуниции, даваемое игроку вместе с оружием.

GivePlayerWeapon(playerid, 26, 250);

IsPlayerAdmin

Определяет, вошел ли игрок с rcon-функциями.

(playerid)

playerid	ID игрока.
Возвращает	1, если игрок - админ, 0,если нет.

if(IsPlayerAdmin(playerid)){

IsPlayerConnected

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

(playerid)

playerid	ID игрока.
Возвращает	1, если он подключен, 0, если нет.

if(IsPlayerConnected(playerid)){

IsPlayerInAnyVehicle

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

(playerid)

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

if(IsPlayerInAnyVehicle(playerid)){

IsPlayerInCheckpoint

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

(playerid)

playerid	ID игрока.
Возвращает	1, если игрок внутри контрольной точки, 0, если нет.

if(IsPlayerInCheckpoint(playerid)){

IsPlayerInRaceCheckpoint

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

(playerid)

playerid	ID игрока.
Возвращает	1, если игрок в гоночном чекпойнте, 0, если нет.

if(IsPlayerInRaceCheckpoint(playerid)){

IsPlayerInVehicle

Проверяет, находится ли игрок в указанном транспорте в данный момент. Запомните, вы должны использовать ID транспорта, а не ID модели транспорта!

(playerid,vehicleid)

playerid	ID игрока.
vehicleid	ID транспорта.

Возвращает

1, если игрок в этом транспорте, 0, если нет.

if(IsPlayerInVehicle(playerid, 32)){

PlayerPlaySound

Эта функция воспроизводит звук для игрока. Звуки могут быть добавлены для некоторых замечательных эффектов, но доступно лишь несколько звуков, потому тчо вы не можете загрузить никакие экстра-звуки.

Важное замечание: x/y/z-координаты, видимо, не оказывают большого влияния на звук.

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

playerid	ID игрока.
soundid	ID звука.

Float:x	X-координата места, где надо проиграть звук.
Float:y	Y-координата места, где надо проиграть звук.

Float:z

Z-координата места, где надо проиграть звук.

PlayerPlaySound(playerid, 1025, 0.0, 0.0, 0.0);

PutPlayerInVehicle

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

Важное замечание: Эта функция НЕ работает со всеми игроками за исключением игрока с ID, равным 0.

(playerid,vehicleid,seatid)

playerid	ID игрока.
vehicleid	ID транспорта.

seatid

ID сиденья.

PutPlayerInVehicle(playerid, 0, 1);

RemovePlayerFromVehicle

Эта функция вытаскивает игрока из транспорта. Запомните, что вызываемая функция OnPlayerExitVehicle не сработает!

(playerid)

playerid

ID игрока.

RemovePlayerFromVehicle(playerid);

RemovePlayerMapIcon

Удаляет иконку на карте игрока.

(playerid, iconid)

playerid	ID игрока.
playerid	ID иконки.

ResetPlayerMoney

Сбрасывает деньги, которые имеются у игрока. Это может быть использовано при создании команды SetPlayerMoney.

(playerid)

playerid

ID игрока.

ResetPlayerMoney(playerid);

ResetPlayerWeapons

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

(playerid)

playerid

ID игрока.

ResetPlayerWeapons(playerid);

SetCameraBehindPlayer

Восстановить камеру на место позади игрока после использования функций, подобных SetPlayerCameraPos.

Важное замечание: Эта функция работает только тогда, когда игрок еще не поместился в стартовую позицию. Используется в OnPlayerSpawn, например.

(playerid)

playerid

ID игрока.

SetCameraBehindPlayer(playerid);

SetPlayerAmmo

Установить для игрока количество патронов в данном слоте.

(playerid, weaponslot, ammo)

playerid	ID игрока.
weaponslot	Номер слота.

ammo	Количество оружия.

SetPlayerAmmo(playerid, 8, 150);

SetPlayerArmour

Устанавливает количество брони для игрока.

(playerid,Float:armour)

playerid	ID игрока.
Float:armour	Количество брони.

SetPlayerArmour(playerid, 100.0);

SetPlayerCameraLookAt

Устанавливает направление и место, куда будет смотреть камера игрока. Вам следует использовать ее в комбинации с SetPlayerCameraPos.

Важное замечание: Вам придется использовать функцию SetCameraBehindPlayer для восстановления камеры игрока.

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

playerid	ID игрока.
Float:x	X-координата, куда будет смотреть камера.

Float:y	Y-координата, куда будет смотреть камера.
Float:z	Z-координата, куда будет смотреть камера.

SetPlayerCameraLookAt(playerid, 324.34, 54.122. -173.35);

SetPlayerCameraPos

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

Важное замечание: Вам придется использовать функцию SetCameraBehindPlayer для восстановления камеры игрока.

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

playerid	ID игрока.
Float:x	Новая x-координата камеры.

Float:y	Новая y-координата камеры.
Float:z	Новая z-координата камеры.

SetPlayerCameraPos(playerid, 652.23, 457.21, 10.84);

SetPlayerCheckpoint

Установить текущую контрольную точку для игрока. В один и тот же момоент времени вы можете использовать только одну контрольную точку, вам следует использовать DisablePlayerCheckpoint, чтобы сначала уничтожить предыдущую.

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

playerid	ID игрока.
Float:x	X-координата для новой контрольной точки.

Float:y	Y-координата для новой контрольной точки.
Float:z	Z-координата для новой контрольной точки.

Float:size

Размер контрольной точки.

SetPlayerCheckpoint(playerid, 354.12, 932.12, 19.34, 2.0);

SetPlayerColor

Эта функция позволяет Вам изменить текущий цвет игрока.

(playerid,color)

playerid	ID игрока.
color	Новый цвет игрока, целое число.

SetPlayerColor(playerid, 0xFFFF00AA);

SetPlayerColor(playerid, 4294901930);

SetPlayerFacingAngle

Устанавливает текущий угол поворота игрока.

(playerid,Float:ang)

playerid	ID игрока.
Float:ang	Новый угол поворота игрока.

SetPlayerFacingAngle(playerid, 90.0);

SetPlayerHealth

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

(playerid,Float:health)

playerid	ID игрока.
Float:health	Новое здоровье, вещественное число.

SetPlayerHealth(playerid, 95.0);

SetPlayerInterior

Изменяет текущее местоположение игрока. Список всех известных на данный момент мест и их позиции можно найти ID интерьеров.

(playerid,interiorid)

playerid	ID игрока.
interiorid	ID нового места (или Universe ID) игрока.

SetPlayerInterior(playerid, 0);

SetPlayerMapIcon

Устанавливает для игрока иконку на радаре и карте.

(playerid, iconid, Float:x, Float:y, Float:z, markertype, color)

playerid	ID игрока.
iconid	ID для данной иконки.

Float:x	X-координата для положения иконки.
Float:y	Y-координата для положения иконки.

Float:z	Z-координата для положения иконки.
markertype	Тип (модель) иконки.

color

Цвет иконки.

SetPlayerMarkerForPlayer

Установить отображение маркера игрока на карте для другого игрока.

(playerid, showplayerid, color)

playerid	ID игрока.
showplayerid	ID игрока, которому нужно показать маркер.

color

Цвет маркера.

SetPlayerMarkerForPlayer(playerid, 0, COLOR_GREEN);

SetPlayerName

Меняет имя игрока.

(playerid, const name[])

playerid	ID игрока.
const name[]	Новое имя игрока.

SetPlayerName(playerid, "[NoTeam]Player");

SetPlayerPos

Изменяет позицию игрока на другую позицию на карте.

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

playerid	ID игрока.
Float:x	X-координата для новой позиции игрока.

Float:y	Y-координата для новой позиции игрока.
Float:z	Z-координата для новой позиции игрока.

SetPlayerPos(playerid, 34.236, 934.323, 12.345);

SetPlayerRaceCheckpoint

Устанавливает гоночный чекпойнт для игрока.

(playerid, type, Float:x, Float:y, Float:z, Float:nextx, Float:nexty, Float:nextz, Float:size)

playerid	ID игрока.
type	Тип гоночного чекпойнта.

Float:x	X-координата для чекпойнта.
Float:y	Y-координата для чекпойнта.

Float:z	Z-координата для чекпойнта.
Float:nextx	X-координата точки, на которую будет "смотреть" стрелка чекпойнта.

Float:nexty	Y-координата точки, на которую будет "смотреть" стрелка чекпойнта.
Float:nextz	Z-координата точки, на которую будет "смотреть" стрелка чекпойнта.

Float:size

Размер контрольной точки.

SetPlayerCheckpoint(playerid, 354.12, 932.12, 19.34, 368.4, 898.2, 19.5, 2.0);

SetPlayerScore

Обновляет счет игрока до другого значения.

(playerid,score)

playerid	ID игрока.
score	Новый счет игрока.

SetPlayerScore(playerid, 10000);

SetPlayerSkin

Изменяет скин игрока. Вам следует проверить в General Referance на форумах, может ли использоваться скин, так как некоторые скины могут привести к вылету игры.

Важное замечание: Этот игрок может привести к вылету Вашей игры!

(playerid,skinid)

playerid	ID игрока.
skinid	ID нового скина для игрока.

SetPlayerSkin(playerid, 121);

SetPlayerTeam

Используйте эту функцию для изменения команды игрока. Игроки одной команды не смогут навредить друг другу.

(playerid,teamid)

playerid	ID игрока.
teamid	ID команды, членом которой станет игрок.

SetPlayerTeam(playerid, TEAM_BALLAS);

SetPlayerTime

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

(playerid, hour, minute)

playerid	ID игрока.
hour	Время (часы).

minute

Время (минуты).

SetPlayerTime(playerid, 18, 30);

SetPlayerVirtualWorld

Перемещает игрока в виртуальный мир с данным ID.

(playerid, worldid)

playerid	ID игрока.
playerid	ID мира, в который нужно переместить игрока.

SetPlayerVirtualWorld(playerid,1);

SetPlayerWantedLevel

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

(playerid, level)

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

SetPlayerWantedLevel(playerid, 6);

SetPlayerWeather

Установить погоду для отдельного игрока.

(playerid, weather)

playerid	ID игрока.
weather	ID погоды.

SetPlayerWeather(playerid, 14);

SetPlayerWorldBounds

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

(playerid,Float:x_max,Float:x_min,Float:y_max,Float:y_min)

playerid	ID игрока.
Float:x_max	Макс. x-координата того, куда игрок может попасть.

Float:x_min	Мин. x-координата того, куда игрок может попасть.
Float:y_max	Макс. y-координата того, куда игрок может попасть.

Float:y_min

Мин. y-координата того, куда игрок может попасть.

SetPlayerWorldBounds(playerid, 20.0, 0.0, 20.0, 0.0);

ShowPlayerNameTagForPlayer

Позволяет включить/выключить отображение имени игрока для другого игрока.

(playerid, showplayerid, show)

playerid	ID игрока.
showplayerid	ID игрока, которому нужно показать имя.

show	1 - показывать, 0 - не показывать.

SetPlayerWeather(playerid, 0, 1);

SpawnPlayer

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

(playerid)

playerid

ID игрока.

SpawnPlayer(playerid);

TogglePlayerControllable

Эта функция позволяет Вам включать/выключать разрешение двигаться для игрока. Используется для замораживания игроков, которых Вы подозреваете в читерстве, например.

(playerid,moveable)

playerid	ID игрока.
moveable	true - игрок сможет двигаться, false - не сможет.

TogglePlayerControllable(playerid, 0);

SetPlayerPosFindZ

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

GetPlayerKeys

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

(playerid, &keys, &updown, &leftright)

TogglePlayerClock

Позволяет включать/выключать игровые часы у игрока.

(playerid, toggle)

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

TogglePlayerClock(playerid, 1);

SetPlayerDisabledWeapons

(playerid,...)

Дата добавления: 2015-10-29