RU/takeWeapon: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Reverted edits by Bonzo (talk) to last revision by MeowCola)
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Server  function}}
__NOTOC__
{{Translate}}
{{RU/Server  function}}
This function removes a specified weapon from a certain player's inventory.
Данная функция отбирает указанное оружие или патроны у определённого игрока.


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


===Required Arguments===
===Обязательные аргументы===
*'''thePlayer''': A player object referencing the specified player.
*'''thePlayer''': [[Игрок]], у которого вы хотите отобрать оружие.
*'''weaponId''': An integer that refers to a [[weapon]] that you wish to remove.
*'''weaponId''': Целое число, указывающее [[оружие]], которое требуется отобрать.


===Returns===
===Необязательные аргументы===
Returns a ''true'' if the weapon was removed successfully, ''false'' otherwise.
*'''ammo''': Если указано, то вместо оружия будет отобрано указанное количество патронов.


==Example==
===Возвращает===
This example removes weapon 28 from player ID 1. If successful, it displays a message in the chat box.
* ''true'', если оружие или патроны были успешно отобраны.
* ''false'' в противном случае.
 
==Пример==
Этот пример отбирает газовый баллончик у игрока.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
thePlayer = getPlayerFromID ( 1 )
addCommandHandler( 'rtear',
if ( takeWeapon ( thePlayer, 28 ) )
  function( thePlayer )
     outputChatBox ( "Weapon 28 removed from " .. getPlayerName ( thePlayer ) .. "." )
     takeWeapon( thePlayer, 17 )
end</syntaxhighlight>
  end
)</syntaxhighlight>


==See Also==
==Смотрите также==
{{RU/Weapon functions}}
{{RU/Weapon functions}}
[[en:takeWeapon]]
[[en:takeWeapon]]

Latest revision as of 03:06, 1 April 2016

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

Синтаксис

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