= Creating Particle Systems =

You can create a particle system by either manually writing the .particle file or by using a graphical tool.

== Manual ==
Here you can find some documentation on how that is done: [http://ogre3d.org/tikiwiki/tiki-index.php?page=Particles&structure=Cookbook here] and [http://www.ogre3d.org/docs/manual/manual_34.html#Particle-Scripts here].


== Tools ==
There are various tools around, but they all seem outdated/old. Here is a list of the ones I've found. Also, most only work on windows:

 * [http://www.ogre3d.org/tikiwiki/Ogre+Particle+Lab OGRE Particle Lab]
 * [http://www.ogre3d.org/tikiwiki/OGRE+Particle+Editor OGRE Particle Editor]
 * [http://www.wzona.info/p/ogre-flow-particle-editor.html OGRE Flow - Particle Editor]
 * [http://www.fxpression.com/Download.html Particle Universe]

= Getting your particle system in the game =


Add your particle system in:
  code/data/particle/particle_name.oxw

{{{
    particle_system Orxonox/particle_name
    {
        //...
        material    PE/material_name
    }
}}}

Add the material to the PE_materials.material file in:
  data_extern/materials/PE_materials.material

{{{
    material PE/material_name
    {
        technique
        {
            pass
            {
                //...

                texture_unit
                {
                    texture texture_name.png
                }
            }
        }
    }
}}}

Add your texture(s) to:
  data_extern/images/textures

{{{
    texture_name.png
}}}

For testing, add a {{{<ParticleEmitter/>}}} to a test level in:
  code/data/levels/level_name.oxw

{{{
    <ParticleEmitter
        source="Orxonox/particle_name"
        //...
        position="0,0,0"
        lifetime=2.0 loop=1 startdelay=3.0
    />
}}}