039D


Particle effect 17 of size 1.0 with an X-strength of 0.5.	Particle effect 17 of size 1.0 with an Z-strength of 0.5.

ADD_MOVING_PARTICLE_EFFECT

Description

Adds a moving particle effect

Syntax

039D: scatter_particles [int1] [flt1] [int2] [int3] [int4] [int5] at [flt2] [flt3] [flt4] [flt5] [flt6] [flt7]

Parameter

[int1]

Particle effect ID (see below)

[flt1]

Scale

[int5]

Duration in milliseconds

[flt2]

X-coordinate

[flt3]

Y-coordinate

[flt4]

Z-coordinate

[flt5]

X-strength

[flt6]

Y-strength

[flt7]

Z-strength

This opcode adds a moving particle effects at the specified location for a duration of time. Some particles do not obey the duration and are noted below. If the duration is set to 0, particles that obey duration will loop forever; the only way to remove a particle effect stuck in a loop is to use opcode 03AE. Using a particle ID outside the range listed below produces unpredictable results and may crash the game. The strength represents the direction and length of movement of the particle. Some particles look meaningless or weird absence of the strength. Ones that are affected by gravity can be seen arcing towards the ground if an X or Y strength is set. Some particles do not obey the strength and are noted below. Particle effects created with this opcode is saved in block 14 of the save file in GTA III and block 15 in Vice City.

The original script in GTA III uses particles 10, 11, 12, 13, 15, 18, and 19; and in Vice City uses 4 and 17.

List of particle effects

All images below are taken with a size of 1.0 and a strength of 0.0.

GTA III

ID	Enum	Obey duration?	Obey strength?	Notes
0	POBJECT_PAVEMENT_STEAM	✓	✓	thin white smoke
1	POBJECT_PAVEMENT_STEAM_SLOWMOTION	✓	✓	thick white smoke
2	POBJECT_WALL_STEAM	✓	✓	thin white smoke
3	POBJECT_WALL_STEAM_SLOWMOTION	✓	✓	thick white smoke
4	POBJECT_DARK_SMOKE	✓	✓	black smoke
5	POBJECT_FIRE_HYDRANT	✗	✗	fire hydrant water
6	POBJECT_CAR_WATER_SPLASH	✓	✓	large water splash
7	POBJECT_PED_WATER_SPLASH	✓	✓	medium water splash
8	POBJECT_SPLASHES_AROUND	✓	✗	a square of raindrops on the ground; if scale is 1.0, size of square is 1x1 units
9	POBJECT_SMALL_FIRE	✓	✗
10	POBJECT_BIG_FIRE	✓	✗
11	POBJECT_DRY_ICE	✓	✗
12	POBJECT_DRY_ICE_SLOWMOTION	✓	✗
13	POBJECT_FIRE_TRAIL	✓	✓
14	POBJECT_SMOKE_TRAIL	✓	✓
15	POBJECT_FIREBALL_AND_SMOKE	✓	✓	initial explosion then smokes
16	POBJECT_ROCKET_TRAIL	✗	✓	initial explosion then smokes; setting duration to 0 can bug out all particles in the game, making random particles produce this smoke
17	POBJECT_EXPLOSION_ONCE	✗	✓	single brief explosion
18	POBJECT_CATALINAS_GUNFLASH	✗	✓	gun flash; strength only affects direction of flash
19	POBJECT_CATALINAS_SHOTGUNFLASH	✗	✓	shotgun flash; strength only affects direction of flash

Vice City

ID	Enum	Obey duration?	Obey strength?	Notes
0	POBJECT_PAVEMENT_STEAM	✓	✓	thin white smoke
1	POBJECT_PAVEMENT_STEAM_SLOWMOTION	✓	✓	thick white smoke
2	POBJECT_WALL_STEAM	✓	✓	thin white smoke
3	POBJECT_WALL_STEAM_SLOWMOTION	✓	✓	thick white smoke
4	POBJECT_DARK_SMOKE	✓	✓	black smoke
5	POBJECT_FIRE_HYDRANT	✗	✗	fire hydrant water
6	POBJECT_CAR_WATER_SPLASH	✓	✓	large water splash
7	POBJECT_PED_WATER_SPLASH	✓	✓	medium water splash
8	POBJECT_SPLASHES_AROUND	✓	✗	a square of raindrops on the ground; if scale is 1.0, size of square is 1x1 units
9	POBJECT_SMALL_FIRE	✓	✗
10	POBJECT_BIG_FIRE	✓	✗
11	POBJECT_DRY_ICE	✓	✗
12	POBJECT_DRY_ICE_SLOWMOTION	✓	✗
13	POBJECT_WATER_FOUNTAIN_VERT	✓	✗	vertical fountain water
14	POBJECT_WATER_FOUNTAIN_HORIZ	✓	✓	horizontal fountain water
15	POBJECT_FIRE_TRAIL	✓	✓
16	POBJECT_SMOKE_TRAIL	✓	✓
17	POBJECT_FIREBALL_AND_SMOKE	✓	✓	initial explosion then smokes
18	POBJECT_ROCKET_TRAIL	✗	✓	initial explosion then smokes; setting duration to 0 can bug out all particles in the game, making random particles produce this smoke
19	POBJECT_EXPLOSION_ONCE	✗	✓	single brief explosion