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 Mar 15, 2014@schamcnelot @hellpish This ended up working perfectly, thank you :)
-
View User Profile
-
Send Message
Posted Mar 11, 2014HyperMerchant 1.41 is now released.
It is compatible with HyperConomy builds #368 - #373
build #374 and above is currently unsupported.
-
View User Profile
-
Send Message
Posted Mar 10, 2014@Mandav22
hellphish's recommendation should work fine. And if you set up a GlobalShop (by disabling shops in your HyperConomy config.yml) you should be able to "/rmenu GlobalShop". Use "/rslist" to make sure that you have GlobalShop enabled.
-
View User Profile
-
Send Message
Posted Mar 8, 2014@Mandav22
First your users need the hypermerchant.remote permission, then they can use "/remotemenu shopname" to open the menu. If you want a shorter command, look into creating custom aliases.
-
View User Profile
-
Send Message
Posted Mar 7, 2014@hellphish
Yes, thats what I'm talking about. However I dont want it to just be inside of a shop area, I want it to encompass the entire world. So people can type /shop while in their own home, or at spawn. They dont have to warp to the server shop location to use the shop. I'm not sure how to make this work.
-
View User Profile
-
Send Message
Posted Mar 7, 2014@hellphish
I will look into adding more sorting options.
-
View User Profile
-
Send Message
Posted Mar 7, 2014Is there a way to show only items that are in stock in the GUI?
Alternatively, is there a way to sort the items by stock amount?
-
View User Profile
-
Send Message
Posted Mar 7, 2014@Mandav22
My users can use /shopmenu inside the server shop. Is that what you're talking about? You could give your users the hypermerchant.remote permission and set up an alias for /shop to remotely open the shop menu for the server shop.
-
View User Profile
-
Send Message
Posted Mar 7, 2014@shmancelot
Thank you :3
-
View User Profile
-
Send Message
Posted Mar 7, 2014@Mandav22
I will look in to this on Saturday. Thank you for bringing it up, I never added support for that possibility.
-
View User Profile
-
Send Message
Posted Mar 7, 2014Okay, sort of a strange question. But I've tried google and youtubing this, and I can't find a solution. How do I make hypermerchant use a GUI for the global shop? I want my server to have one shop (global shop) that players can access with a command like /shop. I dont want them to be able to create shops and use NPC, just use the built in global shop with a gui.
-
View User Profile
-
Send Message
Posted Mar 6, 2014@ryanthemagi
I haven't really made any effort to ensure that every build of HM 1.4 is compatible with every build of HC 974.4
But I can tell you HM build #47 is compatible with HC build #368-373
-
View User Profile
-
Send Message
Posted Mar 5, 2014@shmancelot
Using HC 974.4 & HM 1.4
-
View User Profile
-
Send Message
Posted Mar 5, 2014@ryanthemagi
This bug is due to using incompatible versions of HyperMerchant and HyperConomy.
I do not try to ensure backwards compatibility with HyperConomy versions, so the latest builds of HyperMerchant always require a recent build of HyperConomy.
You may have to test a few HyperMerchant builds out to get compatible, or just upgrade to the latest of both.
-
View User Profile
-
Send Message
Posted Mar 5, 2014@Baamoink
Dev build #47 now shows XP in the shop menus.
-
View User Profile
-
Send Message
Posted Mar 4, 2014@ryanthemagi
Which build #'s of HyperMerchant and HyperConomy?
-
View User Profile
-
Send Message
Posted Mar 4, 2014I'm receiving this error everytime a Merchant is clicked on -> http://pastebin.com/rt6ezXHA
-
View User Profile
-
Send Message
Posted Feb 28, 2014@jeffhardy6190
The /hmerchant command is specifically for managing hypermerchant npcs.
To make use of NPCs, make sure that the Citizens plugin is installed, and that it is loading without errors when the server starts.
-
View User Profile
-
Send Message
Posted Feb 28, 2014Hi I keep getting this error: Citizens is not loaded. NPCs are unavailable at this time. It happens when I type /hmerchant
-
View User Profile
-
Send Message
Posted Feb 26, 2014@Baamoink
No problem, it was an important feature to have, thanks for suggesting it.
I'll look in to the XP issue soon. =)