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! =)
@excavator5
Please post the console output. I can't really remember bugs from that long ago =)
@shmancelot
I got everything working, however I am having internal server errors whenever I try using /managemenu and /shoplist.
Would this be a bug on this version?
@excavator5
Follow this link and try:
0.974.55 [Dev]
and possibly:
0.974.57 [Beta]
@shmancelot
Hello!
I may have missed a step, otherwise just having shit luck.
http://pastebin.com/PCtxmxKh<<
HyperConomy ver: 974.3[DEV] HyperMerchant ver: 1.56.1 Minecraft Ver: 1.7.10
Cheers!
@broluigi
Please describe in precise detail what is meant by "inventory break event".
Please describe the exact conditions and actions that cause this bug.
What version of Spigot, HyperMerchant, HyperConomy and Minecraft are being used?
I will do anything I can to fix the issue. Thanks!
a inventory event break destroys people's inventories if people logout
@Baamoink
Thanks! I really do appreciate the thought. Honestly I haven't worked on this plugin in months, and I don't anticipate that I will, until Minecraft updates and "breaks" current functionality, or someone has a killer feature request that I decide to add.
If you would like to motivate me to work on a feature request, I may accept a "donation ;)", otherwise I recommend making a donation to RegalOwl. He is the real driving force behind HyperConomy, which this little plugin is completely dependent upon.
While we are on the subject, donations can go a long way to boost developer motivation, especially developers who are working primarily for their own personal reasons. Having another human show support for your project with their own precious resources is meaningful.
Don't suppose you accept PayPal donations at all?
Why am I unable to interact with merchant NPCs while in creative mode?
Edit: Oh, okay. Didn't realise that I needed the permission even when I'm OP'd
@Dustinduse
It certainly is possible.
1. Create an npc. /npc create Bob
2. Give "Bob" the hypermerchant trait. /trait hypermerchant
3. Make sure Bob is your currently selected merchant. /hmerch select Bob
4. Assign Bob to a server shop. /hmerch setshop ShopName
5. Toggle Bob's duty status to "on duty". /hmerch offduty
Is it not possible to add a merchant to a server shop?
I use MySQL as database. But i think i know the issue if the database is the problem. I've add 1 custom Item. I try to delete it and see what happen. :D
[Edit] Fixed after deleting database with objects.
I finally resurrected my server, can't wait to get back on the hypermerchant train!
@DaisukeVN
sorry for my delayed response. HyperMerchant should work with any item that HyperConomy works with. But, it appears that there is one or more items in your HyperConomy database that aren't being parsed properly by HyperMerchant. Do you have any custom items in your HyperConomy database? Would you be willing to upload your database so I can take a look at it?
@shmancelot
Does custom items break the plugin? I tried with empty Inventory and its the same issue.
Hyperconomy: v0.975.5 [Beta]
HyperMerchant: 1.58dev
Citizens: 2.0.15-SNAPSHOT
@DaisukeVN
Do you have custom items in your inventory? Or banners? What version of HyperConomy are you on? Thanks!
@shmancelot
I already use the latest dev build. Its still buggy. I can't rightclick the NPC of Citizens and can't use /shopmenu too.
Citizens Error: http://pastebin.com/uRTxKp8b (already open ticket)
HyperMerchant: http://pastebin.com/McuQqhVi
@DaisukeVN
It appears that Citizens does not work with Spigot 1.8.4 or 1.8.5 Please try the latest development build of HyperMerchant. It should function with all 1.8.x builds of Spigot.
Hypermerchant doesn't work with Spigot 1.8.3 Please Update it.
Hi I'm on the latest development builds of Citizen, HyperMerchant and HyperConomy. When I try to create a shop with an npc, it functions perfectly fine, but when I change the owner (with /ms owner (player)) to a player, I can no longer access the shop when I right click the shopkeeper npc. I want the player to own the shop and the NPC, but can't figure out which permission to give to grant that ability.