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! =)
@shmancelot
Is there a way to fix this, it's going to be difficult to manage who's connecting to my server with 1.7.2 and 1.7.4, the item is actually purchasable and retains it's store information and lore (pricing etc)
@InsomniaCraft
Make sure you are running Minecraft client 1.7.4
There is a bug in 1.7.2 that causes the cursor to pick up a ghost item.
When I purchase an item from an NPC, the item is picked up on my cursor, as well as moved to my inventory. This method has changed since the old build, where clicking the item would simply move it to the inventory.
@Ares513
Please upgrade to Hyperconomy dev build #313 or greater.
"Hypermerchant latest dev" Please make sure latest dev means the latest dev from the github link above, in the folder 1.3b
I cannot duplicate the behavior you have described (trait not found) when using the latest development builds of all these plugins.
@Prophayne
In the log, I see a lot of this:
craftbukkit.jar:git-Bukkit-1.6.4-R2.0-9-g68d0e57-b2930jnks
This leadds me to believe that the server is not running a 1.7.2 build of bukkit, or is running an older version of HyperMerchant. Please check the server version and make sure that the HyperMerchant version is the latest 1.3b from the /jar directory of the github link above.
Also, you will have to run a newer build of HyperConomy, HyperMerchant 1.3b requires HyperConomy #313 or newer
@shmancelot
CB version 2957, Citizens version 1030
Hyperconomy 310 Dev
Hypermerchant latest dev
The plugin is throwing up errors on /shopmenu. I'm using the 1.7.3 bukkit, latest version of Hyperconomy, and the latest version of hypermerchant.
These are the errors: http://pastebin.com/rgdMKrDr
@ryanthemagi
Please make sure you are you using at least dev build #313 of HyperConomy from the HyperConomy jenkins build server.
@ryanthemagi
Thanks for reporting this issue. I'll check it out later tonight. Should have a fix soon.
The latest version is causing this error: http://pastebin.com/y8dkK065
EDIT: I thought perhaps Spigot was causing the issue. I updated to Bukkit Beta and this is the new error: http://pastebin.com/V5u6x6hS
@Ares513
Please tell me which versions or build numbers of HyperConomy, HyperMerchant, Citizens, and Bukkit you are using. Sorry I have to make you dig up this info, It's the only way I can track down why the hypermerchant trait isn't registering with citizens. Is citizens loading up without error? Are there any warnings in the console on startup?
Hello,
I've updated my build and everything and I can get the /hmerchant commands to show up but I still can't give my NPCs the hypermerchant trait. What can I do about this?
Thanks!
@shmancelot
This seems to have worked, thanks :D
@Typical_Name You can do this already. I believe I forgot to document it though, sorry about that. Just give yourself the permission "creative.hypermerchant"
This is a minor issue, but is there a way we can make it so that players in creative mode can access the shop? It's mildly irritating for me as admin to have to constantly be switching gamemodes while testing things, and I don't really need the security precaution as anyone with access to creative mode would be staff.
Player Shop compatibility is now working. Please try the latest dev build in the /jar directory at the github link above. At this time it will only work with HyperConomy dev build #313 or newer.
Please let me know how it works and if anything needs fixing.
@shmancelot
Works a treat now, thank you
@TJW28
Alright guys, please download the latest dev build (still version 1.3b) of HyperMerchant from github link above, located in /jar directory.
Thank you both for reporting this issue :)
@shmancelot
I can confirm the same issue as Chrisk123999
Steps to reproduce:
Create an npc, give it the hypermerchant trait. Use /hmerchant setshop shop. ( shop is the name of the server shop )
Interact with the hypermerchant, and it says it is closed for business, and in the console it says npc #0 is assigned to a shop named shop. This shop does not exist ( where it clearly does )
Hope that helps.
@chrisk123999
what is the name of the shop when you use the /rslist command? Is it a player shop, or a server shop? Which version of hyperconomy and hypermerchant are you using?