🔍Example Vouchers

Need some inspiration? Example vouchers included!

Below you will find three example vouchers that have immediate support for the plugin. These are the same as the ones that are pre-generated for you when you first start your server, refer back to here if you ever need them again!

Example 1

# Note: It is important not to change a voucher files name after players have a voucher as it will become un-openable!
###################################################################################################
###################################################################################################
####   ______                           _       __      __              _                 __   ####
####  |  ____|                         | |      \ \    / /             | |               /_ |  ####
####  | |__  __  ____ _ _ __ ___  _ __ | | ___   \ \  / /__  _   _  ___| |__   ___ _ __   | |  ####
####  |  __| \ \/ / _` | '_ ` _ \| '_ \| |/ _ \   \ \/ / _ \| | | |/ __| '_ \ / _ \ '__|  | |  ####
####  | |____ >  < (_| | | | | | | |_) | |  __/    \  / (_) | |_| | (__| | | |  __/ |     | |  ####
####  |______/_/\_\__,_|_| |_| |_| .__/|_|\___|     \/ \___/ \__,_|\___|_| |_|\___|_|     |_|  ####
####                             | |                                                           ####
####                             |_|                                                           ####
###################################################################################################
###################################################################################################
# Below is the first example voucher, you can use this file as reference for all future vouchers you create
# To create a new voucher just copy and paste this file and rename it to assign it a different voucher ID.
# Alternatively, create a file with the name of your pouch followed by the '.yml' file extension, and edit it exactly as you wish.
#*
#* For a slightly more in depth documentation visit our docs website: https://vouchersplus.uhfinn.dev/
#*


#* ############################################################### *#
#* ####################### Primary Details ####################### *#
#* ############################################################### *#

# The name of the voucher, this is required for all created vouchers (Not to be confused with the ID, which is the file name)
Name: '&6&lLUCKY &fVoucher'
Voucher:
  # The ICON used to represent the voucher
  Item: 'ENDER_CHEST'
  # Whether the ICON should be enchanted
  Enchanted: true
  # The lore of the voucher icon
  Lore:
    - '&7Test your luck with the LUCKY Voucher'
    - '&7Prizes Given: 3'
    - '&7Prize List:'
    - '&7- &a[VERY COMMON] &f32x Oak Logs'
    - '&7- &2[COMMON] &f16x Coal'
    - '&7- &9[UNCOMMON] &f16x Iron'
    - '&7- &d[RARE] &f12x Gold'
    - '&7- &5[ULTRA RARE] &f8x Diamonds'
    - '&7- &6[LEGENDARY] &f1x Nether Star'


#* ############################################################### *#
#* ####################### Effects Details ####################### *#
#* ############################################################### *#

# The minecraft sound ID and data to be played upon pouch redeem, don't add this section if you don't need it
Sound:
  SoundID: 'none'
  Volume: 1
  Pitch: 1

# The particle data to be spawned on the player upon pouch redeem, don't add this section if you don't need it
Particles:
  ParticleID: 'none'
  Count: 20
  Offset: 1

# The effect ran when the voucher is redeemed
# To get more information about the effects available, check out: https://vouchersplus.uhfinn.dev/additional-information/effects
Effect: 'firework'


#* ############################################################### *#
#* ####################### Reward Details ######################## *#
#* ############################################################### *#

# The number of rewards that will be given upon redeeming the voucher
# Set to 'all' to give a player every item within the voucher (ignoring weighting)
RewardsPerOpen: 3

