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 Sep 23, 2013I suppose you mean the amount that the merchant will pay the player for the item. That's a good idea. I don't know why I haven't done that already.
To Do: Show purchase price of player items and sorting by categories.
-
View User Profile
-
Send Message
Posted Sep 23, 2013Is there a way to show how much an item is worth while "talking" to a hypermerchant?
-
View User Profile
-
Send Message
Posted Sep 20, 2013@shmancelot I was thinking some sort of categories, such as blocks, armor, tools, etc. I dont know what that would take as far as coding goes (just starting to learn java, its crazy stuff!) but I would definitely appreciate it!
-
View User Profile
-
Send Message
Posted Sep 19, 2013@MimTiller
I will certainly consider it. What sorting options would you like to see? Right now it sorts by type (enchant, item, xp) followed by item id numbers.
-
View User Profile
-
Send Message
Posted Sep 19, 2013@shmancelot I dont mean to bug you, but is there any chance you might be working on adding some way to sort the hypermerchant store menu? :D
-
View User Profile
-
Send Message
Posted Sep 19, 2013@pyropanda01
Cool, glad it's working, and thank you =)
-
View User Profile
-
Send Message
Posted Sep 19, 2013@smancelot we have it working we just did a restart of the server even though we did that the first time maybe just something went wrong the first time lol but ty for ur time for helping and keep up the good work love the plugin
-
View User Profile
-
Send Message
Posted Sep 19, 2013@smancelot I have all of them up to date and it is citizens 2 and yes they did
-
View User Profile
-
Send Message
Posted Sep 19, 2013@pyropanda01
Which version of Citizens, HyperConomy, and HyperMerchant are you using? Are all 3 plugins loaded successfully when you start the server?
-
View User Profile
-
Send Message
Posted Sep 19, 2013jw has anyone had the problem where a trait can not be found if using everything that is needed? Also using citizens.
-
View User Profile
-
Send Message
Posted Sep 19, 2013I can not figure out the traits at all I have all the plugins that is needed and everytime I try to set a npc trait to hyermerchant it does not work can u help me plz
-
View User Profile
-
Send Message
Posted Sep 13, 2013@excavator5
Citizens2 has a lot of bug fixes and should only load the npcs that you are near, if your configure it correctly
-
View User Profile
-
Send Message
Posted Sep 9, 2013Using npcs with HyperMerchant is not required. You may use the /shopmenu or /remotemenu commands instead.
To offer something for your players to click on, try a commandblock, or search for a plugin that creates custom click commands.
I hope that is helpful =)
-
View User Profile
-
Send Message
Posted Sep 9, 2013Not sure if this is accurate but I remember looking into this over 6 months ago..
NPCs such as the ones in Citizens create alot of lag on the server where the villagers do not. I think this plugin is awesome and looks fully functional however, I cannot afford lag where there is going to be at least 12 NPCs per village. Even more in larger towns.
-
View User Profile
-
Send Message
Posted Sep 8, 2013HyperConomy v0.972 beta has officially been released!
HyperMerchant no longer depends on the development branch of HyperConomy.
-
View User Profile
-
Send Message
Posted Sep 7, 2013I'm using HyperConomy version 0.971 and HyperMerchant version 1.15 and all seems well until I attempt to sell items to the merchant. I can buy with no issue but as soon as I for example select an apple then place it into the merchant inventory, it duplicates the item into my inventory instead. And so for example if I had 8 apples selected, it will duplicate 8 into mine. have I done something wrong?
Edit: Fixed issue with 0.972. :)
-
View User Profile
-
Send Message
Posted Sep 6, 2013my apologies. i will add some sort of notification for users in creative mode. and thank you =)
-
View User Profile
-
Send Message
Posted Sep 6, 2013I'm using the latest versions of both hyperconomy and hypermerchant. I created a shop and the menu comes up with smenu and rmenu but I'm unable to interact with it. The GUI indicates I clicked on an item by displacing it momentarily but it returns to its original position and nothing happens. Shift clicking causes the item to briefly appear in my inventory but then disappears. I'm not seeing any error messages and both I and the store have enough balance to cover the transactions.
Any ideas on this one?
Thanks.
EDIT: Solved the problem. The store does not work while I'm in creative mode. That makes sense.
Great plugin by the way!
-
View User Profile
-
Send Message
Posted Sep 4, 2013@KamiHanta
Thank you for trying out Hypermerchant. Please be sure that you are using the latest development build of HyperConomy.
There is a link to dev builds on the HyperConomy project page.
If that is not the problem, please create a ticket and include which version of bukkit is running, which version of hyperconomy, and which version of hypermerchant.
Thanks!
-
View User Profile
-
Send Message
Posted Sep 4, 2013hi, I have 2 problems using your plugin in my server: first, when i try to type /shopmenu it only says "internal error occurred while attempting to perform this comand" I can still acess the shop inventory by using the /remotemenu or right clicking the npc after linking the hypermerchant to the shop so I was not that worried about that The second problem occured when I tried to sell something to the shop, it wouldn't sell the item and duplicate the item, creating one copy one my inventory and one that i was holding/ The buying mechanism is fine though Hope it makes any sense :P