RU/giveWeapon: Difference between revisions

Latest revision as of 03:05, 1 April 2016

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

Синтаксис

bool giveWeapon ( player thePlayer, int weapon [, int ammo=30, bool setAsCurrent=false ] )

Обязательные аргументы

thePlayer: игрок или пед которому выдаётся оружие.
weapon: Модель выдаваемого оружия.

Необязательные аргументы

ammo: Количество патронов которое будет даваться к оружию.

Для оружия, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.

setAsCurrent: Логическое значение будет ли оружие в руках после выдачи

Возвращает

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

Пример

В этом примере при появлении игроку выдаётся M4 в руки

function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
    giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )

Смотрите так же

Серверные функции

giveWeapon - дает указанное оружие игроку или пешеходу
takeAllWeapons - удаляет всё оружие с указанного игрока или пешехода
takeWeapon - удаляет указанное оружие или боеприпасы с игрока или пешехода

ДО ВЕРСИИ 1.3.1 :

takeWeaponAmmo - удаляет определённое кол-во боеприпасов у игрока для указанного оружия
giveWeaponAmmo - даёт определённое кол-во боеприпасов игроку для указанного оружия

Клиентские функции

Общие функции

getOriginalWeaponProperty - получает исходное свойство указанного типа оружия
getPickupWeapon - получает ID оружия из указанного пикапа
getSlotFromWeapon - получает слот к которому принадлежит оружие
getWeaponIDFromName - получает ID оружия из его названия
getWeaponNameFromID - получает название оружия или причину смерти из его ID
getWeaponProperty - получает свойство указанного оружия
setWeaponAmmo - устанавливает определенное кол-во боеприпасов для указанного оружия
setWeaponProperty - устанавливает свойство указанного типа оружия

@@ Line 1: / Line 1: @@
-{{Translate}}
+__NOTOC__
-{{Server function}}
+{{RU/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|пед]] которому выдаётся оружие.
-*'''thePlayer:''' [[element/Player|игроку]] или [[Element/Ped|педу]] которому выдаётся оружие.
 *'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.
-===Выборочные аргументы===
+===Необязательные аргументы===
+*'''ammo:''' Количество патронов которое будет даваться к оружию.
-*'''ammo:''' Колличество патронов которое будет даваться к оружию.  Для оружий, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
+Для оружия, которые не требуют боеприпасов, такие, как ближний бой, патронов будет 1.
 *'''setAsCurrent:''' Логическое значение будет ли оружие в руках после выдачи
-===Возврат===
+==Возвращает==
+Возвращает ''true'' Если оружие успешно выдано, ''false'' если иначе.
-Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.
+==Пример==
+В этом примере при появлении игроку выдаётся M4 в руки
-===Пример===
-В этом примере при спавне игрока ему выдаётся M4
 <syntaxhighlight lang="lua">
 function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
-     giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
+     giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
 end
 addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
 </syntaxhighlight>
+==Смотрите так же==
-==Example==
+{{RU/Weapon functions}}
-'''Example 1:''' This example gives a player an M4 with 200 ammo whenever they spawn.
+[[EN:giveWeapon]]
-<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>