InstallConfig
Installation and configuration
Dependencies
This plugin needs Vault installed.
Installation
- Download the latest version
- Copy to your plugins/ folder
- Restart your server
- Edit the plugins/GB.Shopper/config.yml file to setup the plugin
- 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.
Comments