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 trump600 trump600 Dec 04, 2013 at 17:55 UTC - 1 like


    We're bypassing your gui error by manually adding and editing the "unavailable" list for each shop in the shops.yml file in hyperconomy. It seems that newly created shops are not generating the "unavailable" list and modifying the available categories of an existing shop deletes the list. When we take this approach, your gui shows only the intended items.

  • Avatar of shmancelot shmancelot Dec 02, 2013 at 02:49 UTC - 0 likes

    Yes this plugin will be upgraded to work properly with HyperConomy 0.974.1

    You can try the dev build of this plugin now, but it has some major flaws regarding what is in a shops inventory and what is listed in the gui menu. But it works at the moment if you just want server shops where people can purchase anything in one place.


  • Avatar of bdudek bdudek Dec 02, 2013 at 01:00 UTC - 0 likes

    is this going to be update to use hyperconomy 0.974?

  • Avatar of kotslon kotslon Nov 30, 2013 at 20:05 UTC - 1 like

    I tried to use your development version. It seems to me, that merchants don't check if material is in stock. They show everything in the menu.

    I deleted all items (/ri all MyShop). Now /browseshop a shows nothing, but /shopmenu (and merchant) - everything.

  • Avatar of shmancelot shmancelot Nov 30, 2013 at 12:15 UTC - 0 likes

    If you are using the newest version of HyperConomy (0.974.1), please now try to latest dev build of HyperMerchant. It is available on the HyperMerchant github page, in the "jar" folder. There is a link above to the HyperMerchant github page.

    Thank you for your patience. Please message me with any bugs you find, or features that seem to be missing.

    Last edited Nov 30, 2013 by shmancelot
  • Avatar of kotslon kotslon Nov 26, 2013 at 09:20 UTC - 1 like

    I'm waiting for a new version, too.
    And one more thing: I have several economies - not only the "default" one. So, I need my merchants to get info from the economy of the shop that they are attached to. I've bult previous version replacing "default" with shop's economy, and that worked fine (pull request on github). But for some reason i am unable to build current code :( So, please, add supporting of HyperConomy's multy economies feature.

  • Avatar of shmancelot shmancelot Nov 24, 2013 at 12:14 UTC - 0 likes

    @mrelfire: Go

    Nope it isn't your config. I have not uploaded a dev version yet compatible with current release of HyperConomy.

    Check back, it will be soon.

  • Avatar of mrelfire mrelfire Nov 24, 2013 at 07:37 UTC - 0 likes

    it crash with 1.6.4, is it my config ?

  • Avatar of shmancelot shmancelot Nov 20, 2013 at 23:03 UTC - 0 likes

    @ryanthemagi: Go

    Thank you for the error report ryan, I will have a new dev build available soon.

  • Avatar of RegalOwl RegalOwl Nov 20, 2013 at 05:30 UTC - 0 likes

    @ryanthemagi: Go

    Update HyperConomy Web to 0.0.2. That error isn't from HyperMerchant.

    EDIT: I take that back. One of those errors is from HyperMerchant, but most are from HyperConomy Web.

    Last edited Nov 20, 2013 by RegalOwl


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