GlobalMarket
GlobalMarket is a global market system. It allows players to buy and sell items via a convenient in-game interface. It's similar WoW's Auction House or Runescape's Grand Exchange. I created this plugin awhile ago (back in the days of WebAuction, it's what inspired me) for private use, but I've decided to release it to the public. This plugin requires Vault and ProtocolLib, other than that, just drop it in plugins (make sure you have Vault plus a supported economy plugin installed) and start trading!
Features
- Players can put any item up for sale using a dead simple in-game GUI system (see below)
- Uses ProtocolLib for proper item serialization that supports Bukkit, Spigot, and Cauldron
- Real time interface, all trades show up immediately without having to 'refresh' or close the GUI
- No maintenance or admin interaction required
Mailbox system that allows you to set up market areas or auction houses(not currently in 2.0.0)A built in price guide that compiles average prices from previous transactions(not currently in 2.0.0)
Latest Dev Build
Development builds of this project can be acquired at the following continuous integration server.
These builds have not been approved by the BukkitDev staff. Use them at your own risk.
http://build.survivorserver.com/job/GlobalMarket%202.0.0/
Changelog
Usage
- The Interface
- This is a display of all current listings, you click an item to buy it. You can shift+click to remove a listing if you own it, or if you have the "globalmarket.listingsadmin" permission. Listings automatically expire after 1 week (configurable). You can use
/marketto access the menu.
- Stock
- When you purchase an item it will be sent to your stock. Stock is an entirely optional system but is suggested to be enabled, as disabling it will disable certain other features like
/market send. The stock system can hold a configurable amount of stacks of items in a configurable amount of slots. Once you place an item in your stock, you can list it to be sold to other players. Players can also send items to other players' stock via/market sendif they have the "globalmarket.command.send" permission.
- Server Listings
- You can create 'infinite listings' that do not expire and can't be bought out. Create them with
/market createinf <price> <[amount]>. There's a dedicated section to server listings in the Market menu. You'll need the "globalmarket.command.createserverlisting" permission to do this. Or you can disable this system all-together in the config.
Commands
| Command | Description | Permission |
|---|---|---|
| /market | Opens the Market menu. | globalmarket.use |
| /market ? | Shows command help. | <no permission> |
| /market send <player> <[amount]> | Sends the item you're holding to <player>'s stock. Amount is optional. | globalmarket.command.send |
| /market createinf <price> <[amount]> | Creates a server listing. Amount is optional. | globalmarket.command.createserverlisting |
| /market reload | Reloads config.yml | globalmarket.command.reload |
Permissions
- globalmarket.use - base permission, required to use /market
- globalmarket.listingsadmin - ability to remove all listings
- globalmarket.command.send - ability to use /market send
- globalmarket.command.createserverlisting - ability to use /market createinf
- globalmarket.command.reload - ability to use /market reload
Config
All config values have comments that explain what they do in config.yml, how convenient for me!
If you wish to blacklist items from being used on the Market, there is blacklist.json. You can add material values with meta values:
- APPLE:0 - blacklist apples
- INK_SAC:-1 - blacklist all dies
If you're running Cauldron, you can do things like:
- oredict:ingotSteel - blacklist any item with an OreDictionary value matching ingotSteel
- extracells:storage.component:-1 - blacklist all ExtraCells storage cells
Locale
Virtually every string in the plugin is editable via the "en_US.json" file, inside the plugin's JAR. It's pretty straightforward to edit. Don't replace or edit the %s or %1$s's, these are variables. For example, "Item sold: %s" would appear as "Item sold: Cobblestone" in-game. You can add/edit colors by typing & plus a color code. So light green (the color code is a) would be &a. You can find color codes here: http://ess.khhq.net/mc/
You can also create an entirely different language set, name it something like ch_CN.json, stick it in the server's JAR, and change the appropriate config value in config.yml to use it.
Source
https://github.com/Dasfaust/GlobalMarket
That's all for now. Sorry if things are unclear, I'll be updating this page with more information periodically. If you're stuck just add a reply and I'll do my best to help!
Comments
-
xdasfaust Owner
-
View User Profile
-
Send Message
Posted Dec 16, 2013Looks like the market is becoming one of the major spectacles of our server.
It would be interesting to apply the average market sell value as lore to all sellable items on the server. This would be actual sell value and not listing value.
For example, for us it be cool to have a diamond pickaxe that says:
Reckon its doable?
-
View User Profile
-
Send Message
Posted Dec 16, 2013Coming soon to a dev build near you! Link
@Kane_Hart
Sweet, I might stop by on launch day. I'll be working more on the history command soon, haha.
@siemaeniu500
You have to be using at least snapshot 13w49a. In clients before that there's a bug that prevents the server from cancelling clicks. There's more info on it at the top of the description.
-
View User Profile
-
Send Message
Posted Dec 16, 2013My players can get this "paper" named like second page, previous page. They can use this paper. I am using 1.7.2 spigot.
-
View User Profile
-
Send Message
Posted Dec 16, 20134 days till my server launches. I made a write up on the plugin and a video for my community I thought you might be interested!
http://stonelegion.com/forums/topic/860-4-days-left-till-launch-lets-talk-about-global-markets/
-
View User Profile
-
Send Message
Posted Dec 15, 2013@Bikespot
Works just fine here. Thing is the mailbox shoots it directly to your hand and the first open slot. Not sure if you just did not notice it go directly into your inventory or if creative mode the buffer ended up deleting it. But it does not pick up in your inventory. Also make sure your using 1.7.4 client as it fixes any odd clicking issues before.
-
View User Profile
-
Send Message
Posted Dec 15, 2013Im using 1.7.2 spigot. When someone buys an item the seller gets the money ok. But the buyer gets the item and it still says Click to buy. If you drop the item it disappears , plus its gone from the market listings. Not sure if this is just a bug with spigot.
-
View User Profile
-
Send Message
Posted Dec 14, 2013@KeithSt0ne
There already is multi-world support.
@LeVieuxGildas
Nope
-
View User Profile
-
Send Message
Posted Dec 14, 2013With this system can u change the gold by items ? I mean can u sell for exemple a diamond for 64 wood ?
-
View User Profile
-
Send Message
Posted Dec 14, 2013Thanks for adding the option to select percentage!
Do you plan to offer multi-world support?
I'd like to separate the market between a couple of my world.s
-
View User Profile
-
Send Message
Posted Dec 13, 2013@mobilephone2003
Can do. I'll try to work it in soon.
-
View User Profile
-
Send Message
Posted Dec 13, 2013@xdasfaust
Seems to be working fine now, thanks.
I did a workaround and disallowed commands globally. I've tried to make the process semi-interactive by having a market building, command signs opening the market listings, and just the mailbox chest accessible, so people can then localise to one place instead of using a command to list and check wherever on server.
This is really good stuff, and people seem to be enjoying it so far, but some may need a little reminder that it's there, could the "You have new mail" be added to a (relatively long) timer? Just in case people forget to check after a period of time
-
View User Profile
-
Send Message
Posted Dec 13, 2013@mobilephone2003
Downloads are working fine as of right now for me. The util permission is only to create stalls/mailboxes, there is no permission to use them. But there is a permission for the commands (like /market listings or /market mail)
@KeithSt0ne
I changed it so you can do both in the latest build. Check it out here.
-
View User Profile
-
Send Message
Posted Dec 13, 2013Did you change creation fee to a set amount? It's not working as a percentage, 0.07 is charging 7 cents for every purchase.
I was using the percentage to charge people so they were discouraged from trying to list their items at ridiculous prices as a way to store items.
I hope that's just a bug.
-
View User Profile
-
Send Message
Posted Dec 13, 2013I currently can't seem to get the dev builds, the downloads are timing out mid-way and resulting in a corrupt file, asked a couple others to try and they get the same.
Any ideas?
Also, can the .util permissions be broken down? so people can only access mailboxes and not create or remove them?
-
View User Profile
-
Send Message
Posted Dec 12, 2013@Kane_Hart
Oh, yeah, you suggested that before. Still in the works. The new history system is still a WIP, but no it hasn't changed in awhile. I think if you scroll up your usage stats will still be there.
@ElectroBot4
I see, that plugin basically stores the contents of a book somewhere and updates it as people read the copies. I could definitely do something like that. I'll experiment around with different things to cut down on the spam.
-
View User Profile
-
Send Message
Posted Dec 12, 2013@xdasfaust
We used to use the bookworm plugin (http://dev.bukkit.org/bukkit-plugins/bookworm/) which allowed updating a book with multiple copies in other player's chest/inventories. Would it be possible to link the books to the sql database?
Thanks, ElectroBot
-
View User Profile
-
Send Message
Posted Dec 12, 2013@xdasfaust
Ahhh Sorry. What I was meaning is right now you gotta list every single stone stack on it's own over and over and move it to your hot bar. What be cool is if you could do it to one stack and just say your listing 10 stacks of it and it will grab 10 stacks worth and list it. Of course it still list it the same style you have now but just posts them in batches, rather then having to use the command 10 times. :)
The book thing! Ahh I did not know about that. I thought the data was stored in the world or something that could just have a special ID saved and edited / updated none stop. If I recall a player had given out books to all his friends then he kept updating content in it overtime. But maybe plugins can't interact with that type of system. It was really neat anyways.
Also did history a few days ago have some kind of other features to it? Because this is what it looks like and I swear a week ago there was like total sales total made total lost or something but maybe I'm doing the command wrong /market history
-
View User Profile
-
Send Message
Posted Dec 12, 2013@Kane_Hart
As items are added it counts all of their siblings and puts them in a list, so when you view a page it has a cached copy of all listings in a stack. If that's what you meant. And I fixed that bug in the latest build, thanks :D
@ElectroBot4
Maybe, I'll experiment with a few ideas. As for an auto updating book, there's no way to keep track of a certain item. You'd have to find the book in the player's inventory, if it's not there then it's pretty much impossible to find. And if the player is offline that's a whole different story.
-
View User Profile
-
Send Message
Posted Dec 12, 2013So that bug I said seems to be fixed IDK but we switched to the pick up the book system and it now showed the text and oh my talk about spam haha:
-
View User Profile
-
Send Message
Posted Dec 12, 2013@ElectroBot4
Agreed this would be very helpful. Unless you want to make a filing cabinet mod! :P