Editing Darkplaces effectinfo reference
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
| Latest revision | Your text | ||
| Line 1: | Line 1: | ||
| − | |||
EffectInfo is built-in scripting language to describe particle effects in DarkPlaces, it's pretty simple and contains basic scripting functions. | EffectInfo is built-in scripting language to describe particle effects in DarkPlaces, it's pretty simple and contains basic scripting functions. | ||
Each effect can have several emitters which is defined in effectinfo.txt or maps/''mapname''_effectinfo.txt. Where mapname is a name of the map currently loaded (without path and extension). | Each effect can have several emitters which is defined in effectinfo.txt or maps/''mapname''_effectinfo.txt. Where mapname is a name of the map currently loaded (without path and extension). | ||
| − | ==General syntax== | + | == General syntax == |
// emitter 1 | // emitter 1 | ||
| Line 24: | Line 23: | ||
... | ... | ||
| − | == | + | == Console variables == |
| − | '''effect <name>''' | + | r_drawparticles : toggle drawing of all particles |
| + | |||
| + | r_drawparticles_drawdistance : set a maximal distance to draw particles at | ||
| + | |||
| + | cl_particles_size : this will scale a size of all particles | ||
| + | |||
| + | cl_particles_quality : multiplier of particles count spawned by emitters, better quality = more particles (1 - min, 4 - max. quality) | ||
| + | |||
| + | cl_particles_reloadeffects : reloads effectinfo.txt while in the game; that eliminates a need to quit and restart DP to see updated effects | ||
| + | |||
| + | == Particle parameters == | ||
| + | |||
| + | ''' effect <name>''' | ||
Defines a new emitter with effectname is belongs to, all parms after that will be applied to that emitter. | Defines a new emitter with effectname is belongs to, all parms after that will be applied to that emitter. | ||
| − | '''count <count>''' | + | ''' count <count>''' |
How many particles to spawn at this emitter, this setting is affected by cl_particles_quality cvar | How many particles to spawn at this emitter, this setting is affected by cl_particles_quality cvar | ||
| − | '''countabsolute <count>''' | + | ''' countabsolute <count>''' |
Defines a count of particles spawned regardless of cl_particles_quality setting | Defines a count of particles spawned regardless of cl_particles_quality setting | ||
| Line 40: | Line 51: | ||
Total particles count = countabsolute + count * cl_particles_quality | Total particles count = countabsolute + count * cl_particles_quality | ||
| − | '''type <type>''' | + | ''' type <type>''' |
Sets a generic particle type, affect appearance, blending, physics. | Sets a generic particle type, affect appearance, blending, physics. | ||
| Line 46: | Line 57: | ||
List of particle types: | List of particle types: | ||
| − | :alphastatic : alpha-blended billboard | + | : alphastatic : alpha-blended billboard |
| − | :static : additive-blended billboard | + | : static : additive-blended billboard |
| − | :spark : additive blended, stretched (based on velocity) | + | : spark : additive blended, stretched (based on velocity) |
| − | :beam : a beam particle, drawn from origin to origin + velocity | + | : beam : a beam particle, drawn from origin to origin + velocity |
| − | :rain : a rain particle, alpha-blended spart that will cause splash effect on impact | + | : rain : a rain particle, alpha-blended spart that will cause splash effect on impact |
| − | :raindecal: oriented rain decal, additive-blended | + | : raindecal: oriented rain decal, additive-blended |
| − | :snow: alpha blended, velocity jitters in realtime | + | : snow: alpha blended, velocity jitters in realtime |
| − | :bubble: alpha-blended | + | : bubble: alpha-blended |
| − | :blood: inverse-modulated, leaves decal | + | : blood: inverse-modulated, leaves decal |
| − | :smoke: alpha-blended billboard | + | : smoke: alpha-blended billboard |
| − | :decal: makes a decal on nearest surface | + | : decal: makes a decal on nearest surface |
| − | :entityparticle: alpha-blended, this particle gets removed after being drawn (used on EF_BRIGHTFIELD) | + | : entityparticle: alpha-blended, this particle gets removed after being drawn (used on EF_BRIGHTFIELD) |
| − | '''blend <blendtype>''' | + | ''' blend <blendtype>''' |
Generic blend is set by type, but with this parm it cound be changed after type is defined. | Generic blend is set by type, but with this parm it cound be changed after type is defined. | ||
| Line 69: | Line 80: | ||
: invmod: inverse modulation (used on blood and blood decals) | : invmod: inverse modulation (used on blood and blood decals) | ||
| − | '''orientation <orientationtype>''' | + | ''' orientation <orientationtype>''' |
Same as for blend, generic orientation is set by type, could be altered by this parm. | Same as for blend, generic orientation is set by type, could be altered by this parm. | ||
| Line 75: | Line 86: | ||
List of orientation types: | List of orientation types: | ||
| − | :billboard : always turned to viewer | + | : billboard : always turned to viewer |
| − | :oriented : ignores viewwer, turned to velocity | + | : oriented : ignores viewwer, turned to velocity |
| − | :beam : facing viewer on 2 axises, stretched from origin to origin + velocity | + | : beam : facing viewer on 2 axises, stretched from origin to origin + velocity |
| − | :spark : facing viewer on 2 axises, stretched (based on velocity) | + | : spark : facing viewer on 2 axises, stretched (based on velocity) |
| − | '''color <min_color> <max_color>''' | + | ''' color <min_color> <max_color>''' |
Sets a color for particles. On each particle spawn, it's color is linearly randomized betwen two given colors. Color should be defined as HEX 0xRRGGBB, like 0xFFFFFF is white, and 0xFF0000 is red. | Sets a color for particles. On each particle spawn, it's color is linearly randomized betwen two given colors. Color should be defined as HEX 0xRRGGBB, like 0xFFFFFF is white, and 0xFF0000 is red. | ||
| − | '''tex <min_index> <max_index>''' | + | ''' tex <min_index> <max_index>''' |
Sets a index of particle from particlefont. Indexes are counted from left to right, from up to down, last index is 63, first is 0. Randomized linearly on each particle spawn. | Sets a index of particle from particlefont. Indexes are counted from left to right, from up to down, last index is 63, first is 0. Randomized linearly on each particle spawn. | ||
| − | '''size <min_size> <max_size>''' | + | ''' size <min_size> <max_size>''' |
Size of particle in game units, typical value is 4, randomized. | Size of particle in game units, typical value is 4, randomized. | ||
| − | '''sizeincrease <rate>''' | + | ''' sizeincrease <rate>''' |
This will make particle grow or diminish over time. <rate> is to how much utits to add or subtract per second. Note that while diminishing particle, engine will not check if particle will go to negative size, it will just invert it. | This will make particle grow or diminish over time. <rate> is to how much utits to add or subtract per second. Note that while diminishing particle, engine will not check if particle will go to negative size, it will just invert it. | ||
| − | '''alpha <min_alpha> <max_alpha> <fade_rate>''' | + | ''' alpha <min_alpha> <max_alpha> <fade_rate>''' |
Opacity of particles, 256 is opaque, 0 is transparent. Randomized. Could be more that 256 (to simulate fade delay). Fade rate is how huch alpha to throw away per second, once particle gets alpha 0 (full transparence), it gets removed. | Opacity of particles, 256 is opaque, 0 is transparent. Randomized. Could be more that 256 (to simulate fade delay). Fade rate is how huch alpha to throw away per second, once particle gets alpha 0 (full transparence), it gets removed. | ||
| − | '''time <min_time> <max_time>''' | + | ''' time <min_time> <max_time>''' |
Particle time-to-live in seconds, randomized. | Particle time-to-live in seconds, randomized. | ||
| − | '''gravity <value>''' | + | ''' gravity <value>''' |
Particle gravity modifier, 1 is full gravity, 0.5 is half etc., negative values are supported (particle go up). | Particle gravity modifier, 1 is full gravity, 0.5 is half etc., negative values are supported (particle go up). | ||
| − | '''bounce <value>''' | + | ''' bounce <value>''' |
Particle bounce-of-walls factor, 1 - bounce with full speed, 0.5 bounce with half speed. A value of -1 means particle will be removed on impact. Not that particle physics considered slow and spawning lots of bouncing particles is not recommended. | Particle bounce-of-walls factor, 1 - bounce with full speed, 0.5 bounce with half speed. A value of -1 means particle will be removed on impact. Not that particle physics considered slow and spawning lots of bouncing particles is not recommended. | ||
| − | '''airfriction <value>''' | + | ''' airfriction <value>''' |
Particle friction while moving in air, good option for smoke emitters. A value of 0 means no friction, negative values will do acceleration. | Particle friction while moving in air, good option for smoke emitters. A value of 0 means no friction, negative values will do acceleration. | ||
| − | '''liquidfriction <value>''' | + | ''' liquidfriction <value>''' |
Particle friction while moving in liquids. | Particle friction while moving in liquids. | ||
| − | '''originoffset <x> <y> <z>''' | + | ''' originoffset <x> <y> <z>''' |
Offset particle spawning origin by this values. Coordspace are world, x - forward, y - right, z - up. | Offset particle spawning origin by this values. Coordspace are world, x - forward, y - right, z - up. | ||
| − | '''velocityoffset <x> <y> <z>''' | + | ''' velocityoffset <x> <y> <z>''' |
Add this amount of constant velocity to particle on spawn. | Add this amount of constant velocity to particle on spawn. | ||
| − | '''originjitter <x> <y> <z>''' | + | ''' originjitter <x> <y> <z>''' |
Like originoffset but each axis is jittered between -value/+value. Hence it is defining spherical shape of particle random spawning. | Like originoffset but each axis is jittered between -value/+value. Hence it is defining spherical shape of particle random spawning. | ||
| − | '''velocityjitter <x> <y> <z>''' | + | ''' velocityjitter <x> <y> <z>''' |
Same as originjitter but for velocity. | Same as originjitter but for velocity. | ||
| − | '''velocitymultiplier <x>''' | + | ''' velocitymultiplier <x>''' |
Multiply particle starting velocity (one that set by QC or engine, whatever calls effect) by this value. Useful with trails. Negative values are supported. | Multiply particle starting velocity (one that set by QC or engine, whatever calls effect) by this value. Useful with trails. Negative values are supported. | ||
| − | '''underwater ''' | + | ''' underwater ''' |
Sets underwater flag for particles. Particles that are underwater will be removed in air. Useful for water bubbles. | Sets underwater flag for particles. Particles that are underwater will be removed in air. Useful for water bubbles. | ||
| − | '''notunderwater''' | + | ''' notunderwater''' |
Sets notunderwater flag for particles. Particles that are notunderwater will be removed in liquid. Useful for fire particles. | Sets notunderwater flag for particles. Particles that are notunderwater will be removed in liquid. Useful for fire particles. | ||
| − | '''trailspacing <x>''' | + | ''' trailspacing <x>''' |
This parm is only useful when effect is spawned as trail, defines a game units gap between effect invocations. | This parm is only useful when effect is spawned as trail, defines a game units gap between effect invocations. | ||
| − | '''stretchfactor <x>''' | + | ''' stretchfactor <x>''' |
A custom stretch factor that is used on sparks. | A custom stretch factor that is used on sparks. | ||
| − | '''rotate <startangle_min> <startangle_max> <spin_min> <spin_max>''' | + | ''' rotate <startangle_min> <startangle_max> <spin_min> <spin_max>''' |
Used to rotate particle, first 2 parms is start angle, other two are spin velocity. | Used to rotate particle, first 2 parms is start angle, other two are spin velocity. | ||
| − | ==Particles leaving decals== | + | == Particles leaving decals == |
Particles can leave decals once hit something. For this behavior a special set of parms should be used. This section is unfinished, futher explanation is required. | Particles can leave decals once hit something. For this behavior a special set of parms should be used. This section is unfinished, futher explanation is required. | ||
| − | '''staincolor <min_color> <max_color>''' | + | ''' staincolor <min_color> <max_color>''' |
A randomized color for decal particle. | A randomized color for decal particle. | ||
| − | '''stainalpha <min_alpha> <max_alpha>''' | + | ''' stainalpha <min_alpha> <max_alpha>''' |
A randomized alpha. | A randomized alpha. | ||
| − | '''stainsize <min_size> <max_size>''' | + | ''' stainsize <min_size> <max_size>''' |
A randomized size. | A randomized size. | ||
| − | '''staintex <min_index> <max_index>''' | + | ''' staintex <min_index> <max_index>''' |
A randomized index into particlefont. | A randomized index into particlefont. | ||
| − | '''stainless''' | + | ''' stainless''' |
Disables decal spawning and returns all parms to it's default values. | Disables decal spawning and returns all parms to it's default values. | ||
| − | ==Dynamic lights== | + | == Dynamic lights == |
Dynamic realtime lights could be placed in particle effects (useful for explosions) with this range of parms. This parms applied just like standart ones. | Dynamic realtime lights could be placed in particle effects (useful for explosions) with this range of parms. This parms applied just like standart ones. | ||
| Line 213: | Line 224: | ||
Sets a numbered cubefilter for light, cubemap texture is cubemaps/<value> | Sets a numbered cubefilter for light, cubemap texture is cubemaps/<value> | ||
| − | ==Engine effect | + | == Engine effect names == |
Heres a list of effect names used by engine. | Heres a list of effect names used by engine. | ||
| Line 251: | Line 262: | ||
: TR_GLOWTRAIL | : TR_GLOWTRAIL | ||
: SVC_PARTICLE | : SVC_PARTICLE | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
[[Category:Darkplaces engine]] | [[Category:Darkplaces engine]] | ||
| − | |||
