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
Menu Buttons
How To

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)


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.


I now accept donations in cryptocurrency. If you message me I will happily honor you as a donor on this page.





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! =)

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of ryanthemagi ryanthemagi Nov 19, 2013 at 19:40 UTC - 1 like

    The most recent version on your Github is not compatible with the most recent version of Hyperconomy (.974.1). Here is the error message that my console spews when I run both versions: http://pastebin.com/GpKRh3gv

  • Avatar of shmancelot shmancelot Oct 15, 2013 at 06:04 UTC - 1 like

    @WOLF81au: Go

    Alright, please try the latest dev build found at the github link above. (The latest dev build is not compatible with HyperConomy versions below 0.974)

    Please note, player shops are not properly supported yet. But your server shops should function as they have in the past. Player shop support will come soon.

    Last edited Oct 15, 2013 by shmancelot


  • Avatar of WOLF81au WOLF81au Oct 15, 2013 at 02:02 UTC - 0 likes

    Any chance you could update this to the Hyperconomy .974 snapshot? I just tried it and I can't select the npcs to be hmerchants. it's now broken and will have to go back to .973

  • Avatar of shmancelot shmancelot Oct 08, 2013 at 16:47 UTC - 0 likes

    Version 1.27 has been released. HyperConomy shop permissions are now supported. Thank you MikeGold for your help reporting this issue and testing new builds =)

    Last edited Oct 08, 2013 by shmancelot
  • Avatar of MikeGold MikeGold Oct 08, 2013 at 11:35 UTC - 0 likes

    Works great! Thanks a lot for the fast fix ;]

  • Avatar of shmancelot shmancelot Oct 08, 2013 at 04:52 UTC - 0 likes

    Alright I think I've sorted the permissions issue. Expect an upload in the next couple of days. Or try the latest dev build, available from the github link above.

  • Avatar of MikeGold MikeGold Oct 08, 2013 at 00:08 UTC - 0 likes

    Counting on you ;]. Oh, and thank you very much for creating this awesome plugin.

  • Avatar of shmancelot shmancelot Oct 07, 2013 at 22:25 UTC - 0 likes

    @MikeGold: Go

    Thank you for taking the time to report the issue, Mike. I will look into it the first chance I have. =)

  • Avatar of MikeGold MikeGold Oct 07, 2013 at 13:48 UTC - 1 like

    I've set up two shops, one with items where users are allowed to buy/sell and 2nd with enchants where users are only allowed to buy. When I'm using remotemenu for the 2nd shop I'm still able to buy and sell enchants. It's like HyperMerchant is disregarding permissions.

  • Avatar of shmancelot shmancelot Oct 02, 2013 at 16:45 UTC - 0 likes

    For anyone else experiencing the bug where the wrong sell price is being displayed, please try version 1.26 .

    Thanks TJW28 for your help solving this issue!

    Last edited Oct 02, 2013 by shmancelot


Date created
Aug 15, 2013
Last update
Apr 08, 2016
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files



Required dependency
Optional dependency