Multi Theft Auto: Wiki - User contributions [en]

GetElementRotation

2011-10-01T04:20:32Z

Антон:

{{Server client function}}
__NOTOC__
Retrieve the rotation of elements.

== Only clientside before 1.0.4 ==

==Syntax==
<syntaxhighlight lang="lua">
float float float getElementRotation ( element theElement [, string rotOrder = "default" ] )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' The element whose rotation will be retrieved

===Optional Arguments===
{{New feature|33.0110|1.1|
*'''rotOrder:''' A string representing the rotation order desired when returning the [http://en.wikipedia.org/wiki/Euler_angles euler angles]. If omitted, default value is ''"default"''. Allowed values are:
**''"default":'' default MTA behavior prior to 1.1, where rotation order depends on element type
**''"ZXY":'' rotation about the Z axis (''up''), then about the resulting X axis (''right'') and finally about the resulting Y axis (''front''). This is the default rotation order for [[object|objects]]
**''"ZYX":'' rotation about the Z axis (''up''), then about the resulting Y axis (''front''), and finally about the resulting X axis (''right''). This is the default rotation order for [[vehicle|vehicles]]

The default rotation order for peds/players is Z-Y-X (clientside) and -Z-Y-X (serverside) but those rotation orders (set using ''"default"'' on peds) can not be used manually on other element types since they only exist due to historical and backward compatibility reasons.
Specifying a rotation order other than ''"default"'' allows the same angles to later be uniformly used on several elements without having to consider their type.
}}

===Returns===
* ''rx, ry, rz'': 3 ''float''s representing the Euler rotation angles on the axis X, Y and Z (with the rotation order depending on the ''rotOrder'' argument) if ''element'' exists and is a valid element, ''false'' if it's invalid.

==Example==
If a player points at a player element with a gun, its rotation will appear in the chat box.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function onPlayerTargeted ( targetElem )
if ( isElement(targetElem) and getElementType (targetElem) == "player" ) then
local x,y,z = getElementRotation ( targetElem )
outputChatBox ( "Target player rotation: " .. x .. " " .. y .. " " .. z )
end
end
addEventHandler ( "onClientPlayerTarget", getRootElement(), onPlayerTargeted )
</syntaxhighlight>
</section>

==See Also==
{{Client_element_functions}}

CreateVehicle

2011-09-06T10:17:11Z

Антон:

__NOTOC__
{{Server client function}}
This function creates a vehicle at the specified location.

Its worth noting that the position of the vehicle is the center point of the vehicle, not its base. As such, you need to ensure that the z value (vertical axis) is some height above the ground. You can find the exact height using the client side function [[getElementDistanceFromCentreOfMassToBaseOfModel]], or you can estimate it yourself and just spawn the vehicle so it drops to the ground.

'''Important Note:''' Vehicles (and other elements) created client-side are only seen by the client that created them, aren't synced and players cannot enter them. They are essentially for display only.

==Syntax==
<syntaxhighlight lang="lua">
vehicle createVehicle ( int model, float x, float y, float z, [float rx, float ry, float rz, string numberplate] )
</syntaxhighlight>

===Required Arguments===
* '''model''': The [[Vehicle IDs|vehicle ID]] of the vehicle being created.
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional Arguments===
{{OptionalArg}}
* '''rx''': A floating point number representing the rotation about the X axis in degrees.
* '''ry''': A floating point number representing the rotation about the Y axis in degrees.
* '''rz''': A floating point number representing the rotation about the Z axis in degrees.
* '''numberplate''': A string that will go on the number plate of the car (max 8 characters). This is only applicable to cars.

===Returns===
Returns the [[vehicle]] element that was created. Returns ''false'' if the arguments are incorrect, or if the vehicle limit of 65535 is exceeded.

==Using trains==
Trains are created using the createVehicle function. They are placed at the nearest point of the GTASA train pathing (railroad tracks) from their spawning point.

==Example==
<section name="Example 1: Server" class="server" show="true">
This script spawns a Rhino on top of one lucky individual.
<syntaxhighlight lang="lua">
function scriptCreateTank ( player, command )
local luckyBugger = getRandomPlayer() -- get a random player
local x, y, z = getElementPosition ( luckyBugger ) -- retrive the player's position
createVehicle ( 432, x, y, z + 10 ) -- create the tank 10 units above them
outputChatBox ( "You got Tank'd!", luckyBugger )
end
--Attach the 'scriptCreateTank' function to the "tank" command
addCommandHandler ( "tank", scriptCreateTank )
</syntaxhighlight>
</section>

<section name="Example 2: Client" class="client" show="true">
This script spawns a Rhino on top of the local player.
<syntaxhighlight lang="lua">
function scriptCreateTank ( commandName )
local luckyBugger = getLocalPlayer() -- get the local player
local x, y, z = getElementPosition ( luckyBugger ) -- retrive the player's position
createVehicle ( 432, x, y, z + 10 ) -- create the tank 10 units above them
outputChatBox ( "You got Tank'd!", 255, 0, 0)
end
--Attach the 'scriptCreateTank' function to the "tank" command
addCommandHandler ( "tank", scriptCreateTank )
</syntaxhighlight>
</section>

<section name="Example 3: Server" class="server" show="true">
This example creates a vehicle five units to the right of a player when they type ''createvehicle'' and its name in the console:
<syntaxhighlight lang="lua">
local distance = 5 --units

-- define our handler (we'll take a variable number of parameters where the name goes, because there are vehicle names with more than one word)
function consoleCreateVehicle ( sourcePlayer, commandName, ... )
-- if a player triggered it, not the admin,
if ( sourcePlayer ) then
-- calculate the position of the vehicle based on the player's position and rotation:
local x, y, z = getElementPosition ( sourcePlayer ) -- get the player's position
local rotZ = getPedRotation ( sourcePlayer ) -- get the player's rotation around the Z axis in degrees
x = x + ( ( math.cos ( math.rad ( rotZ ) ) ) * distance ) -- calculate the X position of the vehicle
y = y + ( ( math.sin ( math.rad ( rotZ ) ) ) * distance ) -- calculate the Y position of the vehicle

-- get the complete vehicle name by joining all passed parameters using Lua function table.concat
local vehicleName = table.concat({...}, " ")
-- get the vehicle's model ID from the name
local vehicleID = getVehicleModelFromName ( vehicleName )
-- if vehicle ID is valid,
if vehicleID then
-- create the vehicle using the information gathered above:
local newVehicle = createVehicle ( vehicleID, x, y, z, 0, 0, rotZ )
-- if vehicle creation failed, give the player a message
if not newVehicle then
outputConsole ( "Failed to create vehicle.", sourcePlayer )
end
end
end
end

-- Attach the 'consoleCreateVehicle' function to the "createvehicle" command
addCommandHandler ( "createvehicle", consoleCreateVehicle )
</syntaxhighlight>
</section>

==See Also==

{{Vehicle functions}}

RU/giveWeapon

2011-09-05T10:25:29Z

Антон: /* Смотрите так же */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
==Обязательные аргументы==
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

==Возврат==

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

==Пример==
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>
==Смотрите так же==
{{RU/Weapon functions}}
[[EN:giveWeapon]]

RU/giveWeapon

2011-09-05T10:25:17Z

Антон: /* Смотрите так же */

RU/giveWeapon

2011-09-04T04:52:10Z

Антон:

RU/giveWeapon

2011-09-04T03:15:44Z

Антон: /* Смотрите так же */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>
==Смотрите так же==
{{RU/Weapon functions}}
[[en:giveWeapon]]

RU/giveWeapon

2011-09-04T03:15:04Z

Антон: /* Смотрите так же */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>
==Смотрите так же==
{{RU/Weapon functions}}

RU/giveWeapon

2011-09-04T02:12:22Z

Антон: /* Смотрите так же */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>
==Смотрите так же==
{{Weapon functions}}

RU/giveWeapon

2011-09-04T02:12:04Z

Антон: /* Смотрите так же */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>
==Смотрите так же==
{{Weapon functions}}
[[eng:giveWeapon]]

RU/giveWeapon

2011-09-04T02:11:37Z

Антон: /* Смотрите так же */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>
==Смотрите так же==
{{Weapon functions}}
[[ru:giveWeapon]]

RU/giveWeapon

2011-09-04T02:10:32Z

Антон: /* See Also */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>
==Смотрите так же==
{{Weapon functions}}

RU/giveWeapon

2011-09-04T02:09:28Z

Антон: /* Синтаксис */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>
==See Also==
{{Weapon functions}}

RU/giveWeapon

2011-09-04T02:08:59Z

Антон: /* Пример */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:08:46Z

Антон: /* Пример */

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игроку выдаётся M4 в руки
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200,true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:07:35Z

Антон:

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игрок]] или [[Element/Ped|пед]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:06:57Z

Антон:

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:06:51Z

Антон:

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:06:40Z

Антон:

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:06:34Z

Антон:

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:06:22Z

Антон:

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:06:12Z

Антон:

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:06:03Z

Антон:

{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
*Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:05:31Z

Антон:

{{Translate}}
{{Server function}}

С помощью этой функции можно выдать оружие игроку, педу.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:05:09Z

Антон: /* Синтаксис */

{{Translate}}
{{Server function}}
giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.

С помощью этой функции можно выдать оружие игроку, педу.
==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию.
Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:04:32Z

Антон: /* Синтаксис */

{{Translate}}
{{Server function}}
giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.

С помощью этой функции можно выдать оружие игроку, педу.
==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию. Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:04:19Z

Антон: /* Синтаксис */

RU/giveWeapon

2011-09-04T02:03:28Z

Антон: /* Example */

RU/giveWeapon

2011-09-04T02:03:07Z

Антон: /* See Also */

{{Translate}}
{{Server function}}
giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
С помощью этой функции можно выдать оружие [[element/Player|игроку]], [[Element/Ped|педу]].
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию. Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

==Example==
'''Example 1:''' This example gives a player an M4 with 200 ammo whenever they spawn.
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Gives the M4 weapon with 200 ammo
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn ) -- attach the event handler
</syntaxhighlight>

'''Example 2:''' This example adds a "give" command in console which allows giving of any weapon by entering "give <id> <amount>".
<syntaxhighlight lang="lua">
function consoleGive ( thePlayer, commandName, weaponID, ammo )
local status = giveWeapon ( thePlayer, weaponID, ammo, true ) -- attempt to give the weapon, forcing it as selected weapon
if ( not status ) then -- if it was unsuccessful
outputConsole ( "Failed to give weapon.", thePlayer ) -- tell the player
end
end
addCommandHandler ( "give", consoleGive )
</syntaxhighlight>

'''Example 3:''' This example creates a ped in certain coordinates. You can give him a weapon with "give <weaponID> <amount>" command in console.
<syntaxhighlight lang="lua">
ped = createPed( 19, -1634.5775, 1203.85, 7.1796 );

addCommandHandler( "give",
function ( player, command, id, amount )
if not id then return end
giveWeapon( ped, id, amount, true )
end
)
</syntaxhighlight>

RU/giveWeapon

2011-09-04T02:02:36Z

Антон: /* Syntax */

{{Translate}}
{{Server function}}
giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.

==Синтаксис==
<syntaxhighlight lang="lua">bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )</syntaxhighlight>
С помощью этой функции можно выдать оружие [[element/Player|игроку]], [[Element/Ped|педу]].
===Обязательные аргументы===
*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.

