GetOriginalWeaponProperty: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Remove obsolete Requirements section)
 
(3 intermediate revisions by one other user not shown)
Line 4: Line 4:


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">int getOriginalWeaponProperty ( int weaponID/string weaponName, string weaponSkill, string property/int property )</syntaxhighlight>
<syntaxhighlight lang="lua">int getOriginalWeaponProperty ( int weaponID/string weaponName, string weaponSkill, string property )</syntaxhighlight>


==Required Arguments==
==Required Arguments==
*'''weaponID or weaponName:''' The ID or name of the weapon you want to get info of. Names can be:
*'''weaponID or weaponName:''' The ID or name of the weapon you want to get info of. Names can be:
{{Weapon Types}}
{{Some Weapon Types}}
*'''weaponSkill:''' Either: "pro", "std" or "poor"
*'''weaponSkill:''' Either: "pro", "std" or "poor"
*'''property:''' The property you want to get the value of:
*'''property:''' The property you want to get the value of:
 
{{Weapon Properties Writable}}
** "weapon_range"
The following properties are get only:
** "target_range"
{{Weapon Properties ReadOnly}}
** "accuracy"
** "damage"
** "life_span" // Get only
** "firing_speed" // Get only
** "spread" // Get only
** "maximum_clip_ammo"
** "move_speed"
** "flags"
** "anim_group" // Get only
** "fire_type" // Get only
** "model" // Get only
** "model2" // Get only
** "weapon_slot" // Get only
** "fire_offset" // Get only
** "skill_level" // Get only
** "required_skill_level" // Get only
** "anim_loop_start"
** "anim_loop_stop"
** "anim_loop_bullet_fire"
** "anim2_loop_start"
** "anim2_loop_stop"
** "anim2_loop_bullet_fire"
** "anim_breakout_time"
** "radius" // Get only
** "aim_offset" // Get only
** "default_combo" // Get only
** "combos_available" // Get only


==Returns==
==Returns==
Line 57: Line 30:
outputChatBox("Default M4 range at poor is: "..tostring(range))
outputChatBox("Default M4 range at poor is: "..tostring(range))
</syntaxhighlight>
</syntaxhighlight>
==Requirements==
{{Requirements|1.2|1.2|}}


==See Also==
==See Also==
{{Weapon functions}}
{{Weapon functions}}

Latest revision as of 15:36, 7 November 2024

This function gets the original weapon property of the specified weapons specified weapon type.

Syntax

int getOriginalWeaponProperty ( int weaponID/string weaponName, string weaponSkill, string property )

Required Arguments

  • weaponID or weaponName: The ID or name of the weapon you want to get info of. Names can be:
  • grenade
  • teargas
  • molotov
  • colt 45
  • silenced
  • deagle
  • shotgun
  • sawed-off
  • combat shotgun
  • uzi
  • mp5
  • ak-47
  • m4
  • tec-9
  • rifle
  • sniper
  • rocket launcher
  • rocket launcher hs
  • flamethrower
  • minigun
  • satchel
  • bomb
  • spraycan
  • fire extinguisher
  • camera
  • weaponSkill: Either: "pro", "std" or "poor"
  • property: The property you want to get the value of:
  • "weapon_range" - float
  • "target_range" - float - Max targeting range
  • "accuracy" - float
  • "damage" - int - Note: Changing the standard M4 stat will change how much damage vehicle guns (e.g: Rustler) do.
  • "maximum_clip_ammo" - int
  • "move_speed" - float - How fast player can move with weapon
  • "flags" - int - (specify a flag to toggle it on/off) See Weapon Flags
  • "flag_aim_no_auto" - bool - Disable auto up/down for non-aimed firing
  • "flag_aim_arm" - bool - Uses other arm for aiming
  • "flag_aim_1st_person" - bool - Uses 1st person aim
  • "flag_aim_free" - bool - Can only use free aiming
  • "flag_move_and_aim" - bool - Can move and aim at same time
  • "flag_move_and_shoot" - bool - Can move and fire at same time
  • "flag_type_throw" - bool - Is a throwing weapon
  • "flag_type_heavy" - bool - Can't jump
  • "flag_type_constant" - bool - Fires every frame within loop (ie paint spray)
  • "flag_type_dual" - bool - Can use 2x guns at same time
  • "flag_anim_reload" - bool - Weapon has reload anims
  • "flag_anim_crouch" - bool - Has crouching anims
  • "flag_anim_reload_loop" - bool - Loop from end of reload to fire loop start
  • "flag_anim_reload_long" - bool - Force a longer reload time
  • "flag_shot_slows" - bool - Slows down (area effect)
  • "flag_shot_rand_speed" - bool - Random speed (area effect)
  • "flag_shot_anim_abrupt" - bool - Force the anim to finish player after aim/fire rather than blending out (area effect)
  • "flag_shot_expands" - bool - Expands (area effect)
  • "anim_loop_start" - float - Start of aimed firing animation loop
  • "anim_loop_stop" - float - End of aimed firing animation loop (Reduce to increase firing rate)
  • "anim_loop_bullet_fire" - float - Time in aimed firing animation when weapon should be fired (Must be between Start and End)
  • "anim2_loop_start" - float - Start of non-aimed firing animation2 loop
  • "anim2_loop_stop" - float - End of non-aimed firing animation2 loop (Reduce to increase crouch firing rate)
  • "anim2_loop_bullet_fire" - float - Time in non-aimed firing animation2 when weapon should be fired (Must be between Start and End)
  • "anim_breakout_time" - float - Time after which player can break out of attack and run off

The following properties are get only:

  • "fire_type" - int - Type - instant hit (e.g. pistol), projectile (e.g. rocket launcher), area effect (e.g. flame thrower)
  • "model" - int
  • "model2" - int
  • "weapon_slot" - int
  • "anim_group" - int
  • "skill_level" - int
  • "required_skill_level" - int
  • "firing_speed" - float - Projectile/area-effect (e.g. flame thrower) only
  • "radius" - float - Area effect (e.g. flame thrower) only
  • "life_span" - float - Time taken for shot to dissipate
  • "spread" - float - Angle inside which shots are created
  • "fire_offset" - vector - Offset from weapon origin to projectile starting point
  • "aim_offset" - int - Index into (mystery) array of aiming offsets
  • "default_combo" - int - Base combo for this melee weapon
  • "combos_available" - int - How many further combos are available

Returns

On success:

int: The weapon property

On failure:

bool: False if the passed arguments were invalid

Example

This example gets the default weapon range of the M4 at poor skill level

local range = getOriginalWeaponProperty(31, "poor", "weapon_range")
outputChatBox("Default M4 range at poor is: "..tostring(range))

See Also