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! =)
Well I reverted back when I was having the issue. I tried again with latest dev builds and........ Now I can't reproduce. I guess one of my uploads may have ben corrupt or server restarts fixed it.
@Gamingoutlaws
That is some strange console output. I can not reproduce the same problem selling apples.
What I mean by strange console output is, there is no backtrace. What server version are you running?
More questions:
Can you share what the entry for apple looks like in your objects.yml file?
Are you using a custom item plugin?
Is there anything else you can think of that might effect items on your server in any way?
note to self: This might be related to this ticket.
Latest Dev build hyper merchant and hyperconomy "hyperconomy-0.974.3-SNAPSHOT"
I can buy from /shopmenu but cannot sell some items to shop.
Some of the items I can buy then turn around and sell back. But like say Apple I can buy an apple but cannot sell apple back to shop. (This shop does not deal in apple) But I can use the /sell command for the items.
If you are using the latest development build of HyperMerchant, you might notice that it now creates a HyperMerchant folder in your plugin directory. This contains a config.yml which does nothing at this point. Just letting you guys know that you don't have to mess with it quite yet.
@InsomniaCraft
I guess I forgot to post it. Version 1.3b fully supports HyperConomy player shops. Please use the latest dev build from the github link above, as well as build #329 or higher of HyperConomy. From an admins perspective, there is no difference setting up /shopmenu commands or npcs for player shops versus server shops.
And here are features I plan to add soon:
Right click on player to open their shop. (and /offduty command when players want to be "closed")
Option to require shop-owner physically be in shop for shop to be "open".
NPC commission (percentage NPC takes for working in player shop).
Followed by:
Shop management gui menu for player shop owners.
and
Traveling player shops requiring player to have mule/donkey with chest.
Are there plans for player shops? Havent heard any updates on it.
@MikeGold
Please download the latest dev build of HyperMerchant from the github link further up this page. It is in the jar/V1.3b/ folder.
As for players taking items from inventory, please advise your players to use Minecraft version 1.7.4 as it contains many bugfixes, including one that causes the ghost item issue.
@Galzek
I have reuploaded the jar file for 1.3b at the github link above. please try it out when you get the chance. thanks =)
I've just upgraded my server to 1.7.2. Before the update I had my stores all nicely set up. Enchants and items in separate stores, one allowed to sell items to store, the other didn't and since everything worked fine for me I wasn't updating hyper plugins. Now after the update, I've just downloaded most recent hyperconomy dev build and your plugin from the right side of this page. After opening store, I've got enchants mixed with normal items, all enchants have stones as icons, some normal items are gone. People can take the store buttons and put them in their inventory, but when they try to place them on the ground, blocks disappear. Also the server log is showing loads of errors when players try to use store. Is there a fault in my config files, or maybe the plugins/server? I'm a little bit worried about my configs, since it took me a good chunk of time to set the prices correctly. The last version of plugin I was using before the recent upgrade was the hyperconomy that had webserver incorporated in the main plugin. Any advices will be highly appreciated.
@Galzek
My apologies, I think the jar may be corrupt. I will re-upload as soon as I get home.
@shmancelot
Version 1.3b worked ok but you said to get the newest version so I grabbed the jar like you said from the jar folder on the github, go to launch MC Server and get this:
[16:49:21 ERROR]: Could not load 'plugins\HyperMerchant.jar' in folder 'plugins'
org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPlug inLoader.java:184) [craftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7 -b2978jnks] at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager .java:133) [craftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7-b2978jnk s] at org.bukkit.craftbukkit.v1_7_R1.CraftServer.loadPlugins(CraftServer.ja va:255) [craftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7-b2978jnks] at org.bukkit.craftbukkit.v1_7_R1.CraftServer.<init>(CraftServer.java:23 3) [craftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7-b2978jnks] at net.minecraft.server.v1_7_R1.PlayerList.<init>(PlayerList.java:63) [c raftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7-b2978jnks] at net.minecraft.server.v1_7_R1.DedicatedPlayerList.<init>(SourceFile:14 ) [craftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7-b2978jnks] at net.minecraft.server.v1_7_R1.DedicatedServer.init(DedicatedServer.jav a:126) [craftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7-b2978jnks] at net.minecraft.server.v1_7_R1.MinecraftServer.run(MinecraftServer.java :424) [craftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7-b2978jnks] at net.minecraft.server.v1_7_R1.ThreadServerApplication.run(SourceFile:6 17) [craftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7-b2978jnks] Caused by: java.util.zip.ZipException: error in opening zip file at java.util.zip.ZipFile.open(Native Method) [?:1.7.0_04] at java.util.zip.ZipFile.<init>(Unknown Source) [?:1.7.0_04] at java.util.zip.ZipFile.<init>(Unknown Source) [?:1.7.0_04] at java.util.jar.JarFile.<init>(Unknown Source) [?:1.7.0_04] at java.util.jar.JarFile.<init>(Unknown Source) [?:1.7.0_04] at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPlug inLoader.java:172) [craftbukkit-1.7.2-R0.3.jar:git-Bukkit-1.7.2-R0.2-3-g530fcb7 -b2978jnks]
Any ideas?
To all users of version 1.3b of HyperMerchant. I advise you to upgrade to the latest development build of HyperMerchant, located in the /jar/1.3b folder at the github link further up this page.
You will also have to upgrade to dev build #329 or greater of HyperConomy.
There was a regression that causes your players to sometimes lose the item they are selling and not be paid by the shop.
The cauldron icon that I was using as a placeholder for empty slots no longer exists in game. I have changed that to a light gray stained glass item that is visually appealing and likely to remain indefinitely.
@commandLionO
Menu items have been updated to show display names in the latest dev build of HyperMerchant, available in the github repository in the /jar/1.3b folder. The link is further up on this page.
You must also upgrade HyperConomy to dev build #329 or higher.
@commandLionO
Thanks for taking the time to post up this issue. I will make the necessary adjustment tonight.
Is there a way to get the items to display the alias or display nameinstead of the internal item name? I think these are newly added in hyperconomy. The items all have a _0 or another iteration based on that material and it shows up in the GUI now. Not a huge deal, mostly for looks but i think it might need to call the display name vs the old internal name.
@Ares513 Thank you for reporting this issue. Please see the ticket I made here. It is based on your report. There are a few questions I hope you can answer. I appreciate any help you can give me fixing the problem.
Hello,
Thanks for your assistance earlier. However, several of my users are reporting that they are not being paid for items being sold to the market. The items are consumed, however.
@ryanthemagi
Thank you for reporting this issue. Please see the ticket I have created here
@shmancelot
I updated to the correct versions. The command is working, but occasionally my console will spew this: http://pastebin.com/nXd3C90C
@InsomniaCraft
It is possible to put the ghost item in your inventory, but when you actually try to use (right click while holding) the item, it will disappear. This is because the item is only showing up on the client's side. It doesn't actually exist on the server, your players shouldn't be able to do anything useful with it.
The ghost item will also be replaced if the player picks anything up from the ground, because the item doesn't actually exist, it is actually an empty slot.
You might update your MOTD to let people know that they can/should use Minecraft 1.7.4 because it fixes this glitch and others.