Scripting Functions (a player.inc)

From SA-MP Wiki

Jump to: navigation, search

Contents

AllowPlayerTeleport

Description:

Включает/выключает возможность игроку телепортироваться в любую точку мира отметкой на карте.
Parameters:
({{{1}}})
playeridID игрока.
allow1 - включить, 0 - выключить.
AllowPlayerTeleport(playerid,1);


DisablePlayerCheckpoint

Description:

Отключить инициализированнные контрольные точки для игрока, в одно и тоже время игрок может иметь только одну контрольную точку.
Parameters:
({{{1}}})
playeridID игрока, для которого отключить текущую конотрольную точку.
DisablePlayerCheckpoint(playerid);


DisablePlayerRaceCheckpoint

Description:

Отключить гоночный чекпойнт для игрока.
Parameters:
({{{1}}})
playeridID игрока, для которого отключить текущую конотрольную точку.
DisablePlayerRaceCheckpoint(playerid);


GetPlayerAmmo

Description:

Узнает, сколько патронов оружия, которое игрок сейчас держит в руках.
Parameters:
({{{1}}})
playeridID игрока.

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

Количество патронов.
new ammo = GetPlayerAmmo(playerid);


GetPlayerArmour

Description:

Узнает количество брони игрока и записывает его в переменнную armour.
Parameters:
({{{1}}})
playeridID игрока.
&Float:armourПеременная, в которую нужно записать количество брони.
GetPlayerArmour(playerid, armour);


GetPlayerColor

Description:

Эта функция возвращает текущий цвет игрока.
Parameters:
({{{1}}})
playeridID игрока, цвет которого вы хотите знать.

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

Цвет игрока в виде целого числа.
new playerColor = GetPlayerColor(playerid);


GetPlayerFacingAngle

Description:

Получает угол поворота текущего вида игрока. Это удобно, например, когда вы создаете систему наблюдения за игроком.
Parameters:
({{{1}}})
playeridID игрока, угол которого вы хотите знать.
&Float:angПереданная по ссылке переменная, в которую записывается угол.
GetPlayerFacingAngle(playerid, angle);


GetPlayerHealth

Description:

Получает текущее здоровье игрока. Это может прекрасно использоваться, например, для обнаружения читов.
Parameters:
({{{1}}})
playeridID игрока, здоровье которого вы хотите знать.
&Float:healthПереданная по ссылке переменная, в которую записывается здоровье игрока.
GetPlayerHealth(playerid, health);


GetPlayerInterior

Description:

Узнает ID интериора, в котором находится игрок.
Parameters:
({{{1}}})
playeridID игрока.

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

ID интериора, в котором находится игрок.
new interior = GetPlayerInterior(playerid);


GetPlayerIp

Description:

Узнает IP-адрес игрока и записывает его в строку.
Parameters:
({{{1}}})
playeridID игрока.
name[]Строка, в которую необходимо записать IP игрока.
lenДлина этой строки.
GetPlayerIp(playerid, playerip, sizeof(playerip));


GetPlayerMoney

Description:

Получает количество денег, которыми обладает игрок на данный момент. Эта функция может использоваться для обнаружения читов, покупок вещей и т.д.
Parameters:
({{{1}}})
playeridID игрока, количество денег которого вы хотите знать.

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

Количество денег, которыми обладает игрок на данный момент.
new playerMoney = GetPlayerMoney(playerid);


GetPlayerName

Description:

Получает имя игрока и сохраняет его в многоячеистой переменной, которую вы передаете в качестве второго аргумента.
Parameters:
({{{1}}})
playeridID игрока.
const name[]Переданная по ссылке переменная, в которую записывается имя.
lenЧисло ячеек, которое будет присвоено переменной.
GetPlayerName(playerid, playername, MAX_PLAYER_NAME);


GetPlayerPing

Description:

Узнает пинг игрока.
Parameters:
({{{1}}})
playeridID игрока.

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

Пинг игрока.
new ping = GetPlayerPing(playerid);


GetPlayerPos

Description:

Получает текущую позицию игрока и сохранить ее в переменных, указанный в трех последующих аргументах.
Parameters:
({{{1}}})
playeridID игрока.
&Float:xПереданная по ссылке переменная, в которую записывается x-координата.
&Float:yПереданная по ссылке переменная, в которую записывается y-координата.
&Float:zПереданная по ссылке переменная, в которую записывается z-координата.
GetPlayerPos(playerid, x, y, z);


