Vouchers+  | ⭐ The #1 Vouchers Plugin! ⭐ icon

Vouchers+ | ⭐ The #1 Vouchers Plugin! ⭐ -----

IMPORT Vouchers from other Plugins! ⚡ Fully Customisable ⚡ Anti-Dupe System ⚡



[​IMG]
Revolutionise how you reward your players with Vouchers+

Supports [1.16 - 1.21.4]



Vouchers+ revolutionises how you give your players rewards. With Vouchers+, you can create as many reward vouchers as your server needs. These can then be customised with effects, particles, and sounds...
Take your players experience to the next level with Vouchers+

[​IMG]
Vouchers+ is feature-rich, ensuring that the plugins set-up is easy, whilst holding an incredible user experience. Vouchers+ strives to go above and beyond with its overall experience, thanks to these many features, including:

EASY SETUP
Our voucher files are very easy to understand! Out of the box, the plugin will generate 3x sample voucher files for you to use and learn from. You can easily create more vouchers by copying these files, or creating new ones!

DUPE PROTECTION
Easily enable dupe protection for your vouchers to ensure that the servers economy and items remain safe.

Note: This feature requires an SQL Database

SLEEK PREVIEW MENUS
Your players can easily preview the contents of a voucher (if they have permission), by clicking your configured mouse button!

INGAME EDITOR
Our state-of-the-art ingame editor takes your setup experience to the next level! This is built of the ingame editor framework used in DailyRewards+, so you know it will be reliable!
With our ingame editor, you can quite litterally create vouchers and edit all of their features, without ever opening the file system!

COMPLETE CUSTOMIZABILITY, COMPLETE CONTROL
Almost everything within the plugin is customisable! And, if you have found something that you would like to customise, suggest it in our Discord Support Server!

HEX COLOR CODES
You can include HEX colour codes within the config, message, and rewards files to style up the plugin however your server desires!
We use the simple &#000000 format to ensure that you can set it up with ease.


[​IMG]

Player Commands

/vouchers

Presents the user with the help menu

/vouchers help

Presents the user with the help menu

/vouchers list

Allows the user to view a full list of the vouchers currently stored


Administrator Commands

Permission to use all admin commands can be given through the permission node: daily.admin / daily.*

/vouchers give [PlayerName] [VoucherID] <qty>

Gives the target player the corresponding voucher at a given quantity (if provided, 1 if not)

/vouchers giveall [VoucherID] <qty>

Gives all players the corresponding voucher at a given quantity (if provided, 1 if not)

/vouchers list

Allows the user to view a full list of the vouchers currently stored, when run with administrative permissions, a button will also be present to get a copy of each voucher.

/vouchers menu

View a traversable GUI menu of all vouchers ingame. From here, you can get and preview vouchers.

/vouchers redeemhistory [PlayerName] [VoucherID]

View (up to 10 of) the most recent voucher redemptions for the target player and voucher.

/vouchers edit
Edit all vouchers ingame through our state-of-the-art editing panel.

/vouchers reload

Reload the plugin so that the configuration and messages file have their changes applied to the game. (This does not apply to vouchers).


OP Commands

Only Operators can use these commands


/vouchers import

Allows you to import vouchers from other plugins.
Accepted plugins to import from: CrazyVouchers, Infinite Vouchers, T-Vouchers.


[​IMG]

vouchers.help

Allows you to view the help menu ingame

vouchers.use.[VoucherID]

Allows you to redeem the voucher corresponding with the given Voucher ID


vouchers.use.*

Allows you to redeem all vouchers ingame


vouchers.preview

Allows you to preview vouchers


vouchers.list

Allows you to view a list of all vouchers ingame (and get copies of them if you have the vouchers.admin permission)


vouchers.admin

Allows you to use the majority of administrative commands


vouchers.dupealert
Receive chat notifications when a player attempts to redeem a duped voucher


vouchers.* / OP
Grants all permission nodes within the plugin


[​IMG]
Vouchers+ Has a straightforward, easy-to-understand config system, there are two primary config files: Config.yml, Messages.yml
Additionally, there is one extra file for each voucher that you create.
It's important to note that the voucher file's name is the ID of the voucher!

A sample voucher file has been included below:
Code (YAML):
# 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

These files are relatively simple when you get the hang of them, and there are plenty of resources available to help you out when getting started!
[​IMG]
Vouchers+ currently holds full PlaceholderAPI support, meaning that you can use your placeholders anywhere!
Currently, we do not have any Placeholders that you can use in other plugins, however this could change in a future version!


Additional Resources

Documentation Website: https://vouchersplus.uhfinn.dev/
Support Discord: https://discord.gg/9jyHhUepaG
Ask AI (our AI help-bot): Accessible in our Discord Now!
Need ways to Reward your Players?: Check out our DailyRewards+ plugin: https://www.spigotmc.org/resources/93375/!
Even more ways to Reward your Players!?: Check out our PlaytimeRewards+ plugin: https://www.spigotmc.org/resources/118468/!

If you need any help whatsoever with setting up Vouchers+ make sure to check out our Discord Server for support,
And please remember, if you find an issue with the plugin please feel free to message me at any time before making a review, I would love to help you out in fixing that issue
Resource Information
Author:
----------
Total Downloads: 184
First Release: Jul 31, 2023
Last Update: Nov 13, 2024
Category: ---------------
All-Time Rating:
16 ratings
Find more info at vouchersplus.uhfinn.dev...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings