0213

   CREATE_PICKUP

---

Description

Creates a pickup

Syntax

0213: [var] = create_pickup [int1] type [int2] at [flt1] [flt2] [flt3]

Pickup.Create( [var], [int1], [int2], [flt1] [flt2] [flt3] )

Parameter

[int1]

Valid model index as defined in the IDE file; also acceptable is model's DFF name with a hash character

[int2]

Type (see below)

[flt1]

X-coordinate

[flt2]

Y-coordinate

[flt3]

Z-coordinate (or ≤-100.0 for ground z + 0.5 units)

[var]

Variable to store the handle of the pickup

Native analog

CREATE_PICKUP

This opcode spawns a pickup at the coordinates point that can be "collected" by the player.

The maximum number of pickups that can be spawned in GTA III and Vice City is 336 and in San Andreas is 620. Passing the limit will no longer spawn anymore pickups but the game will not crash.

Example

The following example, using Sanny Builder, will spawn a type 2 adrenaline pickup close to the player character.

// set constants
const
PICKUP_MODEL = #ADRENALINE
PICKUP_HANDLE = 0@
X_POS = 1@
Y_POS = 2@
Z_POS = 3@
end

// spawn pickup
00A0: store_actor $PLAYER_ACTOR position_to X_POS Y_POS Z_POS
X_POS += 4.0
0213: PICKUP_HANDLE = create_pickup PICKUP_MODEL type 2 at X_POS Y_POS Z_POS

Pickup types

This is a list of all available types of pickups.

GTA III

Type	Enum	Type	Description
1	PICKUP_IN_SHOP	weapon/item pickup with cost	respawn time ~5s, (see below for cost)
2	PICKUP_ON_STREET	weapon/item pickup	respawn time ~30s, respawn distance ~15m
3	PICKUP_ONCE	weapon/item pickup	one-time pickup, does not respawn
4	PICKUP_ONCE_TIMEOUT	weapon/item pickup	one-time pickup, does not respawn, disappears in 20s
5	PICKUP_COLLECTABLE1	hidden package pickup	behaves exactly like a package including stat update and money reward
6	PICKUP_IN_SHOP_OUT_OF_STOCK	out of stock pickup	object model darkened, unpickable
7	PICKUP_MONEY	money pickup	no money actually added but money sound plays (money can be added using 032B), one-time pickup, does not respawn, disappears in 30s
8	PICKUP_MINE_INACTIVE	inactive mine	not interactive with anything if player is on foot, pickup type changes to 9 once the player is in any vehicle
9	PICKUP_MINE_ARMED	armed mine	any pickup spawned with this type automatically changes to type 8, this type applies only when pickup type changes from 8 to 9 — selfdestructs in ~10s, explodes upon contact with any vehicle, does not respawn
10	PICKUP_NAUTICAL_MINE_INACTIVE	proximity bomb	selfdestructs in ~10s, explodes upon contact with player vehicle, can float above water but weapon halo doesn't float with object, does not respawn
11	PICKUP_NAUTICAL_MINE_ARMED	proximity bomb	selfdestructs in ~10s, explodes upon contact with player vehicle, can float above water but weapon halo doesn't float with object, does not respawn
12	PICKUP_FLOATINGPACKAGE	vehicle pickup	drive through it to pick it up, can't be picked up on foot, object model sinks through ground, can only float on water, does not respawn (opcode 035B)
13	PICKUP_FLOATINGPACKAGE_FLOATING	vehicle pickup	drive through it to pick it up, can't be picked up on foot, can float on water, does not respawn
14	PICKUP_ON_STREET_SLOW	weapon/item pickup	respawn time ~30s, respawn distance ~15m

Vice City