GetPlayerScore

Description:

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

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

Текущий счет игрока.
new playerScore = GetPlayerScore(playerid);


GetPlayerSkin

Description:

Узнает, ID скина, который сейчас использует игрок.
Parameters:
({{{1}}})
playeridID игрока.

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

ID скина.
new playerskin = GetPlayerSkin(playerid);


GetPlayerState

Description:

Получает текущее состояние игрока, для проверки, управляет ли он транспортом, или идет пешком, или все еще помещается в стартовую позицию, и т.д.
Parameters:
({{{1}}})
playeridID игрока, состояние которого выясняется.

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

Текущее состояние игрока.
new playerState = GetPlayerState(playerid);


GetPlayerTeam

Description:

Получает ID команды, в которой состоит игрок на данный момент. Используется, например, для балансирования команд.
Parameters:
({{{1}}})
playeridID игрока.

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

Текущая команда игрока.
new playerTeam = GetPlayerTeam(playerid);


GetPlayerTime

Description:

Узнает игровое время игрока (в правом верхнем углу экрана).
Parameters:
({{{1}}})
playeridID игрока.
&hourЗаписывается время (часы).
&minuteЗаписывается время (минуты).
GetPlayerTime(playerid, hr, min);


GetPlayerVehicleID

Description:

Получает ID транспорта, которым управляет игрок в данный момент. Она не возвращает ID модели транспорта.
Parameters:
({{{1}}})
playeridID игрока.

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

ID транспорта, которым управляет игрок в данный момент.
new playerVehicle = GetPlayerVehicleID(playerid);


GetPlayerVirtualWorld

Description:

Узнает ID виртуального мира, в котором находится игрок с данным ID.
Parameters:
({{{1}}})
playeridID игрока.

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

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


GetPlayerWantedLevel

Description:

Узнает уровень разыскиваемости игрока (звездочки на экране).
Parameters:
({{{1}}})
playeridID игрока.

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

Уровень розыска (кол-во звезд).
new level = GetPlayerWantedLevel(playerid);


GetPlayerWeapon

Description:

Узнает ID оружия, которое игрок сейчас держит в руках.
Parameters:
({{{1}}})
playeridID игрока.

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

ID оружия.
new weapon = GetPlayerWeapon(playerid);


GetPlayerWeaponData

Description:

Узнает информацию об оружие и количестве патронов в конкретном слоте игрока брони игрока.
Parameters:
({{{1}}})
playeridID игрока.
slotСлот оружия, информацию о котором нужно получить (0-12).
&weaponsПеременная, в которую нужно записать ID оружия в данном слоте.
&ammoПеременная, в которую нужно записать количество патронов в данном слоте.
GetPlayerWeaponData(playerid, 7, weapons, ammo);


GivePlayerMoney

Description:

Эта функция позволяет Вам либо дать, либо отнять у игрока деньги. Если игроку дать отрицательное число денег, то количество его денег уменьшиться.
Parameters:
({{{1}}})
playeridID игрока.
moneyЧисло денег, которые вы хотите дать/отнять.
GivePlayerMoney(playerid, 10000);


GivePlayerWeapon

Description:

Дает игроку указанное оружие, вы можете указать, какое оружие и сколько аммуниции должен получить игрок.
Parameters:
({{{1}}})
playeridID игрока.
weaponidID оружия, даваемого игроку.
ammoКоличестов аммуниции, даваемое игроку вместе с оружием.
GivePlayerWeapon(playerid, 26, 250);


IsPlayerAdmin

Description:

Определяет, вошел ли игрок с rcon-функциями.
Parameters:
({{{1}}})
playeridID игрока.

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

