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; there is no way to remove a particle through the script when stuck in a loop so it is not recommended to use a duration of 0. 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.

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.

ID	Image	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
19		POBJECT_EXPLOSION_ONCE	✗	✓	single brief explosion

Keywords

scatter, add, moving, particle, object, effect