Wiki
Discord
  • 👋Hey
  • 🔌Resources
    • ☄️Arcane
      • 🎟️Vouchers
        • ⭐v2.0.0
        • Example vouchers
        • Actions
          • Properties
          • Tags
        • Comet
        • Commands
        • Configuration
          • config.yml
          • vouchers.yml
          • vouchers-nbt.txt
        • Permissions
        • Requirements
    • ⚡Master
    • ⛏️TokenEnchant
      • ⬆️TEUpgrades
    • 🔴Other
      • 🏗️GUIHelper
Powered by GitBook
On this page
  • Updater
  • MiniMessage
  • Voucher Settings
  • NBT
  • Bulk actions
  • More skull texture options
  • Usages command
  • Utils

Was this helpful?

  1. Resources
  2. Arcane
  3. Vouchers

v2.0.0

See what's new on v2.0.0

PreviousVouchersNextExample vouchers

Last updated 2 years ago

Was this helpful?

Jump to: , ,

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

Every string and message supports . 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'

  • 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

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

NBT

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

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

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

Utils

CHANGED

  • display_name was renamed to name

  • Skull texture was moved to its own setting called texture

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

  • ---

REMOVED

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

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

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 .

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

Find out what / / (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/

Usages are now stored on a database instead of a simple, YAML file

[actionbar] was replaced by [message] with ACTION_BAR type ()

[broadcast] and [permissionbroadcast] were replaced by [message] with

The volume and pitch for [sound] are now instead of action arguments

[json] - 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

🔌
☄️
🎟️
⭐
ADDED
CHANGED
REMOVED
MiniMessage
Comet
MiniMessage
RegEx
WorldGuard
here
vouchers-nbt.txt
Head Database
here
Commands
Materials
Sounds
Enchantments
SQLite
see
broadcast property
properties
MiniMessage
RawMsg