[Copy] Generator {
State = "";
Flat = "";
Mobj = "";
Alt Mobj = "";
Damage Mobj = "";
Map = "";
Flags = flaga | flagb | flagc;
Speed = 0.0;
Speed Rnd = 0.0;
Vector { 0.0 0.0 0.0 }
Vector Rnd { 0.0 0.0 0.0 }
Init Vector Rnd = 0.0;
Center { 0.0 0.0 0.0 }
Submodel = -1;
Spawn Radius = 0.0;
Min Spawn Radius = 0.0;
Distance = 0.0;
Spawn Age = 0;
Max Age = 0;
Particles = 0;
Spawn Rate { 0.0 0.0 0.0 }
Spawn Rnd = 0.0;
Presim = 0;
Alt Start = 0;
Alt Rnd = 0.0;
Force = 0.0;
Force Radius = 0.0;
Force Origin { 0.0 0.0 0.0 }
Force Axis { 0.0 0.0 0.0 }
Stage {
Type = "";
Tics = 0;
Rnd = 0.0;
Color { 0.0 0.0 0.0 }
Radius = 0.0;
Radius Rnd = 0.0;
Flags = flaga | flagb | flagc;
Bounce = 0.0;
Gravity = 0.0;
Force { 0.0 0.0 0.0 }
Resistance = 0.0;
Spin Resistance { 0.0 0.0 }
Frame = "";
End Frame = "";
Spin { 0.0 0.0 }
Spin Resistance { 0.0 0.0 }
Sound = "";
Volume = 1.0;
Hit Sound = "";
Hit Volume = 1.0;
}
}
Makes this a state triggered generator. Whenever a mobj is set to this state, a new particle generator is spawned. If the spawn flag is set, the generator is only spawned when the source mobj itself is being spawned (handy if the mobj has a loop of states and the generator should only be spawned when the state is first set).
Makes this a flat triggered generator. Each plane with the given flat receives its own generator. Flags can be used to control where the particles are actually spawned.
Makes this a type triggered generator. The value must be a defined thing ID (e.g., “PLAYER”). All type triggered generators are spawned in the beginning of a level, and they create particles using all mobjs of the given type as sources. Use the static flag to prevent the generator from being removed by later generators (could happen when the maximum number of generators is reached).
Alternate mobj type for type triggered generators.
Makes this a damage triggered generator. The generator is spawned when a mobj of the specified type receives damage. The initial movement direction is calculated from the relative positions of the mobjs involved in the operation, so that positive speed values will make the particles move away from the inflictor (in the direction of the damage).
Makes this a map triggered generator. The generator is spawned only in the specified map (e.g., “E2M3”). The Center defines the spawn origin.
| Flag | Description |
|---|---|
| static | Generator will not be removed until it times out. Otherwise it might get replaced by newer generators if there are too many active generators. |
| extra | State triggered: This generator is to be spawned simultaneously with the previously defined generator. This allows having multiple generators assigned to the same state. If this flag is not used, all the previously defined generators associated with the state are ignored. |
| srcvel | State/Type triggered: Particles inherit their source's velocity (in addition to spawn velocity). |
| srcdir | State/Type triggered: Particle movement vector is rotated using source's direction angle. |
| spawn | Generator is only spawned if the source mobj is being spawned. |
| blendadd or blend | Particles of the generator are rendered using additive blending. |
| blendrsub | Particles of the generator are rendered using reverse subtractive blending (framebuffer - particle). |
| blendsub | Particles of the generator are rendered using subtractive blending (particle - framebuffer). |
| blendmul | Particles of the generator are rendered using multiplicative blending (particle * framebuffer). |
| blendimul | Particles of the generator are rendered using inverse multiplicative blending ((1 - particle) * framebuffer). |
| modelonly | The particle generator will only be active if the source is represented by a 3D model. |
| floor | Flat triggered: Particles of the generator will be created on the floor of the source sector. |
| ceiling | Flat triggered: Particles of the generator will be created in the ceiling of the source sector. |
| space | Flat triggered: Particles of the generator will be spawned at a random height in the sector. |
| density | Flat_triggered: Particles specifies the maximum density of particles per block (128×128) rather than the maximum number of particles for the generator. |
| group | Flat triggered: The generator will by used for all flats which share the same group. Useful when defining generators for lava, water, etc…, special effects. |
Initial speed for new particles.
Randomness of initial particle speed [0..1]:
Initial movement direction for new particles.
Randomness of initial particle direction. Random components of the given value are added to Vector. For example, if Vector Rnd is 2, a random vector with components ranging from -2 to 2 is added to Vector.
One-time random component applied to Vector when the generator is spawned. Works the same as #Vector Rnd but only applied once.
State/Type triggered: An offset to the source coordinates.
Map triggered: Origin of the generator (X, Y, Z) in the map's coordinate space.
State/Type triggered: If the source is represented by a 3D model, this submodel's center will be used as the origin of the generator. If less than zero, the source's actual coordinates are used and the model has no effect on the origin's position.
Particles will be spawned at a random distance from the center of the source, at a distance of at most this many units. A flat distribution inside a cube is used if the Min spawn radius is zero.
Particles will be spawned at least this many units away from the center of the source. Setting this to a nonzero value will enable the more advanced algorithm for choosing particle spawn coordinates: a random point is chosen inside a sphere with the radius of Spawn radius, but not closer than Min spawn radius.
Maximum distance at which the particles of the generator are visible. If zero, there is no distance limitation.
Number of tics that the generator will create new particles after having been spawned. If -1, the generator will continue creating new particles until destroyed.
Maximum generator lifetime, in tics. If -1, the generator will not be destroyed until either replaced by a newer generator or the level ends.
Maximum number of particles that the generator can have, or the maximum density of particles per 128×128 block (with flat triggered generators using the density flag).
Number of new particles spawned per game tic. Fractional values are allowed (< 1.0).
Randomness of spawn rate (between 0 and 1):
Number of tics to “think ahead” when the generator is spawned. Useful with flat triggered generators that are visible right after starting a map.
Index number of the alternative particle start stage. By default all particles start from stage zero.
Randomness of initial particle stage (between 0 and 1):
Strength of the sphere force that pulls or pushes particles towards the surface of the sphere. In most cases the value should be less than one.
Radius of the sphere for sphere force. The force will push or pull particles to the surface of this sphere, centered around the center of the generator (with the offset specified with Force origin applied).
Defines the coordinates for the force sphere in relation to the center of the source.
The sphere force can also rotate particles around an axis. The length of the axis defines how strong the rotation is.
Each generator can have many particle stages. Each particle will go through the defined stages starting from zero or the alternative start stage.
| Identifier | Description |
|---|---|
| line | Render particle as a line. The length of the line is determined automatically according to the speed of the particle. |
| point | Render particle as a point. |
| texNN | Render the particle as a point-sprite using a texture loaded from the “data/<game-module>/textures/” directory, where the file name is particleNN.ext. For example: “tex01” → particle01.png |
| modelNN | Render the particle as a model using the definition with ID ParticleNN. |
| Flag | Description |
|---|---|
| stagetouch | When touching a wall or a plane, the particle will immediately skip to the next stage. |
| stagevtouch | Same as stagetouch but only applies to walls. |
| stagehtouch | Same as stagetouch but only applies to floor/ceiling planes. |
| dietouch | Particle will die when it touches a wall or floor/ceiling plane. |
| bright | Particle color is not affected by the light level of the sector it is in. |
| flat | When touching a wall or floor/ceiling plane, the particle is drawn flat against the surface. |
| vflat | Same as flat but only applies to walls. |
| hflat | Same as flat but only applies to floor/ceiling planes. |
| force | Particle is affected by the sphere force. |
| zeroyaw | Set particle yaw to zero. |
| zeropitch | Set particle pitch to zero. |
| rndyaw | Set particle yaw to a random value. |
| rndpitch | Set particle pitch to a random value. |
Force { 0 0 -1 }