particle.cfg

The particle.cfg file stores particle configuration data and settings for the particle system for GTA III and Vice City.

Format

See also: handling.cfg § Format and syntax description

The length of each line is limited to 500 characters instead of 200 characters in handling.cfg.

		Identifier	Type	Description
A		Particle name	string	The name of the particle.
B,C,D		Rendering color	integer[3]	The particle color in RGB format. Each is a value between 0 and 255.
E		Initial color variation	integer	Initial color variation of the particle. Using this value a random value gets calculated to manipulate each color level of the particle. This makes every particle look different. Value is between 0 and 100 (any value above 100 is set to 100). Example: Rendering color = (100, 100, 100), Initial color variation = 20 Real variation = random(-20, 20) Real color = (100 + Real variation, 100 + Real variation, 100 + Real variation)
F,G,H		Fade destination color	integer[3]	Destination color in RGB format if the particle is fading. Each is a value between 0 and 255.
I		Fading time	integer	Time required to fade from the rendering color to the fade destination color. Value is between 0 and 100.
J		Initial radius	float	Initial radius of the particle sprite.
K		Expansion rate	float	Rate the particle sprite grows during its lifetime.
L		Fade to black initial intensity	integer	If the particle "fades to black" (means it gets destroyed with fading) this value defines its initial intensity. The value is between 0 and 255 where 255 means 100%.
M		Fade to black time	integer	The number of frames between each fade step.
N		Fade to black amount	integer	The amount the initial intensity gets decreased with each step.
O		Fade alpha initial intensity	integer
P		Fade alpha time	integer
Q		Fade alpha amount	integer
R		Z rotation initial angle	integer	Initial angle around the z-axis. The value is between 0 and 1023.
S		Z rotation change time	integer	Number of frames between each rotation step.
T		Z rotation angle change amount	integer	Amount the sprite gets rotated around the z-axis with each step.
U		Initial z radius	float	Initial radius of the particle around the z-axis.
V		Z radius change time	integer	Number of frames between each radius change step.
W		Z radius change amount	float	Amount the radius changes with each step.
X		Animation speed	integer	Time between each animation step. 0 means that the particle is not animated.
Y		Animation start frame	integer	Index first frame of the animated particle.
Z		Animation final frame	integer	Index of the last frame of the animated particle.
AA		Rotation speed	integer
AB		Gravitational acceleration	float	Acceleration of the particle falling to the ground.
AC		Frictional deceleration	integer	Frictional deceleration of the particle. This value is between 0 and 1 where 1 represents 100%.
AD		Default life span	integer	Default lifetime of the particle in milliseconds.
AE		Position random error	float	Final position gets corrected using a random value between 0 and this one.
AF		Velocity random error	float	Final velocity gets corrected using a random value between 0 and this one.
AG		Expansion rate error	float	Expansion rate gets corrected using a random value between 0 and this one.
AH		Rotation rate error	integer	Rotation rate gets corrected using a random value between 0 and this one.
AI		Life span error shape	integer	Shape for the distribution of the particle's lifetime. Value is between 0 and 255.
AJ		Trail length multiplier	float	If the particle trail flag is set the length of its trail gets multiplied by this value.
–	AK	Stretch X	float	Amount the particle's texture gets stretched along x-axis.
–	AL	Stretch Y	float	Amount the particle's texture gets stretched along y-axis.
–	AM	Wind influence	float	Factor for the influence of wind for the particle.
AK	AN	Creation range	float	Maximum distance from the camera for actually creating the particle.
AL	AO	Flags	integer	See below

Flags

This section is incomplete. You can help by fixing and expanding it.

There are different flags that influence the particles rendering process. Those flags are listed in the following table:

