RU/takeWeapon: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
{{Server  function}}
__NOTOC__
Эта функция отбирает у игрока оружение
{{RU/Server  function}}
Данная функция отбирает указанное оружие или патроны у определённого игрока.


==Синтаксис==
==Синтаксис==
<syntaxhighlight lang="lua">bool takeWeapon ( player thePlayer, int weaponId )</syntaxhighlight>
<syntaxhighlight lang="lua">bool takeWeapon ( player thePlayer, int weaponId [, int ammo ] )</syntaxhighlight>


===Требуемые Аргументы===
===Обязательные аргументы===
*'''thePlayer''': Игрок, в виде объекта
*'''thePlayer''': [[Игрок]], у которого вы хотите отобрать оружие.
*'''weaponId''': Числовое значение оружия, которое нужно убрать
*'''weaponId''': Целое число, указывающее [[оружие]], которое требуется отобрать.


===Возвращения===
===Необязательные аргументы===
Возвращает ''true'' если всё прошло успешно, в ином случае - ''false''
*'''ammo''': Если указано, то вместо оружия будет отобрано указанное количество патронов.
 
===Возвращает===
* ''true'', если оружие или патроны были успешно отобраны.
* ''false'' в противном случае.


==Пример==
==Пример==
Этот код забирает у игрока оружие с ID 28 при написании /takeWeapon в чате. Если всё прошло успешно, то в чате увидите сообщение
Этот пример отбирает газовый баллончик у игрока.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function takeMyWeapon(player)
addCommandHandler( 'rtear',
local ifItIsTrue = takeWeapon(player,28)
  function( thePlayer )
if (ifIsIsTrue == true) then
    takeWeapon( thePlayer, 17 )
outputChatBox("Successfully took the weapon!",player,204,255,0)
  end
end
)</syntaxhighlight>
end
addCommandHandler("takeWeapon",takeMyWeapon)</syntaxhighlight>


==Рекомендовано к просмотру==
==Смотрите также==
{{RU/Weapon functions}}
{{RU/Weapon functions}}
[[en:takeWeapon]]
[[en:takeWeapon]]

Revision as of 08:52, 20 September 2014

Данная функция отбирает указанное оружие или патроны у определённого игрока.

Синтаксис

bool takeWeapon ( player thePlayer, int weaponId [, int ammo ] )

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

  • thePlayer: Игрок, у которого вы хотите отобрать оружие.
  • weaponId: Целое число, указывающее оружие, которое требуется отобрать.

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

  • ammo: Если указано, то вместо оружия будет отобрано указанное количество патронов.

Возвращает

  • true, если оружие или патроны были успешно отобраны.
  • false в противном случае.

Пример

Этот пример отбирает газовый баллончик у игрока.

addCommandHandler( 'rtear',
  function( thePlayer )
    takeWeapon( thePlayer, 17 )
  end
)

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

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

  • giveWeapon - дает указанное оружие игроку или пешеходу
  • takeAllWeapons - удаляет всё оружие с указанного игрока или пешехода
  • takeWeapon - удаляет указанное оружие или боеприпасы с игрока или пешехода
ДО ВЕРСИИ 1.3.1 :
  • takeWeaponAmmo - удаляет определённое кол-во боеприпасов у игрока для указанного оружия
  • giveWeaponAmmo - даёт определённое кол-во боеприпасов игроку для указанного оружия

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

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

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