# The list of rewards within the voucher, currently a voucher supports up to 28 items, any extra items are ignored
Rewards:
  1:
    # The name of the reward
    Name: '&f32 Oak Logs'
    # The icon of the reward
    Icon:
      Item: OAK_LOG
      Amount: 32
    # The weighted chance of getting the item, higher weight = higher chance (Doesn't have to add up to 100)
    # If a weighting isn't provided, the item will automatically assume a weight of 100
    Weight: 100
    # The command to be ran if this reward is given to the user, use <playerName> as a placeholder for the players name
    Commands:
      - 'minecraft:give <playerName> minecraft:oak_log 32'
    # The message sent when a player wins this prize, this message is sent immediately after the commands are run to allow any PAPI placeholders to update
    # You can delete this field if you would rather no message was sent
    Message: '<prefix> &aYou have received 32x Oak Logs'
    # The lore for the reward when previewed in the GUI
    GUILore:
      - '&732x Oak Logs'
      - '&7Win Chance: &f<chance>%'

  2:
    Name: '&f16x Coal'
    Icon:
      Item: COAL
      Amount: 16
    Weight: 80
    Commands:
      - 'minecraft:give <playerName> minecraft:coal 16'
    Message: '<prefix> &aYou have received 16x Coal!'
    GUILore:
      - '&716x Coal'
      - '&7Win Chance: &f<chance>%'

  3:
    Name: '&f16x Iron'
    Icon:
      Item: IRON_INGOT
      Amount: 16
    Weight: 60
    Commands:
      - 'minecraft:give <playerName> minecraft:iron_ingot 16'
    Message: '<prefix> &aYou have received 16x Iron Ingots!'
    GUILore:
      - '&716x Iron Ingots'
      - '&7Win Chance: &f<chance>%'

  4:
    Name: '&f12x Gold'
    Icon:
      Item: GOLD_INGOT
      Amount: 12
    Weight: 35
    Commands:
      - 'minecraft:give <playerName> minecraft:gold_ingot 12'
    Message: '<prefix> &aYou have received 12x Gold Ingots!'
    GUILore:
      - '&712x Gold Ingots'
      - '&7Win Chance: &f<chance>%'

  5:
    Name: '&f8x Diamonds'
    Icon:
      Item: DIAMOND
      Amount: 8
    Weight: 10
    Commands:
      - 'minecraft:give <playerName> minecraft:diamond 8'
    Message: '<prefix> &aYou have received 8x Diamonds!'
    GUILore:
      - '&78x Diamonds'
      - '&7Win Chance: &f<chance>%'

  6:
    Name: '&f&l1x Nether Star'
    Icon:
      Item: NETHER_STAR
      Amount: 1
    Weight: 2
    Commands:
      - 'minecraft:give <playerName> minecraft:nether_star 1'
    Message: '<prefix> &aYou have received 1x Nether Star!'
    GUILore:
      - '&71x Nether Star'
      - '&7Win Chance: &f<chance>%'




#* ############################################################### *#
#* ####################### Additional Data ####################### *#
#* ################## Do Not Touch This Section ################## *#

AdditionalData: null

---

Example 2

# Note: It is important not to change a voucher files name after players have a voucher as it will become un-openable!
#####################################################################################################
#####################################################################################################
####   ______                           _       __      __              _                 ___    ####
####  |  ____|                         | |      \ \    / /             | |               |__ \   ####
####  | |__  __  ____ _ _ __ ___  _ __ | | ___   \ \  / /__  _   _  ___| |__   ___ _ __     ) |  ####
####  |  __| \ \/ / _` | '_ ` _ \| '_ \| |/ _ \   \ \/ / _ \| | | |/ __| '_ \ / _ \ '__|   / /   ####
####  | |____ >  < (_| | | | | | | |_) | |  __/    \  / (_) | |_| | (__| | | |  __/ |     / /_   ####
####  |______/_/\_\__,_|_| |_| |_| .__/|_|\___|     \/ \___/ \__,_|\___|_| |_|\___|_|    |____|  ####
####                             | |                                                             ####
####                             |_|                                                             ####
#####################################################################################################
#####################################################################################################
# Below is the second example voucher, you can use this file as reference for all future vouchers you create
# To create a new voucher just copy and paste this file and rename it to assign it a different voucher ID.
# Alternatively, create a file with the name of your pouch followed by the '.yml' file extension, and edit it exactly as you wish.
#*
#* For a slightly more in depth documentation visit our docs website: https://vouchersplus.uhfinn.dev/
#*


#* ############################################################### *#
#* ####################### Primary Details ####################### *#
#* ############################################################### *#

# The name of the voucher, this is required for all created vouchers (Not to be confused with the ID, which is the file name)
Name: '&2&lLottery &fVoucher'
Voucher:
  # The ICON used to represent the voucher
  Item: 'PAPER'
  # Whether the ICON should be enchanted
  Enchanted: true
  # The lore of the voucher icon
  Lore:
    - '&7Test your luck with the &2&lLottery &fVoucher'
    - '&7Prizes Given: 1'
    - '&7Prize List:'
    - '&7- &a[VERY COMMON] &f&l$100'
    - '&7- &2[COMMON] &f&l$250'
    - '&7- &9[UNCOMMON] &f&l$1,000'
    - '&7- &d[RARE] &f&l$2,500'
    - '&7- &5[ULTRA RARE] &f&l$10,000'
    - '&7- &6[LEGENDARY] &f&l$100,000'


#* ############################################################### *#
#* ####################### Effects Details ####################### *#
#* ############################################################### *#

