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 don't think it saves item names/descriptions when you put them up for bid. Can you allow this in the next version?
I left the broker running on my server for a few days and it now no longer shows anything past the second page. All additional offers bump off the last offer on the 2nd page.
I tried it on my test server and it allowed items up to page 3, 4 etc but somehow on the main server it wont go past page 2.
Any idea why this is happening?
EDIT: i think its caused by this error: http://pastebin.com/RVR8B6V2
pff awesome, this is exactly what i was looking for, thx, just need the language support and is my perfect trade plugin
Version 1.3.0 has just been uploaded (pending approval). This build fixes the major bug that prevented players buying or cancelling orders via the broker!
It ALSO adds a cool new feature:
PERSONAL Broker Stores
A new option has been added to [Broker] signs and the /broker buy command that limits the items show in the store to those being sold by one specific player.
The command option is simple (/broker buy {Seller Name}) but the sign version is far more powerful.
For signs, put a player's name in line 4 and only that players sell orders will appear in the broker interface. This allows you to have localised stores for individual players (who can be given permission to create these stores themselves) and continue to have one central Broker store in a public location.
I'd love to see your comments on this, and of course, if you find any bugs, please report them as tickets via the tab at the top of the page.
Enjoy! (I know I will!)
@WingedSpear
Ouch, yes something has gone horribly wrong. I'm on it.
Citizens integration?
@ellbristow
i find this plugin really long time ago, i was exited but i was waiting till some impovements, i will be using it now, but can u add language support? i need that for my server, thx and great idea, love it
edit: i have some issues, i cant cancel my selling stuff, i used the command, clicked the items, it they ''sell canceled'' but the item its still there, tryed tons of times...
there should be a ''sell'' sign
when buying i get that the item is not avaible (this item may not be avaible anymore, please try again later), maybe cause im buying an item from myself, not sure, but still it should answer saying something like ''u cant buy ur own item'': EDIT: tryed buying one item from another player and i cant, i get the same answer...
i really want to use the plugin but i need it to work of course =/
@macbookfan33
I've just uploaded 1.2.4 which should fix this issue
Is the startup bug now fixed?
@ellbristow
just one more thing...
is there any way for an admin/owner to remove offers or edit the .db file?
I would create another ticket but dunno if this is already possible
v1.2.3 uploaded and awaiting approval
This one adds the requested broker.commands.cancel permission to allow the disabling of /broker sell cancel
@alofoxx
I would have to create a sign for every single combination of price and #items
- /broker sell 1 1
- /broker sell 1 2
- /broker sell 1 3
.....
- /broker sell 2 1
etc....
not really an option, unless commandsigns has something for letting users input arguments?
@BFUSpEd
@alofoxx
Please add your suggestions as tickets so that I see them when I next do a check.
Thanks
@BFUSpEd
"- Make [Broker] sell signs where players click on it then input the price/per#items variables (so there's no need to give the broker.commands.sell node)"
This can be accomplished with command signs
use the sign to issue the command on the players behalf with no perms.
can also be used to restrict the buy command to signs.
This is by far the best trading plugin I have found. There is still one thing stopping me from using it and that is not being able to disable /broker sell cancel. There would be two simple solutions to this:
- Make a separate permission node for /broker sell cancel
- Make [Broker] sell signs where players click on it then input the price/per#items variables (so theres no need to give the broker.commands.sell node)
Either of these features would make this the perfect plugin for me!
@macbookfan33
Please post a ticket with a copy of the error.
This isn't working. I get an invalidpluginexeption when starting up my server. It generates the folder but not the config file.
@fisherman77
This is something I've considered. At the moment I'm not 100% sure how I would do it... but it is on my radar.
@Lukethenuke
Because the item names are new I haven't worked them into the plugin yet. Once the API for named items is stable I will definitely add support.
Thanks for the donation and you support. I've enjoyed making this plugin and I love to see it going to good use.
I just sent you $5 as part of a doing an awesome job. I don't necessarily hate other shop plugins but this is so damn easy compared to some setups that I'm glad you've stepped up to the plate to make it.
One thing I did notice is that if I sell a custom named enchanted anything, it removes the name when sold. I'm not a programmer so I'm not even sure if you can keep named items but consider it a feature request down the line if you think its possible.
Cheers.
Suggestion: Integrate with Citizens 2 to enable NPCs to buy/sell!