Name	Flag	Binary	Description
–	-1	1111 1111 1111 1111	Enables all flags. [1] Never used by default.
ZCHECK_FIRST	1	0000 0000 0000 0001	–
ZCHECK_STEP	2	0000 0000 0000 0010	–
DRAW_OPAQUE	4	0000 0000 0000 0100	–
SCREEN_TRAIL	8	0000 0000 0000 1000	–
SPEED_TRAIL	16	0000 0000 0001 0000	–
RAND_VERT_V	32	0000 0000 0010 0000	–
CYCLE_ANIM	64	0000 0000 0100 0000	Cycles the particles animation.
DRAW_DARK	128	0000 0000 1000 0000	–
VERT_TRAIL	256	0000 0001 0000 0000	–
DRAWTOP2D	1024	0000 0100 0000 0000	–
CLIPOUT2D	2048	0000 1000 0000 0000	–
ZCHECK_BUMP	4096	0001 0000 0000 0000	–
ZCHECK_BUMP_FIRST	8192	0010 0000 0000 0000	–

List of particles in III

The following table shows a list of particles defined in the particle.cfg files. The images were taken on a Sunny day at 12:00, pointed at the sky. The scale of the particles was 0, which is the default size for most particles.

Image	ID	Name
	0	SPARK
	1	SPARK_SMALL
	2	WHEEL_DIRT
	3	WHEEL_WATER
	4	BLOOD
	5	BLOOD_SMALL
	6	BLOOD_SPURT
	7	DEBRIS
	8	DEBRIS2
	9	WATER
	10	FLAME
	11	FIREBALL
	12	GUNFLASH
	13	GUNFLASH_NOANIM
	14	GUNSMOKE
	15	GUNSMOKE2
	16	SMOKE
	17	SMOKE_SLOWMOTION
	18	GARAGEPAINT_SPRAY
	19	SHARD
	20	SPLASH
	21	CARFLAME
	22	STEAM
	23	STEAM2
	24	STEAM_NY
	25	STEAM_NY_SLOWMOTION
	26	ENGINE_STEAM
	27	RAINDROP
	28	RAINDROP_SMALL
	29	RAIN_SPLASH
	30	RAIN_SPLASH_BIGGROW
	31	RAIN_SPLASHUP
	32	WATERSPRAY
	33	EXPLOSION_MEDIUM
	34	EXPLOSION_LARGE
	35	EXPLOSION_MFAST
	36	EXPLOSION_LFAST
	37	CAR_SPLASH
	38	BOAT_SPLASH
	39	BOAT_THRUSTJET
	40	BOAT_WAKE
	41	WATER_HYDRANT
	42	WATER_CANNON
	43	EXTINGUISH_STEAM
	44	PED_SPLASH
	45	PEDFOOT_DUST
	46	HELI_DUST
	47	HELI_ATTACK
	48	ENGINE_SMOKE
	49	ENGINE_SMOKE2
	50	CARFLAME_SMOKE
	51	FIREBALL_SMOKE
	52	PAINT_SMOKE
	53	TREE_LEAVES
	54	CARCOLLISION_DUST
	55	CAR_DEBRIS
	56	HELI_DEBRIS
	57	EXHAUST_FUMES
	58	RUBBER_SMOKE
	59	BURNINGRUBBER_SMOKE
	60	BULLETHIT_SMOKE
	61	GUNSHELL_FIRST
	62	GUNSHELL
	63	GUNSHELL_BUMP1
	64	GUNSHELL_BUMP2
	65	TEST
	66	BIRD_FRONT
	67	RAINDROP_2D

List of particles in Vice City

This section is incomplete. You can help by fixing and expanding it.

The following gallery shows ingame screenshots of the particles defined inside the default particle configuration.

• Particle effects
• 

  SPARK

• 

  SPARK_SMALL

• 

  WATER_SPARK

• 

  WHEEL_DIRT

• 

  SAND

• 

  WHEEL_WATER

• 

  BLOOD

• 

  BLOOD_SMALL

• 

  BLOOD_SPURT

• 

  DEBRIS

See also

• The particle system of GTA San Andreas

References

• ^ Two's complement