To begin, there are a few ways to enable particle effects:

1. Create a weapon in a weapons.sbc file, you will need this part of code to enable the particle effect.

The Dummy is the empty name that is in the model you will attach the particle effect to. This empty may need to be rotated, or just rotate the projection of the effect via the property settings discussed later.

2. Utilize the damage state of a block for particle effect

3. use Particle Emitter mod (link is at end of this section)
Particle Emitter Mod
The Particle Effect Example

Once you have set up how you want to have your particle rendered in game, you can now start editing your particle effect. You can either use the example particle effect from the link above or copy one from one of keen's files in Particles_A.sbc or Particles_B.sbc and use those.

To begin editing the particle you can collapse all levels of the xml in the sbc file, if you are using notepad++ you can minimize all Property tags of the effect to better see the PE settings, below is an easier way of displaying the PE settings.


The below code shows how your file should look with the ID and subtypeID for the effect.
Note: The DurationMin/DurationMax is the total time the particle lasts, later in the properties there is a Life tag, and that is the time that a single particle spawn lives during the durationMin/Max.



This line here you can define your particle name. Not necessary, but will help you sort your particle effect generation sections (PE generation is unique to each particle you have, you can have multiple of the PE generations in a single Particle Effect)


Each PE has Properties sections to define parts of the PE. The property tags define how parts of the particle effect work, there are many, so you can start off with only changing a few to get the hang of this.
Every <Property> tag has a name in it as you can see and basically describes what that particular setting does to the PE. I will describe what the different parts and what they do to better detail than what is in this image.


I had started this guide when I was working on the tractor beam mod, now that there is a mod that allows you to show particle effects, this is an easy way for you to test your particle effects (yes they do show up on the particle list if you have a mod with your particle effect enabled in the world)
======================================
Particle Emitter Mod
The Particle Effect Example
======================================
In this guide I am assuming that you already know how to setup a mod and what you basically need to get started, the only additional things you'll need for a particle effect is a particleeffect.sbc file to save your custom particle in. If you create your own particle atlas you will also need a transparent material definition to define your custom particle effect atlas image. Reference keens TransparentMaterials.sbc file and copy one from there and change the texture location and subtypeid.

The next section describes the property tags and what they do.

To be able to set up your particle effect you'll have to know a few things about these property tags, there are many properties to these particle effects, if you break one and your particle stops working, just revert to where it was working and try again. Here are all of the tags and descriptions of what they do. I try and describe in short what each of these do, you may ask what the 'Key' values are. Those denote time incremented values for specific properties controlled by time and size/intensity, they both can be float/decimal numbers.
The Type of property you can tell by the Type tag:
*Bool - which would require either true or false.
*Int - which requires a whole number
*Float - which can be decimal numbers
*Vector3 - which is usually coordinates on x,y,z
*Vector4 - color denotation (r g b A = x,y,z,W)



-- Rows and columns count (if your atlas is 4 images across x 8 images down, then your Array Size will be x=4 y=8)

-- First frame to use (if first image on atlas then 1, if 2nd or 3rd row, just count amount of images from 1)

-- amount of frames to be played

-- Controls Color of Effect

-- Variation of color intensity

-- how bouncy particle is when bouncing on surfaces

-- scale of emitter, area that particles spawn in

-- when outer size is larger you can have inner size be larger and make a hole in the center

-- direction x,y,z to which particle will align (0,0,0 disables particle)

-- Velocity of particle on axis

-- randomizes spawn velocity

-- direction of inner emitter

-- direction of outer emitter

-- acceleration of particle from emitter

-- acceleration over time

-- speed of particle rotation on z axis

-- radius of particles (scale)

-- Duration of particle effect

-- amount of trails each particle

-- how long each frame plays per loop

-- Enables/Disables Effect

-- how many particle spawn per second

-- TransparentMaterials.sbc where texture is found (either keen's or your own)

-- smooths transitions to better approximate the intended effect.

-- can collide with objects

-- Does particle have sleep state? (no changes noted)

-- particle is light source

-- whether particle emits volumetric lighting

-- don't know what this does, didn't observe any change

-- affected by gravity any integer number +/- gravity

-- offset from point of origin 0,0,0 or empty it's attached to.

-- sets rotation speed, float so can be 0.1

-- varies the specified amount from set hue

-- allows rotation of particle separate from object

-- Inherits motion of empty or object attached to, time controlled

-- variable life of particle

-- persistent trails

-- Rotational reference for p

-- Rotates effect on respective axis

-- randomizes angle from specified angle

-- determines width of particle 1=square 2=rectangle

-- Particle instances allowed per frame

-- camera bias is used to layer your effects, give this a higher number to bring to front, you use each number as a layer number.

-- how emissive the particle will be

-- unknown, no observed change

-- use the emissive channel R in the atlas

-- unknown, no observed change

-- Affected by ambient light?

-- radius variation of particle

-- determines how much particle rotates after collision

-- determines how many collisions particle has before it dies

In this section you'll learn how the atlas is used in the particle effects, and how you can set up your own custom effect with the particle atlas using the size, offset, and modulo properties. (Thank you to Eikester for the help with understanding the modulo properties.)

For this image the atlas is divided up into 16x16 frames, to determine how to get this shape, you need to know the size of the atlas image (in this case it's 8192x8192 which is also the actual required size of particle atlas). You add up the amount of images accross the image and you can get the x size, which is 16, you then take 8192 divide by 16 will get you 512. This means that the frames on the top row are 512x512 (because they are square), so you have 16 frames per row of 4 rows of the explosion. Since these are square your property size of the frames will be:


In this image the frames are split into 256x256, which would be 32x32 in the size property.

This image denotes the 32x16 (256x512) frame size, which you would use with the lightning near the bottom of this atlas.


The offset property tells the particle on which frame to start on the atlas.
So, if you are using the 16x16 frame size an you want to use the explosion frames you would start offset at 0. All frame sizes start with 0, so an easy way to figure out quickly what frame you want to start on you would take the number of the row, and columns and multiply them. What I mean is you take for example the lightning section, you would use 32x16 as frame size and then multiply 32x14 to get the starting frame for the lightning. But, for the explosion effect we would start frame at 0 since it it the first frame on the atlas.

The modulo property tell the effect how many frames to use starting with the offset frame number.
when using the lightning effect it would start at frame 448 and count 32 frames over and repeat. For the explosion effect you would use frame 0-64 since the frames are 16x16.


The two mods you'll need for easier particle testing
Particle Emitter Mod
the example mod if you want notations in the file.
The Particle Effect Example

I know this doesn't cover all particles, but you should be able to get creating your own with this information. Also you will need to subscribe to the particle example mod and Particle Emitter mod to get the annotated xml file.