Vouchers+
  • 👋Welcome to Vouchers+
  • Overview
    • 💡What is Vouchers+?
    • ✨Our Features
    • ⭐Our Reviews
  • Fundamentals
    • 📜General Information
      • Permission Nodes
      • Commands
    • 🛠️Setting Up
      • Config.yml
        • General Configuration
        • Voucher Configuration
      • Messages.yml
        • General Plugin Messages
        • Voucher Action Messages
    • 🎫Creating a Voucher
      • Primary Details
      • Effects Details
      • Adding Rewards
      • 🔍Example Vouchers
  • Advanced
    • ✍️Using /vouchers edit
    • 📘PAPI Placeholders
  • Additional Information
    • 🔊Sounds
    • ✨Particles
    • 🎆Effects
  • FAQ
    • 📃FAQ
Powered by GitBook
On this page
  • Sounds
  • Sound ID
  • Volume
  • Pitch
  • Particles
  • Particle ID
  • Count
  • Offset
  • Effect

Was this helpful?

  1. Fundamentals
  2. Creating a Voucher

Effects Details

Let's take a look at the effects of a voucher, and how to configure them!

Last updated 1 year ago

Was this helpful?

There are 3 main areas of this section, which can be broken down into sub-categories. They are as follows:

It is worth mentioning that more information about the individual parts and validation that occurs from them may be viewed within the section of this documentation. The purpose of this page is to describe how the effects can be implemented into a voucher file.


Sounds

Sounds, when implemented into the voucher file, will play an audible sound to the voucher redeemer through the minecraft master channel. They may be configured through this section of the voucher file.

Sound ID

This is the minecraft Enum ID of the sound to be played. For a list of all sounds in the game, please refer to:

Sound:
  SoundID: 'ENTITY_PLAYER_LEVELUP'

If you ever change your mind about having a sound, you can delete this section of the voucher configuration, or set the SoundID field to "none"

Volume

Next, let's configure the volume. This is a decimal-integer value that is greater than 0. For the purpose of demonstration, I will use the value 1.2, as follows:

Sound:
  SoundID: 'ENTITY_PLAYER_LEVELUP'
  Volume: 1.2

Pitch

Next, let's configure the pitch. This is a decimal-integer that is between 0.0 and 2.0. By default, a minecraft pitch is 1.0, I will use this for the demonstration, as follows:

Sound:
  SoundID: 'ENTITY_PLAYER_LEVELUP'
  Volume: 1.2
  Pitch: 1

Particles

Sounds, when implemented into the voucher file, will show particles to the voucher redeemer and all players around them. It may be configured through this section of the voucher file.

Particle ID

Particles:
  ParticleID: 'VILLAGER_HAPPY'

If you ever change your mind about having particles, you can delete this section of the voucher configuration, or set the ParticleID field to "none"

Count

Next, let's configure the count. This is an integer value that is greater than 0. For the purpose of demonstration, I will use the value 50 to ensure that there are sufficient particles to be recognised by the redeeming user, the voucher configuration is as follows:

Particles:
  ParticleID: 'VILLAGER_HAPPY'
  Count: 50

Offset

Next, let's configure the count. This is a decimal-integer value that is typically greater than 0. Usually, the value 1.0 is sufficient to ensure that the effect is impactful for the user whilst not being intrusive to other users. I will use this for the purpose of demonstration, as follows:

Particles:
  ParticleID: 'VILLAGER_HAPPY'
  Count: 50
  Offset: 1

Effect

To implement the effect into the voucher file, simply add the Effect: "" field, and include the name of the effect you wish to add. For the purpose of demonstration, I will add the firework effect, as follows:

Effect: 'firework'

For example purposes, let's implement the sound effect. To do this, we would include the following lines into the voucher file:

This is the minecraft Enum ID of the particle to be spawned. For a list of all particles in the game, please refer to:

For example purposes, let's implement the particle effect. To do this, we would include the following lines into the voucher file:

Effect's are pre-coded events integrated within Vouchers+ that occur when a player redeems a voucher. To see a full list of effects available, and their functionality, please see .

🎫
Sounds
Sound ID
Volume
Pitch
Particles
Particle ID
Count
Offset
Effect
Additional Information
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
ENTITY_PLAYER_LEVELUP
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
VILLAGER_HAPPY
here