Vouchers

7k Downloads

VouchersX is a rewritten version of my long abandoned plugin Vouchers. For those of you unfamiliar, it allows admins to set up voucher shops, from which players can buy vouchers that allow them to do various things. I wrote it to give my players something to spend their ridiculous amounts of iConomy gold on.

Current Voucher Types:

  • Protection ~ Allows a player to place a block only they (or an admin) can destroy.
  • Teleport ~ Allows a player to teleport to another player.
  • Heal ~ Allows a player to heal themselves or another player.
  • Timeshift ~ Allows a player to chance the time of day.
  • Parachute ~ A player can sneak in the air to negate fall damage.
  • Resurrect ~ Heals a player to full health when they would otherwise die if they're sneaking.
  • Superpick ~ Allows a player to break one block instantly.
  • Sunshine ~ Allows a player to clear up the weather.
  • Thunderpunch ~ Hitting a mob or a player will strike them with lightning.

Commands

  • /vhelp ~ Get help with VouchersX and voucher types.
  • /vlist OR /vlist all ~ Lists all voucher types a player has permission to use or all voucher types.
  • /vcheck OR /vcheck [player] ~ Lists a player's vouchers.
  • /vgive [player] [type] [amount] ~ Allows players to give each other vouchers.
  • /vmodify [player] [type] [amount] ~ Allows an admin to modify a player's voucher amounts.
  • /vsp ~ Toggles SuperPick mode.
  • /vthunder ~ Toggles ThunderPunch mode.
  • /vprotect OR /vprotect check OR /vprotect clear ~ Toggles Protect mode, checks how many protected blocks you have, or clears your saved blocks.
  • /vtp [player] ~ Teleports a player to another player.
  • /vheal OR /vheal [player] ~ Heals a player.
  • /vtime day OR /vtime night ~ Shifts a world's time of day.
  • /vsun ~ Removes storms from a world.

Permissions

  • VouchersX.admin ~ Allows a user to build/destroy shops and destroy all protected blocks.
  • VouchersX.use.[type] ~ Allows a user to use a certain voucher type.
  • VouchersX.use.* ~ Allows a user to use all voucher types.
  • VouchersX.buy ~ Allows a use to buy vouchers.
  • VouchersX.free.[type] ~ Allows a user to use a command associated with a voucher without using the voucher itself.

Config Help

Creating a Voucher Shop

  • Line One: Tag ([VouchersX] by default)
  • Line Two: [type]
  • Line Three: [price] OR [price]:[amount] (Example: 50:3 spends 50 gold and gives 3 vouchers)
  • Line Four: Whatever you want (I personally write the associated commands) That's it! If done correctly, you will be sent a message and the first line will turn blue.

Notes*

  • You must have Vault and an economy plugin (or just Vault, not quite sure how that works) for this to work.
  • Voucher types are CASE SENSITIVE (the default types are all capitalized). This includes in the permissions nodes.
  • Before saying you have an issue, make sure you're config.yml is set up properly.