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
I have found some more bugs. Well they are hard to explain how to reproduce because it seems somewhat random.
But there is times when you use /broker buy nothing shows in the shop but then you can sell something in your hand and then all the items in shop appear.
And there is times when you cancel a order the window to take your stuff out doesn't appear. And you can go in the shop and try and buy your own item but it gives error saying that its not in the shop anymore.
v1.1.0 has just been uploaded, and it's a biggie. Lots of new features and bug fixes... the changelog really doesn't do it justice.
Introducing [Broker] signs! Force your players to go to a specific location to buy from the broker. create a [Broker] sign and remove the broker.commands.buy permission and users will be forced to buy from that location! (By right-clicking the sign)
Also introducing... Batch Sales! Now users can list multiple items in batches. Got 64 stone but don't want to sell them for 1 emerald each? Fine! "/broker sell 1 16" will sell the stack in batches of 16 for 1 emerald per batch (or whatever your currency is)!
As always, ticket me up with any bugs you find or suggestions you may have. My inbox is always listening.
This is PERFECT for my server. I was looking for an economy plugin that allowed players to sell to the server, and the items sold would become the stock that other players can then buy. This is basically the next best thing. Or perhaps better :D
@TerraVale
Cost per X items is something I have already started working on for exactly the same reason. My server now uses an emerald economy and 1 emerald for 1 dirt is a bit steep! At the moment I've set my server to allow you to list a whole stack for a price... but I do intend to tweak that to make it so you can list a stack for a price per X items. This one might take a while to implement properly (there's a lot of bugs in the version on my server) but it's on it's way.
Regarding the console spam... that's also a bug I've spotted and I've already tweaked it ready for the next release.
@ellbristow
Hey there, I agree with BFUSpEd's suggestion, however I do have my own suggestion!
Could you add the ability for the player to set cost <per amount of item> instead of cost per item? I'm using emeralds as my economy and 1 emerald cannot equal 1 stone, so therefor the solution would be to add player configurable item bundles to sell, essentially...
Also, broker seems to be spamming my server's console with [Broker] [SQL] Connection refreshed! This happens every 30 seconds or so... strange :(
v1.0.0 has just been uploaded! Yes it's a proper release!
This release includes configurable sales tax and a whole host of bug fixes.
Please report any bugs you find as tickets and I'll get on them as quick as I can.
@BFUSpEd
This is a good idea that I've considered... I'll look to put it in the next build. Moving it to a Suggestion Ticket.
@JustinFatalx
It's not dead... I just haven't been able to get round to updating it yet.
Watch this space!
Is this plugin dead :(
I cant wait for this to get updated!
any chance for an option to limit the amount of items/stacks a player can have for sale at one time? people are using the broker as a bank by listing all their items for a very high price
Great plugin btw
@Muizers
Looks good.
I can't wait for the 1.3 API so I can integrate the new villager trading system... I have big plans to upgrade this plugin once 1.3 is live
Hey ellbristow!
I've got a plugin with a matching system, it has no interface though :(
http://dev.bukkit.org/server-mods/grandexchangeplugin/
@zipppzy
Mine is very much like RuneScape, therefore called that way:P
http://dev.bukkit.org/server-mods/grandexchangeplugin/
It is a lot like runescape's great exchange.
@Legundo
Video Added :) Thanks Legundo
Update: My plugins are currently on hold while we wait for 1.3, since the 1.3 update will more than likely break large portions of most of my plugins! Sorry for the delay and please stay tuned for future releases.
Hello sir, I am highly interested to have you join my server (6GB soon) NiflheimCraft as part of our staff and dev to our server. If interested add me on Skype alexko234
Hey guys, love the mod! We're using it as our primary shop system on our server!
We also run a Mod Spotlight series and we just released our spotlight of your mod a few days ago, hope you like it!
http://www.youtube.com/watch?v=O7hpWhKXOlI
Wait until your fixes and updates! I hope you support the MYSQL Based!
Yes! I always wanted SimpleTrade to be finished haha, you almost did it now ;)
This plugin deserves to utilize /sell and /buy, please make it do that!
CHEERS!!:D