Bukkit

The blockshop plugin allows you to create shops to sell mined ores to other players. Shop creation is made simple without having to know material names, id numbers or damage values. It allows selling anything in-game, including enchanted and colorable items, changing prices by using commands without having to break signs and re-type them, you can disable buying or selling, limit how many items people can sell to you, finding who sells something (e.g. /shop find diamond) and gives you a full list of all inventory counts for all of your own shops (/shop mystock) so you dont have to walk around and look at every sign.

Requires: Vault

To create a shop, you will need:

• One sign.
• One block (lapis, iron, gold, diamond, emerald).
• Stock to sell in the shop.
  
  

The block you choose to create the shop with will determine the maximum amount of stock the shop can hold (in stacks). Note that in comparison, a single chest can hold 27 stacks, and a double chest can hold 54 stacks:

• Lapis: 8
• Iron: 32
• Gold: 64
• Diamond: 96
• Emerald: 128

To create the shop, place the chosen block somewhere appropriate and place the sign on it. You do not need to type anything on the sign. Place the item you wish to sell in your hand, for example, dirt, and left-click the sign. Type /shop create to create the shop. The shop creation will be confirmed in the chatbox, and some text on the sign will further confirm the shop has been created.

Before you can start selling, you need to set the prices for the shop. These can be altered by typing the following commands at any time:

• /shop buyprice <price>
• /shop sellprice <price>
  

In addition, you can also set the sell price (selling to the shop) as a percentage of the buy price. For example, if you wanted to set all sell prices at 85% of the buy price, you can simply type /shop sellprice 85% and it will be automatically set for you. This allows you to have a uniform profit margin (in this case, 15%) in all of your shops without having to mess around with calculators.

You now have the option to set your buy limit. This number determines the amount of items people can sell to the shop. By default the shop will not allow players to sell to your shop until a player purchases from the shop. Each time a player purchases something the buy limit increases by that amount, and each time somebody sells to the shop, that limit decreases by that amount. For example, if the buy limit is currently zero, and i buy ten items from your shop, somebody else (or you) will be able to sell ten items to the shop. This limit stops people from selling tons of items to your shop and wiping out your entire money balance. It is usually wise to keep the buy limit at zero when first creating a shop - forcing players to buy from your shop before somebody can sell to it. To set your buy limit, type /shop buylimit <amount>.

If you have no stock in your shop, the buy price will be displayed as N/A - you have nothing to sell, therefore they cannot buy. If the buy limit is at zero, the sell price will be displayed as N/A - the shop is not currently buying from players, and is therefore disabled. Once you have added stock, the buy price will become visible again. Once the buy limit increases past zero, the sell price will become visible.

If you wish to disable buying or selling completely, set that price to zero. This will completely disable that ability for that shop in every possible way until you increase the price above zero.

To add stock to your shop, type /shop addstock <amount>. By adding an "s" directly after the amount, you can indicate stacks of items instead of individual amounts. For example, typing /shop addstock 2 will add 2 items from your inventory to the shop. Typing /shop addstock 2s will add 2 stacks of items from your inventory to the shop. To remove stock, type /shop removestock <amount>. You can also specify stacks as stated previously.

You can buy and sell from a shop by left clicking the shop sign first - and then typing:

• /shop buy <amount>
• /shop sell <amount>
  

Again, by adding an "s" directly after the amount, you indicate that you are dealing with stacks, rather than individual amounts.

This plugin also has the ability to find shops that sell a particular item. To find a shop that sells diamonds for example, type /shop find diamond or /shop find 264 - and the chatbox will display all people that sell that particular item, and the amount they have to sell.

All Commands

• /shop buy <amount> - buy something from a shop.
• /shop sell <amount> - sell something to a shop.
• /shop find <material name or ID> - find a shop that sells something.
• /shop create - create a shop.
• /shop buyprice <amount> - set the buy price of a shop. Set to zero to disable buying.
• /shop sellprice <amount> - set the sell price of a shop. Set to zero to disable selling.
• /shop addstock <amount> - add stock to the shop.
• /shop removestock <amount> - remove stock from the shop.
• /shop buylimit <amount> - limit how many items people can sell to your shop.
• /shop mystock - list all of your shop stock.

Permission Nodes

• blockshop.create - Ability to create a shop
• blockshop.buy - Ability to buy from a shop
• blockshop.sell - Ability to sell to a shop

More Information

For a verbose tutorial on how to create and maintain shops, visit: http://bitspawn.com/blockshop