017B - Revision history

Spaceeinstein at 06:27, 8 July 2017

2017-07-08T06:27:20Z

Spaceeinstein at 19:21, 7 July 2017

2017-07-07T19:21:15Z

Spaceeinstein at 02:25, 4 December 2016

2016-12-04T02:25:44Z

Spaceeinstein: highlight

2016-12-04T02:20:11Z

highlight

Spaceeinstein at 18:14, 27 February 2016

2016-02-27T18:14:48Z

Spaceeinstein at 03:49, 29 July 2015

2015-07-29T03:49:37Z

Spaceeinstein: code snippet

2015-07-29T01:25:28Z

code snippet

Spaceeinstein at 18:46, 27 July 2015

2015-07-27T18:46:21Z

Spaceeinstein: page updates

2015-07-26T22:51:22Z

page updates

Unrated69: Created page with '{{OpCode | ini = 017b=3,set_actor %1d% weapon %2d% ammo_to %3d% | description = Sets an actor's weapon ammo. | p1 = Actor variable | p2 = Weapon ID n…'

2011-07-20T21:16:46Z

Created page with '{{OpCode | ini = 017b=3,set_actor %1d% weapon %2d% ammo_to %3d% | description = Sets an actor's weapon ammo. | p1 = Actor variable | p2 = Weapon ID n…'

New page

{{OpCode
| ini = 017b=3,set_actor %1d% weapon %2d% ammo_to %3d%
| description = Sets an actor's weapon ammo.
| p1 = Actor variable
| p2 = Weapon ID number
| p3 = Ammo amount
| game = [[GTA III]], [[Vice City]], [[San Andreas]]
}}

This opcode sets an actors ammo for the specified weapon.

== Sanny Builder example ==

<source lang="scm">017B: set_actor $PLAYER_ACTOR weapon 22 ammo_to 10</source>

==Keywords==
weapons

@@ Line 19: / Line 19: @@
 <span class="nl">:opcode_017B</span>
 <span class="c1">// 0@ - input param (char handle)</span>
-<span class="c1">// 1@ - input param (weapon number)</span>
+<span class="c1">// 1@ - input param (weapon type)</span>
 <span class="c1">// 2@ - input param (ammo count)</span>
 E6: <span class="nv">0@</span> = actor <span class="nv">0@</span> struct

@@ Line 2: / Line 2: @@
 | games       = {{Icon|3}} {{Icon|SA}}
 | command     = SET_CHAR_AMMO
-| description = Sets the character's weapon ammo
+| description = Sets the character's [[weapon]] ammo
 | syntax1     = 017B: set_actor [''char handle''] weapon [''int1''] ammo_to [''int2'']
 | p1t         = [''char handle'']
 | p1d         = The handle of the character
 | p2t         = [''int1'']
-| p2d         = [[Weapon#Lists of Weapons|Weapon number]]
+| p2d         = [[Weapon#Lists of weapons|Weapon type]]
 | p3t         = [''int2'']
 | p3d         = Ammo
@@ Line 15: / Line 15: @@
 == 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:
+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:
 {{Pre|class=sb-code|1=
 <span class="nl">:opcode_017B</span>

@@ Line 15: / Line 15: @@
 == 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 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:
+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:
 {{Pre|class=sb-code|1=
 <span class="nl">:opcode_017B</span>

@@ Line 15: / Line 15: @@
 == 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:
+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 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:
-<syntaxhighlight lang="scm">
+{{Pre|class=sb-code|1=
-:opcode_017B
+<span class="nl">:opcode_017B</span>
-// 0@ - input param (char handle)
+<span class="c1">// 0@ - input param (char handle)</span>
-// 1@ - input param (weapon number)
+<span class="c1">// 1@ - input param (weapon number)</span>
-// 2@ - input param (ammo count)
+<span class="c1">// 2@ - input param (ammo count)</span>
-E6: 0@ = actor 0@ struct
+E6: <span class="nv">0@</span> = actor <span class="nv">0@</span> struct
-E3: call_method 0x4FF780 0@ num_params 2 pop 0 ammo 2@ weapon 1@  // CPed::SetAmmo
+E3: call_method <span class="m">0x4FF780</span> <span class="nv">0@</span> num_params <span class="m">2</span> pop <span class="m">0</span> ammo <span class="nv">2@</span> weapon <span class="nv">1@</span>  <span class="c1">// CPed::SetAmmo</span>
-F6: ret 0
+F6: ret <span class="m">0</span>
-</syntaxhighlight>
+}}
 Use this line as a substitute for opcode 017B. This can be placed anywhere within the external script:
-<syntaxhighlight lang="scm">
+{{Pre|class=sb-code|1=
-F5: call_scm_func @opcode_017B inputs 3 char_handle [char handle] weapon [int1] ammo [int2]
+F5: call_scm_func <span class="nl">@opcode_017B</span> inputs <span class="m">3</span> char_handle [char handle] weapon [int1] ammo [int2]
-</syntaxhighlight>
+}}
 == Keywords ==

@@ Line 1: / Line 1: @@
-{{Icon|3}} {{Icon|SA}} '''SET_CHAR_AMMO'''
+{{OpCode
-<hr />
+| games       = {{Icon|3}} {{Icon|SA}}
-'''Description'''
+| command     = SET_CHAR_AMMO
-: Sets the character's weapon ammo
+| description = Sets the character's weapon ammo
-'''Syntax'''
+| syntax1     = 017B: set_actor [''char handle''] weapon [''int1''] ammo_to [''int2'']
-: 017B: set_actor [''char handle''] weapon [''int1''] ammo_to [''int2'']
+| p1t         = [''char handle'']
-'''Parameter'''
+| p1d         = The handle of the character
-: [''char handle'']
+| p2t         = [''int1'']
-:: The handle of the character
+| p2d         = [[Weapon#Lists of Weapons|Weapon number]]
-: [''int1'']
+| p3t         = [''int2'']
-:: [[Weapon#Lists of Weapons|Weapon number]]
+| p3d         = Ammo
-: [''int2'']
+}}
 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 [[0213#Weapons|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 [[Main.scm|original script]] of GTA III.
@@ Line 26: / Line 25: @@
 F6: ret 0
 </syntaxhighlight>
 Use this line as a substitute for opcode 017B. This can be placed anywhere within the external script:
 <syntaxhighlight lang="scm">
@@ Line 35: / Line 35: @@
 == See also ==
-* [[017A]], sets the player's weapon ammo
+* {{Icon|3}} {{Icon|VC}} [[017A]], sets the player's weapon ammo
-* [[01B2]], gives a weapon to a character
+* {{Icon|t}} [[01B2]], gives a weapon to a character

@@ Line 13: / Line 13: @@
 :: 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 [[0213#Weapons|pickup type 4 with predefined ammo count]]. This opcode was never called in the [[Main.scm|original script]] of GTA III.
+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 [[0213#Weapons|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 [[Main.scm|original script]] of GTA III.
 == Keywords ==
@@ Line 23: / Line 36: @@
 [[Category:OpCodes]]