Broker
THE BROKER HAS RETURNED FOR 1.14!
Broker is a trading plugin that allows players to buy and sell items to other players via a MMORPG style broker. What I mean by that is, the seller lists that they have an item to sell and specifies their price, a buyer browses through the sales orders (which they can do using a very clever virtual chest based browsing system) to find something they want to buy. The buyer buys, the seller receives their money.
Alternatively, the Buyer lists a Buy Order stating what they want to buy and the maximum they are willing to pay, and when a players has the item to sell, they can list it and the two orders are automatically matched up to each other!
This method will allow multiple players to list multiple items in ONE shop, where the buyer gets an easy to use interface for buying. This shop can be accessed either via commands or by right-clicking a [Broker] sign.
Features
- Easy Selling and Buying of items
- Sell the item in your hand and set your price with one easy command
- Express your interest in buying an item using Buy Orders
- List admin store orders for infinite supply
- Works with item economies by allowing multiple items to be listed for one price (1 Emerald for 16 items)
- Visual interface for buying from the broker
- Optional 'sales tax' charged to seller on completion of a sale (fixed rate or percentage)
- Option to pay taxes to a player or list of players
- Optional listing limit to avoid people using the broker for extra storage
- Use commands or create a [Broker] sign to access the store
- Automatically sell the item in your hand at the highest Buy Order price using an Auto Sell sign!
- Trade with Villagers or directly with other players by crouching and Right-Clicking them
- Use personal broker stores to list only items listed by one player (try a broker sign with a player's name in line 4)
- Easy setup and configuration
- NO SPOUT, NO MYSQL !!
It's difficult to describe the concept in detail so here's a video which helps:
(NOTE this video is based on a pre-release version and some aspects have changed)
Interface
By request, I've uploaded a screenshot of the buying interface. The paper on the bottom row of the chest inventory indicates the number of pages. Click them to change page. Click an item to see listed sell orders.
Requirements
This plugin requires Vault and some form of economy plugin.
Installation and Configuration
- Drop the JAR in your plugins folder
- Restart your server/plugins
- Edit the newly created config.yml (instructions in the file)
- Restart your server
- Have fun (Important!)
Suggestions
If you have a suggestion, now's the time to add it
Donations
If you like this plugin (or any of my other plugins) and want me to continue putting hard work into maintaining this standard, PLEASE consider donating using the donate button in the top right corner. If nothing else, this will help me justify to my wife why I spend so much time staring at code! :)
Other Projects
Have a look at some of my Other Projects
This is exactly what I've been hoping for. I devised this idea of trading in my head one day, almost exactly as you describe it here, and you have already provided. Many thanks to you ellbristow.
This looks fantastic! I'll start testing this as well... The first plugin I've seen that makes use of the new Inventory API!
BUG... SQUASHED :)
See 0.0.5a, uploaded and awaiting approval
I have a potential bug here. We are testing the plugin on our server and it seems like if there are multiple items of the same type in the broker and you try to cancel your sale of the same type of item, we're using diamonds for instance, it won't allow you to cancel the sale. We have 1 full stack of diamonds in first from one player, then i added mine for sale for a different price, not sure if price is important in the problem or not just mentioning it, when either of us attempts to cancel it does nothing. I like the plugin very much its super simple and super awesome, so i hope this is enough detail to figure out the problem. thanks in advance!
ok further testing has shown that its items of the same type with a different price, also the person who adds theirs first can remove them but not the second or following people. Here is the error report. 2012-04-05 17:04:57 [SEVERE] Could not pass event InventoryClickEvent to Broker org.bukkit.event.EventException at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:303) at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:62) at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:459) at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:1071) at net.minecraft.server.Packet102WindowClick.handle(SourceFile:28) at net.minecraft.server.NetworkManager.b(NetworkManager.java:229) at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:113) at net.minecraft.server.NetworkListenThread.a(NetworkListenThread.java:78) at net.minecraft.server.MinecraftServer.w(MinecraftServer.java:554) at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:452) at net.minecraft.server.ThreadServerApplication.run(SourceFile:490) Caused by: java.lang.NullPointerException at me.ellbristow.broker.BrokerListener.onInventoryClick(BrokerListener.java:199) at sun.reflect.GeneratedMethodAccessor36.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) at java.lang.reflect.Method.invoke(Unknown Source) at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:301)
v0.0.4a uploaded.. fixes some important bugs
Spiderman, we meet again :p I shall try this out, it looks interesting.
@QweSteR2221
Um... thanks for that comment... not really sure what you mean by it though.
I detest the idea of spout so none of my plugin use it. This plugin is for those who agree with me :)
No Spout?
Spout Shop >
http://www.youtube.com/watch?feature=player_embedded&v=-1nCd-EbZF0
or
http://dev.bukkit.org/server-mods/rpgessentials/pages/store/
This sounds a lot like SwearWord's VirtualShop plugin; he stopped updating it, but that plugin achieved a lot of eminence and success.
Can't wait to try this out - especially when chest-integration is implemented!
v0.0.1a (alpha) has just been uploaded pending verification.
This is the first alpha release and does not yet contain ALL the planned features, and may contain some bugs. Please report all bugs via the ticket system (either on this project page or via the github.com ticket system)
@ellbristow
im waiting for this plugin, for real, it look nice...
I'm just testing the first alpha release on my server at ellitopia.net ... it should hit dev.bukkit.org tomorrow! :)
Very nice. I'm looking forward for the video.
I have been waiting for a plugin like this!