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 May 17, 2014@butterfly1633
no problem, it happened to be an easy one and since it's saturday i happened to have some time in the middle of the day :)
-
View User Profile
-
Send Message
Posted May 17, 2014@shmancelot
Thank you so much for fixing it so quickly! *biginternethugs*
-
View User Profile
-
Send Message
Posted May 17, 2014@butterfly1633
Thank you very much for reporting this bug butterfly. It should be fixed in dev build #71, from the development builds link further up this page.
-
View User Profile
-
Send Message
Posted May 17, 2014@shmancelot
Rinas is a playershop created with "/ms create Rinas 2". I am the owner and no list of shops is shown when right clicking on the npc.
I have several servershops set up with npc's assigned through hmerch and they are working just fine. :) It's just the player shop I'm trying to make that doesn't seem to work.
-
View User Profile
-
Send Message
Posted May 17, 2014@butterfly1633
Make sure shop "Rinas" is a playershop, not a servershop. If you need an npc to work at a server shop use the "/hmerch" commands to assign it to one.
with npc selected "/hmerch setshop Rinas".
make sure the merchant is on duty "/hmerch onduty".
If Rinas is a playershop: when you have an npc set forhire, you right click the npc it will ask you to type the name of the shop and it will also list all of the player shops that belong to you.
If Rinas is not in the list, then Rinas belongs to a different owner.
Change ownership of Rinas with "/ms owner butterfly"
let me know if that information helps sort things out, or there might be a bug to find.
-
View User Profile
-
Send Message
Posted May 17, 2014I'm having trouble with forhire npcs. I have a playershop created, and the npc is for hire. I right click him and it tells me to say the name of the shop within 10 seconds. I do this and nothing happens. If I try to use the clerk command "/clerk hire ClerkBrandon -s Rinas" I get this error Pastebin
-
View User Profile
-
Send Message
Posted May 16, 2014There was a "critical" bug in HyperMerchant-1.51-dev that caused the shopmenu to fail to open if you didn't have a "name:" set for "help5:" in your menubuttons.yml file.
This is fixed in dev build #70 and upcoming version 1.52-dev.
-
View User Profile
-
Send Message
Posted May 8, 2014@shmancelot
To the moon!
-
View User Profile
-
Send Message
Posted May 8, 2014HyperMerchant development build #69 now includes the ability to sort menus 5 different ways. Also you can toggle displaying items with 0 stock.
Much thanks to hellphish for a generous donation that seriously motivated me to add this often requested feature. =)
-
View User Profile
-
Send Message
Posted May 8, 2014@pepper82
select the NPC you want to use: /npc select name
make that NPC a hypermerchant: /trait hypermerchant
assign that npc to the shop you want him to work at: /hmerch setshop shopname
make sure that the npc is "on duty": /hmerch onduty
Right click the npc and buy some stuff! =)
Have a look at the "Commands and Permissions" page, there are other ways to create an NPC hypermerchant depending on whether they work at a server-shop, or a player-shop.
You can set up NPCs who wait around to be hired by a player who owns a player-shop, or you can put an NPC in a player-shop that is ready to be rented by any player.
You can give your players permission to create their player-shop NPCs themselves (without giving them permission to create NPCs in general).
You can force players to keep their NPCs in their shops, or allow them to move them anywhere.
You can also configure that players who own shops will display a shop menu when clicked on.
-
View User Profile
-
Send Message
Posted May 8, 2014Can you make it so that righ-clicking the Shopkeeper NPC opens the GUI?
How do I define the Shopkeeper NPC for a shop (for example if I have multiple NPCs standing in a shop but only 1 of them should be the shopkeeper)
-
View User Profile
-
Send Message
Posted May 6, 2014@chiopas
Error on my part, I didn't include the npcblacklist.yml file in the correct directory in my last upload. It only effect new installations.
Please download latest development build (#64) of HyperMerchant from the link further up this page.
That will fix the issue.
-
View User Profile
-
Send Message
Posted May 6, 2014I get an error:
http://pastebin.com/pQbcrKBV
Why is that? I use latest HyperMerchant and HyperConomy.
-
View User Profile
-
Send Message
Posted May 6, 2014@butterfly1633
If they are regular enchanted items, I have fixed that in the latest dev build, available from the dev builds link above. (Build #64)
If they are items with custom names and lore, continue reading.
Add the items with the /additem command.
Simply hold the item in your hand and use command "/additem itemname" where itemname is whatever name you want the item to have.
You may have to reenable HyperConomy after you add the items you want, with command "/hc disable" followed by command "/hc enable".
-
View User Profile
-
Send Message
Posted May 5, 2014@shmancelot
It seems to be happening on enchanted items that I have added. I don't get the error on stock items.
-
View User Profile
-
Send Message
Posted May 4, 2014@butterfly1633
Thank you for reporting this error. I will look into it later today!
Can you tell me when the error appears?
example: when shift-clicking an item to purchase it.
Also, does it seem to happen on every item, or only certain ones?
And, does the error prevent you from buying or selling the item?
-
View User Profile
-
Send Message
Posted May 4, 2014Hello, I am getting the error "Could not pass event InventoryClickEvent to HyperMerchant v1.5 org.bukkit.event.EventException" when I try to click on an item in a shop.
I'm using hypermerchant 1.5 with hyperconomy 0.974.54.
Does anyone have any idea why?
Thanks in advance!
-
View User Profile
-
Send Message
Posted Apr 16, 2014HyperMerchant dev build #62 is compatible with HyperConomy dev build #386
-
View User Profile
-
Send Message
Posted Apr 7, 2014@momzlilmonsters
A lot of commands have changed in the dev builds. Try the new commands page.
-
View User Profile
-
Send Message
Posted Apr 7, 2014@shmancelot
thanks a bunch for going throu all my consol spam, its working now with the latest builds you mentioned, thank you so much i can finaly fix my servers market and economy
thanks for all the help guys, sorry if i seemed annoying trying to figure it out