Type	Enum	Type	Notes
1	PICKUP_IN_SHOP	weapon/item pickup with cost	respawn time ~5s, (see below for cost)
2	PICKUP_ON_STREET	weapon/item pickup	respawn time ~30s, respawn distance ~15m
3	PICKUP_ONCE	weapon/item pickup	one-time pickup, does not respawn
4	PICKUP_ONCE_TIMEOUT	weapon/item pickup	one-time pickup, does not respawn, disappears in 20s
5	PICKUP_ONCE_TIMEOUT_SLOW	weapon/item pickup	one-time pickup, does not respawn, disappears in 120s
6	PICKUP_COLLECTABLE1	hidden package pickup	behaves exactly like a package including stat update and money reward
7	PICKUP_IN_SHOP_OUT_OF_STOCK	out of stock pickup	object model darkened, unpickable
8	PICKUP_MONEY	money pickup	no money actually added but money dialogue and sound plays (money can be added using 032B), one-time pickup, does not respawn, disappears in 30s
9	PICKUP_MINE_INACTIVE	inactive mine	not interactive with anything if player is on foot, pickup type changes to 10 once the player is in any vehicle
10	PICKUP_MINE_ARMED	armed mine	any pickup spawned with this type automatically changes to type 9, this type applies only when pickup type changes from 9 to 10 — selfdestructs in ~10s, explodes upon contact with any vehicle, does not respawn
11	PICKUP_NAUTICAL_MINE_INACTIVE	proximity bomb	selfdestructs in ~10s, explodes upon contact with player vehicle, can float above water but weapon halo doesn't float with object, does not respawn
12	PICKUP_NAUTICAL_MINE_ARMED	proximity bomb	selfdestructs in ~10s, explodes upon contact with player vehicle, can float above water but weapon halo doesn't float with object, does not respawn
13	PICKUP_FLOATINGPACKAGE	vehicle pickup	drive through it to pick it up, can't be picked up on foot, object model sinks through ground, can only float on water but weapon halo doesn't float with object, does not respawn
14	PICKUP_FLOATINGPACKAGE_FLOATING	vehicle pickup	drive through it to pick it up, can't be picked up on foot, can float on water but weapon halo doesn't float with object, does not respawn
15	PICKUP_ON_STREET_SLOW	weapon/item pickup	respawn time ~30s, respawn distance ~15m
16	PICKUP_ASSET_REVENUE	property pickup	unpickable
17	PICKUP_PROPERTY_LOCKED	property pickup	unpickable
18	PICKUP_PROPERTY_FORSALE	property pickup	press the ACTION button to pick it up; if on a mission pressing ACTION will show a help box with GXT key PROP_2 and prevents you from picking it up

San Andreas

Type	Description
1	pickups with cost, unpickable for most
2	item pickup, respawn time 30s, respawn distance 15m
3	item pickup, does not respawn.
4	item picked-up, does not respawn.
5	item pickup, does not respawn.
6	unpickable
7	unpickable
8	item picked-up, does not respawn.
9	proximity bomb?, selfdestruct when player driving in proximity 20m, explodes upon contact with vehs
10	proximity bomb?, selfdestruct when player driving in proximity 20m, explodes upon contact with vehs
11	proximity bomb?, selfdestruct when player driving in proximity 20m, explodes upon contact with vehs
12	proximity bomb?, selfdestruct when player in proximity 40m, explodes upon contact with vehs
13	item photo-op, fake pickup drops slowly down, real visible when photographed.
14	vehicle pickup, drive thru it to make it dissapear, does not respawn.
15	item pickup, respawns after time.
16	unpickable, (originally property)
17	shows cancel popup. (originally property)
18	paycash pickup, pay amount to make it dissapear. (originally property)
19	getcash pickup, get amount to make it dissapear.
20	snapshot pickup, photograph it to make it dissapear, adds 1 snapshot collected.
21	2nd player pickup, press second controller to make it dissapear.
22	invisible
23	unpickable

Weapons

When this opcode is used with weapon models, it creates a weapon pickup with predefined ammo count depending on the type of pickup. To have a custom ammo count, use opcode 032B. The "Ammo" column applies to types PICKUP_IN_SHOP, PICKUP_ONCE, PICKUP_ONCE_TIMEOUT, and PICKUP_ONCE_TIMEOUT_SLOW. The "Ammo on street" column applies to types PICKUP_ON_STREET and PICKUP_ON_STREET_SLOW. The "Cost" column applies to type PICKUP_IN_SHOP. All these values are hardcoded and their locations in memory are referenced below.

GTA III

Weapon	Ammo[1]	Ammo on street[2]	Cost[3]
Bat	1	1	$10
Pistol	45	9	$250
Uzi	125	25	$800
Shotgun	25	5	$1500
AK47	150	30	$3000
M16	300	60	$5000
Sniper Rifle	25	5	$10000
Rocket Launcher	5	1	$25000
Flamethrower	250	50	$25000
Molotov Cocktail	5	1	$2000
Grenade	5	1	$2000
Armor	-	-	$3000

1. ^ For US v1.0, the array containing this data starts at 0x5ED8D4.
2. ^ For US v1.0, the array containing this data starts at 0x5ED8FC.
3. ^ For US v1.0, the array containing this data starts at 0x5ED924.

Vice City

Weapon	Ammo[4]	Ammo on street[5]	Cost[6]
Brass Knuckle	1	1	$10
Screw Driver	1	1	$10
Golf Club	1	1	$10
Night Stick	1	1	$10
Knife	1	1	$10
Baseball Bat	1	1	$10
Hammer	1	1	$10
Cleaver	1	1	$10
Machete	1	1	$10
Katana	1	1	$10
Chainsaw	1	1	$10
Grenade	8	4	$1000
Detonator Grenade	8	4	$1000
Tear Gas	8	4	$1000
Molotov	8	4	$500
Missile	8	4	$8000
Colt .45 (Pistol)	68	34	$250
Python (.357)	24	12	$400
Chrome Shotgun	32	16	$1200
Spaz Shotgun (S.P.A.S. 12)	28	14	$1250
Stubby Shotgun	20	10	$1250
Tec-9	200	100	$800
Uzi 9mm (Uz-I)	120	60	$800
Ingram Mac 10	120	60	$650
MP5 (MP)	120	60	$1200
M4	120	60	$5000
Ruger (Kruger)	120	60	$400
Sniper Rifle	40	20	$10000
PSG-1 (.308 Sniper)	28	14	$10000
Rocket Launcher	8	4	$8000
Flame Thrower	300	150	$8000
M60	200	100	$8000
Minigun	1000	500	$10000
Camera	36	36	$500
Health	-	-	$20
Armor	-	-	$10
Adrenaline	-	-	$10

