Skip to content
Multi Theft Auto: Wiki

getWeaponIDFromName

Shared

Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

This function will obtain the ID of a particular weapon from its name.

Syntax 

​int getWeaponIDFromName ( ​string name )
Required arguments
  • name: A string containing the name of the weapon. Names can be: (Case is ignored)

Returns

Returns an int if the name matches that of a weapon, false otherwise.

  • int: value

Code Examples

shared

This example will give the player the weapon they specify 20 ammo whenever they type "weaponname" into the console.

-- Define our function that will handle this command
function consoleGiveWeapon ( playerSource, commandName, weapName )
  -- If a player triggered it (rather than the admin) then
  if ( playerSource ) then
    -- Get the weapon ID from the name
    local weapID = getWeaponIDFromName ( weapName )
    -- If it's a valid weapon
    if ( weapID ) then
       -- Give the weapon to the player
      giveWeapon ( playerSource, weapID, 20 )
      -- Output it in the chat box
      outputChatBox ( "You got a " .. weapName, playerSource )
    else outputChatBox ( "Invalid weapon name." )
    end
  end
end
-- Register the command handler and attach it to the 'consoleGiveWeapon' function
addCommandHandler ( "weapon", consoleGiveWeapon )

See Also

Weapon Functions
Weapon Events
Reference