HyperMerchant
I will no longer be supporting this plugin. I can't find the time or motivation and I have moved on to Sponge for my personal servers. If anyone is interested in forking this, go right ahead and I will link to your project.
Thanks to everyone who reported a bug or donated their time or cryptocurrency.
Introducing HyperMerchant
HyperMerchant is a shopmenu GUI and NPC shopkeeper plugin for HyperConomy shops.
HyperConomy is the premier fully dynamic minecraft shop plugin. It is loaded with super unique features and is the perfect shop/economy plugin for RP, Faction, Freeplay, Towny, and Hybrid servers; Or any other server that is in need of a superb economy or shop plugin.
HyperConomy is most likely compatible with whatever economy plugin you are already using; And if you don't have an economy plugin already, HyperConomy has one built in.
So what is a fully dynamic shop plugin? It means that prices change automatically based on what your players buy and sell, much like they would in a real economy. This functionality can be disabled if you want prices to remain the same. Check out HyperConomy now.
HyperMerchant simmers alongside and together they become a super sauce, packed with vitamin awesome!
To get started, download the correct versions of each program. Details can be found in the compatibility guide.
Follow the links below to learn more about configuring and using HyperMerchant.
Commands and Permissions
Configuration
Menu Buttons
Compatibility
How To
Languages
HyperMerchant Features
Coming soon in version 1.58
Language support. Currently available in the latest development build.
- Simple to use Inventory-style shop menus.
There are helpful tooltips in the shop menu to guide new players.
Purchase 1, 8, or a full stack of items in a single click.
To sell items, simply drag them from your inventory window to the shop window. - Management Menu for player shops. Players can use /mmenu while staning in their shop, or shift+click their shopkeeper NPC.
- NPC's are not required, you can enjoy the shop interface with /shopmenu and /remotemenu commands.
- Assign many NPC's around your world to the same shop.
- Convenient commands to quickly set NPC greetings, farewells, offduty, and service denial messages.
- NPCs can be toggled to offduty mode to temporarily close shops.
- Players who own a player shop can be "clicked on" to open their shop menu.
- Player shop owners can toggle themselves "/onduty" and you can limit them to only being "open" while inside their shop.*
- Your players can /hire their own NPC shopkeepers (clerks) for a configurable "comission percentage".
- You can set up NPCs who are ready to be hired by a player to work in that player's shop.
- You can set up shops to be rented by players with NPC shopkeepers included.
- Configure the Interface Icons in the shopmenu gui by editing "menubuttons.yml".
- Sort menu by name, material, sell price, buy price, or stock amount. (donated for by hellphish)
- Hide items with zero stock. (donated for by hellphish)
Requirements
See the compatibility page for a breakdown of Bukkit + HyperConomy + HyperMerchant + Citizens matchups.
HyperMerchant is compatible with Java 6.
You must have Citizens2 installed to use NPC shopkeepers. You do not need Citizens if you only want to use the shop menus.
Development Builds and Source Code
Development builds are available at the continous integration server.
Development builds have not been verified safe by Bukkit staff. Use at your own risk.
Get the source for HyperMerchant on github.
Donations
I now accept donations in cryptocurrency. If you message me I will happily honor you as a donor on this page.
DogeCoin:
DJHgjbD2qpeWstJxBtyzEVetPSeGiQN2Zt
BitCoin:
1EwTvDRXu9nERfzdFxWZMV8y5ct76e1DPT
SHORT VIDEO TUTORIAL
https://www.youtube.com/watch?v=afvurpJJC6g
Also, you can direct your players to this video on how to shop in HyperConomy shops via HyperMerchant menus or HyperConomy commands:
Shopping Tutorial: http://www.youtube.com/watch?v=Ck4gr-QrjG8
Video is courtesy of JacksmackDave. Thank you!
Special Thanks
Thanks to Tux2 for getting me started with this bukkit plugin tutorial.
Thanks to nisovin for sharing his menu code in this forum post.
And especially thanks to RegalOwl for developing the featurefilled HyperConomy plugin. It is the machine and HyperMerchant is just an interface built upon it.
Much credit also goes to the developers of Citizens, whose plugin provides all the npc interaction.
Reporting Bugs
If you are having a problem, there is a good chance it has never been reported yet. If I don't hear about the bug, I probably won't ever know about the bug, because I don't run a populated server to test out every feature of HyperMerchant.
Please take the time to report any issue, it will be a help to the community and your own server. I usually check this page each day. Thanks! =)
-
View User Profile
-
Send Message
Posted Dec 11, 2013My NPC's aren't working with shops. The console says that they are assigned to a shop that doesn't exist when it clearly does.
-
View User Profile
-
Send Message
Posted Dec 9, 2013@Ares513
HyperMerchant probably isn't loading properly. Make sure you are using HyperConomy development build #312 or greater, HyperMerchant Version 1.3b (from the github link above), one of the latest Citizens dev builds, and Bukkit 1.7.2 dev build.
If you are using Bukkit 1.6.4 or lower you will have to use HyperMerchant 1.2.7 and HyperConomy 0.973[Beta] or HyperConomy 0.974.1[Dev] and a version of Citizens that works with bukkit 1.6.4
If you are using Bukkit 1.6.4 you will not be able to use player shops with HyperMerchant.
-
View User Profile
-
Send Message
Posted Dec 9, 2013@TJW28
Sorry about that, that is some output I was using for debugging and forgot to turn it off. Please download the file again, It should be fixed.
-
View User Profile
-
Send Message
Posted Dec 9, 2013Hi,
I can't seem to get the /trait hypermerchant going. It just says the trait isn't found.
Can you help?
Ares
-
View User Profile
-
Send Message
Posted Dec 9, 2013@shmancelot
Hi shmancelot, while testing 1.3b, each time an item is clicked in the merchant, it generates All the items in the console, and happens each time previous and back options are presses in the merchants navigation area at bottom. Is that meant to happen?
-
View User Profile
-
Send Message
Posted Dec 7, 2013There is now an updated build of HyperMerchant in the github repository. Use the link above. Look in the /jar folder for version 1.3b
Version 1.3b is only compatible with bukkit 1.7.2 and HyperConomy development build #312 or higher.
Please note, player shops are still not fully supported. Player shops will display the correct prices and stock amounts, but the financial transaction will be with the server and the shop owner will not profit at this time. Fix coming soon.
There is a client-side bug that will make players receive a ghost item almost every time they click on the menu. These items are only client-side wierdness and they disappear when a player tries to use them. The bug is fixed in the latest builds of Minecraft, and it will be fixed for all players when Mojang releases their next bugfix version.
-
View User Profile
-
Send Message
Posted Dec 6, 2013@therennon
I will have time to really work on HyperMerchant tonight. It should be compatible this weekend.
-
View User Profile
-
Send Message
Posted Dec 6, 2013hello,
It works in version 1.7.2?
greetings and thanks
-
View User Profile
-
Send Message
Posted Dec 4, 2013@trump600
Thank you very much, that information is very helpful and I bet it will lead right to the source of the issue.
-
View User Profile
-
Send Message
Posted Dec 4, 2013@shmancelot
We're bypassing your gui error by manually adding and editing the "unavailable" list for each shop in the shops.yml file in hyperconomy. It seems that newly created shops are not generating the "unavailable" list and modifying the available categories of an existing shop deletes the list. When we take this approach, your gui shows only the intended items.
-
View User Profile
-
Send Message
Posted Dec 1, 2013Yes this plugin will be upgraded to work properly with HyperConomy 0.974.1
You can try the dev build of this plugin now, but it has some major flaws regarding what is in a shops inventory and what is listed in the gui menu. But it works at the moment if you just want server shops where people can purchase anything in one place.
-
View User Profile
-
Send Message
Posted Dec 1, 2013is this going to be update to use hyperconomy 0.974?
-
View User Profile
-
Send Message
Posted Nov 30, 2013I tried to use your development version. It seems to me, that merchants don't check if material is in stock. They show everything in the menu.
I deleted all items (/ri all MyShop). Now /browseshop a shows nothing, but /shopmenu (and merchant) - everything.
-
View User Profile
-
Send Message
Posted Nov 30, 2013If you are using the newest version of HyperConomy (0.974.1), please now try to latest dev build of HyperMerchant. It is available on the HyperMerchant github page, in the "jar" folder. There is a link above to the HyperMerchant github page.
Thank you for your patience. Please message me with any bugs you find, or features that seem to be missing.
-
View User Profile
-
Send Message
Posted Nov 26, 2013I'm waiting for a new version, too.
And one more thing: I have several economies - not only the "default" one. So, I need my merchants to get info from the economy of the shop that they are attached to. I've bult previous version replacing "default" with shop's economy, and that worked fine (pull request on github). But for some reason i am unable to build current code :( So, please, add supporting of HyperConomy's multy economies feature.
-
View User Profile
-
Send Message
Posted Nov 24, 2013@mrelfire
Nope it isn't your config. I have not uploaded a dev version yet compatible with current release of HyperConomy.
Check back, it will be soon.
-
View User Profile
-
Send Message
Posted Nov 23, 2013it crash with 1.6.4, is it my config ?
-
View User Profile
-
Send Message
Posted Nov 20, 2013@ryanthemagi
Thank you for the error report ryan, I will have a new dev build available soon.
-
View User Profile
-
Send Message
Posted Nov 19, 2013@ryanthemagi
Update HyperConomy Web to 0.0.2. That error isn't from HyperMerchant.
EDIT: I take that back. One of those errors is from HyperMerchant, but most are from HyperConomy Web.
-
View User Profile
-
Send Message
Posted Nov 19, 2013The most recent version on your Github is not compatible with the most recent version of Hyperconomy (.974.1). Here is the error message that my console spews when I run both versions: http://pastebin.com/GpKRh3gv