# The minecraft sound ID and data to be played upon pouch redeem, don't add this section if you don't need it
Sound:
  SoundID: 'ENTITY_PLAYER_LEVELUP'
  Volume: 1
  Pitch: 1

# The particle data to be spawned on the player upon pouch redeem, don't add this section if you don't need it
Particles:
  ParticleID: 'VILLAGER_HAPPY'
  Count: 50
  Offset: 1

# The effect ran when the voucher is redeemed
# To get more information about the effects available, check out: https://vouchersplus.uhfinn.dev/additional-information/effects
Effect: 'None'


#* ############################################################### *#
#* ####################### Reward Details ######################## *#
#* ############################################################### *#

# The number of rewards that will be given upon redeeming the voucher
# Set to 'all' to give a player every item within the voucher (ignoring weighting)
RewardsPerOpen: 1

# The list of rewards within the voucher, currently a voucher supports up to 28 items, any extra items are ignored
Rewards:
  1:
    # The name of the reward
    Name: '&f&l$100'
    # The icon of the reward
    Icon:
      Item: SUNFLOWER
      Amount: 1
    # The weighted chance of getting the item, higher weight = higher chance (Doesn't have to add up to 100)
    # If a weighting isn't provided, the item will automatically assume a weight of 100
    Weight: 250
    # The command to be ran if this reward is given to the user, use <playerName> as a placeholder for the players name
    Commands:
      - 'eco give <playername> 100'
    # The message sent when a player wins this prize, this message is sent immediately after the commands are run to allow any PAPI placeholders to update
    # You can delete this field if you would rather no message was sent
    Message: '<prefix> &aYou have won &f&l$100&a!'
    # The lore for the reward when previewed in the GUI
    GUILore:
      - '&7Receive $100 immediately'
      - '&7Win Chance: &f<chance>%'

  2:
    Name: '&f&l$250'
    Icon:
      Item: SUNFLOWER
      Amount: 1
    Weight: 200
    Commands:
      - 'eco give <playername> 250'
    Message: '<prefix> &aYou have won &f&l$250&a!'
    GUILore:
      - '&7Receive $250 immediately'
      - '&7Win Chance: &f<chance>%'

  3:
    Name: '&f&l$1,000'
    Icon:
      Item: GOLD_NUGGET
      Amount: 1
    Weight: 125
    Commands:
      - 'eco give <playername> 1000'
    Message: '<prefix> &aYou have won &f&l$1,000&a!'
    GUILore:
      - '&7Receive $1,000 immediately'
      - '&7Win Chance: &f<chance>%'

  4:
    Name: '&f&l$2,500'
    Icon:
      Item: GOLD_INGOT
      Amount: 1
    Weight: 80
    Commands:
      - 'eco give <playername> 2500'
    Message: '<prefix> &aYou have won &f&l$2,500&a!'
    GUILore:
      - '&7Receive $2,500 immediately'
      - '&7Win Chance: &f<chance>%'

  5:
    Name: '&f&l$10,000'
    Icon:
      Item: GOLD_BLOCK
      Amount: 1
    Weight: 20
    Commands:
      - 'eco give <playername> 10000'
    Message: '<prefix> &aYou have won &f&l$10,000&a!'
    GUILore:
      - '&7Receive $10,000 immediately'
      - '&7Win Chance: &f<chance>%'

  6:
    Name: '&f&l$100,000'
    Icon:
      Item: GOLD_BLOCK
      Amount: 10
    Weight: 1
    Commands:
      - 'eco give <playername> 100000'
    Message: '<prefix> &aYou have won &f&l$100,000&a!'
    GUILore:
      - '&7Receive $100,000 immediately'
      - '&7Win Chance: &f<chance>%'






#* ############################################################### *#
#* ####################### Additional Data ####################### *#
#* ################## Do Not Touch This Section ################## *#

AdditionalData: null

---

Example 3

