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! =)
Nice update! The bugs I experieced previously are all fixed. However it seems theres a new bug.
I tried to sell enchantments today in a servershop but I got a message "This shop doesn't want this enchantment" even though it's in the /shopmenu interface. It worked pre update, nothing changed. Selling enchantments with the command /sell works fine.
@CombatWiZ
If selling blocks isn't counting toward your stock in a playershop, make sure you are using dev build #18. The link to the development builds is further up this page.
If you buy an item from your own playershop, then your balance won't change, because you just paid yourself for the item.
To make an item have inifinite stock, you must enable this setting in your HyperConomy config.yml:
unlimited-stock-for-static-items: true
Then for every item that you want to have infinite stock, set it to static pricing mode.
For example:
/hcset static dirt
/hcset static all:true <
to set all items to static pricing
Finally, if you are using BOSEeconomy, set hook-internal-economy-into-vault: false
@shmancelot
If I ever figure out this plugin, I'll see if I can do that for ya. But more questions await. How do I set infinite stock on an item? And how come when I buy an item it doesn't add to my balance? Also, selling blocks doesn't count towards the stock in a shop.
I have BOSEconomy working in correlation with HyperConomy. use-external: true and hook-internal-economy-into-vault: true
@CombatWiZ
I hear you on the video. Many plugin developers, including myself would love if a grateful user of our plugin came along and spent several hours making up-to-date tutorial vids -wink- -wink-
@shmancelot
And how exactly am I suppose to be inside of a shop if I may ask? I don't see where I can define points and such.
EDIT: Nevermind. You really need to update that video tutorial... lol. But thanks nevertheless.
All users of HyperConomy for bukkit/spigot 1.8 and higher, you are now strongly advised to use HyperMerchant dev build #18
This fixes the atrocious bug mentioned in my last post.
All users be aware that there is still a serious bug in recent versions of HyperMerchant.
A shop owner will lose their money as players sell items to them. Because the items go to the server, instead of to the shop owner's inventory.
I will release a fix asap.
@CombatWiZ
You must specify a shopname, or be standing inside of a shop when using the command /hmerch setshop
Also, you must have an npc selected.
/hmerch setshop YummySnackShop
I can't even... why has NO ONE made a tutorial on how to properly set up a shop? An updated one atleast. Anyways, here is a log of what happens when I try to do /hmerchant setshop <shopname> it just doesn't seem to like me. I have all updated builds of HyperConomy and HyperMerchant aswell as BOSEconomy.
http://pastebin.com/QfwqRpqh
@sLasH2Dhed
Thank you, I am looking into this.
All users of HyperMerchant please be advised that there is currently a bug that will cause PlayerShop owners to lose ANY ITEM that they try to REMOVE from their playershop inventory using the Management Menu.
The plugin doesn't seem to work very well with playershops.
Players can buy and sell items on an item where the status is set to buy. Generally, Selling will not give the player money, and the stock will add up to the servershop instead. Using the /buy and /sell commands will still work however using the /shopmenu interface causes the bugs.
I'm using the most recent builds of Spigot, HyperConomy and HyperMerchant. Also, I don't receive any errors in the console. The plugin works fine with servershops.
I now recommend HyperMerchant dev build #14 which fixed a bug that caused enchanted items to be repaired for free.
@xs0lidus
i am working on this bug. FYI the damaged item is for some reason sold, instead of the undamaged item that you try to sell. The good news is that the damaged item is sold for the correct price, so this cannot be used to exploit shops for more money.
Bug report:
Hold 2 wood swords, one damaged and one not. Sell the undamaged sword to the NPC and your damaged sword will be fully repaired. Using wood swords for an example, any item which can be damaged works this way.
http://pastebin.com/RcUgg7jt
Also posted in the hyperconomy plugin topic. Not sure which one is causing the problem.
I find this error in my skyblock server console -> http://pastebin.com/bPQhY1XA
Hey Awesome work! i have spigot 1.8.1 citizens-2.0.14-SNAPSHOT hyperconomy-0.975.3-SNAPSHOT hypermerchant-1.57-dev
i can create shop, npc, trait, everything seems to work, but when i close the server this appear and npc trait it's deleted:
[SOLVED] I update Vault and everything works ok! Thanks!!!
@Dutch_Boy
I shall look in to this tonight. thanks for reporting!
Edit: This should be fixed in the latest build of HyperConomy as per this comment by RegalOwl.
This error just popt up after updating hyperconomy.
http://pastebin.com/4t0SN6S0
That "/removeall item" command used in the tutorial video doesn't work. How do I remove items?
Also, how do I set the value per item? I "/hcset value" and the prices don't change within the store.
@FutureForce
Make sure the merchant is not offduty /hmerch offduty
I cannot reproduce the error that occured. Please share with me the actual commands you used. Thanks!