Particle Manual
2 General Keywords
How the particles look.
Mode may be:
beam: valid only for trails. Particles form a single textured beam acting as nodes along it.
spark: particles are lines, their length depending upon their speed.
sparkfan: particles are non-planar triangle fans, their length depending upon their speed.
texturedspark: textured particles are aligned along their direction of movement, their length depending upon their speed, width equal to their scale.
cdecal/decal: particles are spawned only upon bsp geometry. They are clipped by it.
udecal: unclipped decal. exact semantics are subject to change.
normal/*default*: Particles are regular, rotating, 2d images.
Point/box effects only (not trails or beams)
Specifies how many particles are spawned per effect (some classic effects contain an extra scaler which is multiplied by the resulting value)
Specifies another effect to spawn at the same time that this effect is spawned.
Thus allowing two sets of particles from one effect.
Specifies the maximum age of the particle, in seconds.
This affects how particles are positioned when they first spawn, and their initial velocities.
For point effects, mode may be one of:
box: simple axially aligned box of particles.
circle: particles spawn within a ball with uniform distance from the center. none will appear in the middle.
arg1: percentage of the circle to cover. a value of 5 will go around the circle 5 separate times. this can be used for weird beam effects.
areaspread: the radius of the ball
areaspreadvert: the height of the ball. if 0, will be a flat circle
ball: particles spawn randomly within a ball.
areaspread: the radius of the ball
areaspreadvert: the height of the ball. if 0, will be a flat circle.
telebox: matches quake's telebox
lavasplash: like chthon's lava splash
uniformcircle: particles are spawned in a circle with uniform distance between and from the center. z=0.
syncfield: particles spawn at predictable locations based upon time within a rough sphere. Only useful for effects that are regenerated+replaced every frame.
distball:
*default*: regular box. particles are spawned inside an axially aligned box.
For trail effects, mode may be one of:
spiral: particles are given velocities perpendicular to the direction based on the distance moved.
tracer: particles spawn with alternating horizontal velocities (a wake effect).
*default*: particles spawn as a regular trail.
Implies 'type decal'.
The two extra args allow you to spawn these decals ONLY on surfaces with matching surfaceflags.
Separation of mask+match allows you to create many descrete surface types instead of being limited to 32 bits/types.
Specifies the effect to periodically emit.
Particles will not emit additional effects for this duration after emitting one.
FIXME: fold into emitinterval
Prevents the particle from emitting anything for this duration when it first spawns.
Apply inverse frametime to count (causes emits to be per frame).
Average trail points from start to end, useful with t_lightning, etc
Causes the particle system to ignore all state information.
Plays a sound when the effect is spawned.
Only ONE sound will be used, picked randomly from the included sounds according to their weights.
Options are:
vol=
attn=
pitch=
delay=
weight=
Spawns sprites or models that fly away with random angles and run through
some frame sequence. handy for simple gib effects.
Options are:
frame=
framestart=
framecount=
frameend=
frames=
framerate=
skin=
alpha=
scalemin=
scalemax=
trail=
orient
additive
transparent
fullbright
shadow
noshadow
Specifies that this particle type should move relative to the camera.
Should not normally be used in combination with clipping/bouncing.
Not compatible with most splitscreen games.
Back | Home | Next