017B

SET_CHAR_AMMO

---

Description

Sets the character's weapon ammo

Syntax

017B: set_actor [char handle] weapon [int1] ammo_to [int2]

Parameter

[char handle]

The handle of the character

[int1]

Weapon number

[int2]

Ammo

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 group, nothing happens. If the character does not have the weapon but does have another weapon of the same group, weapon ammo will be set for that weapon instead. Place this at the end of the file:

:opcode_017B
// 0@ - input param (char handle)
// 1@ - input param (weapon number)
// 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]

Keywords

set, character, actor, weapon, ammo

See also

• 017A, sets the player's weapon ammo
• 01B2, gives a weapon to a character