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 12, 2013 at 06:21 UTC - 0 likes

    @TJW28: Go

    Alright guys, please download the latest dev build (still version 1.3b) of HyperMerchant from github link above, located in /jar directory.

    Thank you both for reporting this issue :)

    Last edited Dec 12, 2013 by shmancelot


  • Avatar of TJW28 TJW28 Dec 12, 2013 at 04:05 UTC - 1 like

    @shmancelot: Go

    I can confirm the same issue as Chrisk123999

    Steps to reproduce:

    Create an npc, give it the hypermerchant trait. Use /hmerchant setshop shop. ( shop is the name of the server shop )

    Interact with the hypermerchant, and it says it is closed for business, and in the console it says npc #0 is assigned to a shop named shop. This shop does not exist ( where it clearly does )

    Hope that helps.

  • Avatar of shmancelot shmancelot Dec 12, 2013 at 03:44 UTC - 0 likes

    @chrisk123999: Go

    what is the name of the shop when you use the /rslist command? Is it a player shop, or a server shop? Which version of hyperconomy and hypermerchant are you using?

  • Avatar of chrisk123999 chrisk123999 Dec 11, 2013 at 20:38 UTC - 0 likes

    My NPC's aren't working with shops. The console says that they are assigned to a shop that doesn't exist when it clearly does.

    Last edited Dec 11, 2013 by chrisk123999
  • Avatar of shmancelot shmancelot Dec 10, 2013 at 03:54 UTC - 0 likes

    @Ares513: Go

    HyperMerchant probably isn't loading properly. Make sure you are using HyperConomy development build #312 or greater, HyperMerchant Version 1.3b (from the github link above), one of the latest Citizens dev builds, and Bukkit 1.7.2 dev build.

    If you are using Bukkit 1.6.4 or lower you will have to use HyperMerchant 1.2.7 and HyperConomy 0.973[Beta] or HyperConomy 0.974.1[Dev] and a version of Citizens that works with bukkit 1.6.4

    If you are using Bukkit 1.6.4 you will not be able to use player shops with HyperMerchant.

  • Avatar of shmancelot shmancelot Dec 10, 2013 at 03:46 UTC - 0 likes

    @TJW28: Go

    Sorry about that, that is some output I was using for debugging and forgot to turn it off. Please download the file again, It should be fixed.

  • Avatar of Ares513 Ares513 Dec 09, 2013 at 23:59 UTC - 0 likes


    I can't seem to get the /trait hypermerchant going. It just says the trait isn't found.

    Can you help?


  • Avatar of TJW28 TJW28 Dec 09, 2013 at 22:23 UTC - 0 likes

    @shmancelot: Go

    Hi shmancelot, while testing 1.3b, each time an item is clicked in the merchant, it generates All the items in the console, and happens each time previous and back options are presses in the merchants navigation area at bottom. Is that meant to happen?

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

    There is now an updated build of HyperMerchant in the github repository. Use the link above. Look in the /jar folder for version 1.3b

    Version 1.3b is only compatible with bukkit 1.7.2 and HyperConomy development build #312 or higher.

    Please note, player shops are still not fully supported. Player shops will display the correct prices and stock amounts, but the financial transaction will be with the server and the shop owner will not profit at this time. Fix coming soon.

    There is a client-side bug that will make players receive a ghost item almost every time they click on the menu. These items are only client-side wierdness and they disappear when a player tries to use them. The bug is fixed in the latest builds of Minecraft, and it will be fixed for all players when Mojang releases their next bugfix version.

    Last edited Dec 08, 2013 by shmancelot
  • Avatar of shmancelot shmancelot Dec 07, 2013 at 00:00 UTC - 0 likes

    @therennon: Go

    I will have time to really work on HyperMerchant tonight. It should be compatible this weekend.


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