Bukkit

This mod will allow multiple users to easily buy and sell items from one another. Players will be able to put items up for sale with a price, put offers up for certain items, display prices for a certain item, and see offers on items. Items up for sale and money being offer will be stored by the plugin, and saved so that no items or money are lost.

Command Instructions

All item names must be exactly as they are in game, and are not case sensitive. All commands may be prefixed with "st_" if the command is in use by another plugin. For instance, if another plugin uses "/sell", you may use "/st_sell" instead.

/sell <item name> <amount> <price> - Put an item or multiple of the item up for sale for the set price. The price is per item.
/buy <item name> <amount> <price> - Put an offer up for an item or a number of one item for the set price. The price is per item.
/offers <item name> - Check the prices people are buying an item for.
/sales <item name> - Check the prices people are selling an item for.
/mytrades - List all of your active trades
/collect - Collect as many bought items as possible
/collect <trade> - Collect as many items from trade number <trade> as possible
/deletetrade <trade> - Removes a trade from the main listing. If there are items to be collected and they cannot fit in your inventory, they will be dropped

Usage Instructions

Trades are stored on a global server listing which is saved whenever the plugin is unloaded to prevent items or money from being lost.

If you want to buy an item, you would type "/buy" with the above parameters. The plugin will first attempt to buy out all sales cheaper than the set price, starting with the cheapest. If after those are all bought out (or there weren't any cheaper anyway) it will create an offer on the listing at the price you set for however many left there are. People can now view your sale with "/offers" if they specify the item you're looking for. At any time, you may view you own trade with "/mytrades" to see its progress. If you have any items you bought, they are stored in the plugin until you want to collect them, which you would do with "/collect" and either collecting all items or specifying a specific trade to collect from.

Selling an item is very similar to buying an item. You would use "/sell" with the above parameters, and make sure you have the correct amount of item in your inventory. The plugin will now attempt to sell the items to all offers with prices greater than or equal to the price you set, starting from the highest price. If after all of those offers are exhausted and you still have items left, the sale will be put up on the main listing, which can be viewed with "/sales" with the item you're selling as a parameter. Money from completed sales is automatically given to you, with no need to use "/collect".

If you want to delete one of your trades, you will need to first find the trade number of it with "/mytrades". A list will show up with numbers next to each trade. Simply type "/deletetrade <number>" with the number of the trade you want to remove, and the trade will be deleted. For an offer, any items uncollected will be given to you automatically. If you don't have room in your inventory they will be dropped. For a sale, you will get all of the item back that isn't sold yet. If there isn't room in your inventory, they will be dropped.

Permissions

The only permission node so far is "trade". Giving a player the trade permission will let them buy and sell items using the plugin. There are planned administration commands which will have a separate node.

Dependencies

This plugin requires Vault and an economy plugin that works with Vault.

Installation

Simply download the latest release and drop it into your /plugins folder. There is no configuration file for this plugin.