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

- - - Commands and Permissions - - - Configuration - - -

HyperMerchant Features

  • 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.

  • 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.*

    New in version 1.4
  • Your players can /hire their own NPC shopkeepers (clerks) for a configurable "comission percentage".

  • You can set up ready to hire merchants by toggling a hypermerchant with /hmerch forhire.

  • You can set up ready to rent playershops by assigning a merchant to a playershop and toggle that merchant with /hmerch rental.

  • Configure the Interface Icons in the shopmenu gui by editing "menubuttons.yml".

    Coming soon in version 1.5
  • Management Menu for player shops.


For Bukkit 1.7.2
I recommend that you use 1.33 or the latest 1.4 build of HyperMerchant at this time.
Have build #335 of HyperConomy installed to use version 1.33.
HyperMerchant 1.41 is compatible with HyperConomy dev builds #368 - #373.

HyperMerchant dev build #58 is compatible with HyperConomy dev build #375.

HyperMerchant dev build #62 is compatible with HyperConomy dev build #386

For Bukkit 1.6.4
You must use HyperMerchant-1.27 and you must have version 0.972 or 0.973 of HyperConomy installed.

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

All Development builds of this project are >Available here<
These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Get the source for HyperMerchant on github.


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.

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

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

    @ryanthemagi: Go

    Please make sure you are you using at least dev build #313 of HyperConomy from the HyperConomy jenkins build server.


  • Avatar of shmancelot shmancelot Dec 20, 2013 at 01:42 UTC - 0 likes

    @ryanthemagi: Go

    Thanks for reporting this issue. I'll check it out later tonight. Should have a fix soon.

  • Avatar of ryanthemagi ryanthemagi Dec 19, 2013 at 17:43 UTC - 1 like

    The latest version is causing this error: http://pastebin.com/y8dkK065

    EDIT: I thought perhaps Spigot was causing the issue. I updated to Bukkit Beta and this is the new error: http://pastebin.com/V5u6x6hS

    Last edited Dec 19, 2013 by ryanthemagi
  • Avatar of shmancelot shmancelot Dec 19, 2013 at 10:15 UTC - 0 likes

    @Ares513: Go

    Please tell me which versions or build numbers of HyperConomy, HyperMerchant, Citizens, and Bukkit you are using. Sorry I have to make you dig up this info, It's the only way I can track down why the hypermerchant trait isn't registering with citizens. Is citizens loading up without error? Are there any warnings in the console on startup?

  • Avatar of Ares513 Ares513 Dec 19, 2013 at 05:46 UTC - 0 likes


    I've updated my build and everything and I can get the /hmerchant commands to show up but I still can't give my NPCs the hypermerchant trait. What can I do about this?


  • Avatar of Typical_Name Typical_Name Dec 17, 2013 at 08:44 UTC - 0 likes

    @shmancelot: Go

    This seems to have worked, thanks :D

  • Avatar of shmancelot shmancelot Dec 17, 2013 at 07:21 UTC - 0 likes

    @Typical_Name: Go You can do this already. I believe I forgot to document it though, sorry about that. Just give yourself the permission "creative.hypermerchant"

    Last edited Dec 17, 2013 by shmancelot
  • Avatar of Typical_Name Typical_Name Dec 17, 2013 at 03:44 UTC - 0 likes

    This is a minor issue, but is there a way we can make it so that players in creative mode can access the shop? It's mildly irritating for me as admin to have to constantly be switching gamemodes while testing things, and I don't really need the security precaution as anyone with access to creative mode would be staff.

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

    Player Shop compatibility is now working. Please try the latest dev build in the /jar directory at the github link above. At this time it will only work with HyperConomy dev build #313 or newer.

    Please let me know how it works and if anything needs fixing.

    Last edited Dec 16, 2013 by shmancelot
  • Avatar of TJW28 TJW28 Dec 12, 2013 at 06:50 UTC - 0 likes

    @shmancelot: Go

    Works a treat now, thank you

    Last edited Dec 12, 2013 by TJW28


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



Required dependency
Optional dependency