Last updated
Last updated
Vouchers+ allows you to include a particle effect that is run every time a voucher is redeemed. This is under the Particles configuration area of the YML file.
There are three primary settings that are included within the sound option. These are below:
ParticleID: This is the minecraft Enum value of the particle to be shown. This may be set to 'none' to prevent any particles from being shown.
Count: This is the number of particles that are generated.
Offset: This is how far randomly offset (spread) the particles are from the origin (player torso). It is recommended to keep this value at 1 or below to ensure that the particles are not intrusive to other players.
It is worth noting that all particles are visible to all players, this can not be adjusted.
There are a couple of validation rules applied internally, these apply to the three primary configuration areas surrounding the particle setting.
The ParticleID must be a valid minecraft particle Enum in order for a particle to be shown. A list of valid particle Enum's can be found here:
Some data manipulation is applied to allow for different standards of writing. For example, let us consider the particle Enum This may be written as villager_happy, or villager.happy The plugin will automatically manipulate the data to the standard format of writing. That being said, this will not apply to all scenarios, and thus it is recommended that you enter the particle Enum exactly as found within the list.
The Count value must be a valid integer (number) that is greater than or equal to 0. If a value less than 0 is given, the plugin will default to the value 20.
The Offset value must be a valid decimal-integer (number) that is greater than or equal to 0.0. If a value less than 0 is given, the plugin will default to the value 1.
An example configuration extract for the particle with Enum , with count 20 and offset 1 has been included below:
A descriptive overview of the Voucher particle effects within Vouchers+