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 (see below)
[flt2]: X-coordinate
[flt3]: Y-coordinate
[flt4]: Z-coordinate
[flt5]: X-strength
[flt6]: Y-strength
[flt7]: Z-strength
[flt1]: Scale
[int2]: Red, between 0 and 255
[int3]: Green, between 0 and 255
[int4]: Blue, between 0 and 255
[int5]: Duration in milliseconds

This opcode adds a moving particle effects at the specified location for a duration of time. Particle effects must be in range of the player (about 95 units) when adding them into the world; they will not appear when added outside the range. Particle effects that have been added will disappear when the player moves out of range regardless of duration.

Using a particle effect outside the range listed below produces unpredictable results and may crash the game. The colors red, green, and blue only affect particle 14 in GTA III and particle 16 in Vice City and has no effect on anything else. 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; using opcode 03AE or moving outside the range of the particle can remove a particle effect stuck in a loop. 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

Particle effect	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	✓	✓	the only particle effect that colors can be applied
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

Particle effect	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	✓	✓	the only particle effect that colors can be applied
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