CEG-OldInfo
Custom explosion generators
What are they?
Custom explosions are small explosion scripts read from gamedata/explosions/*.tdf. The explosion script specifies which particles/projectiles have to be created when the explosion happens, and their initial properties (position,speed,...)
Explosion script definition
The explosion script directly specifies which C++ projectile classes have to be created, and also which properties the projectiles should have.
The explosion script is structured like this:
[ExplosionScriptName]
{
[projectile scriptname] // this specifies the class of the projectile
{
[properties]
{
size = 40;
sizeGrowth = -2;
pos = -30 r60, r30, -30 r60; // These codes are explained below
speed=0.75 r-1.5, 1.7 r1.6, 0.75 r-1.5;
}
underwater=0; // should this projectile be created when underwater?
air=0; // should this projectile be created when in air?
water=1; // should this projectile be created on water?
ground=1; // should this projectile be created when on ground?
count=10; // number of projectiles of this type
}
.. other projectiles types can follow here ..
}
Defaults for air/underwater/ground/water are zero. Default of count is 1.
Projectile properties
To begin, you should run
spring /p (or "spring -p" on linux)
to let spring export "projectiles.txt", which contains all the classes you can use in an explosion script. At the time of writing, this would contain projectiles.txt
The items listed in "properties" are directly mapped to the class properties in projectiles.txt The properties are specified with a bit of a cryptic syntax. You can use extra commands in them (r,d,i). For example this:
pos = -30 r60, r30, -30 r60;
The x coordinate (specified with -30 r60) will be:
x = -30 + (Random value between 0 and 60);
Commands:
rX: add a number between 0 and X iX: multiply the projectile index with X and add it. See the example for this below. dX: multiply the damage with X and add it.
Explosion script examples
This is an example of a script that makes 10 smoke projectiles (yeah they should have been called particles, but they are handled by spring using the projectile system)
[ARM_HLT_Expl]
{
[smoke]
{
[properties]
{
// age increase per frame, when age >= 1 the particle is destroyed
ageSpeed=0.04;
size = 40;
sizeGrowth = -2;
pos = -30 r60, r30, -30 r60;
speed=0.75 r-1.5, 1.7 r1.6, 0.75 r-1.5;
}
water=1;
ground=1;
count=10;
}
}
This particular script would be linked to with "explosiongenerator=custom:ARM_HLT_Expl;"
Here is an example that uses the index (i) command in the properties:
[heatcloud]
{
[properties]
{
pos = 0, i20, 0;
heat = 10;
maxheat=10;
heatFalloff=1;
size = 30;
}
ground=1;
count=10;
}
This script creates a tower of heatcloud projectile. The first projectile gets y=0, the second y=20, y=40, y=60, .. and finally y=180
How to link a custom explosion to a weapon
The weapon definitions needs to have this in it:
explosiongenerator = custom:ExplosionScriptName;
The explosion definition for ExplosionScriptName would be one of the TDF files in gamedata/explosions/
You can also link the weapons for self-destruct and normal destruct to an explosion script.
Adding ground flashes
The ground flash is currently not an actual projectile, so it's specified in a different way:
[ARM_HLT_Expl]
{
.. projectiles definitions ..
[groundflash]
{
flashSize = 100; // flash size
flashAlpha = 1; // initial alpha of the flash
circleGrowth = 60; // size increase/frame
circleAlpha = 1; // initial alpha of the ring
ttl = 10; // number of frames
color = 0,0,1; // color RGB
}
}
