Shop Configuration

Items.yml

# ---------------------------------------------- #
#        Shop Configuration Configuration        #
# ---------------------------------------------- #

Type

You can choose between following types:

  • Item (Grants a Item to the player, you can define the Material/Sub-ID/lore/displayname and enchantment.
  • PlayerCommand (Forces the player to run a(or multiple) command(s))
  • Permission (Grants the player a(or multiple) Permission node(s))
  • Command (The Console runs a(or multiple) Command(s) - possible to specify a player variable (%player) which is replaced with the nickname of the player).

PriceType

You can choose between following price types. These define how the players should pay.

  • Money (Default Money from your Economy System)
  • EXP (Players pay with EXP levels)
  • Token (Players pay with the inbuilt Token system)
  • Item (Players pay with the inbuilt Item currency system, the item you specified in your config.yml)

Additional Features per Package

  • Discount: 20 (This would put the Item on a 20% discount/sale with a information)
  • Cooldown: 10 (Seconds between a purchase (Only usable following Types: Command, Permission and PlayerCommand)

Below are some examples

stock:
  #In this case we sell a Player command. The Icon would be a Diamond, the pricetype is money and the price is 15.
  #In the Commands value you can specify a command or even a string the player would write to the chat.
  #Multiple Commands are possible, separated with a ":"
  #Example: /money:/spawn -> This would force the player to run /money then /spawn
  '0':
    Type: PlayerCommand
    Reward: Diamond
    Pricetype: Money
    Displayname: Show your money balance
    Command: /money
    Cooldown: 10
    Discount: 20
    Price: 15
  #In the following example you sell a Custom item (Wood:1) with a custom displayname and lore for 25 money,
  #and players are able to sell their item for 5.0 with an amount of 9
  '1':
    Type: Item
    Reward: Wood:1
    Displayname: This is a custom Item name.
    lore:
    - 'Look a '
    - fancy lore
    - '&ccan &abe &fadded :)'
    Pricetype: Money
    Price: 25.0
    Sell: 5.0
    Amount: 9
  '2':
    Type: Item
    Reward: Stone
    Pricetype: Money
    Price: 40.0
    Sell: 19.5
    Amount: 9
  # This example shows you how to setup multiple Permission nodes you wish to sell.
  # You can set a custom displayname / lore which explains the permission package the player is going to buy.
  '3':
    Type: Permission
    Reward: Diamond_Pickaxe
    Permission: essentials.home:essentials.fly:essentials.warp
    Displayname: VIP Package
    lore:
    - '&eThis Upgrade unlocks '
    - '&ethe usage of the &a/home, /fly and /warp'
    - '&ecommand on your account'
    Pricetype: Money
    Price: 25.0
  #Example setup for an Item with Enchantments, possible to add any enchantment level
  #The -1 sell price means, the player is unable to sell this item back to the shop.
  '4':
    Type: Item
    Reward: Diamond_sword
    Displayname: Sword of Fire
    Enchantments: FIRE_ASPECT:3;KNOCKBACK:40
    Pricetype: Money
    Price: 25.0
    Sell: -1
    Amount: 1
  #Simple MobSpawner which costs 500.125 Money and players can sell it to the shop for 0.0 (free) 
  '5':
    Type: Item
    Reward: Mob_Spawner
    Pricetype: Money
    Price: 500.125
    Sell: 0.0
    Amount: 1
  #You can even let the players pay with EXP for an Item / Permission or whatever.  
  '6':
    Type: Item
    Reward: Lever
    Pricetype: EXP
    Price: 5
    Sell: 1
    Amount: 64
  #This example shows a completly free item. You can buy and sell it for 0 (free)  
  '7':
    Type: Item
    Reward: Apple
    Pricetype: Money
    Price: 0
    Sell: 0.0
    Amount: 20
  #Mob Spawn eggs are also possible :)  
  '8':
    Type: Item
    Reward: MONSTER_EGG:90
    Pricetype: EXP
    Price: 15
    Sell: 10
    Amount: 5
  # Console Command example. This one would give the player wood for a price of 15 money  
  '9':
    Type: Command
    Reward: Wood:4
    Pricetype: Money
    Displayname: Free Wood
    Command: give %player% wood
    Price: 15
  # Now this is an example to run multiple commands. This one would give your player wood and announce it via /say  
  '10':
    Type: Command
    Reward: Wood:4
    Pricetype: Money
    Displayname: Multiple Commands is &cNEW!
    lore:
    - '&eThis is a new Feature '
    - '&eIt will run multple commands'
    - in this case give and a say announce!
    Command: give %player% wood:say %player% has just bought the wood package!
    Price: 15
  #In this example you can see the use of the new Token system.
  #Tokens can be aquired via the token commands, excellent for a premium/micropayment system. Let your players buy tokens from your webshop, and let them spend these
  #tokens ingame :)
  #Or reward your players tokens for voting, and let them buy some cool permissions or items for votes?
  '11':
    Type: Command
    Reward: Wood:4
    Pricetype: Token
    Displayname: Wood Reward
    lore:
    - '&eThis is a new Feature '
    - '&eIt will run multple commands'
    - in this case give and a say announce!
    - and requires the new Token feature!
    Command: give %player% wood 64:say %player% has just bought the wood package:pex user %player% group set VIP:tcmd 30 days pex user %player% group set Default
    Price: 50