1, если игрок - админ, 0,если нет.
if(IsPlayerAdmin(playerid)){


IsPlayerConnected

Description:

Эта функция может быть использована для проверки, подключен ли игрок к серверу.
Parameters:
({{{1}}})
playeridID игрока.

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

1, если он подключен, 0, если нет.
if(IsPlayerConnected(playerid)){


IsPlayerInAnyVehicle

Description:

Эта функция может быть использована для проверки, находится ли игрок в каком-либо транспорте в данный момент.
Parameters:
({{{1}}})
playeridID игрока.

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

1, если игрок находится в транспорте, 0, если нет.
if(IsPlayerInAnyVehicle(playerid)){


IsPlayerInCheckpoint

Description:

Проверяет, находится ли игрок внутри контрольной точки в данный момент. Функция может быть использована для свойств, точек телепортации или гонок, например.
Parameters:
({{{1}}})
playeridID игрока.

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

1, если игрок внутри контрольной точки, 0, если нет.
if(IsPlayerInCheckpoint(playerid)){


IsPlayerInRaceCheckpoint

Description:

Проверяет, находится ли игрок в гоночном чекпойнте в данный момент.
Parameters:
({{{1}}})
playeridID игрока.

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

1, если игрок в гоночном чекпойнте, 0, если нет.
if(IsPlayerInRaceCheckpoint(playerid)){


IsPlayerInVehicle

Description:

Проверяет, находится ли игрок в указанном транспорте в данный момент. Запомните, вы должны использовать ID транспорта, а не ID модели транспорта!
Parameters:
({{{1}}})
playeridID игрока.
vehicleidID транспорта.

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

1, если игрок в этом транспорте, 0, если нет.
if(IsPlayerInVehicle(playerid, 32)){


PlayerPlaySound

Description:

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


Image:32px-Circle-style-warning.png

Важное
Примечание

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


Parameters:
({{{1}}})
playeridID игрока.
Float:xX-координата места, где надо проиграть звук.
Float:yY-координата места, где надо проиграть звук.
Float:zZ-координата места, где надо проиграть звук.
PlayerPlaySound(playerid, 1025, 0.0, 0.0, 0.0);


PutPlayerInVehicle

Description:

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


Parameters:
({{{1}}})
playeridID игрока.
vehicleidID транспорта.
seatidID сиденья.
PutPlayerInVehicle(playerid, 0, 1);


RemovePlayerFromVehicle

Description:

Эта функция вытаскивает игрока из транспорта. Запомните, что вызываемая функция OnPlayerExitVehicle не сработает!
Parameters:
({{{1}}})
playeridID игрока.
RemovePlayerFromVehicle(playerid);


RemovePlayerMapIcon

Description:

Удаляет иконку на карте игрока.
Parameters:
({{{1}}})
playeridID игрока.
playeridID иконки.


ResetPlayerMoney

Description:

Сбрасывает деньги, которые имеются у игрока. Это может быть использовано при создании команды SetPlayerMoney.
Parameters:
({{{1}}})
playeridID игрока.
ResetPlayerMoney(playerid);


ResetPlayerWeapons

Description:

Сбрасывает все оружие, которое носит игрок в данный момент. Применима, например, если кто-то убивает своего напарника по команде, то все его оружие заменяется цветочками.
Parameters:
({{{1}}})
playeridID игрока.
ResetPlayerWeapons(playerid);


SetCameraBehindPlayer

Description:

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


Image:32px-Circle-style-warning.png

Важное
Примечание

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


Parameters:
({{{1}}})
playeridID игрока.
SetCameraBehindPlayer(playerid);


SetPlayerAmmo

Description:

Установить для игрока количество патронов в данном слоте.
Parameters:
({{{1}}})
playeridID игрока.
weaponslotНомер слота.
ammoКоличество оружия.
SetPlayerAmmo(playerid, 8, 150);


SetPlayerArmour

Description:

Устанавливает количество брони для игрока.
Parameters:
({{{1}}})
playeridID игрока.
Float:armourКоличество брони.
SetPlayerArmour(playerid, 100.0);


SetPlayerCameraLookAt

Description:

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


Image:32px-Circle-style-warning.png

Важное
Примечание

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


Parameters:
({{{1}}})
playeridID игрока.
Float:xX-координата, куда будет смотреть камера.
Float:yY-координата, куда будет смотреть камера.
Float:zZ-координата, куда будет смотреть камера.
SetPlayerCameraLookAt(playerid, 324.34, 54.122. -173.35);


SetPlayerCameraPos

Description:

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


Image:32px-Circle-style-warning.png

Важное
Примечание

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


Parameters:
({{{1}}})
playeridID игрока.
Float:xНовая x-координата камеры.
Float:yНовая y-координата камеры.
Float:zНовая z-координата камеры.
SetPlayerCameraPos(playerid, 652.23, 457.21, 10.84);


SetPlayerCheckpoint

Description:

Установить текущую контрольную точку для игрока. В один и тот же момоент времени вы можете использовать только одну контрольную точку, вам следует использовать DisablePlayerCheckpoint, чтобы сначала уничтожить предыдущую.
Parameters:
({{{1}}})
playeridID игрока.
Float:xX-координата для новой контрольной точки.
Float:yY-координата для новой контрольной точки.
Float:zZ-координата для новой контрольной точки.
Float:sizeРазмер контрольной точки.
SetPlayerCheckpoint(playerid, 354.12, 932.12, 19.34, 2.0);


SetPlayerColor

Description:

Эта функция позволяет Вам изменить текущий цвет игрока.
Parameters:
({{{1}}})
playeridID игрока.
colorНовый цвет игрока, целое число.
SetPlayerColor(playerid, 0xFFFF00AA);
SetPlayerColor(playerid, 4294901930);


SetPlayerFacingAngle

Description:

Устанавливает текущий угол поворота игрока.
Parameters:
({{{1}}})
playeridID игрока.
Float:angНовый угол поворота игрока.
SetPlayerFacingAngle(playerid, 90.0);


SetPlayerHealth

Description:

Изменяет текущее здоровье игрока. Параметр health указывается в процентах, так 100 означает, что полоса здоровья полная.
Parameters:
({{{1}}})
playeridID игрока.
Float:healthНовое здоровье, вещественное число.
SetPlayerHealth(playerid, 95.0);


SetPlayerInterior

Description:

Изменяет текущее местоположение игрока. Список всех известных на данный момент мест и их позиции можно найти на этой странице.
Parameters:
({{{1}}})
playeridID игрока.
interioridID нового места (или Universe ID) игрока.
SetPlayerInterior(playerid, 0);


SetPlayerMapIcon

Description:

Устанавливает для игрока иконку на радаре и карте.
Parameters:
({{{1}}})
playeridID игрока.
iconidID для данной иконки.
Float:xX-координата для положения иконки.
Float:yY-координата для положения иконки.
Float:zZ-координата для положения иконки.
markertypeТип (модель) иконки.
colorЦвет иконки.


SetPlayerMarkerForPlayer

Description:

Установить отображение маркера игрока на карте для другого игрока.
Parameters:
({{{1}}})
playeridID игрока.
showplayeridID игрока, которому нужно показать маркер.
colorЦвет маркера.
SetPlayerMarkerForPlayer(playerid, 0, COLOR_GREEN);


SetPlayerName

Description:

Меняет имя игрока.
Parameters:
({{{1}}})
playeridID игрока.
const name[]Новое имя игрока.
SetPlayerName(playerid, "[NoTeam]Player");


SetPlayerPos

Description:

Изменяет позицию игрока на другую позицию на карте.
Parameters:
({{{1}}})
playeridID игрока.
Float:xX-координата для новой позиции игрока.
Float:yY-координата для новой позиции игрока.
Float:zZ-координата для новой позиции игрока.
SetPlayerPos(playerid, 34.236, 934.323, 12.345);


SetPlayerRaceCheckpoint

Description:

Устанавливает гоночный чекпойнт для игрока.
Parameters:
({{{1}}})
playeridID игрока.
typeТип гоночного чекпойнта:
0 - Наземный нормальный
1 - Наземный финиш
2 - Наземный пустой (Без стрелки)
3 - Воздушный нормальный
4 - Воздушный финиш


Float:xX-координата для чекпойнта.
Float:yY-координата для чекпойнта.
Float:zZ-координата для чекпойнта.
Float:nextxX-координата точки, на которую будет "смотреть" стрелка чекпойнта.
Float:nextyY-координата точки, на которую будет "смотреть" стрелка чекпойнта.
Float:nextzZ-координата точки, на которую будет "смотреть" стрелка чекпойнта.
Float:sizeРазмер контрольной точки.
SetPlayerCheckpoint(playerid, 354.12, 932.12, 19.34, 368.4, 898.2, 19.5, 2.0);


SetPlayerScore

Description:

Обновляет счет игрока до другого значения.
Parameters:
({{{1}}})
playeridID игрока.
scoreНовый счет игрока.
SetPlayerScore(playerid, 10000);


SetPlayerSkin

Description:

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


Image:32px-Circle-style-warning.png

Важное
Примечание

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


Parameters:
({{{1}}})
playeridID игрока.
skinidID нового скина для игрока.
SetPlayerSkin(playerid, 121);


SetPlayerTeam

Description:

Используйте эту функцию для изменения команды игрока. Игроки одной команды не смогут навредить друг другу.
Parameters:
({{{1}}})
playeridID игрока.
teamidID команды, членом которой станет игрок.
SetPlayerTeam(playerid, TEAM_BALLAS);


SetPlayerTime

Description:

Устанавливает игровое время для игрока (в правом верхнем углу экрана).
Parameters:
({{{1}}})
playeridID игрока.
hourВремя (часы).
minuteВремя (минуты).
SetPlayerTime(playerid, 18, 30);


SetPlayerVirtualWorld

Description:

Перемещает игрока в виртуальный мир с данным ID.
Parameters:
({{{1}}})
playeridID игрока.
playeridID мира, в который нужно переместить игрока.
SetPlayerVirtualWorld(playerid,1);


SetPlayerWantedLevel

Description:

Устанавливает уровень разыскиваемости игрока (звездочки на экране).
Parameters:
({{{1}}})
playeridID игрока.
levelУровень розыска (кол-во звезд).
SetPlayerWantedLevel(playerid, 6);


SetPlayerWeather

Description:

Установить погоду для отдельного игрока.
Parameters:
({{{1}}})
playeridID игрока.
weatherID погоды.
SetPlayerWeather(playerid, 14);


SetPlayerWorldBounds

Description:

Эта функция может быть использована для изменения границ для игрока в игровом мире, мест, до куда он может добраться.
Parameters:
({{{1}}})
playeridID игрока.
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

Description:

Позволяет включить/выключить отображение имени игрока для другого игрока.
Parameters:
({{{1}}})
playeridID игрока.
showplayeridID игрока, которому нужно показать имя.
show1 - показывать, 0 - не показывать.
SetPlayerWeather(playerid, 0, 1);


SpawnPlayer

Description:

Эта функция может быть использована, чтобы переразместить игрока в стартовой позиции, хорошо подходит, например, после установки различных позиций камеры.
Parameters:
({{{1}}})
playeridID игрока.
SpawnPlayer(playerid);


TogglePlayerControllable

Description:

Эта функция позволяет Вам включать/выключать разрешение двигаться для игрока. Используется для замораживания игроков, которых Вы подозреваете в читерстве, например.
Parameters:
({{{1}}})
playeridID игрока.
moveabletrue - игрок сможет двигаться, false - не сможет.
TogglePlayerControllable(playerid, 0);


SetPlayerPosFindZ

Parameters:
({{{1}}})


GetPlayerKeys

Description:

Узнает состояние кнопок у игрока.
Parameters:
({{{1}}})


TogglePlayerClock

Description:

Позволяет включать/выключать игровые часы у игрока.
Parameters:
({{{1}}})
playeridID игрока.
toggle1 - включить, 0 - отключить.
TogglePlayerClock(playerid, 1);


SetPlayerDisabledWeapons

Parameters:
({{{1}}})


Image:32px-Circle-style-warning.png

Предупреждение!

Эта функция не работает в текущей версии SA:MP!


ForceClassSelection

Description:

Заставляет игрока вернуться к выбору класса.
Parameters:
({{{1}}})
playeridID игрока.
ForceClassSelection(playerid);


ApplyAnimation

Description:

Установить анимацию для игрока
Parameters:
({{{1}}})


ClearAnimations

Description:

Убрать анимацию у игрока.
Parameters:
({{{1}}})


GetPlayerSpecialAction

Parameters:
({{{1}}})


SetPlayerSpecialAction

Parameters:
({{{1}}})


TogglePlayerSpectating

Description:

Переключает игрока в режим спектатора и обратно.
Parameters:
({{{1}}})
playeridID игрока.
toggle1 - включить режим спектатора, 0 - отключить режим спектатора.
TogglePlayerSpectating(playerid, 1);


PlayerSpectatePlayer

Description:

Позволяет игроку наблюдать за другим игроком в режиме спектатора.
Parameters:
({{{1}}})
playeridID игрока, который будет осуществлять наблюдение.
targetplayerid,ID игрока, за которым будет осуществляться наблюдение.
modeРежим наблюдения.
PlayerSpectatePlayer(playerid, 4, SPECTATE_MODE_NORMAL);


PlayerSpectateVehicle

Description:

Позволяет игроку наблюдать за транспортным средством в режиме спектатора.
Parameters:
({{{1}}})
playeridID игрока, который будет осуществлять наблюдение.
targetvehicleidID транспортного средства, за которым будет осуществляться наблюдение.
modeРежим наблюдения.
PlayerSpectateVehicle(playerid, 278, SPECTATE_MODE_NORMAL);
Personal tools