⭐v2.0.0

See what's new on v2.0.0

Jump to: ADDED, CHANGED, REMOVED

ADDED

Updater

Since this version brings many changes in terms of configuration, I've made a small program that will convert your files (config.yml, limits.yml and vouchers.yml) to the new format, including strings that use the legacy format (&) to MiniMessage.

Comet

MiniMessage

Every string and message supports MiniMessage. Legacy strings (including & color codes) were deprecated for a long time, and is better to move one to a more modern system. With MiniMessage, you can add everything you want to any message: click events, hover, hex & gradient (1.14.4+).

Voucher Settings

Bind to receiver

Make the voucher usable only by the player who received it

bindToReceiver:
  enabled: true
  message: '<red>You can not use this voucher, it belongs to {player}!</red>'

Cooldown

Put the voucher on a cooldown after each usage (e.g. allow them to use the voucher once a day)

cooldown:
  enabled: true
  cooldown: 1d
  message: '<red>You can use this voucher again in {left}</red>'

Limit for bulk open

Limit how many vouchers can be opened at a time.

bulkOpen:
  enabled: true
  limit: 5

Regex for 'regions' and 'worlds'

Since some servers might have different regions / worlds that follow a format, it is much easier to use a RegEx expression than to list all of them. These options can be combined with normal strings. Examples:

• regex:player_world_.+ - match all worlds that start with player_world_

• regex:mine-\w+ - match all regions that start with mine-

worlds:
  whitelist:
    list:
    - spawn
    - regex:player_world_.+
    message: '<red>This voucher can only be used at spawn or on a player world.<red>'

Regions

Allow or disallow players to use vouchers based on the region they are standing on. This function require WorldGuard 6.x.x or 7.x.x.

regions:
  whitelist:
    list: [boss-spawn-region]
    #
    # This message will be sent to players that attempt to redee the voucher
    # but they are not standing inside 'boss-spawn-region'
    #
    message: '<red>The boss can not be spawned here!</red>'

World blacklist

Previously it was only possible to whitelist certain worlds, now you can also blacklist them.

worlds:
  blacklist:
    list: [world_nether]
    message: '<red>You can not use the voucher in world {world}</red>'

Message types

By default, all voucher related messages are sent in chat, but you can specify the type of each of them individually by adding a prefix before the actual message.

• ACTION_BAR;<message>

• CHAT;<message>

• TITLE;<title>[n]<subtitle

Sounds

Play a sound when the voucher is received / redeemed, when it is on cooldown, when the limit was reached, etc. More info can be found here.

NBT

Go beyond available customization options for voucher items with NBT tags.

vouchers-nbt.txt

Bulk actions

A separated list of actions used when the player redeem multiple vouchers at once, use %amount% for actions to access the amount of vouchers used. If your actions don't fit this system (e.g. you use a command that must be executed n times) leave this list empty and the plugin will execute the actions n times (n = amount of vouchers).

actions:
  - '[addmoney] 5000'
bulkActions:
  #
  # We multiply 5000 by %amount% to calculate the new amount of money that
  # will be given, depending on how many vouchers the player has redeem
  #
  - '[addmoney] math:{5000 * %amount%}'

More skull texture options

The texture was moved to its own setting, texture, and now you can use: player names, Head Database IDs or texture. Info about how to use each of them can be found here.

texture: BASE64;eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZGNlYjE3MDhkNTQwNGVmMzI2MTAzZTdiNjA1NTljOTE3OGYzZGNlNzI5MDA3YWM5YTBiNDk4YmRlYmU0NjEwNyJ9fX0=
texture: HDB;21899
texture: PLAYER;MHF_Chest

Usages command

Previously, it was impossible to edit or view the usages of a voucher in-game. Now, you can use the /av usages command to do so.

• /av usages [voucher] check (player) - Check the usages of a voucher

• /av usages [voucher] modify [value] (player) - Modify the usages of a voucher

• /av usages [voucher] set [value] (player) - Set the usages of a voucher

Commands

Utils

Find out what Materials / Sounds / Enchantments (and many more) are available for your game version without having to check an external source. The files containing this data can be found in /plugins/ArcaneVouchers/.RESOURCES/

CHANGED

• display_name was renamed to name

• Usages are now stored on a SQLite database instead of a simple, YAML file
• [actionbar] was replaced by [message] with ACTION_BAR type (see)
• [broadcast] and [permissionbroadcast] were replaced by [message] with broadcast property
• The volume and pitch for [sound] are now properties instead of action arguments
• Skull texture was moved to its own setting called texture

• The format for arguments was changed from {args[n]} to %args[n]%

• ---

REMOVED

• [json] - MiniMessage is a better replacement
• [centermessage] and [centerbroadcast] - the system used wasn't working if the player had a different chat width so I decided to remove them, the functionality can still be achieved with a plugin like RawMsg