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 was wondering if someone could help me find the permission I am missing. For some odd reason I can't access the citizens wiki and I have been messing with the permissions I can find but to no avail. I have the correct Hypermerchant perms in place and everything but the NPC works correctly except for the Owner group which also has citizens.*
When trying to interact with the shop with any other group I get "Hey! Sorry, but you can't use that here.". I know it's a perm I am missing but for the life of me can't figure out which it is.
Any help would be greatly appreciated until I can figure out my access issue for their wiki(which I know is up).
Sorry guys; I've been swamped lately. I still haven't even looked at spigot 1.8. I won't be able to get to it until at least Saturday night.
Update coming? Getting errors with the new Hyperconomy dev builds for 1.8 Spigot. Thanks!
@shmancelot
umm alright,and what about updating them so will be able to use with spigot 1.8?
Sorry for long response time.
@Kobotz No I am afraid not. Hypermerchant is just an interface. Hyperconomy is the real shop plugin.
After creating a server shop NPC, it says "I am sorry I am closed for business at this time."
How do I fix this? Thank you.
EDIT: I found out I had it set to a server account, so I had to make a server shop by that account name. This was fine, but I'm trying to only trade gold ingots, but it won't let me ban all items! I need to ban items in different shops so they can all be set to one item at a time.
anyway running hypermerchant without the hyperconomy?.. :P
@pacificfils
Are you running the latest dev build of both HyperMerchant and HyperConomy?
The shop works, except for one thing:
When selling an item, the user is paid for the item, but still has the item.
I am running the latest dev build on 1.7.10.
@TheGeek007
Thank you for reporting the error. Please try HyperMerchant development build #98 and let me know if that fixes it.
I'm doing some testing to see if this mod would be good for our Pixelmon server.
I'm encountering an error when trying to use the /clerk command: Pastebin: http:pastebin.com/mEabQuzM
HyperMerchant Version: 1.56.1
HyperConomy Version: v0.974.56
cauldron-1.7.10-1.1207.01.198-server (craftbukkit/forge server)
It was working at some point, but can't get it to work again. Please tell me my next step! Thanks!
TheGeek007
@dddylan98
I'll see what I can make of it when I get home. In the mean time, I wonder if you wouldn't mind messaging me a copy of your hyperconomy config.yml
Also, which versions of HyperConomy and HyperMerchant are you using, and have you tried the latest dev builds?
Thanks!
Whenever a player right clicks or left clicks in a shop, this error pops up in console. The shops are working fully 100% but just a bit spammy.
@InsomniaCraft
@TJW28
Please try the latest spigot dev build, the shop closing issue is "fixed" for now.
@TJW28
hyperconomy.buy and sell permissions should now be properly supported in HyperMerchant build #96.
@InsomniaCraft
This is due to a recent change in the way the server handles inventories. If you are using spigot, please try spigot build #1601
Jenkins should be back up within 20 minutes, thanks for alerting me =)
Your Jenkins account is on "hibernate". Was checking for latest dev builds. When I open an shop through an NPC with a sword in my hand, the shop opens and closes real fast.
@shmancelot
No Probs.
Just another quick Question. I have changed the way my economy works, in as much they can buy items, but not sell. They make money in other ways.
If a user uses the hyperconomy commands to sell, they have no perms, but, if they use the merchant, they can still sell.
Im sure i am missing something obvious, any ideas ?
@TJW28
Thank you for your help!
@shmancelot
Yes, turns out it is an issue with the latest dev builds of spigot, I rolled back to an earlier version, and all works fine.
This is where the issue started i believe. Build 1602