Reward Types

May 6, 2017
Reward Types
  • Every shopitem has a specific reward that players will get when they purchase it. There are many different kinds of reward types to choose from. Additionally more rewards can be added via Addons.

    Calculation support: Every numerical reward type supports simple calculations with raw numbers (excluding placeholders). Example:
    Code (Text):
    RewardType: money
    Reward: 120 * 64


    Items
    Either one or a few items. Find out more about ItemData here.
    Example with one item:
    Code (Text):
        RewardType: item
        Reward:
        - - type:DIAMOND
          - amount:5
     


    Example with multiple items:
    Code (Text):
        RewardType: item
        Reward:
        - - type:WOOL
          - amount:10
          - durability:14
        - - type:WOOL
          - amount:10
          - durability:11
        - - type:WOOL
          - amount:10
          - durability:4
        - - type:WOOL
          - amount:10
          - durability:5

    PlayerCommands
    One or multiple commands executed by the related player. As basically everywhere you can use different placeholders here. The most common placeholder is %player% which will be replaced by the name of the affected player.
    Example with one command:
    Code (Text):
        RewardType: playercommand
        Reward:
        - warp spawn
    Example with multiple commands:
    Code (Text):
        RewardType: playercommand
        Reward:
        - warp spawn
        - me has warped to the spawn

    Commands
    One or multiple commands executed by the console. As basically everywhere you can use different placeholders here. The most common placeholder is %player% which will be replaced by the name of the affected player.
    Example with one command:
    Code (Text):
        RewardType: command
        Reward:
        - say %player% just bought %itemname% for %price%
    Example with multiple commands:
    Code (Text):
        RewardType: command
        Reward:
        - 'gamemode %player% 1'
        - 'tell %player% You are in creative mode now!'

    OpCommands
    One or multiple commands executed by the player with op permissions. As basically everywhere you can use different placeholders here. The most common placeholder is %player% which will be replaced by the name of the affected player.
    Example with one command:
    Code (Text):
        RewardType: opcommand
        Reward:
        - fly
    Example with multiple commands:
    Code (Text):
        RewardType: opcommand
        Reward:
        - fly
        - give 4 64

    Nothing
    You can use 'RewardType: nothing' for decoration and similar things. Players will simply get nothing when they click this item.
    Example:
    Code (Text):
        RewardType: nothing

    Enchantment
    An enchantment that is added to the item in the players main hand. The Reward should look like following: 'Reward: <enchantment name/id>#<level>'. You can find a list of enchantment names here and all enchantment ids here.
    Example:
    Code (Text):
        RewardType: ENCHANTMENT
        Reward: DURABILITY#3

    Money
    Gives the player money. Therefor the plugin Vault is needed. When working with multipliers, the received money will automatically be adapted and divided by the factor. In order to display the actual amount of money that the player will receive simply use the '%reward%' placeholder.
    Example:
    Code (Text):
        RewardType: money
        Reward: 500

    Points
    Gives the player points. Supported Points plugins are following (message me if you want an other plugin to be supported):
    When working with multipliers, the received points will automatically be adapted and divided by the factor. In order to display the actual amount of points that the player will receive simply use the '%reward%' placeholder.
    Example:
    Code (Text):
        RewardType: points
        Reward: 750

    Permissions
    A list of permissions (or a single one) that the player will get. Therefor the plugin Vault is needed.
    Example with one permission:
    Code (Text):
        RewardType: permission
        Reward:
        - Permission.Node
    Example with multiple permissions:
    Code (Text):
        RewardType: permission
        Reward:
        - Permission.Node1
        - Permission.Node2
        - Permission.Node3

    Shop
    This reward will open an other shop GUI. Simply set the Reward to the name of the other shop.
    Example:
    Code (Text):
        RewardType: shop
        Reward: menu

    ShopPage
    This will send the player to an other page of the current shop. Possible Rewards are:
    • 'next' - Sends player to next page
    • 'previous' - Sends player to previous page
    • '<any number>' - Sends player to specified page
    Example:
    Code (Text):
        RewardType: page
        Reward: previous

    BungeeCordServer
    Sends player to the named BungeeCord server. Therefor you need your servers connected with BungeeCord.
    Example:
    Code (Text):
        RewardType: bungeecordserver
        Reward: survival
    Reward: server survival[/CODE]


    BungeeCordCommands
    Makes the BungeeCord console execute a list of commands.
    Example:
    Code (Text):
        RewardType: bungeecordcommand
        Reward:
        - 'alert This alert was triggered by %player%.'
    In this example BungeeCord will send an alert to all connected players.
    In order for BungeeCordCommands to work you need to put a copy of the BossShopPro.jar in your BungeeCord plugins folder.


    LilyPadServer

    To send a player to a LilyPadServer you simply work with a PlayerCommand. Therefor your servers need to be connected via LilyPad.
    Example:
    Code (Text):
        RewardType: playercommand
        Reward: server survival
    Exp
    Increases the players exp level.
    Example:
    Code (Text):
        RewardType: exp
        Reward: 10
    In this example the player gets 10 additional exp levels.

    ItemAll
    Fills the inventory of the player with that kind of item. Requires a numeric pricetype. Set the reward to the item you want with an amount of one. The given price is the price per unit.
    Example:
    Code (Text):
        RewardType: ITEMALL
        Reward:
        - type:LOG
        - amount:1
        PriceType: MONEY
        Price: 10
    In this example players can fill their inventory with log and have to pay 10 money for each.




    More reward types can be added via Addons
  • Loading...
  • Loading...