Rewards Option

Item Format

Each reward must has item to display. Should use Item Format at this page.

Example:

  1:
    material: DIAMOND
    cmd: 0
    display: '&eA Reward'
    lore:
      - '&fLine1'
      - '&fLine2'
    # For command rewards, you should set this option to false.
    # Otherwise, players will get both item you set here and also the commands reward.
    give-item: true
    # Random amount.
    amount: 1~10
    chance: 20

General Options

Those options can be used in the 2 types of reward. All of them except chance are optional.

  • chance(or rate): The chance of this reward. Can be set to any numbers, as our plugin will automatically calculate percentage.

You can also use rates option, you should write this option like this:

rates:
  default: 0.1
  one_rates_condition: 0.4

This means default players will have 0.1 rate for this reward, players meet one_rates_condition condition(view rates-conditions option below) have 0.4 rate.

This rate supports PlaceholderAPI's placeholder and Math string, like this: (You need enable check-math option in config.yml file to use Math string)

  • rates-conditions:

rates-conditions:
  one_rates_condition:
    1: 
      type: world
      world: 'OneWorld'

one_rates_condition is Condition ID, can write it at rates option which replace the permission. In this example, players who in OneWorld will have 0.4 rate.

Each condition id section should use Condition Format, for more info, please view Format page.

  • amount: The amount of reward items. Like 1. You can also entry in the form of "1~5" which means the amount is random in the interval. (Added in 2.0.0)

  • times: How many times the commands excute, can be used as random money amount. You can also entry in the form of "1~5" which means the times is random in the interval.

  • give-item: Whether give the item to the player. Recommend set false if just want to use commands as reward. Like: true.

  • actions: The action will actived after finish spin. Use Action Format here, for more info, please view this page.

Last updated