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! =)
Thank you shmancelot, Love the plugin. I rate this plugin five stars ★★★★★
There is a new dev build. #39
Fixes the issue of players not being able to sell enchants.
Also adds the feature that players can now sell their own XP in increments of 10.
They must right click on the "experience" item in the shop menu.
The default menubuttons.yml has been updated.
heya shmancelot, hope you've been well. I'm curious, is there a way to to sell XP to a server shop via the GUI?
I have been well, thanks!
There is not a way to sell experience, I will go ahead and add it though.
There is a new dev build.
#36#37fixes the issue that caused the last page of the shop menu not to appear.
well i tried the last version (dev 1.59) of this plugin, the last version of hyperconomy (dev 0.975.7) and last version of citizens 2 (dev 2.0.21-snapshot) on spigot server 1.11.2
And everything seems to be working fine first, but when i ban all items in a shop and then allow one or two items to commerce, i right clicked on NPC and hypermerchant giveme an error (npc right click event). if i use /shopmenu command giveme the same error.
Plugin works "good" only if i not ban some items for that shop.
Another issue:
The gui (if i not ban a item) on the last page don't show any items and console giveme another error. Sorry about my language i speak spanish.
Will there be 1.11 support? It seems like this is the only thing that needs fixing: http://pastebin.com/FFeUWQWi
Thank you.
This is finally fixed in dev build 36
1.11 support?
@dNiym
Please try dev build #34, I think it will work.
The plugin that is adding the color codes should check to see if the chat event has been cancelled and strip the color codes automatically, because It could affect any plugin that uses player chat for input.
Found a bit of an issue..
If a player tries to set a price via the /managemenu and has to say the new price.
if their chat is prefixed with a color code it fails to change the price. 02.09 17:32:26 [Server] WARN java.lang.NumberFormatException: For input string: "§620000"
could you please have it strip color codes from players chats when setting buy/sell prices?
@HammerHedd
Thank you!
Anyone who can, please try out dev build #31
compiled for
HyperConomy dev build #21
bukkit 1.10.2
citizens 2.0.20 dev build #1408
I will have time to test all the features this weekend, but I can confirm that the menus and merchant npcs do work now (for me).
@shmancelot
You rock, Schmancey!
This is really one of the best vendor plugins around.
My workload has recently leveled out, so I think I will have a build by the weekend
I am having the same error as everyone else is, please fix ASAP, open donations if you need to but our server needs this plugin to work.
using spigot 1.10 R0.1 snapshot. If you need motivation, let us offer you donations. Or go to spigot
hyperconomy-0.975.7-SNAPSHOT hypermerchant-1.6-dev
Cannot set the merchant traited Npc. Cannot use the shop.
Also, bugs when i set the hypermerchant trait
been pretty busy lately plus uninspired as far as minecraft goes. I don't know when I will take the time to fix this.
@shmancelot
I'm having the same issue as mashal1004 below on 1.10 and the latest Citizen builds.
There occurs a strange error when I input '/shopmenu'. Version of my plugin and minecraft: Bukkit 1.9,HyperConomy-0.975.7b14-CB1.9, HyperMerchant-1.6b30-CB1.9,citizens-dtlTraders-3.3b5-CB1.8.6 Message in minecraft is there :An internal error occurred while attempting to perform this command!
[16:53:51 ERROR]: null org.bukkit.command.CommandException: Unhandled exception executing command 'shopmenu' in plugin HyperMerchant v1.59 at org.bukkit.command.PluginCommand.execute(PluginCommand.java:46) [craftbukkit.jar:git-Bukkit-2bfda1f] at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:140) [craftbukkit.jar:git-Bukkit-2bfda1f] at org.bukkit.craftbukkit.v1_9_R1.CraftServer.dispatchCommand(CraftServer.java:624) [craftbukkit.jar:git-Bukkit-2bfda1f] at net.minecraft.server.v1_9_R1.PlayerConnection.handleCommand(PlayerConnection.java:1298) [craftbukkit.jar:git-Bukkit-2bfda1f] at net.minecraft.server.v1_9_R1.PlayerConnection.a(PlayerConnection.java:1158) [craftbukkit.jar:git-Bukkit-2bfda1f] at net.minecraft.server.v1_9_R1.PacketPlayInChat.a(SourceFile:37) [craftbukkit.jar:git-Bukkit-2bfda1f] at net.minecraft.server.v1_9_R1.PacketPlayInChat.a(SourceFile:9) [craftbukkit.jar:git-Bukkit-2bfda1f] at net.minecraft.server.v1_9_R1.PlayerConnectionUtils$1.run(SourceFile:13) [craftbukkit.jar:git-Bukkit-2bfda1f] at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source) [?:1.8.0_92] at java.util.concurrent.FutureTask.run(Unknown Source) [?:1.8.0_92] at net.minecraft.server.v1_9_R1.SystemUtils.a(SourceFile:45) [craftbukkit.jar:git-Bukkit-2bfda1f] at net.minecraft.server.v1_9_R1.MinecraftServer.D(MinecraftServer.java:679) [craftbukkit.jar:git-Bukkit-2bfda1f] at net.minecraft.server.v1_9_R1.DedicatedServer.D(DedicatedServer.java:361) [craftbukkit.jar:git-Bukkit-2bfda1f] at net.minecraft.server.v1_9_R1.MinecraftServer.C(MinecraftServer.java:635) [craftbukkit.jar:git-Bukkit-2bfda1f] at net.minecraft.server.v1_9_R1.MinecraftServer.run(MinecraftServer.java:539) [craftbukkit.jar:git-Bukkit-2bfda1f] at java.lang.Thread.run(Unknown Source) [?:1.8.0_92] Caused by: java.lang.NullPointerException at grokswell.hypermerchant.HyperMerchantPlugin.onCommand(HyperMerchantPlugin.java:129) [?:?] at org.bukkit.command.PluginCommand.execute(PluginCommand.java:44) [craftbukkit.jar:git-Bukkit-2bfda1f] ... 15 more
@CR33P3R4TT4CK
Please share the stack trace from the console. What version of HyperMerchant and HyperConomy and Citizens are you running?