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! =)
Another bug, when editing categories for items to sell, acacia door is in basically in all of them and is unremovable
@shmancelot
The only time it happens is basically after /trait hypermerchant and it appears im using citizens 2.0.15 snapshot, spigot 1.8.3, and latest hypermerchant, ill try citizens 2.0.14 (since im not seeing 2.0.15 anywhere), but I doubt it'll fix anything, at the moment im using server signs to open the shop for players, which isnt quite as rpg like (since im making an rpg server) Edit: Ok, now it they stopped disappearing, not sure why all of a sudden, they did disappear after a /reload or stopping the server then turning it back on. If it happens again ill let you know, and if you're not busy some time, you should check out my server xD Im trying to add everything an rpg server should have (this plugin is one of them, although it was a little complicated to use at first since theres the /clerk command AND the /hmerchant commands), I'm also trying to add a market where players could buy stuff from each other, but I only want them buying from each other inside the market, so is it possible to set a world guard flag or something (maybe the allow-shop flag ?) would be very helpful, thanks :D
@agentwolf44
What happens to your other Citizens npcs? Do they ever disappear? What version of Citizens, Spigot, and HyperMerchant are you using?
Everytime I create a merchant, stop server, then start server back up, the merchant is gone, help please?
@RegalOwl
Hey guys, I just wanted to let you know that I got my issue sorted by deleting the affected shops/economy and re-creating them from scratch. I did need to do some manual database manipulation to get everything properly deleted.
A new issue that I've noticed, which I assume is within HyperMerchant, is that some, but not all items
with zero stockshow a sell price of zero. It seems to be happening with composite items only. The sell price does display the correct amountif the stock is more than zero, orif I have the item in my personal inventory when opening the shop menu. When I remove the item from my inventory and reopen the shop menu, the sell price is back to displaying zero.Update: To clarify, even with a stock of more than zero, composite items show a zero sell price unless I have at least one of the items in my personal inventory.
It did that day. But didnt had the time to check it if it happens often.
@Dutch_Boy
Thanks. Does this error appear often? I will take a look at it tonight.
http://pastebin.com/PG1ANCn0
Error in console.
@timsavage
Your error looks like it may be HyperConomy related. Could you try buying an affected item with /buy? Do you get the same error?
If you do get the same error could you send me the object data for the item as well as the item name? You can get the data either from the database or from the GUI. (Click Edit Object Data)
@adamk523
I will fix it, but I need your help to find what the root of the problem is. The key is sharing lots of details (specific version numbers for all plugins involved as well as server) and every error message complete with console output.
Fixing this issue might help others who have the same problem.
@shmancelot
Now it's not even enabling again. :( Unless you have any other ideas, I'll just go and find another system. i don't know why it's being so stubborn even with no other plugins running and all the right dependencies/versions. Thanks for your assistance all the same!
@timsavage
I am perplexed. What version of java are you running? What version of spigot?
Everything seems to work, with HyperConomy dev build 515, HyperMerchant dev build #23, Spigot 1.8-R0.1-SNAPSHOT and java 7.
@shmancelot
When the problem first occurred, it seemed to be only some items, but now it appears to be every item.
@adamk523
Thank you for reporting this! Please use Citizens2 dev build #1142.
As for the error using /shopmenu or /managemenu, I am able to use them without error on spigot1.7.9-R0.2 with HyperConomy dev build #443 and HyperMerchant 1.56.1
I have updated the compatibility page to reflect this information.
@shmancelot
Gah, another error whenever I try to type commands like /shopmenu and /managemenu. Now it's 'An internal error occurred" on the client, and "Unhandled exception executing command" in the console. Using both versions you recommended; also, it doesn't hook in with the latest Citizens designed for 1.7.9-R0.2.
@adamk523
The update to HyperConomy 0.975.0 was a major revision. I think there is not a HyperMerchant build compatible with that version. Try HyperConomy 0.974.57 or HyperConomy dev builds #426 up to possibly #443.
With HyperMerchant 1.56.1
The plugin refuses to load with HyperConomy version 0.975.0 using your suggested compatibility version or any version on Spigot 1.7.9-R0.2. :(
@timsavage
Does the error happen for every item? If not which items do cause the error?
@shmancelot
I was using the published v0.975.4 [Beta], but I also tried the latest dev build, #515.
@timsavage
Which build of HyperConomy do you have?