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
Question for you: Would it be possible to have the sales tax amounts added to a tax account? I want to have a closed economy, and if the tax amounts are just "subtracted" into thin air, and don't really end up anywhere, it somewhat defeats the purpose of having a closed economy. Plus, I can use the funds collected from the taxes to fund other things, as in a real economy. I look forwards to seeing this in the next update!
- Cole
Seems enchanted items are unpurchaseable no error or any message just when you type the quanity you wish to buy it does nothing. Also seems to not let us cancell items with enchantments listed in broker.
Actually enchanted items work but not when I used tim the enchanter /enchant all items. Which isnt a big deal anyhow.
Hey!!
The Mod Spot is coming back, so we'll do an update of Broker to celebrate our return!! I'll message you when the video is released.
I do seem to have found 1 weird function to the plugin. Not really anything serious but if you buy more than 1 Armour/weapon it stacks them. Like buy 4 diamond swords at once then the 4 diamond swords are stacked. Not really anything wrong with that but just think it be cool to add a option on whether to stack weapon/Armour or not.
Do you think you will ever add MySQL support to this plugin? :D
@Sylar6281
Strange, if you have other SQlite plugins running it should just work. Is the path it is reporting valid? (/home/minecraft/worlds/world/plugins/Broker/Broker.db)
I get the following errors when trying to load Broker
Line 139: 2012-09-10 13:05:28 [SEVERE] [Broker] null Line 140: 2012-09-10 13:05:28 [SEVERE] [Broker] No suitable driver found for jdbc:sqlite:/home/minecraft/worlds/world/plugins/Broker/Broker.db Line 141: 2012-09-10 13:05:28 [SEVERE] Error occurred while enabling Broker v1.2.1 (Is it up to date?) Line 143: at me.ellbristow.broker.BrokerDb.tableContainsColumn(BrokerDb.java:169) Line 144: at me.ellbristow.broker.Broker.onEnable(Broker.java:62)
We definitely have the drivers as we have other SQLite plugins running. Is there anything I can change on my end to get this working? It looks like such an awesome plugin!
Awesome plugin thanks for it !
Edit: I spoke to soon it does not work on 1.3.1 R2 but that's my fault for trying when it says it works up to 1.3.1 R0.1
Appears to be working great now. No issues found so far.
@JustinFatalx
Hmm, interesting. could you post a ticket and attach your broker.db file, I'll hook it up to my test server and see if I can reproduce the problem.
The [SEVERE] is an error but it's obviously one I didn't expect to get thrown so didn't include a stack trace printout... I'll add some debug code to my local version to see if i can spot it.
There is still some minor display bugs. And there is no error logs showing in console it just stops displaying stuff in the shop sometimes and then it just fixes itself. Its weird and there is no error in console it just says [SEVERE] [Broker] null
I dont do anything to fix it. Sometimes it displays and other times it don't.
@JustinFatalx
IKR!
They sure do take awile to approve -.-
Yay can't wait for this to be available. Keep up the good work.
I've just uploaded v1.2.0. The code changes are very minor but the implications are quite huge. Inventories now correctly assign an owner so that it can interact with other plugins like LogBlock! (And I worked it out all by myself :D )
@JustinFatalx
These comments should have been put in a ticket. Please remove them and repost as a ticket.
Your problem is actually to do with the interaction with LogBlock... a matter I am currently working with them to try to rectify. Their plugin does not support virtual chests which are not connected to a specific block. (I have a similar issue with my ChestBank plugin).
Once we have worked out a way around this one or other plugin will be updated to fix it.
@TerraVale
Have you seen the 1.1.0 update? I added [Broker] signs for centralised shop locations. Simple do not give players the commands.buy command and people will have to go to the broker sign to buy... plus I added sell order limiting to stop people listing orders for storage. I think that's both your problems fixed! :)
@JustinFatalx
Please check the console when these issues happens. It sounds to me like the plugin is throwing an error. If you can post this error in a ticket I'll try and reproduce it and see if I can fix it.
@ellbristow
Good job! I'm glad to see we're both on the same page with the economy thing :)
I just wanted to mention that your plugin is absolutely perfect for server's (such as mine, in the works). I was looking around and at first was planning item signs, but soon realized that it's very inconvenient in my setup for players to have shops in their homes or their own locations. It'd be clunky and confusing; coincidentally, I found your plugin. Your plugin provides exactly what's needed on a server - A localized area/location (in this case a GUI) to show all items people want to sell, an easy method of buying those items, and an even easier way to compare prices to one another (which provides another factor of competition to the whole shopping system, balancing an economy).
All in all, thank you for dev'ing this plugin! I can't wait for testificate use too, having players go to a centralized location will be fun :D
All that's really needed as of current is the ability to prevent people from storing items in the broker! Hopefully that's not too challenging to accomplish.