4. ^ For US v1.0, the array containing this data starts at 0x687F68.
5. ^ For US v1.0, the array containing this data starts at 0x687FB4.
6. ^ For US v1.0, the array containing this data starts at 0x688000.

Any other pickups will display a cost of $0.

Unique objects

There are objects that have unique properties when used with this opcode. An example would be the object "bribe" that can only be picked up when the player has a wanted level. The uniqueness of the object is based mostly on the model name of the object, independent of the ID number of the object with the exception of weapons. Here is a list of all unique objects.

Vice City

By default, objects have concentric halos when used as a pickup, similar to the halos seen around weapon pickups but not around health pickups. Also by default, when an object gets picked up, it produces a sound. Some objects can have a unique sound, different from generic objects.

Model	Concentric halos?	Unique sound?	Other properties
briefcase	no	no	unique glow, shows no price when used as type 1
adrenaline	no	no	creates slow motion and super strength effects when picked up, shows no price when used as type 1
bodyarmour	yes	yes	gives the player full armor when picked up
info	no	yes
health	no	yes	gives the player full health when picked up, shows no price when used as type 1
bonus	no	yes
bribe	no	yes	lowers the player's wanted level by one for most types when picked up, can usually be picked up for most types only when the player has a wanted level
killfrenzy	no	yes
camerapickup	no	no	can only be picked up while driving, doesn't self destruct for types 9 to 12
bigdollar	no	no
pickupsave	no	no
property_locked	no	no
property_fsale	no	no
clothesp	no	no
barrel1	no	no	unique glow, shows no price when used as type 1
barrel2	no	no	unique glow, shows no price when used as type 1
package1	no	no	unique glow, shows no price when used as type 1
money	no	no	unique glow, shows no price when used as type 1
brassknuckle	yes	no	gives the player Brass Knuckles when picked up
screwdriver	yes	no	gives the player a Screwdriver when picked up, light teal halos
golfclub	yes	no	gives the player a Golf Club when picked up, light teal halos
nitestick	yes	no	gives the player a Nightstick when picked up, light teal halos
knifecur	yes	no	gives the player a Knife when picked up, light teal halos
bat	yes	no	gives the player a Bat when picked up, light teal halos
hammer	yes	no	gives the player a Hammer when picked up, light teal halos
cleaver	yes	no	gives the player a Meat Cleaver when picked up, light teal halos
machete	yes	no	gives the player a Machete when picked up, light teal halos
katana	yes	no	gives the player a Katana when picked up, light teal halos
chnsaw	yes	no	gives the player a Chainsaw when picked up, light teal halos
grenade	yes	no	gives the player Grenades when picked up, light blue halos
teargas	yes	no	gives the player a Tear Gas when picked up, light blue halos
molotov	yes	no	gives the player Molotov Cocktails when picked up, light blue halos
missile	no	no	gives the player a Missile when picked up
colt45	yes	no	gives the player a Pistol when picked up, light green halos
python	yes	no	gives the player a .357 when picked up, light green halos
ruger	yes	no	gives the player a Kruger when picked up, orange halos
chromegun	yes	no	gives the player a Shotgun when picked up, green halos
shotgspa	yes	no	gives the player a S.P.A.S. 12 when picked up, green halos
buddyshot	yes	no	gives the player a Stubby Shotgun when picked up, green halos
m4	yes	no	gives the player an M4 when picked up, orange halos
tec9	yes	no	gives the player a Tec 9 when picked up, yellow halos
uzi	yes	no	gives the player an Uz-1when picked up, yellow halos
ingramsl	yes	no	gives the player a Mac when picked up, yellow halos
mp5lng	yes	no	gives the player an MP when picked up, yellow halos
sniper	yes	no	gives the player a Sniper Rifle when picked up, pink halos
laser	yes	no	gives the player a .308 Sniper when picked up, pink halos
rocketla	yes	no	gives the player a Rocket Launcher when picked up, purple halos
flame	yes	no	gives the player a Flame Thrower when picked up, purple halos
m60	yes	no	gives the player an M60 when picked up, purple halos
minigun	yes	no	gives the player a Minigun when picked up, contains two models within one pickup (minigun and minigun2), purple halos
bomb	yes	no	gives the player Detonator Grenades when picked up, light blue halos
camera	yes	no	gives the player Camera when picked up

Keywords

create, pickup, weapon

See also

• Pickup to object – a function to convert pickup's handle to an object one.

External link

•  GTAForums: Generic SA SCM Documentation