Custom Particles

As of version 1.2.0.0, one can define custom particle types for use with the VFX Generator. This is done via a custom datapack.

Important

Any changes to the datapack will require a restart of the server.
/reload will not load the changes.

Defining available particles

To define the available particles, the file data/<namespace>/vfxgenerator/particle.json is needed.
Its format is similar to that of a tag file.

The root object.
├─ replace: Optional. Whether or not the list of available particles defined in this file should completely replace those defined in different lower priority data packs sharing the same namespace. 
│           If false the defined available particles here are appended to those defined in lower priority data packs sharing the same namespace. Defaults to false. 
└─ values: A list of resource locations referencing custom particles.

Defining custom particles

To define a custom particle, a JSON file in data/<namespace>/vfxgenerator/particle/ is needed.
Used textures need to be placed in data/<namespace>/vfxgenerator/particle/textures/.
The JSON file should look as follows.

The root object.
├─ type: The particle type. Currently always "single".
└─ value: A resource location referencing the texture to use.