RU/giveWeapon: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Reverted edits by Bonzo (talk) to last revision by Strix)
 
(28 intermediate revisions by 3 users not shown)
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>  
<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|Модель]] выдаваемого оружия.
*'''weapon:''' [[Weapon|Модель]] выдаваемого оружия.


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


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


Возвращёет ''true'' Если оружие успешно выдано, ''false'' если иначе.
==Пример==
 
В этом примере при появлении игроку выдаётся M4 в руки
===Пример===
В этом примере при спавне игрока ему выдаётся M4
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
     giveWeapon ( source, 31, 200 ) -- Дадим M4 с 200 патронами
     giveWeapon ( source, 31, 200, true) -- Дадим M4 с 200 патронами
end
end
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
addEventHandler ( "onPlayerSpawn", getRootElement(), giveWeaponsOnSpawn )
</syntaxhighlight>
</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>

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 - устанавливает свойство указанного типа оружия