From GTAMods Wiki
Jump to navigation Jump to search


Sets the character's weapon ammo
017B: set_actor [char handle] weapon [int1] ammo_to [int2]
[char handle]
The handle of the character
Weapon type

This opcode sets the character's weapon ammo. If the character does not have the weapon, the weapon is given to it. Unlike opcode 01B2, it sets rather than adds to the ammo count and does not set the weapon as the current one for the character. You have to use opcode 01B9 to set it as the current one. When the character dies, it drops the weapon as a pickup type 4 with predefined ammo count. If the ammo count is already less than the predefined count, it drops that ammo count instead. This opcode was never called in the original script of GTA III.

For Vice City

This opcode does not exist in Vice City but it is possible to recreate this opcode based on 017A. The following example, using Sanny Builder with CLEO for Vice City in an external script (not the main one) and tested on US v1.0, should work similarly to this opcode. Due to the way how 017A works in Vice City, if the character does not have the weapon or another weapon of the same slot, nothing happens. If the character does not have the weapon but does have another weapon of the same slot, weapon ammo will be set for that weapon instead. Place this at the end of the file:

// 0@ - input param (char handle)
// 1@ - input param (weapon type)
// 2@ - input param (ammo count)
05E6: 0@ = actor 0@ struct
05E3: call_method 0x4FF780 0@ num_params 2 pop 0 ammo 2@ weapon 1@  // CPed::SetAmmo
05F6: ret 0

Use this line as a substitute for opcode 017B. This can be placed anywhere within the external script:

05F5: call_scm_func @opcode_017B inputs 3 char_handle [char handle] weapon [int1] ammo [int2]


set, character, actor, weapon, ammo

See also

  • GTA III Vice City 017A, sets the player's weapon ammo
  • GTA III Vice City San Andreas 01B2, gives a weapon to a character