Bukkit

Installation and configuration

Dependencies

This plugin needs Vault installed.

Installation

1. Download the latest version
2. Copy to your plugins/ folder
3. Restart your server
4. Edit the plugins/GB.Shopper/config.yml file to setup the plugin
5. Perform a /gbshopper reloadconfig when done
   
   

Configuration

A rundown of things you can control through the config.yml file

config.sellModifier

This modifier is applied when users sell something to the shop, set to less than 1.0 if you want to make items worth less when selling to the shop.

Setting this to values larger than 1.0 will allow users to give themselves unlimited cash

config.allowChatTrades

Allows using chat commands to trade, for instance using !diamond_sword to purchase a diamond sword.

Changing this requires a restart of the server.

config.chatTradePrefix

If allowChatTrades is enabled, this is the prefix that is reactod upon.

config.inventoryPageLenght

Set the number of items per page using the /gbshopper list command

config.signSetupTimeout

The time, in seconds, before an unfinished gbshopsetup sign times out and is removed.

Defaults to 30 seconds.

itemprices

The itemprices section of the configuration sets up which items will be available, their price, how they are traded and any aliases they might have. (Use the WiKi for reference)

An item definition consist of an itemid and up to four subsettings.

id

The ID of the blocktype, can be found via the aforementioned WiKi link. (Required)

If defining a subitem (ie, colored wool), the id should be of format id_subid (For more information, read the subitem part of this document)

price

The price of the item (Defaults to 0.0)

sellmodifier

Override the global sellmodifier for this item.

allowbuy

Can the player buy this item from the shop? (Defaults to false)

allowsell

Can the player sell this item to the shop? (Defaults to false)

aliases

A list of aliases for this item, NOTE! For subitems, at least 1 alias is required.

For instance, if you want stone to have a value of 0.75, be allowed to be sold but not bought from the shop, and have the alias smoothstone, use this configuration.

itemprices:
  '1':
    value: 0.75
    allowsell: true
    allowbuy: false
    aliases:
    - smoothstone

You can use the list on this page as a starting point.

Subitems

Because of the way Minecraft handles certain items, by having item properties like color in an extra datafield, you have to define them a bit differently from regular items, namely id_datavalue

For instance, wool has itemid 35, which is white by default. The color of the wool is controlled by a data value, for instance, black wool has a data value of 15, and if you want to add this to your shop inventory, you need to specify the id as 35_15.

NOTE! When specifying subitems, you need to specify at least one alias in the aliases: section of the item, or else the item will not be added to the shop inventory.

Data values can be found on the same WiKi page mentioned earlier.

If you have specified wool to be on sale, all "sub items" can be sold at the same price, if you want to block subitems, you have to specify all of them in the config.

Permissions

GB.Shopper currently has two permissions.

gbshopper.user

Basic usage, this is set to true by default.

gbshopper.admin

Administrator access, can reload config.