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! =)
Hyperconomy/hypermerchant seems to be working fine on my server (assigning trait, adding items, etc), but when I try to use /managemenu, it gives me the client error "An unknown error occured". We're running Cauldron 1.7.10.
edit: nvm.. this is related to hyperconomy, not merchant.
@mellowism
I have attempted to fix this bug in a new dev build. Please try it out and let me know if it fixes the issue.
Hi. After I create an npc and click him with the latest citizens and your latest build I get this in console.
The latest dev build fixes an important bug where players could sell enchanted books infinitely.
It also adds compatibility for Bukkit 1.9.2
Use at your own risk.
http://ci.citizensnpcs.co/job/HyperMerchant/29/
HyperMerchant 1.6 dev build is now available and compatible with spigot/bukkit 1.9. The spawn egg icons are all white, and a few other icons are not properly displayed. It seems to function normally otherwise.
@djwubamonkey
Yes. If you have any problems report them here. I will fix any bugs and I do consider all feature requests.
is this up to date?
@VapidScissors5
I will look into this. What plugin are you creating these items with?
RE: custom items - I notice when I add enchanted items with lore that the lore does not show up in the shop and neither does the enchant glow? Can this be fixed or is there a way to add it?
@SpaceNinjas
Yes, HyperConomy supports custom items. You have to add them to the database.
It's easy: Hold the item in your hand and type /additem name value
Where "name" is the whatever name you want the item to have, and "value" is the default money value for the item. If the name is more than one word, use underscores for whitespace character. Example: /additem enhanced_fire_wand 57.3
Does this plugin support custom items? I'm searching for a plugin that is compatible with MagicSpells and need players to be able to sell wands, scrolls and the like.
@nashoxx
I believe the categories are now contained in the database. You can edit it with the HyperConomy gui, which can be run by double-clicking the HyperConomy.jar.
Or if you are comfortable working with SQL databases, use your preferred method.
There's no config file to create your own categories. I'm using Spigot 1.8.8, latest version and latest version of this plugin, with Hyperconomy too.. (Both latest versions available on this site) Only files that seem to be appearing here are config. file, another thing called Hyperconomy which is a .bat file and a folder called "Languages" nothing else appears. I'm also using Citizens, latest version of it available on this site. There are no errors in the console, I've tried disabling the plugin, enabling it again, restarting the thing, trying to see if things appear while the server is off... Nothing, there is no categories.yml, I've searched in the HyperMerchant folder and the results are the same, nothing.
@broluigi
Edit:Okay fixed in latest dev build (#26). Get it from the development builds link above.
Thank you for your help, I would never have caught that error if no one had reported it.
And good job solving the inventory issue, players will only put up with that sort of bug for so long.
@shmancelot
I solved the first issue.. it wasnt hyperconomy or hypermerchant, but a samestine sign fix plugin.. phew..
This bug slows the server to a crawl.
@broluigi
I am left scratching my head trying to figure this out for hours now. Is there anything else you can tell me. Do the players quit with the shop menu still open? Please share a list of all your plugins, maybe there is some conflict with HyperMerchant and another. If you can think of anything or can identify some kind of pattern let me know.
@shmancelot
It's not a inventory break event, and i apologize. I remember exactly when i last posted it. The problem is i cant find a log of this happening. But this DOES happen only when hypermerchant is working. Minecraft 1.7 And up, Currently using 1.8.8 spigot. Latest dev build of hyperconomy and Hypermerchant. It happens on all versions of hyperconomy and hypermerchant.
@broluigi Do you remember when you posted about this bug in July?
You said "a inventory event break destroys people's inventories if people logout"
Please describe what is meant by "inventory break event".
What version of Spigot, HyperMerchant, HyperConomy and Minecraft are you using?
Sometimes plugins can interact in strange ways. What other plugins do you have?
I will do anything I can to fix the issue. But I can do nothing without more information. Thanks!
the only bug i have is that some people lose inventories upon logging in. disabling the plugin fixes it.