events/example.yml

# ============================================================
# VVoucher example event file
# ============================================================
#
# You can create as many .yml files as you want inside:
# /plugins/VVoucher/events/
#
# Every top-level key is an event id.
# Example:
#   example-event:
#   crate-basic:
#   boss-drop:
#
# An event is a reusable weighted reward table.
# It can be called from a voucher Random-Command entry with:
#   Event: "example-event"
#
# ============================================================
# Reward options inside an event
# ============================================================
#
# Chance:
#   Required.
#   Higher number = higher chance to be selected.
#
# Command:
#   Required.
#   Console command that will run when this reward is selected.
#   Supported placeholders:
#   - %player%
#   - %uuid%
#   - %random-amount%
#   - %local-random%
#   - %current-usage%
#   - %max-usage%
#
# Message-Chat:
#   Optional chat message sent to the player.
#
# Message-Title:
#   Optional title message.
#   Title is required.
#   SubTitle is optional.
#
# Message-ActionBar:
#   Optional action bar message.
#
# Random:
#   Optional local random generator for this one reward only.
#   If present, %local-random% will use a value between Min and Max.
#
# Notes:
# - Event rewards do not support nested Event calls.
# - Event rewards use the same weighted random logic as voucher Random-Command.
# - The total Chance does not need to be 100.
#
# ============================================================
# Example event
# ============================================================

example-event:
  reward-1:
    Chance: 20
    Command: "give %player% diamond 1"
    Message-Chat: "{prefix} You got a բFFdiamond&7!"
    Message-Title:
      Title: "բFFEpic Drop"
      SubTitle: "&71 diamond"
  reward-2:
    Chance: 10
    Command: "give %player% diamond 2"
    Message-Chat: "{prefix} You got a few բFFdiamonds&7!"
    Message-Title:
      Title: "բFFLegendary Drop"
      SubTitle: "&72 diamonds"
  reward-3:
    Chance: 70
    Command: "give %player% iron_ingot 1"
    Message-Chat: "{prefix} You got a բFFiron ingot&7!"
    Message-Title:
      Title: "բFFRare Drop"
      SubTitle: "&71 iron ingot"