# Note: It is important not to change a voucher files name after players have a voucher as it will become un-openable!
######################################################################################################
######################################################################################################
####   ______                           _       __      __              _                 ____    ####
####  |  ____|                         | |      \ \    / /             | |               |___ \   ####
####  | |__  __  ____ _ _ __ ___  _ __ | | ___   \ \  / /__  _   _  ___| |__   ___ _ __    __) |  ####
####  |  __| \ \/ / _` | '_ ` _ \| '_ \| |/ _ \   \ \/ / _ \| | | |/ __| '_ \ / _ \ '__|  |__ <   ####
####  | |____ >  < (_| | | | | | | |_) | |  __/    \  / (_) | |_| | (__| | | |  __/ |     ___) |  ####
####  |______/_/\_\__,_|_| |_| |_| .__/|_|\___|     \/ \___/ \__,_|\___|_| |_|\___|_|    |____/   ####
####                             | |                                                              ####
####                             |_|                                                              ####
######################################################################################################
######################################################################################################
# Below is the third example voucher, you can use this file as reference for all future vouchers you create
# To create a new voucher just copy and paste this file and rename it to assign it a different voucher ID.
# Alternatively, create a file with the name of your pouch followed by the '.yml' file extension, and edit it exactly as you wish.
#*
#* For a slightly more in depth documentation visit our docs website: https://vouchersplus.uhfinn.dev/
#*


#* ############################################################### *#
#* ####################### Primary Details ####################### *#
#* ############################################################### *#

# The name of the voucher, this is required for all created vouchers (Not to be confused with the ID, which is the file name)
Name: '&c&lFOOD &fPackage'
Voucher:
  # The ICON used to represent the voucher
  Item: 'CHEST'
  # Whether the ICON should be enchanted
  Enchanted: true
  # The lore of the voucher icon
  Lore:
    - '&7Gain a supply package full of food!'
    - '&7Contains: Apples, Steak, Carrots, Potato, and Bread'


#* ############################################################### *#
#* ####################### Effects Details ####################### *#
#* ############################################################### *#

# The minecraft sound ID and data to be played upon pouch redeem, don't add this section if you don't need it
# To access a full list of available soundID's, view: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
Sound:
  SoundID: 'ENTITY_PLAYER_LEVELUP'
  Volume: 1
  Pitch: 1

# The particle data to be spawned on the player upon pouch redeem, don't add this section if you don't need it
# To access a full list of available particleID's, view: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
Particles:
  ParticleID: 'HEART'
  Count: 20
  Offset: 1

# The effect ran when the voucher is redeemed
# To get more information about the effects available, check out: https://vouchersplus.uhfinn.dev/additional-information/effects
Effect: 'None'


#* ############################################################### *#
#* ####################### Reward Details ######################## *#
#* ############################################################### *#

# The number of rewards that will be given upon redeeming the voucher
# Set to 'all' to give a player every item within the voucher (ignoring weighting)
RewardsPerOpen: all

# The list of rewards within the voucher, currently a voucher supports up to 28 items, any extra items are ignored
Rewards:
  1:
    # The name of the reward
    Name: '&f5x Apples'
    # The icon of the reward
    Icon:
      Item: APPLE
      Amount: 5
    # The command to be ran if this reward is given to the user, use <playerName> as a placeholder for the players name
    Commands:
      - 'minecraft:give <playerName> minecraft:apple 5'
    # The lore for the reward when previewed in the GUI
    GUILore:
      - '&75x Apples'
      - '&7Win Chance: &f<chance>%'

  2:
    Name: '&f5x Steak'
    Icon:
      Item: COOKED_BEEF
      Amount: 5
    Commands:
      - 'minecraft:give <playerName> minecraft:cooked_beef 5'
    GUILore:
      - '&75x Steaks'
      - '&7Win Chance: &f<chance>%'

  3:
    Name: '&f5x Carrots'
    Icon:
      Item: CARROT
      Amount: 5
    Commands:
      - 'minecraft:give <playerName> minecraft:carrot 5'
    GUILore:
      - '&75x Carrots'
      - '&7Win Chance: &f<chance>%'

  4:
    Name: '&f5x Potatoes'
    Icon:
      Item: POTATO
      Amount: 5
    Commands:
      - 'minecraft:give <playerName> minecraft:potato 5'
    GUILore:
      - '&75x Potato'
      - '&7Win Chance: &f<chance>%'

  5:
    Name: '&f20x Bread'
    Icon:
      Item: BREAD
      Amount: 20
    # The message sent when a player has received all other prizes, this message is sent immediately after the commands are run to allow any PAPI placeholders to update
    # You can delete this field if you would rather no message was sent
    Message: '<prefix> &aYou have redeemed the &c&lFOOD &fPackage'
    Commands:
      - 'minecraft:give <playerName> minecraft:bread 20'
    GUILore:
      - '&720x Potato'
      - '&7Win Chance: &f<chance>%'




#* ############################################################### *#
#* ####################### Additional Data ####################### *#
#* ################## Do Not Touch This Section ################## *#

AdditionalData: null