ParticleFields
List of particle fields:
! Note: all fields default to 0 or "" unless otherwise indicated or inherited from special case particle types.
Spawn Related Fields
. *count (count)*
- count: specifies number of particles to spawn with point effects
. *step (step)*
- step: specifies Quake units per particle to spawn with trails
! Note: step (x) is a synomyn for count 1/(x)
. *die (die)*
- die: specifies time in seconds it takes for the particle to die. A value of 0 means that the particle will be rendered for a duration of 1 frame.
. *diesubrand (rand)*
- rand: subtracts a random value from 0 to rand from the die time on particle spawn, and causes the particle to "decay" for that amount of time
! Note: Using diesubrand with delta ramps will cause weird things to happen.
. *assoc (particleeffectname)* - particleeffectname: name of other particle effect to execute when the current particle effect is executed ! Note: Using assoc to loop back to the same particle effect is invalid.
. *emit (particleeffectname)* - particleeffectname: specifies the particle effect that the current particles should emit
. *emitinterval (time)* - time: specifies the time between the emitting of the chosen effect (a value of less than 0 means to emit the chosen effect as a trail)
. *emitintervalrand (timerand)* - timerand: adds a value between 0 and timerand to the time interval on emit
. *emitstart (time)* - time: specifies time that emitting of the chosen effect should start after particle spawn
Render Related Fields
. *type (type)* - type: specifies the type of particles to use for the effect, possible types are "normal", "beam", and "decal". ! Note: type defaults to "normal" ! Note: "decal" is currently experimental. Use at your own risk.
. *colorindex (colorindex)* - colorindex: specifies the current loaded palette index to use with the particle ! Note: colorindex overrides red/green/blue values ! Note: A colorindex with a value greater than 255 means to apply an alpha value of 0.5 and use the remainder of colorindex / 256 for the actual colorindex. This is to mimic Hexen 2 behavior. ! Note: colorindex defaults to -1, meaning not to use a colorindex.
. *colorrand (colorrand)* - colorrand: adds a random value between 0 and colorrand-1 to the colorindex field on particle spawn
. *citracer (citracer)* - citracer: 1 enables Quake tracer-like index changes ! Note: Do not use this for any sane particle configs. This is bound to change.
. *red (red)* - red: changes the red color value with the range of 0-255
. *green (green)* - green: changes the green color value with the range of 0-255
. *blue (blue)* - blue: changes the blue color value with the range of 0-255
. *rgb (r) (g) (b)* - r: changes the red color value with the range of 0-255 - g: changes the green color value with the range of 0-255 - b: changes the blue color value with the range of 0-255 - Note: If b is excluded, g and b are assumed to be r
. *reddelta (reddelta)* - reddelta: specifies the rate of change of the red color value to reddelta per second
. *greendelta (greendelta)* - greendelta: specifies the rate of change of the green color value to greendelta per second
. *bluedelta (bluedelta)* - bluedelta: specifies the rate of change of the blue color value to bluedelta per second
. *rgbdelta (r) (g) (b)* - r: specifies the rate of change of the red color value to r per second - g (optional): specifies the rate of change of the green color value to g per second - b (optional): specifies the rate of change of the blue color value to b per second ! Note: If b is excluded, g and b are assumed to be r
. *rgbchangetime (time)* - time: specifies the time that reddelta/greendelta/bluedelta will remain in effect ! Note: defaults to die time
. *redrand (redrand)* - redrand: adds a random value between 0 and redrand to the red color value on particle spawn
. *greenrand (greenrand)* - greenrand: adds a random value between 0 and redrand to the green color value on particle spawn
. *bluerand (bluerand)* - bluerand: adds a random value between 0 and bluerand to the blue color value on particle spawn
. *rgbrand (r) (g) (b)* - r: adds a random value between 0 and r to the red color value on particle spawn - g (optional): adds a random value between 0 and g to the green color value on particle spawn - b (optional): adds a random value between 0 and b to the blue color value on particle spawn ! Note: If b is excluded, g and b are assumed to be r
. *redrandsync (redrandsync)* - redrandsync: specifies how much of the red random value should be in sync with a common random value (0 meaning no synchronization, 1 meaning full synchronization)
. *greenrandsync (greenrandsync)* - greenrandsync: specifies how much of the green random value should be in sync with a common random value (0 meaning no synchronization, 1 meaning full synchronization)
. *bluerandsync (bluerandsync)* - bluerandsync: specifies how much of the blue random value should be in sync with a common random value (0 meaning no synchronization, 1 meaning full synchronization)
. *rgbrandsync (r) (g) (b)* - r: specifies how much of the red random value should be in sync with a common random value - g: specifies how much of the green random value should be in sync with a common random value - b: specifies how much of the blue random value should be in sync with a common random value ! Note: 0 means no synchronization, 1 means full synchronization ! Note: If b is excluded, g and b are assumed to be r
. *isbeam* - Specifying this field with no parameters means all particles represents points in beams. ! Note: This field is obsolete, use "type" instead
. *stains (stain)* - stain: specifies if the particle should leave stains (0 meaning no, 1 meaning yes)
. *blend (mode)* - mode: specifies blend mode for the particles, valid modes are "add", "subtract", and "merge" ! Note: mode defaults to "merge" ! Note: "blend add" will remove the black in .png particle texture images (and possibly other image file formats too).
. *rotationstart (angle) (anglerand)* - angle: specifies angle the sprite should be rendered - anglerand (optional): adds a random number between 0 and anglerand to the angle on particle spawn ! Note: angle defaults to -180, and anglerand defaults to 360
. *rotationspeed (anglespeed) (anglespeedrand)* - anglespeed: specifies angles per second the sprite should rotate - anglespeedrand (optional): adds a random number between 0 and anglespeedrand to the angle speed on particle spawn
. *alpha (alpha)* - alpha: specifies starting transparency of the particle (0 meaning invisible, 1 meaning fully visible) ! Note: alpha defaults to 1
. *alphachange (alphachange)* - alphachange: specifies alpha change due to time (0 meaning no change in alpha over time, 1 meaning alpha change to 0 according to die time and starting alpha) ! Note: alphachange defaults to 1
. *texture (texturename)* - texturename: the texture name to apply to this particle. If no texture is applied, the particle is drawn as a spark, or a shaded beam if isbeam is set.
. *scale (scale)* - scale: sets scale of the particle
. *scalerand (scalerand)* - scalerand: adds a random value between 0 and scalerand to the scale on particle spawn
. *scalefactor (scalefactor)* - scalefactor: the factor that the particle scales due to distance. 0 means no scaling to distance, and 1 means normal scaling due to distance.
. *scaledelta (scaledelta)* - scaledelta: specifies the scale per second change of the particle
Movement/Placement Fields
. *spawnmode (mode)* - mode: specifies spawn mode to use for the particles, valid modes are "circle", "ball", "spiral", "tracer", "telebox", "lavasplash", "uniformcircle", "syncfield", and "box" ! Note: mode defaults to "box"
. *spawnorg (xy) (z)* - xy: specifies origin range in the x and y components that the spawn mode should effect - z (optional): specifies origin range in the z component that the spawn mode should effect ! Note: If z is excluded, z is assumed to be xy
. *spawnvel (xy) (z)* - xy: specifies velocity range in the x and y components that the spawn mode should effect - z (optional): specifies velocity range in the z component that the spawn mode should effect ! Note: If z is excluded, z is assumed to be xy
. *spawnparam1 (param)* - param: passes a parameter which changes spawn behavior based on spawn mode
. *spawnparam2 (param)* - param: passes a parameter which changes spawn behavior based on spawn mode
. *cliptype (particleeffectname)* - particleeffectname: specifies particle effect to spawn when a particle clips an object, specifying itself means that no effect will be spawned and the current particle will be maintained
. *clipcount (count)* - count: amount of particle effects to spawn when a particle clips an object
. *areaspread (areaspread)* - areaspread: specifies origin range in the x and y components that the spawn mode should effect ! Note: This field is obsolete, use spawnorg instead.
. *areaspreadvert (areaspreadvert)* - areaspreadvert: specifies origin range in the z component that the spawn mode should effect ! Note: This field is obsolete, use spawnorg instead.
. *offsetspread (offsetspread)* - offsetspread: specifies velocity range in the x and y components that the spawn mode should effect ! Note: This field is obsolete, use spawnvel instead.
. *offsetspreadvert (offsetspreadvert)* - offsetspreadvert: specifies velocity range in the z component that the spawn mode should effect ! Note: This field is obsolete, use spawnvel instead.
. *up (z)* - z: adds z to the z component of the origin for all particles
. *gravity (gravity)* - gravity: applies an acceleration of -gravity per second^2 to the particle ! Note: this is not effected by [sv_gravity]
. *randomvel (randomvel) (vert)* - randomvel: adds a random value from -randomvel to randomvel to the x and y components of the particle velocity - vert (optional): adds a random value from -vert to vert to the z component of the particle velocity ! Note: if vert is excluded, vert is assumed to be randomvel
. *veladd (veladd)* - veladd: if a direction is associated with the effect, veladd*direction is added to the particle velocity, otherwise veladd is added to the z component of the particle velocity
. *friction (x) (y) (z)* - x: applies friction to the x axis of the particles, slowing down by a factor of x per second - y (optional): applies friction to the x axis of the particles, slowing down by a factor of y per second - z (optional): applies friction to the x axis of the particles, slowing down by a factor of z per second ! Note: if 2 parameters are given, the format is assumed to be friction (xy) (z), with x and y assumed to be xy ! Note: if 1 parameter is given, x, y, and z are all assumed to be that 1 parameter
. *clipbounce (factor)* - factor: the velocity maintained after a particle bounces off of an object (0 meaning no velocity maintained, 1 meaning all velocity maintained) ! Note: factor defaults to 0.8
Ramp Fields
. *rampmode (mode)* - mode: specifies the ramp style to be used, possible modes are "none", "absolute", and "delta" ! Note: mode defaults to "none"
. *rampindexlist (index1)...(indexn)* - Adds a point in the ramp per number of color indexes - index1...indexn: list of color indexes to be used with the ramps ! Note: Alpha values are assumed to be 1 or 0.5 if the colorindex is greater than 255.
. *rampindex (index) (alpha) (scale)* - Adds a new point in the ramp - index: index to be used with this point of the ramp - alpha (optional): alpha value to be used with this point of the ramp - scale (optional): scale value to be used with this point of the ramp ! Note: If alpha is excluded, alpha is assumed to be 1 or 0.5 if the colorindex is greater than 255. ! Note: If scale is excluded, scale is assumed to be the scale given in the scale field.
. *ramp (r) (g) (b) (alpha) (scale)* - Adds a new point in the ramp - r: red color value to be used with this point of the ramp, with range 0-255 - g (optional): green color value to be used with this point of the ramp, with range 0-255 - b (optional): blue color value to be used with this point of the ramp, with range 0-255 - alpha (optional): alpha value to be used with this point of the ramp - scale (optional): scale value to be used with this point of the ramp ! Note: If b is excluded, g and b are assumed to be r. ! Note: If alpha is excluded, alpha is assumed to be the alpha given in the alpha field. ! Note: If scale is excluded, scale is assumed to be the scale given in the scale field.