===Выборочные аргументы===

*'''ammo:''' Колличество патронов которое будет даваться к оружию. Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
*'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи

===Возврат===

Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.

===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>

==Example==
'''Example 1:''' This example gives a player an M4 with 200 ammo whenever they spawn.
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
giveWeapon ( source, 31, 200 ) -- Gives the M4 weapon with 200 ammo
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn ) -- attach the event handler
</syntaxhighlight>

'''Example 2:''' This example adds a "give" command in console which allows giving of any weapon by entering "give <id> <amount>".
<syntaxhighlight lang="lua">
function consoleGive ( thePlayer, commandName, weaponID, ammo )
local status = giveWeapon ( thePlayer, weaponID, ammo, true ) -- attempt to give the weapon, forcing it as selected weapon
if ( not status ) then -- if it was unsuccessful
outputConsole ( "Failed to give weapon.", thePlayer ) -- tell the player
end
end
addCommandHandler ( "give", consoleGive )
</syntaxhighlight>

'''Example 3:''' This example creates a ped in certain coordinates. You can give him a weapon with "give <weaponID> <amount>" command in console.
<syntaxhighlight lang="lua">
ped = createPed( 19, -1634.5775, 1203.85, 7.1796 );

addCommandHandler( "give",
function ( player, command, id, amount )
if not id then return end
giveWeapon( ped, id, amount, true )
end
)
</syntaxhighlight>

==See Also==
{{RU/Weapon functions}}