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! =)
I'm still getting an error when trying to drag an item from player inventory to shop inventory to sell with dev build #23. It appears to be a number format exception, rather than the NPE reported by Dutch_Boy.
http:pastebin.com/NQX9sWub
edit: This should be fixed in develpoment build #23
@Dutch_Boy
Yes I will fix it in next development build. Thank you for reporting it.
http://pastebin.com/xAYyJ0Ad
Can you fixes this pls :)
Updating HyperConomy fixed it, thanks!
HyperMerchant development build #21 and higher now includes langauge support.
This build is NOT stable and is not recommended for use on a populated server until you guys have had time to test it.
As always, bug reports are essential, so please test and report.
If you would like to add your own language file, use the existing en_us.yml file as a template and save your new language file under a different name.
Then change the language setting in the config.yml to match your new file name.
Please see the Language Page for more details.
If you do take the time to make a language file, please share it and I will add your name to the contributers list for this project.
@sLasH2Dhed
Which build of HyperConomy are you using?
I just noticed RegalOwl fixed this bug in the latest HyperConomy dev build about 5 days ago.
That's weird. I'm using build #20. Just tested it myself.
I was holding 64 books in my hand, left clicked on an enchantment and it gave me 64 enchanted books. Also they have the same enchantment twice at once. It also said "You purchased 1 ... for ..." I'll include a screenshot to show it to you: http://i.imgur.com/hPaMQCn.png
@sLasH2Dhed
Are you using the latest version? I cannot enchant a stack of books. Please test it out for yourself. Perhaps the user is mistaken.
@sLasH2Dhed
Thanks, I'll check it out.
It seems like there's a more critical bug if you are buying enchantments from a servershop. Yesterday, users on the server I run, reported that if you have more than one book in one slot (by stacking) and you want to buy one enchantment on one book you will receive the enchantment on every book and the stock will only decrease by one in total. This allows people to get infinite money as you get more enchantments than you paid for.
@charleyx115 What version of HyperConomy are you using? Check the compatibility page to see which versions of HyperMerchant and HyperConomy are compatible.
Getting this error? 08.02 18:55:08 [Server] INFO org.bukkit.plugin.InvalidPluginException: java.lang.NoClassDefFoundError: regalowl/hyperconomy/api/HyperEconAPI 08.02 18:55:08 [Server] ERROR Could not load 'plugins/HyperMerchant.jar' in folder 'plugins'
@sLasH2Dhed
Thanks. I'll look into it tonight.
edit:
It looks to me like the server stock is doing what it is supposed to, but the icon isn't updated until the next time you open the shop menu. I will try to fix it after I finish adding support for language files.
Hey, me again :] Thanks for the quick updates! Almost everything is working fine now. There is just a small issue left where players will not increase the server stock after selling one enchantment. Buying an enchantment will decrease the stock like it should.
@CombatWiZ
I can't remember everything about my own plugin.
Your players CAN hire an npc on their own with the /clerk hire command.
I've added a How-To on the /clerk command that you can copy and paste or link to for your users.
@sLasH2Dhed
Development build #20 is out and fixes this bug. This bug was happening with custom items that had vanilla enchants.
Thanks for your help :)
Hi, thanks for the quick reply! Now I get the message that I sold my enchantment, but when I do so, I receive my old enchanted item and the same one without the enchantment which will disappear once I click on it. I get money and the stock increases.
@CombatWiZ
Players can manage their shop with the /managemenu command. They need to stand inside the shop when they use the command.
They need to have the permission hypermerchant.menu. They should have this by default.
If the player has an NPC, they can Shift+RightClick the NPC to open the management menu.
A player can create their own PlayerShop, but you need to make the NPC. You can set up a pool of NPCs for "hire".
See
http://dev.bukkit.org/bukkit-plugins/hypermerchant/pages/how-to/
and
http://dev.bukkit.org/bukkit-plugins/hyperconomy/pages/how-to/
Your players can manage their NPC with the /clerk command.
@shmancelot
Can you explain briefly how player shops work? And how they are suppose to be simple for the player to use, rather than me having to use /ms add and /ms status <object> trade just to have items show up. I want to know if a player can just make an NPC on his own and have them instantly become a shop for them to edit.
HyperMerchant development build #19 fixes this bug.
Thanks again, sLasH2Dhed.
@sLasH2Dhed
Thanks for the heads up. I will check it out this evening.